JSP自定义标签

1.自定义标签的作用

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

2.标签语言特点

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

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

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

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>/zking</uri>

<tag> <name>test</name> <tag-class>com.zking.tag.TestTag</tag-class> <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;
...
}