本文实例讲述了Java自定义标签用法。分享给大家供大家参考，具体如下：
简单例子
实现一个标签分为两步：（1）继承SimpleTagSupport或TagSupport实现一个控制器（2）创建一个描述标签的tld文件。下面是一个简单例子：
（1）实现一个标签控制器，向页面输出“hello”：
|
1
2
3
4
5
6
|
public class Test extends SimpleTagSupport{ public void doTag() throws IOException{ JspWriter out = getJspContext().getOut(); out.write("hello"); }} |
（2）在WEB-INF文件夹下创建一个custom.tld文件：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
<?xml version="1.0" encoding="UTF-8"?><taglib version="2.0" 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 web-jsptaglibrary_2_0.xsd"> <tlib-version>1.0</tlib-version> <jsp-version>2.0</jsp-version> <short-name>my</short-name> <!-- 直接显示hello --> <tag> <name>Hello</name> <tag-class>com.huanle.utils.tags.Test</tag-class> <body-content>empty</body-content> </tag></taglib> |
上面代码通过<tag>标签描述一个自定义标签，<body-content>empty</body-content>表示这个标签没有标签体，也就是开始标签和结束标签之间没有内容。
接下就可以在jsp文件中使用这个标签了（记得使用<%@taglib prefix="my" uri="/WEB-INF/custom.tld" %>指令导入标签库）：
|
1
2
3
4
5
6
7
8
9
10
11
|
<%@taglib prefix="my" uri="/WEB-INF/custom.tld" %><!DOCTYPE html><html><head><title>标签</title></head><body> <p>没有标签体，直接输出内容的标签</p> <my:Hello/></body></html> |
继承SimpleTagSupport定义简单标签
继承SimpleTagSupport，然后实现doTag()方法就可以自定义一个标签。这里有份英文教程，对继承SimpleTagSupport方式讲得非常透彻浅显易懂，本站下载链接。
下面是一些例子：
定义标签属性
（1）首先在控制器里填加一个属性，并生成setter 方法
|
1
2
3
4
5
6
7
8
9
10
|
public class Test extends SimpleTagSupport{ private String name; public void doTag() throws IOException{ JspWriter out= getJspContext().getOut(); out.write("hello"); } public void setName(String name) { this.name = name; }} |
（2）在tld文件里添加这个属性的描述，用<attribute>标签：
|
1
2
3
4
5
6
7
8
|
<tag> <name>Hello</name> <tag-class>com.huanle.utils.tags.Test</tag-class> <body-content>empty</body-content> <attribute> <name>name</name> </attribute></tag> |
<attribute>标签有多个子标签可以用来定义该属性的限制：
| 名称 | 用处 |
|---|---|
| name | 定义属性名 |
| required | 定义该属性是否是必须的，默认是false |
| rtexprvalue | 定义是否允许使用一个运行时表达式的值作为该属性的值，默认为false。比如要支持EL表达式，这个属性应该置为true |
| type | 定义属性的值类型，默认是String |
| fragment | 声明这个变量是否应该被看做JspFragment. |
定义标签体
之前定义的标签标签体一直都是空的，如果要支持标签体：
（1）修改tld文件的<body-content>值为scriptless，表示有标签体，并且标签体不含脚本（指jsp脚本，EL表达式等）
|
1
2
3
4
5
6
|
<!-- 获取标签体，输出 --> <tag> <name>Hello</name> <tag-class>com.huanle.utils.tags.Test</tag-class> <body-content>scriptless</body-content> </tag> |
（2）在标签控制器中获得标签体并输出：
|
1
2
3
4
5
6
7
|
public class Test extends SimpleTagSupport { private StringWriter sw = new StringWriter(); public void doTag() throws JspException, IOException{ getJspBody().invoke(sw); getJspContext().getOut().write(sw.toString().trim().substring(0, length)); }} |
使用时就可以包含标签体了：
|
1
|
<my:Hello>hello</my:Hello> |
继承TagSupport实现更复杂的标签
（后面更新。。。）
在标签内部使用request
标签属于其实最终会转化成一个Servlet，所有Servlet能做的标签都能做，包括操作request，session等，其中关键就在getJspContext()方法上。代码如下：
|
1
2
3
4
5
6
7
8
9
|
public class DispalyErrorMessageTag extends SimpleTagSupport { public void doTag() throws IOException{ JspWriter out = getJspContext().getOut(); PageContext pageContext = (PageContext)getJspContext(); HttpServletRequest request = (HttpServletRequest) pageContext.getRequest(); String value = request.getParameter(param); ... }} |
希望本文所述对大家java程序设计有所帮助。
原文链接：http://blog.csdn.net/ruangong1203/article/details/51101043
