首页 | 编程 | Jsp

Jsp自定义标签和方法详解

2016年11月30日 作者：lqh 原文

Jsp自定义标签和方法详解

首先是要有一个标签处理类，标签处理类可以直接实现Tag接口，也可以继承Java中已经实现了的TagSupport这个类，TagSupport也是继承自Tag接口的，它内部已经对Tag接口进行了实现，一般是继承TagSupport类，之后是重写父类的doStartTag和doEndTag方法，

对于开始标签来说返回值主要有EVAL_BODY_INCLUDE和SKIP_BODY，前者表示执行标签体，后者表示略过标签体；
对于结束标签的返回值主要有两种EVAL_PAGE和SKIP_PAGE，前者表示继续执行结束标签以后的内容，后者表示忽略结束标签以后的内容；另外，在继承自TagSupport类的标签处理类里面还有两个隐含的属性，一个是parent,表示该标签上层标签的处理类，另外一个是pageContext，pageContext是为了方便我们使用的WEB元素而引入的一个属性，像HttpSession之类的；实现了Tag接口的类也可以使用这两个隐含属性，只需要实现其中的setParent()方法和setPageContext()方法就可以了。

下面是一个标签处理类的代码式样：

public class MyTag extends TagSupport { 
 
private String prop1; 
private String prop2; 
 
  /** 
   * 
   */ 
  private static final long serialVersionUID = -8771409930058657336L; 
   
  @Override 
  //对于结束标签的返回值主要有两种EVAL_PAGE和SKIP_PAGE，前者表示继续执行结束标签以后的内容，后者表示忽略结束标签以后的内容； 
  public int doEndTag() throws JspException { 
    // TODO Auto-generated method stub 
//这里面可以处理自己的逻辑，然后选择返回值，如果不处理，调用super.doEndTag()则会返回EVAL_PAGE 
//   return EVAL_PAGE; 
//   return SKIP_PAGE; 
    return super.doEndTag(); 
  } 
 
  @Override 
  /** 
   * 对于开始标签来说返回值主要有EVAL_BODY_INCLUDE和SKIP_BODY，前者表示执行标签体，后者表示略过标签体 
   */ 
  public int doStartTag() { 
    // TODO Auto-generated method stub 
//同样这里面也是执行自己的逻辑，然后来决定是要显示标签体 
//可以使用两个内部属性，parent和pageContext 
    if (yourCondition) 
      return EVAL_BODY_INCLUDE; 
    else 
      return SKIP_BODY; 
  } 
//省略get和set方法 
}

接下来是要在WEB-INF下面新建.tld文件，名称随便取，这个tld文件是对标签库的描述,包括该标签库里面包括哪些标签和和方法，以及对标签属性等的描述，有了这个文件以后，在WEB服务器启动的时候，系统就会将该文件加载，然后当在页面上使用该标签库的时候系统就会到已经在WEB-INF目录下加载的tld文件里面去找相应的标签库，如果没有则会出错！

下面是tld文件的一个样式：

<?xml version="1.0" encoding="UTF-8" ?> 
 
<taglib xmlns="http://java.sun.com/xml/ns/j2ee" 
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
 xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd" 
 version="2.0"> 
   
 <tlib-version>1.0</tlib-version><!-- 版本号 --> 
 <short-name>my</short-name><!-- 名称随便取 --> 
 <uri>http://www.test.com/core</uri><!-- 这个uri即在页面上进行引入的时候的uri --> 
  
 <function><!-- 这是对方法的定义，对方法的定义比较简单，只要该方法是公共的并且是静态的就可以了，该类也不需要继承什么类和接口 --> 
  <name>funcTest</name><!-- 方法名 --> 
  <function-class>com.test.util.Util</function-class><!-- 方法所在的类 --> 
  <!-- 方法的一些信息，boolean表示返回类型, funcName表示方法名,后面是参数类型,对于其他非基本类型的数据一定要用全称，如java.lang.String--> 
  <function-signature>boolean funcName(int,int,int)</function-signature> 
 </function> 
  
 <tag> 
  <name>tagName</name><!-- 标签名称，在使用的时候以前缀加这个名称使用的 --> 
  <tag-class>com.test.web.tag.MyTag</tag-class><!-- 标签类 --> 
  <attribute> 
    <name>prop1</name><!-- 标签类里面的属性名称 --> 
    <required>true</required><!-- 是否必须有 --> 
  </attribute> 
  <attribute> 
    <name>prop2</name> 
    <required>true</required> 
  </attribute> 
 </tag> 
</taglib>

之后就可以在页面上直接引入该标签库使用自定义的标签了：

如：

<%@taglib prefix="my" uri="http://www.test.com/core" %> 
//使用<my:myTag prop1="" prop2="">content</my:myTag>

对于自定的方法的使用则是要利用jstl来使用：

在导入了jstl的标签以后，可以这样使用：

${my:funcName(arg0,arg1,arg2)}，这个参数的类型是需要匹配的，

感谢阅读，希望能帮助到大家，谢谢大家对本站的支持！

相关链接