Test.jsp
<html>
<head>
<title>My JSP 'Test.jsp' starting page</title>
</head>
<body>
This is my JSP page. <br>
Date : <%= new java.util.Date().toString() %> <br>
File : <input value="<%= request.getServletPath() %>" />
</body>
</html>
爲了將這個這個Test.jsp改成自定義標籤方法,我們分別使用簡單標籤和內容標籤兩種不同的方式實現。
1. 簡單標籤
由於我們需要輸出兩個內容(日期和文件名),因此我們爲標籤創建一個參數。具體代碼:
DemoTag.java
import java.util.Date;
import javax.servlet.http.*;
import javax.servlet.jsp.*;
import javax.servlet.jsp.tagext.*;
public class DemoTag extends TagSupport {
public int doStartTag() throws JspException {
try {
HttpServletRequest request = (HttpServletRequest)pageContext.getRequest();
JspWriter out = pageContext.getOut();
if (parameter.compareToIgnoreCase("filename") == 0)
out.print(request.getServletPath());
else
out.print(new Date());
} catch (java.io.IOException e) {
throw new JspTagException(e.getMessage());
}
return SKIP_BODY;
}
private String parameter = "date";
public void setParameter(String parameter) {
this.parameter = parameter;
}
public String getParameter() {
return parameter;
}
}
接下來,我們創建標籤文件 MyTagLib.tld。標籤文件其實只是一個XML格式的說明文件,內容也很簡單。
MyTagLib.tld
<taglib>
<tlib-version>1.0</tlib-version>
<jsp-version>1.2</jsp-version>
<tag>
<name>demo</name>
<tag-class>com.mycompany.DemoTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>parameter</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
</taglib>
在這個標籤文件中,我們將我們創建的標籤取名 demo,並聲明瞭類型和參數(parameter)。將該文件保存在 /WEB-INF 下面。
當然,我們還需要將我們自定義的標籤添加到 web.xml 中,否則還是無法使用。
web.xml
<web-app xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.4" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<jsp-config>
<taglib>
<taglib-uri>/WEB-INF/MyTagLib</taglib-uri>
<taglib-location>/WEB-INF/MyTagLib.tld</taglib-location>
</taglib>
</jsp-config>
</web-app>
你可能在別處看到過類似的聲明,只是沒有外面的 jsp-config,但是我們使用的是DTD 2.4,如果不加,Eclipse 會提示出錯。
到此爲止,我們的自定義標籤算是創建完畢。接下來,我們可以開始改寫那個JSP文件來分離代碼了。
Test.jsp
<%@taglib uri="/WEB-INF/MyTagLib" prefix="mytag"%>
<html>
<head>
<title>My JSP 'Test.jsp' starting page</title>
</head>
<body>
This is my JSP page. <br>
Date : <mytag:demo parameter="date" /><br>
File : <mytag:demo parameter="filename" />
</body>
</html>
上面這些想必你已經很熟悉,我就不做多說了。
2. 內容標籤
創建過程和上面大抵相同,只是程序文件和配置內容有些差異。
DemoTag2.java
import java.io.IOException;
import java.util.Date;
import javax.servlet.http.*;
import javax.servlet.jsp.*;
import javax.servlet.jsp.tagext.*;
public class DemoTag2 extends BodyTagSupport {
public int doStartTag() throws JspTagException {
return EVAL_BODY_BUFFERED;
}
public int doEndTag() throws JspTagException {
String body = this.getBodyContent().getString();
HttpServletRequest request = (HttpServletRequest)pageContext.getRequest();
body = body.replace("$date", new Date().toString());
body = body.replace("$filename", request.getServletPath());
try {
pageContext.getOut().print(body);
}
catch (IOException e) {
throw new JspTagException(e.getMessage());
}
return SKIP_BODY;
}
}
我們將新的標籤 DemoTag2 加入到上面的標籤文件中。
MyTagLib.tld
<taglib>
<tlib-version>1.0</tlib-version>
<jsp-version>1.2</jsp-version>
<tag>
<name>demo</name>
<tag-class>com.mycompany.DemoTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>parameter</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
<tag>
<name>demo2</name>
<tag-class>com.mycompany.DemoTag2</tag-class>
<body-content>jsp</body-content>
</tag>
</taglib>
web.xml 文件無需修改。
看看同時使用兩種標籤的Test.jsp效果。
Test.jsp
<%@taglib uri="/WEB-INF/MyTagLib" prefix="mytag"%>
<html>
<head>
<title>My JSP 'Test.jsp' starting page</title>
</head>
<body>
This is my JSP page. <br>
Date : <mytag:demo parameter="date" /><br>
File : <mytag:demo parameter="filename" />
<hr>
<mytag:demo2>
Date: $date<br>
File: $filename
</mytag:demo2>
</body>
</html>
至此,兩種標籤方式都完成。
本文並沒有就相關技術細節做出說明,建議您看看Sun有關JSP自定義標籤的官方文檔。
無論是用自定義標籤,還是使用JavaBean,都沒有太大的區別,各人或者團隊可以根據自己的習慣使用。如果需要在獨立類庫中封裝一些供頁面使用的單元,自定義標籤應該更適合些。不過現在的IDE環境(MyEclipse)在編寫自定義標籤的時候可能有些不太舒服的情況,界面開發人員使用JavaBean方式可能更方便些,免得莫名其妙的提示干擾您的工作。