JSP自定义标签

1.自定义标签的作用

• 用于移除jsp页面的Java代码。
• 控制jsp页面某一部分内容是否执行(内容权限控制)
• 控制整个jsp页面是否执行(页面权限控制)
• 控制jsp页面内容(标签体)重复执行
• 修改jsp页面的内容输出

2.标签语言特点

标签是由三个部分组成的: 开始标签  标签体  结束标签

<开始标签 属性 = "属性值">标签体</结束标签>

• 空标签: <开始标签/>  例如:<br/>
• 标准标签: <开始标签> 标签体 </结束标签> 例如: <a></a>

3.自定义标签开发及使用步骤

第一步：创建一个标准的标签工具类，并继承BodyTagSupport；

public class TestTag extends BodyTagSupport {
    ...
}

 标签属性必须与工具类中的属性对应、且要提供对应get/set方法

 第二步：创建标签库描述文件（.tld），添加自定义标签的配置；

<description>JSTL 1.1 core library</description>
<display-name>JSTL core</display-name>
<tlib-version>1.1</tlib-version>
<short-name>c</short-name>
<uri>http://java.sun.com/jsp/jstl/core</uri>
<!-- 你的标签库的简称 -->
<short-name>l</short-name>
<!-- 你标签库的引用uri -->    
<uri>/zking</uri>

<tag>
    <!-- 标签名 -->
    <name>test</name>
    <!-- 标签工具类 -->
    <!-- 根据全路径名反射机制实例化 -->
    <tag-class>com.zking.tag.TestTag</tag-class>
    <!-- 标签的内容类型：empty表示空标签，jsp表示可以为任何合法的JSP元素 -->
    <!-- empty 类似Html中br/hr标签 -->
    <body-content>jsp</body-content>
</tag>

注：.tld文件必须保存到WEB-INF目录或其子目录  

 第三步：在JSP页面中通过taglib指令导入标签库；

<%@taglib prefix="z" uri="/zking" %> 

 

4.自定义标签的生命周期

• doStartTag

但JSP容器遇到自定义标签的起始标志，就会调用doStartTag()方法,doStartTag()方法返回一个整数值，用来决定程序的后续流程。

<z:test>demo</z:test> 

 当执行到z:test开始标签时，将会执行对应标签工具类中的doStartTag方法

• doEndTag

但JSP容器遇到自定义标签的结束标志，就会调用doEndTag()方法。doEndTag()方法也返回一个整数值，用来决定程序后续流程。

<z:test>demo</z:test>

当执行到/z:test结束标签时，将会执行对应标签工具类中的doEndTag方法

• doAfterBody

遇到标签体执行

<z:test>demo</z:test>

调用z:test并执行动作之后(输出了一次标签主体内容之后)，在/z:test执行动作之前所执行的动作

• 返回值

方法返回值	备注
SKIP_BODY	跳过主体，不输出主体内容
EVAL_BODY_INCLUDE	计算标签主体内容并输出
EVAL_PAGE	计算页面的后续部分
SKIP_PAGE	跳过页面的后续部分
EVAL_BODY_AGAIN	再计算主体一次并输出

 

5.自定义标签运行流程

• 流程A

• 流程B

6.自定义标签实现

6.1.自定义out标签

创建OutTag标签类，定义属性value，在mytag.tld标签描述文件中定义out输出标签及属性信息。

public class OutTag extends BodyTagSupport {
    private Object value;
    ...
} 

6.2.自定义if标签

创建if标签类，定义属性test，在mytag.tld标签描述文件中定义if判断标签及属性信息

public class IfTag extends BodyTagSupport {   
 //定义if标签的条件判断属性test 
 private boolean test; 
  ... 
}

 

6.3.自定义forEach标签

创建forEach标签类，定义属性var和items，在mytag.tld标签描述文件中定义forEach循环标签及属性信息。

public class ForEachTag extends BodyTagSupport {
    //保存当前元素到page作用域中,并以var属性值来命名
    private String var;
    //被遍历的数据源
    private List<Object> items;
    ...
}

 

6.4.自定义dept数据标签

创建DeptTag类，定义属性var，并在mytag.tld标签描述文件中定义DeptTag标签及属性信息

public class DeptTag extends BodyTagSupport {    
 //保存当前元素到page作用域中,并以var属性值来命名
 private String var; 
 ... 
}

6.5.自定义select下拉框标签

创建SelectTag类，定义相关属性，并在mytag.tld标签描述文件中定义SelectTag标签及属性信息

public class SelectTag extends BodyTagSupport {
    //数据源
    private List<Object> items;
    //设置select中option的值
    private String value;
    //设置select中option的显示文本
    private String text;
    ...
} 

---