`
meiwm
  • 浏览: 13883 次
社区版块
存档分类
最新评论

JSP 使用参考 -- 自定义标签

 
阅读更多

 

首先约定下标签各部分的名称
  • <标签开始> 标签主体内容 </标签结束部分>
1. 声明自定义标签的类
(1). 自定义标签的实现类须继承自 javax.servlet.jsp.tagext.TagSupport, 其中可能需要重写的方法有 
  • init()  --- 初始化资源
  • doStartTag() --- 解析标签的开始部分
  • doAfterBody() --- 解析标签内容部分
  • doEndTag()  --- 解析标签的结束部分
  • release()  --- 用于回收资源
(2). 和大部分 java(web) 功能 一样,标签的实现类也需要 符合 javabean规范,即使用 get/set方法 操作字段

(3). 标签解析方法的返回值
标签解析方法 返回值有:
  • EVAL_BODY_INCLUDE:告诉服务器正文的内容,并把这些内容送入输出流 ,(doStartTag()函数可用)  
  • EVAL_PAGE:继续处理页面,(doEndTag()函数可用 )
  • SKIP_BODY:告诉服务器不要处理正文内容,(doStartTag()和doAfterBody()函数可用) 
  • SKIP_PAGE:让服务器不要处理剩余的页面,doEndTag()函数可用   (doEndTag()函数可用 )
  • EVAL_BODY_TAG:已经废止,由EVAL_BODY_BUFFERED取代  
  • EVAL_BODY_BUFFERED:申请缓冲区,由setBodyContent()函数得到的BodyContent对象来处理tag的body,如果类实现了BodyTag,那么否则非法  
(4). 如果需要与标签主体内容进行交互, 自定义标签类可以继承自  javax.servlet.jsp.tagext.BodyTagSupport

(5) 范例代码

package com.forum.tag;

import java.io.IOException;
import javax.servlet.jsp.tagext.TagSupport;
public class TagPrimary extends TagSupport {
                private static final long serialVersionUID = 1L;

                private String name;
                private String age;
                @Override
                public int doStartTag()
                {
                       return EVAL_PAGE;
                }
                @Override
                public int doEndTag()
                {
                       try {
                                pageContext.getOut().write( "neme:" + name + "; age: " + age);
                       } catch (IOException e) {

                      }
                         return EVAL_PAGE;
                }
                public String getName() {
                        return name;
                }
                public void setName(String name) {
                       this. name = name;
                }
                public String getAge() {
                       return age;
                }
                public void setAge(String age) {
                       this. age = age;
                }
}


2. 建立TLD
TLD文件就是一个xml文件, 其用来保存 自定义标签的相应设置,一个TLD文件可以包含多个标签的定义

(1) 范例文件 primary.tld

<? xml version= "1.0" encoding = "UTF-8"?>
< taglib version= "2.1" xmlns = "http://java.sun.com/xml/ns/javaee"
        xmlns:xsi ="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation ="http://java.sun.com/xml/ns/javaee web-jsptaglibrary_2_1.xsd">
        <tlib-version> 1.0</tlib-version>
        <short-name> p</short-name>
        <tag>
               <name> tagtest </name>
               <tag-class> com.forum.tag.TagPrimary </tag-class>
               <body-content> empty</ body-content>
               <attribute>
                      <name> name</name>
                      <required> true</required>
                      <rtexprvalue> true</rtexprvalue>
               </attribute>
               <attribute>
                      <name> age</name>
                      <required> true</required>
                      <rtexprvalue> true</rtexprvalue>
               </attribute>
        </tag>
</taglib>


(2) 元素说明
TLD文件中的标签
  • taglib -- TLD文件的根标签
  • tlibversion -- 此标签库的版本
  • jspversion -- 此标签库依赖的JSP版本。
  • shortname -- 当在JSP中使用标签时,此标签库建议的前缀。
  • tag -- 包含针对此标签库中的一个标签的元数据
<tag>子标签
  • name -- 标签名称
  • tagclass -- Java标签处理器类的完全限定名
  • bodycontent -- 此标签的主体内容部分的内容的处理方式,
       1. empty:表示标签主体内容必须为空;
       2. JSP: 表示脚本元素和模板及其它标签一样被评估。
       3. tagdependent:内容被原封不动写入BodyContent,其它脚本元素以源码形式出现,而不是被JSP容器解释。
  • attribute -- 包含了此标签的一个属性的元数据
<attribute>子标签
  • name -- 属性的名字。
  • required -- 属性是否必须。
  • rtexprvalue -- 属性值能否用表达式指定(如EL表达式)
3 配置 TLD
必须在 web.xml 中声明 对应的 TLD文件, 才能够使用相应的自定义标签,如

<jsp-config>
  <taglib>
      <taglib-uri> /mytaglib </taglib-uri>
      <taglib-location> /WEB-INF/classes/primary.tld </taglib-location >
  </taglib>
</jsp-config>


4. 使用 自定义标签 (红色部分代码)

<%@ page language= "java" pageEncoding ="GBK"
        contentType ="text/html;charset=GBK" %>
<%@ taglib prefix= "p" uri= "/mytaglib" %>
<! DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head>
    <meta http-equiv= "Content-Type" content= "text/html; charset=GBK">        
    <title>测试页面 </title>
  </head>
  <body>
        <p:tagtest age= "20" name = "小明" />
  </body>
</html>


5. 参考文章

 

 

 

 

 

 

 

 

原创文章 转载请注明出处 http://meiwm.iteye.com/ 谢谢
...
分享到:
评论

相关推荐

Global site tag (gtag.js) - Google Analytics