首页 > 代码库 > JavaWeb:标签(二)
JavaWeb:标签(二)
接上一节
setJspContext:
一定会被 JSP 引擎所调用,先于 doTag, 把代表JSP 引擎的 pageContext 传给标签处理器类。
带属性的自定义标签:
1)、先在标签处理器类中定义 setter 方法,建议把所有的属性类型都设置为 String 类型。
例如:
private String value; private String count; public void setValue(String value) { this.value =http://www.mamicode.com/ value; } public void setCount(String count) { this.count = count; }
2)、在 .tld 描述文件中来描述属性:
例如:
<!-- 描述当前标签的属性 --> <attribute> <!-- 属性名, 需和标签处理器类的 setter 方法定义的属性相同 --> <name>value</name> <!-- 该属性是否被必须 --> <required>true</required> <!-- rtexprvalue: runtime expression value 当前属性是否可以接受运行时表达式的动态值 --> <rtexprvalue>true</rtexprvalue> </attribute>
3)、在页面中使用属性,属性名同 .tld 文件中定义的名字。
例如: <hnust:hello value="${param.name }" count="10"/>
4)、通常情况下,开发简单标签直接继承 SimpleTagSupport 就可以了,可以直接调用其对应的 getter 方法得到对应的 API 。
1 public class SimpleTagSupport implements SimpleTag{ 2 3 public void doTag() 4 throws JspException, IOException{} 5 6 private JspTag parentTag; 7 8 public void setParent( JspTag parent ) { 9 this.parentTag = parent; 10 } 11 12 public JspTag getParent() { 13 return this.parentTag; 14 } 15 16 private JspContext jspContext; 17 18 public void setJspContext( JspContext pc ) { 19 this.jspContext = pc; 20 } 21 22 protected JspContext getJspContext() { 23 return this.jspContext; 24 } 25 26 private JspFragment jspBody; 27 28 public void setJspBody( JspFragment jspBody ) { 29 this.jspBody = jspBody; 30 } 31 32 protected JspFragment getJspBody() { 33 return this.jspBody; 34 } 35 }
带标签体的自定义标签:
1)、若一个标签有标签体: <hnust:testJspFragment>abcdefg</hnust:testJspFragment>
在自定义标签的标签处理器中使用 JspFragment 对象封装标签体信息。
2)、若配置了标签含有标签体,则 JSP 引擎会调用 setJspBody() 方法把 JspFragment 传递给标签处理器类。
在SimpleTagSupport 中还定义了一个 getJspBody() 方法,用于返回 JspFragment 对象。
3)、JspFragment 的 invoke(Wirter) 方法:把标签体内容从 Writer 中输出,若为 null,则等同于 invoke(getJspContext.getOut()),即直接把标签体内容输出到页面上。
有时,可以借助 StringWriter,可以在标签处理器类中先得到标签体的内容:
①、利用 StringWriter 得到标签体的内容。
StringWriter sw = new StringWriter(); bodyContent.invoke(sw);
②、把标签体的内容都变为大写
String content = sw.toString().toUpperCase();
4)、在 .tld 文件中,使用 body-content 节点来描述标签体的类型:
<body-content>: 指定标签体的类型, 大部分情况下, 取值为 scriptless 。可能取值有 3 种:empty: 没有标签体;scriptless: 标签体可以包含 el 表达式和 JSP 动作元素,但不能包含 JSP 的脚本元素;tagdependent: 表示标签体交由标签本身去解析处理。若指定 tagdependent,在标签体中的所有代码都会原封不动的交给标签处理器,而不是将执行结果传递给标签处理器。
例如:<body-content>tagdependent</body-content>
5)、定义一个自定义标签: <hnust:printUpper time="10">abcdefg</hnust> 把标签体的内容转为大写,并输出 time 次到浏览器上。
1 public class TestJspFragment extends SimpleTagSupport { 2 3 @Override 4 public void doTag() throws JspException, IOException { 5 JspFragment bodyContent = getJspBody(); 6 //JspFragment.invoke(Witer): Writer 即为标签体内容输出的字符流, 若为 null, 则 7 //输出到 getJspContext().getOut(), 即输出到页面上. 8 9 //1. 利用 StringWriter 得到标签体的内容. 10 StringWriter sw = new StringWriter(); 11 bodyContent.invoke(sw); 12 13 //2. 把标签体的内容都变为大写 14 String content = sw.toString().toUpperCase(); 15 16 //3. 获取 JSP 页面的 out 隐含对象, 输出到页面上 17 getJspContext().getOut().print(content); 18 } 19 20 }
有父标签的标签:
1)、父标签无法获得子标签的引用,父标签仅把子标签作为标签体来使用。
2)、子标签可以通过 getParent() 方法来获取父标签的引用(需继承 SimpleTagSupport 或自实现 SimpleTag 接口的该方法):若子标签的确有个父标签,JSP 引擎会把代表父标签的引用通过 setParent(JspTag parent) 赋给标签处理器。
3)、注意:父标签的类型是 JspTag 类型的,该接口是一个空接口,但是来统一 SimpleTag 和 Tag 的。实际使用需要进行类型的强制转换。
4)、在 .tld 配置文件中,无需为父标签有额外的配置,但,子标签是以标签体的形式存在的,所以父标签的 <body-content></body-content> 需设置为 scriptless。
JavaWeb:标签(二)