jsp自定义标签
自定义标签简介：
自定义标签移除jsp页面中的java代码，只需要完成以下两个步骤：
编写一个实现Tag接口的Java类(标签处理器类)。
编写标签库描述符（tld）文件，在tld文件中对标签处理器类进行描述。
Tag接口的执行流程：JSP引擎将遇到自定义标签时，首先创建标签处理器类的实例对象。
1、public void setPageContext(PageContext pc)， JSP引擎实例化标签处理器后，将调用setPageContext方法将JSP页面的pageContext对象传递给标签处理器，标签处理器以后可以通过这个pageContext对象与JSP页面进行通信。
2、public void setParent(Tag t)，setPageContext方法执行完后，WEB容器接着调用的setParent方法将当前标签的父标签传递给当前标签处理器，如果当前标签没有父标签，则传递给setParent方法的参数值为null。
3、public int doStartTag()，调用了setPageContext方法和setParent方法之后，WEB容器执行到自定义标签的开始标记时，就会调用标签处理器的doStartTag方法。
4、public int doEndTag()，WEB容器执行完自定义标签的标签体后，就会接着去执行自定义标签的结束标记，此时，WEB容器会去调用标签处理器的doEndTag方法。
5、public void release()，通常WEB容器执行完自定义标签后，标签处理器会驻留在内存中，为其它请求服务器，直至停止web应用时，web容器才会调用release方法。
tld文件中的四种标签体类型----
EMPTY--标签体没有有内容
JSP--标签体有内容
scriptless--接受文本、EL和JSP动作
tagdepentend--这个属性是让标签体只给标签用
SimpleTag方法介绍：
setJspContext方法--用于把JSP页面的pageContext对象传递给标签处理器对象
setParent方法--用于把父标签处理器对象传递给当前标签处理器对象
getParent方法-用于获得当前标签的父标签处理器对象
setJspBody方法--用于把代表标签体的JspFragment对象传递给标签处理器对象
doTag方法--用于完成所有的标签逻辑，包括输出、迭代、修改标签体内容等。在doTag方法中可以抛出javax.servlet.jsp.SkipPageException异常，用于通知WEB容器不再执行JSP页面中位于结束标记后面的内容，这等效于在传统标签的doEndTag方法中返回Tag.SKIP_PAGE常量的情况。
SimpleTag接口方法的执行顺序：
当web容器开始执行标签时，会调用如下方法完成标签的初始化
WEB容器调用标签处理器对象的setJspContext方法，将代表JSP页面的pageContext对象传递给标签处理器对象。
WEB容器调用标签处理器对象的setParent方法，将父标签处理器对象传递给这个标签处理器对象。注意，只有在标签存在父标签的情况下，WEB容器才会调用这个方法。
如果调用标签时设置了属性，容器将调用每个属性对应的setter方法把属性值传递给标签处理器对象。如果标签的属性值是EL表达式或脚本表达式，则WEB容器首先计算表达式的值，然后把值传递给标签处理器对象。
如果简单标签有标签体，容器将调用setJspBody方法把代表标签体的JspFragment对象传递进来。
执行标签时：
容器调用标签处理器的doTag()方法，开发人员在方法体内通过操作JspFragment对象，就可以实现是否执行、迭代、修改标签体的目的。
JspFragment类 ：
javax.servlet.jsp.tagext.JspFragment类是在JSP2.0中定义的，它的实例对象代表JSP页面中的一段符合JSP语法规范的JSP片段，这段JSP片段中不能包含JSP脚本元素。
WEB容器在处理简单标签的标签体时，会把标签体内容用一个JspFragment对象表示，并调用标签处理器对象的setJspBody方法把JspFragment对象传递给标签处理器对象。JspFragment类中只定义了两个方法，如下所示：
getJspContext方法--用于返回代表调用页面的JspContext对象.
public abstract void invoke(java.io.Writer out)--用于执行JspFragment对象所代表的JSP代码片段
参数out用于指定将JspFragment对象的执行结果写入到哪个输出流对象中，如果传递给参数out的值为null，则将执行结果写入到JspContext.getOut()方法返回的输出流对象中。(简而言之，可以理解为写给浏览器)
invoke方法详解
JspFragment.invoke方法是JspFragment最重要的方法，利用这个方法可以控制是否执行和输出标签体的内容、是否迭代执行标签体的内容或对标签体的执行结果进行修改后再输出。例如：
在标签处理器中如果没有调用JspFragment.invoke方法，其结果就相当于忽略标签体内容；
在标签处理器中重复调用JspFragment.invoke方法，则标签体内容将会被重复执行；
若想在标签处理器中修改标签体内容，只需在调用invoke方法时指定一个可取出结果数据的输出流对象（例如StringWriter），让标签体的执行结果输出到该输出流对象中，然后从该输出流对象中取出数据进行修改后再输出到目标设备，即可达到修改标签体的目的。
开发带属性的标签：
要想让一个自定义标签具有属性，通常需要完成两个任务：
在标签处理器中编写每个属性对应的setter方法
在TLD文件中描术标签的属性
为自定义标签定义属性时，每个属性都必须按照JavaBean的属性命名方式，在标签处理器中定义属性名对应的setter方法，用来接收JSP页面调用自定义标签时传递进来的属性值。 例如属性url，在标签处理器类中就要定义相应的setUrl(String url)方法。
在标签处理器中定义相应的set方法后，JSP引擎在解析执行开始标签前，也就是调用doStartTag方法前，会调用set属性方法，为标签设置属性。
<attribute>
<description>description</description> --不一定要指定，用于指定属性的描述信息。
<name>aaaa</name>--一定指定，用于指定属性的名称，大小写敏感。
<required>true</required>--指定在jsp页面中得调用自定义标签时是否必须设置这个属性。只有true和false，默认false
<rtexprvalue>true</rtexprvalue>--指定属性值是一个静态值或动态值，也是true，false。false表示只能为该属性指定静态文本值true可以为该属性指定一个jsp动态元素，动态元素的结果作为属性值，<%=value%>。
<type>ObjectType</type>--指定属性值得Java类型
</attribute>
tld文件中的四种标签体类型----
empty--不允许有标签体存在
JSP--允许有标签存在，可以是jsp代码
scriptless--接受文本、EL和JSP动作
tagdependen--允许有标签体存在，但是标签体内的jsp代码不会被执行
例子：
1)编写一个实现tag接口的标签处理器类
public class ViewIPTag implements Tag {
private PageContext pageContext; //jsp内容
//标签开始执行
public int doStartTag() throws JspException {
HttpServletRequest request = (HttpServletRequest) pageContext.getRequest();
//获取out对象
JspWriter out = pageContext.getOut();
String ip = request.getRemoteAddr();
try {
out.write(ip);
} catch (IOException e) {
throw new RuntimeException(e);
}
return 0;
}
//标签执行结束
public int doEndTag() throws JspException {
return 0;
}
public Tag getParent() {
return null;
}
public void release() {
}
public void setPageContext(PageContext arg0) {
this.pageContext = arg0;
}
public void setParent(Tag arg0) {
}
}
2)在web-inf/目录下新建tld文件，在tld文件中对标签处理器进行描述taglib.lib
<?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>A tag library exercising SimpleTag handlers.</description>
<tlib-version>1.0</tlib-version>
<short-name>SimpleTagLibrary</short-name>
<uri>/lcp</uri>
<tag>
<name>viewIP</name> <!-- 为标签处理器类配一个标签名 -->
<tag-class>cn.lcp.web.tag.ViewIPTag</tag-class>
<body-content>empty</body-content>
</tag>
</taglib>
3)在jsp页面中导入并使用自定义标签
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@taglib uri="/lcp" prefix="lcp" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>输出客户机的IP</title>
</head>
<body>
您的IP是：<lcp:viewIP/>
</body>
</html>
自定义标签的扩展功能：
控制jsp页面某一部分内容是否执行。
1.编写一个类实现tag接口，控制dostarttag方法的返回值，如果这个方法返回EVAL_BODY_INCLUDE，则执行标签体，如果返回SKIP_BODY，则不执行标签体
控制整个jsp页面是否执行。
2、编写一个类实现tag接口，控制doendtag方法的返回值，如果这个方法返回EVAL_PAGE，则执行标签余下的jsp页面，如果返回SKIP_PAGE，则不执行余下的jsp
控制jsp页面内容重复执行。
3.编写一个类实现Iterationtag接口，控制doAfterBody方法的返回值，如果这个方法返回EVAL_BODY_AGAIN， 则web服务器又执行一次标签体，依次类推，一直执行到doAfterBody方法返回SKIP_BODY，则标签体才不会重复执行。
修改jsp页面内容输出。
4、编写一个类实现BodyTag接口，控制doStartTag方法，返回EVAL_BODY_BUFFERED，则web服务器会创建BodyContent对象捕获标签体，开发人员在doendtag方法体内，得到代表标签体的bodyContent对象，从而就可以对标签体进行修改。。。。。。操作。
lcp.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>A tag library exercising SimpleTag handlers.</description>
<tlib-version>1.0</tlib-version>
<short-name>SimpleTagLibrary</short-name>
<uri>http://www.lcp.com</uri>
<tag>
<name>viewIP</name> <!-- 为标签处理器类配一个标签名 -->
<tag-class>cn.lcp.web.tag.ViewIPTag</tag-class>
<body-content>empty</body-content>
</tag>
<tag>
<name>tagDemo</name> <!-- 为标签处理器类配一个标签名 -->
<tag-class>cn.lcp.web.tag.TagDemo</tag-class>
<body-content>JSP</body-content> <!-- 标签体有内容 -->
</tag>
<tag>
<name>tagDemo2</name> <!-- 为标签处理器类配一个标签名 -->
<tag-class>cn.lcp.web.tag.TagDemo2</tag-class>
<body-content>empty</body-content> <!-- 标签体没有有内容 -->
</tag>
<tag>
<name>tagDemo3</name> <!-- 为标签处理器类配一个标签名 -->
<tag-class>cn.lcp.web.tag.TagDemo3</tag-class>
<body-content>JSP</body-content>
</tag>
<tag>
<name>tagDemo4</name> <!-- 为标签处理器类配一个标签名 -->
<tag-class>cn.lcp.web.tag.TagDemo4</tag-class>
<body-content>JSP</body-content>
</tag>
</taglib>
TagDemo.java
public class TagDemo extends TagSupport {
private String name;
@Override
public int doStartTag() throws JspException {
return Tag.SKIP_BODY; //有访问权限，不能看到
}
}
TagDemo2.java
public class TagDemo2 extends TagSupport {
@Override
public int doEndTag() throws JspException {
//控制结束标签
return Tag.EVAL_PAGE; //EVAL_PAGE-余下的jsp就不会执行
}
}
TagDemo3.java
//控制标签体执行的次数
public class TagDemo3 extends TagSupport {
int x = 5;
@Override
public int doAfterBody() throws JspException {
x --;
if(x > 0){
return IterationTag.EVAL_BODY_AGAIN;
}else{
return IterationTag.SKIP_BODY;
}
}
@Override
public int doStartTag() throws JspException {
return Tag.EVAL_BODY_INCLUDE; //标签体执行。
}
}
TagDemo4.java
//修改标签体的内容
public class TagDemo4 extends BodyTagSupport {
@Override
public int doStartTag() throws JspException {
return BodyTag.EVAL_BODY_BUFFERED;
}
@Override
public int doEndTag() throws JspException {
//拿到标签体
String content = this.getBodyContent().getString();
String result = content.toUpperCase();
try {
this.pageContext.getOut().write(result);
} catch (IOException e) {
throw new RuntimeException(e);
}
return Tag.EVAL_PAGE;
}
}
郑重声明：本站内容如果来自互联网及其他传播媒体，其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享，并不代表本站赞同其观点和对其真实性负责，也不构成任何其他建议。
