jsp自定义标签

博客已迁移到CSDN《https://blog.csdn.net/qq_33375499》

 

　　你可以不去造轮子，但是你得知道轮子怎么造。

　　Javaweb实现自定义标签:将方法封装到自定义标签处理类中，然后使用方法与JSTL标签一致。在实际开发中，前台页面是不允许html代码和java代码相混合的，但有时jsp或第三方为我们提供的标签满足不了需求，这时需要通过自己将业务逻辑封装到继承jsp规范的类或接口的处理类中来定义标签，这就是所谓的自定义标签。这样的缺点是加重了工作量。但与前端人员沟通和后期的维护上来看，这点工作是微不足道的。

1. 创建一个类，如TimeTag，继承TagSupport类。为自定义标签添加属性，需要再java类中创建对应属性，并实现set方法，在后面的tld注册是，为tag标签添加attribute。
2. 在WEB-INF下创建一个tld的文件。这是一个标签库文件，我们所定义的标签都要在这个tld文件中进行注册。这个tld文件可以在tomcat安装目录下的webapps\examples\WEB-INF\jsp中找到。

如：

<?xml version="1.0" encoding="ISO-8859-1" ?>
<taglib>
    <tlib-version>1.0</tlib-version>
    <jsp-version>1.2</jsp-version>
    <short-name>lzqTag</short-name>
    <uri>/lzqTag</uri>
    <description>
        这是一个标签库
    </description>
    <tag>
        <name>time</name>
        <tag-class>com.lzq.tag.TimeTag</tag-class>
        <body-content>empty</body-content>
<!--
body-content标签有4个值：empty，JSP，scriptless，tagdependent：
1.empty：它是一个空的标签体。
2.JSP：是允许标签体内出现JSP脚本，也就是java代码。
3.scriptless：可以接受文本，EL表达式，和JSP的动作。
4.tagdependent：它是指在标签体的内容可以直接被写入bodyContent，由自定义标签处理类来处理，而不被JSP容器所解析。
-->
        <description>
            Perform a server side action; Log the message.
        </description>
        <attribute>
            <name>str</name>
            <required>true</required>
        </attribute>
    </tag>
</taglib>

 

　　3.在jsp中引入标签库，如：<%@ taglib prefix="lzqtag" uri="/lzqTag" %>，并在body中使用<lzqtag:time str=’’ />

 

 

 

Tag接口：

int SKIP_BODY = 0;    // 跳过标签体，不执行标签体的内容
int EVAL_BODY_INCLUDE = 1;    // 执行自定义标签的标签体
int SKIP_PAGE = 5;    // 告诉web容器忽略标签后面的内容
int EVAL_PAGE = 6;    // 告诉web容器继续执行标签后面的代码

// 在jsp运行过程中，遇见自定义标签后，执行的方法：返回常量SKIP_BODY、EVAL_BODY_INCLUDE
int doStartTag() throws JspException;

// 在执行标签的结束标志后，执行该方法：返回常量SKIP_PAGE、EVAL_PAGE
int doEndTag() throws JspException;

 

IterationTag接口：

int EVAL_BODY_AGAIN = 2;    // 
// 提供了对标签内容循环的功能：返回EVAL_BODY_AGAIN，一直循环，知道返回常量SKIP_BODY、EVAL_BODY_INCLUDE
int doAfterBody() throws JspException;

 

 

SimpleTag接口：

在源码中可以看到SimpleTag接口有5个方法，

1、doTag()方法是核心方法，我们可以将所有的标签处理逻辑都写在这个方法中，这个方法会抛出一个JspException，然后我们可以通过这个异常通知WEB容器，不再执行此标签后面的内容。

2、setParent(JspTag)，这个方法呢，由WEB容器所调用的，是将父标签处理器对象传递给标签处理器。

3、getParent()是获取当前标签的父标签对象，比如在标签嵌套时，可以用此方法得到当前标签的父标签。

4、setJSPContext(JspContext)这个方法也是由容器调用的，这个方法是将JSP页面中的pageContext对象传递给标签处理器对象。

5、setJspBody(JspFragment)这个方法也由web容器调用，意思是将代表当前标签体的JspFragment对象传递给标签处理器对象，这里的参数可以理解为标签体的内容。

 注意：JSP引擎在处理简单标签的标签时，会将标签体中的内容封装到JspFragment这个参数中，并调用setJspBody(JspFragment)将该对象传递给标签处理器，我们就可以根据需求来控制是否输出标签体或者循环标签体。