学习TagLib

一、概要：

1、JSP标签技术始于JSP1.1

2、作用：代码复用；JSP页面简洁

3、四个步骤：
     A、创建实现标签功能的JAVA类（Bean或Servlet）
     B、创建标签库的描述文件
     C、web.xml中添加标签库说明
     D、JSP页面中添加标签库说明，及使用标签

4、标签可以访问的数据范围类型：application;session;request;page.
     ------------------------[主要是为了说明什么时候用JavaBean或TagLib]

二、TagLib常用知识点

1、JSP Tag API----标签处理类必须是此API[只两种，且任一种即可]的子类
    -----javax.servlet.jsp.TagSupport
    -----javax.servlet.jsp.BodyTagSupport

2、TagSupport的主要方法[8种]及重要属性[2个]
     1)主要方法：
        与Servlet容器处理TAG开关相关的方法：
        A、doStartTag()---Servlet容器遇到自定义标签的起始标志时调用该方法
        B、doEndTag()----Servlet容器遇到自定义标签的结束结志时调用该方法
        
        与标签处理类中值相关的方法：
        C、setValue(String k,Object o)---在标签处理类中设置key/value
        D、getValue(String k)--------------在标签处理类中根据参数key返回相应的value
        E、removeValue(String k)---------删除标签处理类中的相应的key/value
        
        与Servlet容器相关，设置页面上下文相关的方法：
        F、setPageContext(PageContext pc)--设置PageContext对象，该方法由Servlet容器
　　　　　　　　　　　　　　　　　　　　　　　在调用doStartTag或doEndTag方法前调用
       
        与标签嵌套相关的方法：
        G、setParent(Tag t)----------------设置嵌套了当前标签的上层标签的处理类，该方法由
                                                        Servlet容器在调用doStartTag或doEndTag方法前调用
        H、getParent()---------------------- 返回嵌套了当前标签的上层标签的处理类

   2)重要属性：
        A、parent---代表了嵌套了当前标签的上层标签的处理类
        B、pageContext----代表了Web应用中的javax.servlet.jsp.PageContext对象
        两点说明：
        C、Servlet容器在调用doStartTag（）或doEndTag（）方法前，会先调用
             setPageContext()和setParent()方法，调置pageContext和parent.
        D、在doStartTag()或doEndTag()方法中可以通过getParent()方法获取上层标签的处理类；
             在TagSupport类中定义了protected类型的pageContext成员变量，因此在标签处理类
             中可以直接访问pageContext变量。

3、pageContext类的几点说明：
     A、pageContext类提供了保存及访问WEB应用共享数据的方法：
          ---public void setAttribute(String name,Object value,int scope)
          ---public Object getAttribute(String name,int scope)
     B、scope---用来指定数据的作用范围。可选值如下：
          PageContext.PAGE_SCOPE
          PageContext.REQUEST_SCOPE
          PageContext. SESSION_SCOPE
          PageContext.APPLICATION_SCOPE
    如：setAttribute("userName","dxm",PageContext.SESSION_SCOPE);

二、TagLib常用知识点  

4、javax.servlet.jsp.TagSupport的两个基础方法的重申：
       ---public int doStartTag() throws JspException
       ---public int doEndTag() throws JspException
    1)doStartTag()方法：
     A、当servlet容器遇到自定义标签的起始标志，就会调用doStartTag()方法。
     B、doStartTag()方法会返回一个整数值，用来决定程序的后续流程。它有两个可选值：
          ----Tag.SKIP_BODY
                表示忽略掉标签之间的内容
          ----Tag.EVAL_BODY_INCLUDE
                表示标签之间的肉容要正常执行
         如：
                  ... ...
                 Dxm,Hello!
                  ... ...
　　　　　
        若 的doStartTag()方法返回Tag.SKIP_BODY,“Dxm,Hello!”字样即不会出现在页
        面；若返回Tag.EVAL_BODY_INCLUDE，则页面上显示出"Dxm,Hello!"字样。

   2)doEndTag()方法：
   A、当servlet容器遇到自定义标签的结束标志，就会自动调用doEndTag()方法
   B、doEndTag()方法也会返回一个整数值，用来决定程序的后续流程。它也有两个可选值：
        ---Tag.SKIP_PAGE
            表示立刻停止执行JSP网页，网页上未处理的静态内容和JSP程序均被忽略，任何已有的输出
            内容立刻返回到客户的浏览器上。
        ---Tag.EVAL_PAGE
            表示按正常的流程继续执行JSP网页。

5、用户自定义标签属性:
A、标签中可以包含自定义的属性，如：

... ...

B、但标签处理类中应将这个属性做为成员变量来使用，并给出赋值及取值的方法。如:
      private String username;
      public setUsername(String value){
           this.username=value;
     }
     public  String getUsername(){
           return username;
     }

 

三、一个简单的范例
1、创建hello标签:定义一个名为mytaglib的标签库，它包含一个简单的hello标签，这个标签能够将
     JSP页面中所有的 解析为字符串"hello".
     A、hello标签的处理类：
          public int doEndTag() throws JspException{
                 try{
                          pageContext.getOut().print("hello");
                      }catch(Exception e){
                          throw new JspTagException(e.getMessage());
                      }
                      return EVAL_PAGE;
          }
     B、创建标签库描述文件：.tld文件存放位置；标签库名，标签名，属性，对应的处理类。
         
     C、web.xml中引入标签库：
         
               ... ...
               
                          /mytaglib
                          /WEB-INF/tld/mytaglib.tld
               
               ... ...
         
     D、JSP页面中引入标签库说明，并使用标签：
           
          taglib指令中，prefix属性值用作指代mytaglib标签库。

四、另一个标签
1、创建一个能替换helloapp应用中JSP网页的静态文本的标签，这个标签名为message，它放在mytaglib标签库中。
2、在hellowithtag2.jsp文件中使用message标签的代码如下：
    
   当客户访问hello.jsp网页时，message标签的处理类会根据属性key的值从一个文本文件中找到与key匹配的字符串。假定这个字符串为“Hello”，然后将这个字符串输出到网页上。
3、创建包含JSP网页静太文本的文件
   messageresource.properties:
   hello.title=Title of hello.jsp
   hello.hello=hello
4、由DispatcherServlet类的init方法负责从静态文本中读取静态文本，然后把它们装载到Properties对象中，最后再把这个Properties对象作为属性保存到ServletContext中。
5、DispatcherServlet类的init方法：
    public void init(ServletConfig config) throws ServletException{
          super.init(config);
          Properties ps=news Properties();
          SevletContext context=config.getServletContext();
          InputStream in=context.getResourceAsStream("/WEB-INF/messageresource");
          ps.load(in);
          in.close();

         context.setAttribute("ps",ps);
    }

6、为保证在WEB应用启动时就加载DispathcherServlet,应该在web.xml中配置这个Servlet时的设置load-on-startup属性:
   
  
     dispacher
     mypack.DspacherServlet
     1
  
  

n        dispatcher

n        mypack.DispatcherServlet

n        1

     7、创建MessageTag标签处理类
      MessageTag包含一个成员变量key ，它与message标签的属性key 对应，在MessageTag
      中定义了getKey和setKey 方法。
     private String key=null;
     public String getKey(){

           return this.key;

  }

    public void setKey(String key)

          this.key=key;

}

 在MessageTag的doEndTag方法中，首先从pageContext中读取包含静态文本的Properties对象：
 Properties ps=(Properties)pageContext.getAttribute("ps",pageContext.APPLACTION_SCOPE);

然后从Properties对象中读取key对应的静态文本，最后输出该文本：
String message=null;
message=(String)ps.get(key);
pageContext.getOut.print(message);

8、mytaglib库中定义message标签：

    message
    mypack.MessageTag
    empty
    produce message by key
   
     key
     true
    
后记：
        1/ 问题：在标签处理类中，如何访问session范围内的共享数据? 
           选项：
       (B)在标签处理类TagSupport类中定义了pageContext成员变量，先通过它的
            getSession()方法获得当前的HttpSession对象，再调用HttpSession对
            象的getAttribute()方法。

       备注： 所有内容源于如下网址，在此表示感谢。

http://www.javathinker.org/train/alesson/javaweb/07_taglib.files/frame.htm