自定义标签主要用于jsp中的java代码
使用自定义标签移除jsp页面中的java代码,只需要完成以下两个步骤:
1.编写一个实现Tag接口的Java类(标签处理器类)。
2.编写标签库描述符(tld)文件,在tld文件中对标签处理器类描述成一个标签。
例子:使用标签输出客户机IP。
1.编写一个实现tag接口的java类
public class ViewIPTag extends TagSupport { @Override public int doStartTag() throws JspException { HttpServletRequest request = (HttpServletRequest) this.pageContext.getRequest(); JspWriter out = this.pageContext.getOut(); String ip = request.getRemoteAddr(); try { out.print(ip); } catch (IOException e) { throw new RuntimeException(e); } return super.doStartTag(); } }
写在doStartTag()或者doEndTag()都可以。
2.在tld文件中对标签处理器类进行描述
注意:tld一定要放在WEB-INF下面,可以建个文件夹存放所以的tld文件
在WEB-INF目录下新建一个xx.tld (参考tomcat目录--webapps--examples--WEB-INF--JSP2---)
<?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>itcast</short-name> <uri>http://www.itcast.cn</uri> <tag> <name>viewIP</name> <tag-class>cn.itcast.web.tag.ViewIPTag</tag-class> <body-content>empty</body-content> </tag> </taglib>
一定要把标签绑定到一个uri上去,在jsp中就可以使用该标签。
3.在jsp页面中导入和使用自定义标签
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> <%@taglib uri="http://www.itcast.cn" prefix="itcast" %>//导入标签,可以取个前缀名字 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>My JSP '1.jsp' starting page</title> </head> <body> 您的ip是:<itcast:viewIP/> </body> </html>
Tag接口的执行流程
JSP引擎将遇到自定义标签时,首先创建标签处理器类的实例对象,然后按照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方法。
自定义标签功能扩展:重点内容
自定义标签除了可以移除jsp页面java代码外,还有其他功能:
1. 控制jsp页面某一部分内容是否执行。//常用来做权限控制
2. 控制整个jsp页面是否执行。//权限控制,在整个页面的上面加个自定义标签
3. 控制jsp页面内容重复执行。
4. 修改jsp页面内容输出。//如字母改成大写输出等
1. 控制jsp页面某一部分内容是否执行
public class TagDemo1 extends TagSupport { @Override public int doStartTag() throws JspException { return Tag.SKIP_BODY;//参考doStartTag方法的返回值 } }
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> <%@taglib uri="http://www.itcast.cn" prefix="itcast" %>//uri的值也可以用tld的路径表示,/WEB-INF/XX.tdl <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>使用标签控制页面内容(标签体)是否输出</title> </head> <body> <itcast:demo1> aaaaa </itcast:demo1> </body> </html>
//控制标签体执行5次 public class TagDemo3 extends TagSupport { int x = 5; @Override public int doStartTag() throws JspException { // TODO Auto-generated method stub return Tag.EVAL_BODY_INCLUDE; } @Override public int doAfterBody() throws JspException { x--; if(x>0){ return IterationTag.EVAL_BODY_AGAIN; }else{ return IterationTag.SKIP_BODY; } } }
//修改标签体(把标签体改为大写) public class TagDemo4 extends BodyTagSupport { @Override public int doStartTag() throws JspException { // TODO Auto-generated method stub return BodyTag.EVAL_BODY_BUFFERED; } @Override public int doEndTag() throws JspException { BodyContent bc = this.getBodyContent(); //得到标签体 String content = bc.getString(); content = content.toUpperCase(); try { this.pageContext.getOut().write(content); } catch (IOException e) { throw new RuntimeException(e); } return Tag.EVAL_PAGE; } }
以上是传统标签库开发技术,是JSP2.0以前的技术,做不同的事情需要实现不同的接口(Tag接口,BodyTag接口,IterationTag接口),太麻烦。
SUN公司新增了简单标签开发技术(SimpleTag接口),推荐用简单标签开发技术