自定義JSP標簽實例

jopen 11年前發布 | 23K 次閱讀 JSP Java開發

自定義標簽:
1.修改web.xml文件在其中加上對自定義標簽的支持:

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" 
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 
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
  <welcome-file-list>
    <welcome-file>index.jsp</welcome-file>
  </welcome-file-list>
   <jsp-config>  
   <taglib>  
        <taglib-uri>/tld/helloworld</taglib-uri>  
       <taglib-location>/WEB-INF/tlds/helloworld.tld</taglib-location>  
   </taglib>  
   </jsp-config>   
</web-app>

---------------------------------------------------------------------------------


----
2.在META-INF下創建tld文件夾并且創建helloword.tld文件
  <?xml version="1.0" encoding="UTF-8"?>
  <!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><!--這個標簽庫要求的jsp規范版本-->
<short-name>mytag</short-name><!--jsp頁面編寫工具可以用來創建助記名的可選名字-->
<tag>
<name>helloworld</name><!--唯一標簽名字-->
<tag-class>com.credream.mytag.HelloWorldTag</tag-class><!--標簽helloword類的完全



限定名-->
<body-content>empty</body-content><!-- 正文內容類型 --> 
</tag>
</taglib>
---------------------------------------------------------------------------------


----------
  這里注意:web.xml和xxx.tld這兩個XML文件的頭信息的版本匹配很重要,否則會導致頁面


報錯找不到標簽 。
3、創建標簽處理程序類 HelloWorldTag(重寫doStartTag和doEndTag方法)。
package com.credream.mytag;


import java.io.IOException;


import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspTagException;
import javax.servlet.jsp.tagext.TagSupport;
/** 
* TagSupport與BodyTagSupport的區別: 
* 主要看標簽處理類是否要讀取標簽體的內容和改變標簽體返回的內容,如果不需


要就用TagSupport,否則就用BodyTagSupport 
* 用TagSupport實現的標簽,都可以用BodyTagSupport來實現,因為


BodyTagSupport繼承了TagSupport  
*/  


public class HelloWorldTag extends TagSupport {


@Override
public int doEndTag() throws JspException {
try {
pageContext.getOut().write("Hello World!!!");
} catch (IOException e) {
e.printStackTrace();
throw new JspTagException("調用doEndTag方法的時候出錯


了...");
}
return EVAL_PAGE;
}
@Override
public int doStartTag() throws JspException {
return EVAL_BODY_INCLUDE;
}


}

---------------------------------------------------------------------------------


----------------
這時候要注意一些參數的意思:
補充: 
doStartTag()方法是遇到標簽開始時會呼叫的方法,其合法的返回值是EVAL_BODY_INCLUDE與


SKIP_BODY,前者表示將顯示標簽間的文字,后者表示不顯示標簽間的文字。
doEndTag()方法是在遇到標簽結束時呼叫的方法,其合法的返回值是EVAL_PAGE與SKIP_PAGE


,前者表示處理完標簽后繼續執行以下的JSP網頁,后者是表示不處理接下來的JSP網頁。
doAfterBody(),這個方法是在顯示完標簽間文字之后呼叫的,其返回值有EVAL_BODY_AGAIN與


SKIP_BODY,前者會再顯示一次標簽間的文字,后者則繼續執行標簽處理的下一步。


EVAL_BODY_INCLUDE:把Body讀入存在的輸出流中,doStartTag()函數可用。
EVAL_PAGE:繼續處理頁面,doEndTag()函數可用。
SKIP_BODY:忽略對Body的處理,doStartTag()和doAfterBody()函數可用。
SKIP_PAGE:忽略對余下頁面的處理,doEndTag()函數可用。
EVAL_BODY_BUFFERED:申請緩沖區,由setBodyContent()函數得到的BodyContent對象來處理


tag的body,如果類實現了BodyTag,那么doStartTag()可用,否則非法。
EVAL_BODY_AGAIN:請求繼續處理body,返回自doAfterBody(),這個返回值在你制作循環tag


的時候是很有用的。


預定的處理順序是:doStartTag()返回SKIP_BODY,doAfterBodyTag()返回


SKIP_BODY,doEndTag()返回EVAL_PAGE。如果繼承了TagSupport之后,如果沒有改寫任何的方


法,標簽處理的執行順序是:doStartTag() ->不顯示文字 ->doEndTag()->執行接下來的網


頁 。如果您改寫了doStartTag(),則必須指定返回值,如果指定了EVAL_BODY_INCLUDE,則執


行順序是:doStartTag()->顯示文字->doAfterBodyTag()->doEndTag()->執行下面的網頁 。
---------------------------------------------------------------------------------


---------------------------------------------------------------------
4.編寫測試網頁hello.jsp
<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<%@ taglib uri="/tld/helloworld" prefix="mytag"%><!-- 在頁面中加以聲明 -->  
<%
String path = request.getContextPath();
String basePath = request.getScheme()+"://"+request.getServerName


()+":"+request.getServerPort()+path+"/";
%>


<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <base href="<%=basePath%>">

    <title>My JSP 'index.jsp' starting page</title>
<meta http-equiv="pragma" content="no-cache">
<meta http-equiv="cache-control" content="no-cache">
<meta http-equiv="expires" content="0">    
<meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
<meta http-equiv="description" content="This is my page">
<!--
<link rel="stylesheet" type="text/css" href="styles.css">
-->
  </head>
  <body>
    <mytag:helloworld/>
  </body>
</html>
 本文由用戶 jopen 自行上傳分享,僅供網友學習交流。所有權歸原作者,若您的權利被侵害,請聯系管理員。
 轉載本站原創文章,請注明出處,并保留原始鏈接、圖片水印。
 本站是一個以用戶分享為主的開源技術平臺,歡迎各類分享!