jsp标签库

1）提供属性的set方法，此后这个属性就可以在jsp页面设置。以jstl标签为例 ＜c:out value=""/＞，这个value就是jsp数据到tag之间的入口。所以tag里面必须有一个setValue方法，具体的属性可以不叫value。例如

setValue(String data){this.data = data;}

这个“value”的名称是在tld里定义的。取什么名字都可以，只需tag里提供相应的set方法即可。

2）处理 doStartTag 或 doEndTag 。这两个方法是 TagSupport提供的。 还是以＜c:out value=""/＞为例，当jsp解析这个标签的时候，在“＜”处触发 doStartTag 事件，在“＞”时触发 doEndTag 事件。通常在 doStartTag 里进行逻辑操作，在 doEndTag 里控制输出。

3）编写tld文件。

4）在jsp页面导入tld




1.编写标签处理程序

OutputTag

java 代码

package diegoyun;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.TagSupport;
/**
* @author chenys
*/
public class OutputTag extends TagSupport
{
private String name=null;
public void setName(String name)
{
this.name = name;
}
public int doStartTag() throws JspException{
try
{
JspWriter out = pageContext.getOut();
out.print("Hello! " + name);
}
catch (Exception e)
{
throw new JspException(e);
}
//表示tag已处理完毕，返回jsp页面。还有几个值，例如 EVAL_BODY_AGAIN 和EVAL_BODY_INCLUDE等
return EVAL_PAGE;
}
}

2.编写tld文档
    short-name：taglib的名称，也称为前缀。比如＜c:out value=""/＞ 里的“c”

name：tag的名字。例如＜c:out value=""/＞ 里的"out”，我们的类也取名为out，由于有前缀作区分，不会混淆

tag-class：具体的tag类。带包名

body-content：指tag之间的内容。例如＜c:out value=""＞ ...... ＜/c＞ 起始和关闭标签之间就是body-content。由于没有处理body-content，所以上面设为empty

＜attribute＞里的name：属性名字。例如＜c:out value=""/＞里的value。名字可任意取，只要类里提供相应的set方法即可。

required：是否必填属性。

rtexprvalue：是否支持运行时表达式取值。这是tag的强大功能。
    
    RunTime EXPRession VALUE
    true代表，<xxx:yyyy zzz="&lt;%= something %&gt;">
    标签库zzz的属性是<%= %>表达式的结果而非"<%= something %>"这几个字母


</xxx:yyyy>

xml 代码

＜?xml version="1.0" encoding="ISO-8859-1" ?＞
＜!DOCTYPE taglib
PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
"http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd"＞
＜taglib＞
＜tlib-version＞1.0＜/tlib-version＞
＜jsp-version＞1.2＜/jsp-version＞
＜short-name＞c＜/short-name＞
＜!--OutputTag--＞
＜tag＞
＜name＞out＜/name＞
＜tag-class＞diegoyun.OutputTag＜/tag-class＞
＜body-content＞empty＜/body-content＞
＜attribute＞
＜name＞name＜/name＞
＜required＞false＜/required＞
＜rtexprvalue＞false＜/rtexprvalue＞
＜/attribute＞
＜/tag＞
＜/taglib＞

3.TagSupport和body区别
    TagSupport与BodyTagSupport的区别主要是标签处理类是否需要与标签体交互，如果不需要交互的就用TagSupport，否则如果不需要交互就用BodyTagSupport。

     交互就是标签处理类是否要读取标签体的内容和改变标签体返回的内容。

    用TagSupport实现的标签，都可以用BodyTagSupport来实现，因为BodyTagSupport继承了TagSupport。

如果tag处理类与body交互，那tag处理类应实现BodyTag接口或从BodyTagSupport中派生。这种tag处理类一般要实现doInitBody和doAfterBody方法。

Body允许一些方法来读写它的内容。Tag处理类可以调用body内容的getString或getReader方法来从body中提取信息，也可用  writeOut(out) 方法来将body的内容写入到out对象中。其中out对象通过tag处理类的getPreviousOut方法来获得。

如果body的内容需要被计算，那么doStartTag方法必须返回EVAL_BODY_BUFFERED，否则，它将返回 SKIP_BODY。

doInitBody 方法

此方法在body内容已经设好，但未被计算之前被调用。你可以根据不同的body内容来制定初始化策略。

doAfterBody方法

此方法在body内容已被计算后进行调用。

和doStartTag方法一样，doAfterBody方法返回一个指示符指示是否要继续计算body，如果要继续计算，则doAfterBody应返回EVAL_BODY_BUFFERED，否则，它应返回SKIP_BODY。

release 方法

tag处理类调用此方法将它的状态重置为初始状态，并释放所有的私有资源。


以下的例子读取body的内容（其中含有一条sql语句），然后将它传递给一个对象，让它进行查询。由于此处body不须重新计算，所以doAfterBody会返回SKIP_BODY。

  

java 代码

1. Public class QueryTag extends BodyTagSupport
   2.
   3. {
   4.
   5. public int doAfterBody() throws JspTagException
   6.
   7. {
   8.
   9. BodyContent bc = getBodyContent();
  10.
  11. //将body的内容以字符串的格式提取出来
  12.
  13. String query = bc.getString();
  14.
  15. //清除body
  16.
  17. bc.clearBody();
  18.
  19. try{
  20.
  21. Statement stmt = connection.createStatement();
  22.
  23. Result result = stmt.executeQuery(query);
  24.
  25. }catch(SQLException e){
  26.
  27. throw new JspTagException(“queryTag: “ + e.getMessage() );
  28.
  29. return SKIP_BODY;
  30.
  31. }
  32.
  33. }

4.doStartTag(),doEndTag()

   doStartTag()方法是遇到标签开始时会呼叫的方法，其合法的返回值是EVAL_BODY_INCLUDE与SKIP_BODY,前者表示将显示标签间的文字，后者表示不显示标签间的文字；doEndTag()方法是在遇到标签结束时呼叫的方法，其合法的返回值是EVAL_PAGE与  SKIP_PAGE，前者表示处理完标签后继续执行以下的JSP网页，后者是表示不处理接下来的JSP网页

    doAfterBody(),这个方法是在显示完标签间文字之后呼叫的，其返回值有EVAL_BODY_AGAIN与SKIP_BODY，前者会再显示一次标签间的文字，后者则继续执行标签处理的下一步。

   预定的处理顺序是：doStartTag()返回SKIP_BODY,doAfterBodyTag()返回SKIP_BODY,doEndTag()返回EVAL_PAGE.

  如果继承了TagSupport之后，如果没有改写任何的方法，标签处理的执行顺序是：

   doStartTag() ->不显示文字 ->doEndTag()->执行接下来的网页

  如果您改写了doStartTag(),则必须指定返回值，如果指定了EVAL_BODY_INCLUDE,则执行顺序是

   doStartTag()->显示文字->doAfterBodyTag()->doEndTag()->执行下面的网页


5.

EVAL_BODY_INCLUDE：把Body读入存在的输出流中，doStartTag()函数可用

EVAL_PAGE：继续处理页面，doEndTag()函数可用

SKIP_BODY：忽略对Body的处理，doStartTag()和doAfterBody()函数可用

SKIP_PAGE：忽略对余下页面的处理，doEndTag()函数可用

EVAL_BODY_TAG：已经废止，由EVAL_BODY_BUFFERED和EVAL_BODY_AGAIN取代 ,三者值是一样的，但后二者的名称意义更明确

EVAL_BODY_BUFFERED：申请缓冲区，由setBodyContent()函数得到的BodyContent对象来处理tag的body，如果类实现了BodyTag，那么doStartTag()可用，否则非法

EVAL_BODY_AGAIN：请求继续处理body，返回自doAfterBody()，这个返回值在你制作循环tag的时候是很有用的。