首页 > 代码库 > 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:标签(二)