java架構執行個體---自訂標籤執行個體
來源：互聯網
上載者：User
自訂標籤:
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>
---------------------------------------------------------------------------------
