你的位置:首页 > Java教程

[Java教程]自定义JSTL标签和函数库


一、自定义JSTL标签

1.编写标签处理类:

(1)实现 SimpleTag 接口,通过 setJspContext()方法可以获取到 jspContext 对象,实际上也是 pageContext 对象。

在 doTag() 方法中完成逻辑,通过 JspWriter out = jspContext.getOut(); 获取到的 out 对象,可以输出到页面。如:

/** * MyTag2 * * @author solverpeng * @create 2016-07-03-10:20 */public class MyTag2 implements SimpleTag {  private JspContext jspContext = null;  @Override  public void doTag() throws JspException, IOException {    SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd");    String dataStr = simpleDateFormat.format(new Date());    JspWriter out = jspContext.getOut();    out.write(dataStr);  }  @Override  public void setParent(JspTag jspTag) {  }  @Override  public JspTag getParent() {    return null;  }  @Override  public void setJspContext(JspContext jspContext) {    this.jspContext = jspContext;  }  @Override  public void setJspBody(JspFragment jspFragment) {  }}

MyTag2

(2)在 WEB-INF 下新建自定义 tld 文件,可以参考 JSTL 本身一些标签的的实现,如 c.tld。然后注册标签。如:

<??><taglib ="http://java.sun.com/    ="http://www.w3.org/2001/    xsi:schemaLocation="http://java.sun.com/    version="2.0">  <display-name>solverpeng core</display-name>  <tlib-version>1.1</tlib-version>  <short-name>solverpeng</short-name>  <uri>http://solverpeng.com/tags</uri>  <tag>    <name>showDate</name>    <tag-class>com.nucsoft.myservlet.tag.MyTag2</tag-class>    <body-content>empty</body-content>  </tag>  </taglib>

solverpeng core tag

(3)在页面中导入自定义的标签库,然后使用。如:

<%@ page contentType="text/html;charset=UTF-8" language="java" %><%@ taglib prefix="s" uri="http://solverpeng.com/tags" %><html><head>  <title>Title</title></head><body>  <s:showDate/></body></html>

tag.jsp

2.继承 SimpleTagSupport。其中在 SimpleTagSupport 类中已经完成了对 JspTag、JspContext,JspFragment 的注入操作,可以直接使用。

3.需要注意的地方

在自定义标签tld文件中,tag 节点里的 body-content 节点内容有四个可选值,分别介绍一下:

(1)tagdependent:将标签体的内容不经过任何修改和处理原封不动的交个标签处理类

(2)empty:没有任何标签体

(3)scriptless:表示标签体支持纯文本、EL表达式、JSTL等标签,不支持JSP脚本片段和JSP表达式

(4)JSP:在 SimpleTag 标签体系下不可用

 

可以通过 jspContext 获取到其他8大 JSP 隐含对象。

 

如果为带属性的自定义标签,在目标处理类中通过提供 setXxx() 方法来获取,在 tld 文件中,需要在 tag 元素中添加子节点 attribute 。

其中对 attribute 节点下的三个子节点进行说明:

(1)name:属性名称,和目标处理类中通过 setXxx() 方法定义的属性名一致

(2)required:是否是必须输入的

(3)rtexprvalue:是否支持 EL 表达式

 

如果需要对标签体处理,需要在目标处理类中进行一系列的处理:

(1)在 doTag() 方法中通过 this.getJspBody() 可以获取到 JspFragment 对象

(2)执行 JspFragment 对象的 invoke() 方法,若不需要对执行后的标签体进行处理,而是直接输出的话,invoke() 方法的参数传入 null就 ok。

若是需要对执行后的标签体进行处理,则需要传入一个 Write 对象,在调用 invoke() 方法之后,然后对 Write 对象进行处理。如:

JspFragment jspBody = this.getJspBody();StringWriter out = new StringWriter();jspBody.invoke(out);String content = out.toString();String result = content.toUpperCase();JspWriter writer = this.getJspContext().getOut();writer.print(result);

View Code

 

二、自定义JSTL函数库

1.定义函数处理类,要求类和方法必须为 public ,且方法必须为 static 。如:

/** * @author solverpeng * @create 2016-07-03-10:34 */public class MyFunction {  public static String hello() {    return new Date().toString();  }}

MyFunction

2.在 WEB-INF 下新建自定义 tld 文件,可以参考 JSTL 本身一些标签的的实现,如 c.tld。然后注册函数。如:

<??><taglib ="http://java.sun.com/    ="http://www.w3.org/2001/    xsi:schemaLocation="http://java.sun.com/    version="2.0">  <display-name>solverpeng core</display-name>  <tlib-version>1.1</tlib-version>  <short-name>solverpeng</short-name>  <uri>http://solverpeng.com/tags</uri>  <function>    <name>hello</name>    <function-class>com.nucsoft.myservlet.function.MyFunction</function-class>    <function-signature>java.lang.String hello()</function-signature>  </function></taglib>

solverpeng tag tld

3.在JSP页面中导入自定义的函数库,然后在页面中使用,如:

<%@ page contentType="text/html;charset=UTF-8" language="java" %><%@ taglib prefix="s" uri="http://solverpeng.com/tags" %><html><head>  <title>Title</title></head><body>  ${s:hello()}</body></html>

tag.jsp

 

三、JSTL中一个不常用的标签 c:forTokens

<% pageContext.setAttribute("str", "aa,bb,ee,mm,tt"); %><c:forTokens items="${str }" delims="," var="item">${item }</c:forTokens>

c:forTokens