Jsp自定义标签和方法详解
Jsp自定义标签和方法详解
首先是要有一个标签处理类，标签处理类可以直接实现Tag接口，也可以继承Java中已经实现了的TagSupport这个类，TagSupport也是继承自Tag接口的，它内部已经对Tag接口进行了实现，一般是继承TagSupport类，之后是重写父类的doStartTag和doEndTag方法，
对于开始标签来说返回值主要有EVAL_BODY_INCLUDE和SKIP_BODY，前者表示执行标签体，后者表示略过标签体；
对于结束标签的返回值主要有两种EVAL_PAGE和SKIP_PAGE，前者表示继续执行结束标签以后的内容，后者表示忽略结束标签以后的内容；另外，在继承自TagSupport类的标签处理类里面还有两个隐含的属性，一个是parent,表示该标签上层标签的处理类，另外一个是pageContext，pageContext是为了方便我们使用的WEB元素而引入的一个属性，像HttpSession之类的；实现了Tag接口的类也可以使用这两个隐含属性，只需要实现其中的setParent()方法和setPageContext()方法就可以了。
下面是一个标签处理类的代码式样：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 | public class MyTag extends TagSupport { private String prop1; private String prop2; /** * */ private static final long serialVersionUID = -8771409930058657336L; @Override //对于结束标签的返回值主要有两种EVAL_PAGE和SKIP_PAGE，前者表示继续执行结束标签以后的内容，后者表示忽略结束标签以后的内容； public int doEndTag() throws JspException { // TODO Auto-generated method stub //这里面可以处理自己的逻辑，然后选择返回值，如果不处理，调用super.doEndTag()则会返回EVAL_PAGE // return EVAL_PAGE; // return SKIP_PAGE; return super.doEndTag(); } @Override /** * 对于开始标签来说返回值主要有EVAL_BODY_INCLUDE和SKIP_BODY，前者表示执行标签体，后者表示略过标签体 */ public int doStartTag() { // TODO Auto-generated method stub //同样这里面也是执行自己的逻辑，然后来决定是要显示标签体 //可以使用两个内部属性，parent和pageContext if (yourCondition) return EVAL_BODY_INCLUDE; else return SKIP_BODY; } //省略get和set方法 } |
接下来是要在WEB-INF下面新建.tld文件，名称随便取，这个tld文件是对标签库的描述,包括该标签库里面包括哪些标签和和方法，以及对标签属性等的描述，有了这个文件以后，在WEB服务器启动的时候，系统就会将该文件加载，然后当在页面上使用该标签库的时候系统就会到已经在WEB-INF目录下加载的tld文件里面去找相应的标签库，如果没有则会出错！
下面是tld文件的一个样式：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 | <?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"> <tlib-version>1.0</tlib-version><!-- 版本号 --> <short-name>my</short-name><!-- 名称随便取 --> <uri>http://www.test.com/core</uri><!-- 这个uri即在页面上进行引入的时候的uri --> <function><!-- 这是对方法的定义，对方法的定义比较简单，只要该方法是公共的并且是静态的就可以了，该类也不需要继承什么类和接口 --> <name>funcTest</name><!-- 方法名 --> <function-class>com.test.util.Util</function-class><!-- 方法所在的类 --> <!-- 方法的一些信息，boolean表示返回类型, funcName表示方法名,后面是参数类型,对于其他非基本类型的数据一定要用全称，如java.lang.String--> <function-signature>boolean funcName(int,int,int)</function-signature> </function> <tag> <name>tagName</name><!-- 标签名称，在使用的时候以前缀加这个名称使用的 --> <tag-class>com.test.web.tag.MyTag</tag-class><!-- 标签类 --> <attribute> <name>prop1</name><!-- 标签类里面的属性名称 --> <required>true</required><!-- 是否必须有 --> </attribute> <attribute> <name>prop2</name> <required>true</required> </attribute> </tag> </taglib> |
之后就可以在页面上直接引入该标签库使用自定义的标签了：
如：
1 2 | <%@taglib prefix="my" uri="http://www.test.com/core" %> //使用<my:myTag prop1="" prop2="">content</my:myTag> |
对于自定的方法的使用则是要利用jstl来使用：
在导入了jstl的标签以后，可以这样使用：
${my:funcName(arg0,arg1,arg2)}，这个参数的类型是需要匹配的，
上一篇：JSP 导出Excel表格的实例
