JSP简单标签

第9章    简单标签
9.1    简单标签知识
在Jsp2.0中定义SimpleTag 接口用于替换传统的标签开发的接口，它只有一个方法doTag() 用于取代传统的doStartTag()、doEndTag()、doAfterBody() 等方法。
1、    JSP引擎调用标签处理器对象的setJspContext()，将JSP页面的pageContext()对象传递给标签处理器对象。
2、    JSP引擎调用setParent()，将父标签处理器对象传递给标签处理器对象。
3、    如果调用标签设置属性，容器将每个属性对应的setter()方法把属性值传递给标签处理器对象。
4、    如果有标签体，容器将标签体封装为JspFragment对象，然后调用setJspBody()将JspFragment对象传递给标签处理器对象。
5、    调用doTag()方法执行标签逻辑。
9.1.1    SimpleTag接口
SimpleTag接口定义方法：
1、    setJspContext()

   public void setJspContext(JspContext context);

 

    JSP页面的pageContext对象传递给标签处理器对象。
2、    setParent()

public void setParent(JspTag parent);

 

    把父标签处理器对象传递给当前标签处理器对象。
3、    getParent()

public JspTag getParent();

 

    获取当前父标签处理器对象。
4、    setJspBody()

public void setJspBody(JspFragment jspBody);

 

    把代表标签体的JspFragment对象传递给标签处理器对象。
5、    doTag()

public void doTag();

 

    用于完成标签处理逻辑。

9.1.2    JspFragment类
JSP引擎处理标签体内容时会把标签体内容用一个JspFragement对象表示，并调用标签体处理器对象的setJspBody()把JspFragement对象传递给标签处理器对象，标签开发者根据需要调用JspFragement对象的方法，决定是否执行和输出标签体。
1、    getJspContext()

public abstract JspContext getJspContext();

 

用于返回调用页面的JspContext对象。
2、    invoke()

public abstract void invoke(Writer out);

 

用于执行JspFragment对象代表的JSP代码片段。
9.1.3    SimpleTagSupport类
SimpleTagSupport类是SimpleTag接口的实现。

9.2    简单标签实例

public class SimpleTagDemo extends SimpleTagSupport {
    private String username;

    public void setUsername(String username) {
        this.username = username;
    }
    @Override
    public void doTag() throws JspException, IOException {
        if ("wangtong".equals(username)) {
            JspFragment fragment = this.getJspBody();
            fragment.invoke(null);
        } else {
            getJspContext().getOut().write("用户名不正确");
            throw new SkipPageException();
        }
    }}

 

 

<tag>
        <name>simpleTag</name>
        <tag-class>tag.simpletag.SimpleTagDemo</tag-class>
        <body-content>scriptless</body-content>
        <attribute>
            <name>username</name>
            <required>true</required>
            <rtexprvalue>true</rtexprvalue>
        </attribute>
    </tag>

 

 

<wangtong:simpleTag username="wangtong">
    username
</wangtong:simpleTag>

 

9.3    迭代数组

public class SimpleIterateTag extends SimpleTagSupport {
    private String name;
    private String items[];

    public void setName(String name) {
        this.name = name;
    }

    public void setItems(String[] items) {
        this.items = items;
    }

    @Override
    public void doTag() throws JspException, IOException {
        for (String i : items) {
            getJspContext().setAttribute(name, i);
            getJspBody().invoke(null);
        }}}

 

 

<tag>
        <name>simpleIterateTag</name>
        <tag-class>tag.simpletag.SimpleIterateTag</tag-class>
        <body-content>scriptless</body-content>
        <attribute>
            <name>name</name>
            <required>true</required>
        </attribute>
        <attribute>
            <name>items</name>
            <required>true</required>
            <rtexprvalue>true</rtexprvalue>
        </attribute>
    </tag>

 

 

<%
    String[] books = { "book1", "book2", "book3" };
%>
<wangtong:simpleIterateTag items="<%=books%>" name="bookname">
    ${bookname}
</wangtong:simpleIterateTag>

 

9.4    修改标签体内容

public class ReadFileTag extends SimpleTagSupport {
    private String src;

    public void setSrc(String src) {
        this.src = src;
    }

    @Override
    public void doTag() throws JspException, IOException {
        InputStream in;
        BufferedReader br;
        try {
            in = ((PageContext) getJspContext()).getServletContext()
                    .getResourceAsStream(src);
            br = new BufferedReader(new InputStreamReader(in));
            String line = br.readLine();
            while (line != null) {
                this.getJspContext().getOut().write("line" + "\r\n");
                line = br.readLine();
            }
            br.close();
        } catch (Exception e) {
            e.getMessage();
        }}}

public class HtmlFilterTag extends SimpleTagSupport {

    @Override
    public void doTag() throws JspException, IOException {
        JspFragment fragment = this.getJspBody();
        StringWriter writer = new StringWriter();
        fragment.invoke(writer);
        String newBody = filter(writer.toString());
        this.getJspContext().getOut().write(newBody);
    }

    private String filter(String message) {
        if (message == null) {
            return null;
        }
        char content[] = new char[message.length()];
        message.getChars(0, message.length(), content, 0);
        StringBuffer result = new StringBuffer(content.length + 50);
        for (int i = 0; i < content.length; i++) {
            switch (content[i]) {
            case '<':
                result.append("&lt;");
                break;
            case '>':
                result.append("&gt;");
                break;
            case '&':
                result.append("&amp;");
                break;
            case '"':
                result.append("&quot;");
                break;
            default:
                result.append(content[i]);
            }
        }
        return result.toString();
    }}

 

 

<tag>
        <name>simpleHtmlFilter</name>
        <tag-class>tag.simpletag.ReadFileTag</tag-class>
        <body-content>scriptless</body-content>
    </tag>
    <tag>
        <name>simpleReadFile</name>
        <tag-class>tag.simpletag.HtmlFilterTag</tag-class>
        <body-content>empty</body-content>
        <attribute>
            <name>src</name>
            <required>true</required>
        </attribute>
    </tag>

 

<wangtong:simpleHtmlFilter>
    <wangtong:readfile src="/tag.jsp" />
</wangtong:simpleHtmlFilter>