自定义标签库jsp

最新推荐文章于 2020-11-29 02:09:40 发布
最新推荐文章于 2020-11-29 02:09:40 发布
阅读量526 收藏
点赞数
分类专栏： 前端技术 文章标签： jsp tag 标签
建立TLD文件

我们写Servlet的时候，会在web.xml中加入定义的Servlet类和URL之间的映射。同理，我们定义了标签类，也需要一个配置文件，将自定义标签和对应的标签类关联起来。在定义自定义标签时，这个配置文件叫做标签库定义文件，是以tld后缀结尾的，每个TLD文件对应一个标签库，一个标签库中可包含多个标签。

标签库定义文件的根元素是taglib，它可以包含多个tag子元素，每个tag子元素都定义一个标签。我们需要将tld文件保存到Web应用的WEB-INF/路径，或者WEB-INF的任意子路径下。

以下就是我定义的一个简单的tld文件。

<?xml version="1.0" encoding="UTF-8" ?>

<taglib xmlns="http://java.sun.com/xml/ns/j2ee"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"
  version="2.0">

  <description>Test 1.0</description>
  <tlib-version>1.0</tlib-version>
  <short-name>jtlib</short-name>
  <uri>http://www.jellythink.com/jtlib/</uri>

  <!-- 定义一个标签 -->
  <tag>
    <!-- 定义标签名 -->
    <name>jtTag</name>
    <!-- 定义标签处理类 -->
    <tag-class>com.jellythink.practise.TestTag</tag-class>
    <!-- 定义标签体内容为空 -->
    <body-content>empty</body-content>
  </tag>
</taglib>

标签库定义文件是一个XML文件，该XML文件的根元素是taglib元素。taglib主要有以下几个子元素：

  • description，对该tld文件的一些描述性的信息
  • tlib-version，指定该标签库实现的版本，这是一个作为标识的内部版本号，对程序没有太大的作用
  • short-name，标签库的默认短名，没有太大的作用
  • uri，这个属性非常重要，它指定该标签库的URI，相当于指定该标签库的唯一标识。JSP页面中使用标签库时就是根据该URI属性来定位标签库的

接下来，taglib元素下可以包含多个tag元素，每个tag元素定义一个标签，tag元素主要有以下子元素：

  • name，指定标签的名字，JSP页面中就是根据该名称来使用此标签的，所以该子元素非常重要
  • tag-class，指定标签的处理类，它指定了标签由哪个标签处理类来处理，该子元素极其重要
  • body-content，指定标签体的内容，该子元素非常重要，它主要可以取以下几个值：
    • tagdependent，指定标签处理类自己负责处理标签体
    • empty，该标签只能作为空标签来使用
    • scriptless，指定该标签的标签体可以是静态HTML元素、表达式语言，但不能是JSP脚本
    • dynamic-attributes，指明该标签是否支持动态属性。只有定义动态属性标签时才需要该子元素

以上就是标签库定义文件的编写规范，以及编写过程中需要注意的内容事项。编写好标签库定义文件以后，将标签库文件放在Web应用的WEB-INF路径，或者任意子路径下，Java Web会自动加载该文件，该文件定义的标签库也将生效。

使用标签库

标签库处理类定义好了，标签库定义文件也写好了，接下来就该小试牛刀了，看看在JSP中到底该怎么使用我们自定义的标签。

在JSP页面中使用标签库需要注意以下两点：

  • 标签库URI：确定使用哪个标签库
  • 标签名：确定使用哪个标签

具体使用标签库主要分为以下两个步骤：

  1. 导入标签库；使用taglib编译指令导入标签库，就是将标签库和指定前缀关联起来
  2. 使用标签；在JSP页面中使用自定义标签

下面通过一个简单的JSP来说明如何使用自定义标签，JSP页面代码如下：

<%@ page language="java" contentType="text/html; charset=utf-8"%>
<%@ page pageEncoding="UTF-8"%>

<!-- 导入标签库 -->
<%@ taglib uri="http://www.jellythink.com/jtlib/" prefix="jt" %>

<!DOCTYPE>
<html>
<head>
<title>页面一</title>
</head>
<body>
    <!-- 使用自定义标签  -->
    <!-- 输出：http://www.jellythink.com 果冻想-一个原创技术文章分享网站  -->
    <jt:jtTag />
    <jt:jtTag />
</body>
</html>

总结到这里，对于如何定义一个简单的标签，以及如何使用这个简单的自定义标签，大家心里应该都有数了，接下来看看自定义标签的一些高级用法，而这些高级用法才是开发中真正经常碰到的。

带属性的标签

很多时候，单纯的一个标签根本无法满足我们的需要。我们需要在标签中添加一些属性，通过设置的这些属性值，我们可以进行更丰富的操作，比如执行属性值中指定的SQL语句，从而返回并显示查询结果。下面就来说说如何在自定义标签中添加属性的功能。

首先，带属性的标签必须要为每个属性提供对应的setter和getter方法；例如，我们的自定义标签将会有三个属性，分别是：name、price和store。那么我们对应的标签处理类会变成下面这个样子：

package com.jellythink.practise;

import java.io.IOException;

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.SimpleTagSupport;

public class TestTag extends SimpleTagSupport
{
    // 标签定义的属性
    private String name;
    private String price;
    private String store;

    // 需要为每个属性定义setter和getter方法
    public void setName(String name)
    {
        this.name = name;
    }

    public String getName()
    {
        return this.name;
    }

    public void setPrice(String price)
    {
        this.price = price;
    }

    public String getPrice()
    {
        return this.price;
    }

    public void setStore(String store)
    {
        this.store = store;
    }

    public String getStore()
    {
        return this.store;
    }

    public void doTag() throws JspException, IOException
    {
        JspWriter out = getJspContext().getOut();
        out.write("书名：" + name);
        out.write("价格：" + price);
        out.write("书店：" + store);
    }
}

每个属性都必须要有对应的setter和getter方法，这是不能少的。标签对应的处理类进行了对应的变更；同理，对于标签库定义文件也要进行对应的修改，需要为<tag... />元素增加<attribute... />子元素，每个attribute子元素定义一个标签属性。在定义attribute元素时，需要为其指定以下几个子元素：

  • name，设置属性名；在使用自定义标签时，就是通过该名指定属性名
  • required，设置该属性是否为必须属性，取值为true或false
  • fragment，设置该属性是否支持JSP脚本、表达式等动态内容，取值为true或false

为此，我们的标签库定义文件就要修改为如下这样：

<?xml version="1.0" encoding="UTF-8" ?>

<taglib xmlns="http://java.sun.com/xml/ns/j2ee"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"
  version="2.0">

  <description>Test 1.0</description>
  <display-name>Test TLD</display-name>
  <tlib-version>1.0</tlib-version>
  <short-name>jtlib</short-name>
  <uri>http://www.jellythink.com/jtlib/</uri>

  <!-- 定义一个标签 -->
  <tag>
    <!-- 定义标签名 -->
    <name>jtTag</name>
    <!-- 定义标签处理类 -->
    <tag-class>com.jellythink.practise.TestTag</tag-class>
    <!-- 定义标签体内容为空 -->
    <body-content>empty</body-content>

    <!-- 配置name属性 -->
    <attribute>
        <name>name</name>
        <required>true</required>
        <fragment>true</fragment>
    </attribute>

    <!-- 配置price属性 -->
    <attribute>
        <name>price</name>
        <required>true</required>
        <fragment>true</fragment>
    </attribute>

    <!-- 配置store属性 -->
    <attribute>
        <name>store</name>
        <required>true</required>
        <fragment>true</fragment>
    </attribute>
  </tag>
</taglib>

接下来，我们就可以在JSP中使用这个带有属性定义的自定义标签了，具体代码如下：

<jt:jtTag name="Java编程思想" price="75.58" store="三味书屋" /> <br/>
<jt:jtTag name="看见" price="25.10" store="书海书屋" /> <br/>
<jt:jtTag name="狼图腾" price="23.00" store="国家图书馆" /> <br/>

具体输出如下：

书名：Java编程思想价格：75.58书店：三味书屋 
书名：看见价格：25.10书店：书海书屋 
书名：狼图腾价格：23.00书店：国家图书馆

这就是带有属性的自定义标签。

带标签体的标签

可以看到，上面自定义的标签都是没有任何标签体的，都是一个简单的标签。那么如果我们希望标签中带有标签体，这又如何完成呢？

对于带标签体的自定义标签，我们可以在标签内嵌入静态的HTML内容和动态的JSP内容，通常用于循环输出一些内容。下面就通过一个简单的例子进行说明。

标签类的处理代码如下：

package com.jellythink.practise;

import java.io.IOException;
import java.util.Collection;

import javax.servlet.jsp.JspContext;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.SimpleTagSupport;

public class TestTag extends SimpleTagSupport
{
    // 标签定义的属性
    private String collection;
    private String item;

    public void setCollection(String collection)
    {
        this.collection = collection;
    }

    public String getCollection()
    {
        return this.collection;
    }

    public void setItem(String item)
    {
        this.item = item;
    }

    public String getItem()
    {
        return this.item;
    }


    public void doTag() throws JspException, IOException
    {
        JspContext context = getJspContext();

        // 根据属性值，获得设置的对象
        Collection itemList = (Collection)context.getAttribute(collection);
        for (Object s : itemList)
        {
            // 设置属性值，供标签体使用
            context.setAttribute(item, s);

            // 输出标签体，这个是重点
            getJspBody().invoke(null);
        }
    }
}

标签库定义文件：

<?xml version="1.0" encoding="UTF-8" ?>

<taglib xmlns="http://java.sun.com/xml/ns/j2ee"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"
  version="2.0">

  <description>Test 1.0</description>
  <display-name>Test TLD</display-name>
  <tlib-version>1.0</tlib-version>
  <short-name>jtlib</short-name>
  <uri>http://www.jellythink.com/jtlib/</uri>

  <!-- 定义一个标签 -->
  <tag>
    <!-- 定义标签名 -->
    <name>jtTag</name>
    <!-- 定义标签处理类 -->
    <tag-class>com.jellythink.practise.TestTag</tag-class>
    <!-- 定义标签体内容为空 -->
    <body-content>scriptless</body-content>

    <!-- 配置属性 -->
    <attribute>
        <name>collection</name>
        <required>true</required>
        <fragment>true</fragment>
    </attribute>

    <attribute>
        <name>item</name>
        <required>true</required>
        <fragment>true</fragment>
    </attribute>
  </tag>
</taglib>

对于标签库定义文件来说，主要是<body-content>字段的值需要设置为scriptless。最重要的是JSP页面里如何使用带有标签体的自定义标签，具体代码如下：

<%@ page language="java" contentType="text/html; charset=utf-8"%>
<%@ page pageEncoding="UTF-8"%>
<%@ page import="java.util.*" %>

<!-- 导入标签库 -->
<%@ taglib uri="http://www.jellythink.com/jtlib/" prefix="jt" %>

<!DOCTYPE>
<html>
<head>
<title>页面一</title>
</head>
<body>
    <%
    // 创建一个List对象
    List<String> obj = new ArrayList<String>();
    obj.add("博客园");
    obj.add("开源中国");
    obj.add("果冻想");
    pageContext.setAttribute("collection", obj);
    %>

    <jt:jtTag collection="collection" item="item">
        ${pageScope.item} <br />
    </jt:jtTag>

</body>
</html>

由于JSP主要作为表现层，上面只是通过一个简单的例子来说明如何表现数据；很多时候，我们后台返回一个数据集合，我们就可以通过这种方式来表现数据。


wsz智
关注
专栏目录
JSP中如何使用自定义的标签库
折戟沉沙
09-03 761
主要分为三步：1.创建标签的处理类     2.创建标签ku
jsp通过自定义标签库实现数据列表显示的方法
10-23
在JSP技术中，自定义标签库是一种提高代码复用性、降低页面复杂度的有效手段。通过自定义标签库，开发者可以创建可复用的组件，这些组件封装了特定的逻辑，可以在多个JSP页面中使用。 自定义标签库通常由两部分组成...
十六.标签管理
lvmengzou的专栏
11-26 213
标签的概念 什么是标签 标签是一个引用，标签对象可以指向任何对象 通常情况下，是指向一个提交（commit） 包括一个标签，一组数据，一个消息，一个指针 标签有什么作用 使用标签可以方便地标记里程碑 发布软件的版本标识（内核linux2.6.30） 标签的基本操作 打标签 在当前分支的末端创建轻量级标签，git tar V1.0 给指定某个commit打标签：git t...
JSP自定义标签库
qq_43656358的博客
07-19 174
JSP 自定义标签 自定义标签是用户定义的JSP语言元素。当JSP页面包含一个自定义标签时将被转化为servlet，标签转化为对被 称为tag handler的对象的操作，即当servlet执行时Web container调用那些操作。 JSP标签扩展可以让你创建新的标签并且可以直接插入到一个JSP页面。 JSP 2.0规范中引入Simple Tag Handlers来编写这些自定义标记。 你可以...
（转）JSP自定义标签库-详解
艾利克斯冰的博客
05-15 337
JSP自定义标签开发入门 一般情况下开发jsp自定义标签需要引用以下两个包 importjavax.servlet.jsp.*; importjavax.servlet.jsp.tagext.*; 首先我们需要大致了解开发自定义标签所涉及到的接口与类的层次结构(其中SimpleTag接口与SimpleTagSupport类是JSP2.0中新引入的)。 目标1:自定义一个用表格显示用户信息的简单标签 效果图： 在jsp页面使用此自定义标签： 假设我们有...
JSP自定义标签库和函数
人不风流枉少年
06-28 1901
一、基础知识1. 常见的自定义标签库有哪些？ jstl中的c、fn、fmt等 <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions"%> <%@ taglib prefix="fmt" uri
jsp自定义标签库实现数据列表显示
03-07
在JavaServer Pages (JSP) 开发中，自定义标签库是提高代码可重用性和模块化的重要手段。本文将详细讲解如何利用JSP自定义标签库实现数据列表的显示，以及涉及到的相关技术。 首先，`UserListTag.java` 是自定义...
Jsp自定义标签和方法详解
01-20
在JSP页面中，可以通过以下方式引入自定义标签库： ```jsp ``` 然后，可以使用`my:`前缀来调用自定义标签： ```jsp ``` 4. **自定义函数** 除了自定义标签，JSP还可以定义自定义函数。在TLD文件中，定义...
JSP自定义标签基础知识学习
10-22
具体做法是在JSP页面顶部添加taglib指令，指定自定义标签库的位置和前缀。之后，就可以按照给定的前缀加上标签名的方式来使用自定义标签了。 在实际应用中，一个典型的自定义标签可能处理特定属性，以控制标签的...
jsp El 标签不生效
Assassinl
04-11 340
在页面上加入   &lt;%@ page isELIgnored="false" %&gt; &lt;%-- el表达式不生效加入--%&gt;
jsp自定义标签报错的问题
02-23
在网上学习jsp自定义标签的时候, 出现了异常, 在网上寻找了好久, 都没有找到合适的答案, 自己通过摸索最后成功, 分享给大家, 希望能够帮助到你, 自定义标签不能放在java Project中, 只能在java web Project中才可以.
jsp 使用<base>标签 没有作用_北京尚学堂卓越班252天[第043天]——Jsp
weixin_39802962的博客
11-29 128
Jsp的a) 内置对象（隐含对象）内置对象：在jsp中的输出脚本(<%= %>)或者是普通脚本(<% %>)中，不用创建就可以直接使用的对象。1. request【重要】操作request作用域：request.setAttribute(); request.getAttribute();request.getContextPath(); //动态获取应用名2. res...
JSP自定义标签问题2
Freeboydoit的博客
07-17 217
tag问题：HTTP Status 500 - ······ Unterminated <c:out tag 原因：属于jsp语法错误，可能是标签格式不对，可能是双引号、尖括号、大括号位置不对，或者少写多写了等等。之前碰到问题修改的时候就不小心多写了个大括号，所有造成这样的错误。 错误示例： <c:out value="${t:exchange(‘wen’)} }"></c...
jsp自定义标签——部分容易不注意到的属性
buer的博客
09-02 1690
看项目中的源代码才发现自定义标签中也是个小知识点。      有些小激动的查了下，以下就是查阅别人的博客后的观后感。      rtexprvalue 全称Run - time Expression Value,表示是否可以使用jsp表达式。          rtexprvalue标签在标签下面，其中有true,false。     当true时，表示该自定义标签的某个属性的值
自定义标签中使用El表达式
Angegril的博客
09-19 1074
在自定义标签中如果没有配置使用El表达式会报错 &lt;t:tag tagType="Add" id="${list.id}" /&gt; 需要在tld文件中添加属性rtexprvalue，如下面这样 &lt;?xml version="1.0" encoding="UTF-8"?&gt; &lt;!DOCTYPE taglib PUBLIC "-//Sun Microsy
关于jsp页面标签失效
ziruominglin的专栏
08-22 1746
1.今天花了好多时间解决这个问题 网上说的&lt;?xml version="1.0" encoding="UTF-8"?&gt; &lt;web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:web="http://xmlns.jc
当jsp自定义标签结果既没有报错，也没有显示正确结果时
c1776167012的博客
03-16 454
前几天在练习一个jsp自定义标签时，遇到了这样的情况：当我写好代码后，启动服务器，访问它，结果既没有报错也不显示我要的结果，就是一片空白 当时我的代码是这样的： java文件： package com.yan.tag; import javax.servlet.jsp.JspException; import javax.servlet.jsp.tagext.BodyTagSupport; p...
自定义JSP标签库详解
本章内容主要讲解了JSP中的自定义标签库的使用，包括自定义标签的四种形式以及创建和使用自定义标签的核心概念。 在JSP中，自定义标签库提供了一种方式，使得开发者能够创建符合自身需求的标签，从而更好地分离程序...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值