转: struts2 标签 2

一、概要：
1、JSP标签技术始于JSP1.1
2、作用：代码复用；JSP页面简洁
3、四个步骤：
    A、创建实现标签功能的JAVA类（Bean或Servlet）
    B、创建标签库的描述文件
    C、web.xml中添加标签库说明
    D、JSP页面中添加标签库说明，及使用标签
4、标签可以访问的数据范围类型：application;session;request;page.

 

jspTag 的API位于javax.servlet.jsp.tagext这个包中，下图是其中的主要的接口和类的框架图：

所有的标签类都要实现JSPTag接口，但该接口只是一个标识接口，其中不包含任何静态常量和方法声明。
接口Tag和SimpleTag都继承该接口。

打开 javax.servlet.jsp.JSPTag 接口的源码：

Java代码   

1. package javax.servlet.jsp.tagext;  
2.   
3. public interface JspTag {} //空接口  

打开javax.servlet.jsp.Tag接口，源码：

Java代码   

1. /* 
2. * 源码：javax.servlet.jsp.tag接口 
3. * 
4. * 
5. */   
6. package javax.servlet.jsp.tagext;  
7.   
8. import javax.servlet.jsp.*;  
9. public interface Tag extends JspTag   
10. {  
11.   
12.     //静态的状态常量，此接口定义了4个，用于指示标签体的流程  
13.       
14.     public final static int SKIP_BODY = 0;  //作为doStartTag()返回值，表示忽略标签体,不执行  
15.    
16.     public final static int EVAL_BODY_INCLUDE = 1;  //作为doStartTag()的返回值，表示正常的执行标签体中的内容  
17.   
18.     public final static int SKIP_PAGE = 5;  //作为doEndTag()的返回值，表示跳过页面中标签后剩下的jsp程序代码  
19.   
20.     public final static int EVAL_PAGE = 6;  //作为doEndTag()的返回值，表示继续执行页面中标签后的jsp程序代码  
21.       
22.       
23.     //接口定义的方法  
24.     void setPageContext(PageContext pc);  //jsp容器调用，向当前的标签出离对象传递当前的PageContext对象  
25.       
26.     void setParent(Tag t);  //向当前的对象传递父标签的标签对象      
27.   
28.     Tag getParent();  //当标签嵌套时，可以获取父标签      
29.       
30.     int doStartTag() throws JspException;    //当jsp容器遇到自定义标签的起始标志，执行该方法，通过返回值来确定执行流程  
31.   
32.     int doEndTag() throws JspException;    // 当jsp容器遇到自定义标签的结束标志，执行该方法，通过返回值来确定后续流程  
33.   
34.     void release();  
35. }  

 

标签对象由jsp容器来负责创建，当在执行jsp文件时，遇见自定义标签，在缓存中查找该tag 对象，如果没有则创建一个Tag对象放到缓存中，以便重用。
当容器得到Tag对象后，按照如下图中的流程来执行，该标签类对象的具体生命周期如下：

1.jsp容器调用对象的setPageContext()方法设置标签页面的上下文，setParent()来设置标签的父标签
2.jsp容器调用tag对象的其他的setXXX方法来设置tag对象的属性，setXXX()方法是标签支持属性所需的唯一的方法
3.JSP容器调用doStartTag()方法，如果返回SKIP_BODY,则忽略了该标签。如果返回EVAL_BODY_INCLUDE,则执行标签体的内容
4.JSP容器调用doEndTag()方法，如果返回SKIP_PAGE,则此标签后所有的jsp页面代码都不再执行，如果返回EVAL_PAGE,则继续执行标签后的代码

 

 

IterationTag接口

IterationTag接口继承Tag接口，其仅定义了一个doAfterBody方法，一个EVAL_BODY_AGAIN常量

IterationTag接口源码：

Java代码   

1. package javax.servlet.jsp.tagext;  
2.   
3. import javax.servlet.jsp.JspException;  
4.   
5. public abstract interface IterationTag extends Tag {  
6.       
7.     public static final int EVAL_BODY_AGAIN = 2;  
8.   
9.     public abstract int doAfterBody() throws JspException;  
10. }  

doAfterTag方法，在执行完标签体内的代码时发生，如果返回Iteration.EVAL_BODY_AGAIN，则将再次执行标签体内的代码

要注意的是，必须有条件让doAfterTag返回Tag.SKIP_BODY，不能就会陷入死循环。

如果返回Tag.SKIP_BODY，将不再执行标签体代码，接着执行doEndTag方法。

 

TagSupport类

TagSupport类实现了IterationTag接口中的pageContext和parent的get和set方法以及其他一些功能。

 

BodyTagSupport类

BodyTagSupport类替我们实现了BodyTag接口，并提供getBodyContent方法

 

 

 

DynamicAttributes接口

这个接口提供一个setDynamicAttribute方法，实现这个方法的标签类就可以使用动态属性，所谓动态属性就是属性名和对应的属性值都是不固定的。

Java代码   

1. package javax.servlet.jsp.tagext;  
2.   
3. import javax.servlet.jsp.JspException;  
4.   
5. public abstract interface DynamicAttributes {  
6.     public abstract void setDynamicAttribute(String paramString1, String paramString2, Object paramObject) throws JspException;  
7. }  

 

下面是个demo，继承TagSupport类，实现DynamicAttributes接口。

Java代码   

1. import java.io.IOException;  
2. import java.util.HashMap;  
3. import java.util.Map;  
4. import java.util.Map.Entry;  
5. import javax.servlet.jsp.JspException;  
6. import javax.servlet.jsp.tagext.DynamicAttributes;  
7. import javax.servlet.jsp.tagext.Tag;  
8. import javax.servlet.jsp.tagext.TagSupport;  
9.   
10. public class TagLibDemo extends TagSupport implements DynamicAttributes {  
11.   
12.     /** 
13.      *  
14.      */  
15.     private static final long serialVersionUID = -1570836057539895855L;  
16.     private final Map<String, String> map = new HashMap<String, String>();  
17.   
18.     @Override  
19.     public void setDynamicAttribute(String uri, String localName, Object value) throws JspException {  
20.         map.put(localName, value.toString());// 使用Map集合保持所有的动态属性对  
21.     }  
22.   
23.     @Override  
24.     public int doStartTag() throws JspException {  
25.         System.out.println("TagLibDemo.....doStartTag()");  
26.         return Tag.EVAL_BODY_INCLUDE;  
27.     }  
28.   
29.     @Override  
30.     public int doEndTag() throws JspException {  
31.         System.out.println("TagLibDemo.....doEndTag()");  
32.         StringBuffer buffer = new StringBuffer();  
33.         for (Entry<String, String> entry : map.entrySet()) {  
34.             buffer.append(entry.getKey());  
35.             buffer.append(':');  
36.             buffer.append(entry.getValue());  
37.             buffer.append("<br />");  
38.         }  
39.         try {  
40.             this.pageContext.getOut().print(buffer.toString());  
41.         } catch (IOException e) {  
42.             e.printStackTrace();  
43.         }  
44.         return Tag.EVAL_PAGE;  
45.     }  
46.   
47.     @Override  
48.     public int doAfterBody() throws JspException {  
49.         System.out.println("TagLibDemo.....doAfterBody()");  
50.         return Tag.SKIP_BODY;  
51.     }  
52.   
53.     @Override  
54.     public void release() {  
55.         System.out.println("TagLibDemo.............release");  
56.     }  
57. }  

在前台的JSP页面：

Xml代码   

1. <taglib:TaglibDemo 姓名="张饰轩" 性别="男" 年龄="101">  
2. </taglib:TaglibDemo>