posts - 14, comments - 37, trackbacks - 0

2007年7月10日初始的時候，我就是想處理404錯誤的頁面，

1

<web-app>
2

<error-page>
3

<error-code>404</error-code>
4

<location>/NotFound.jsp</location>
5

</error-page>
6

<!--

-->
7

</web-app>

這樣就可以了
下面的link可以看到更進一步的說明
http://fanqiang.chinaunix.net/app/web/2006-04-29/4123.shtml
7 指定歡迎頁
假如用戶提供了一個像http://host/webAppPrefix/directoryName/ 這樣的包含一個目錄名但沒有包含文件名的URL，會發(fā)生什么事情呢？用戶能得到一個目錄表？一個錯誤？還是標準文件的內(nèi)容？如果得到標準文件內(nèi)容，是index.html、index.jsp、default.html、default.htm或別的什么東西呢？
Welcome -file-list元素及其輔助的welcome-file元素解決了這個模糊的問題。例如，下面的web.xml項指出，如果一個URL給出一個目錄名但未給出文件名，服務(wù)器應(yīng)該首先試用index.jsp，然后再試用index.html。如果兩者都沒有找到，則結(jié)果有賴于所用的服務(wù)器（如一個目錄列表）。

1

<welcome-file-list>
2

<welcome-file>index.jsp</welcome-file>
3

<welcome-file>index.html</welcome-file>
4

</welcome-file-list>
5

雖然許多服務(wù)器缺省遵循這種行為，但不一定必須這樣。因此，明確地使用welcom-file-list保證可移植性是一種良好的習(xí)慣。

8 指定處理錯誤的頁面

現(xiàn)在我了解到，你在開發(fā)servlet和 JSP頁面時從不會犯錯誤，而且你的所有頁面是那樣的清晰，一般的程序員都不會被它們的搞糊涂。但是，是人總會犯錯誤的，用戶可能會提供不合規(guī)定的參數(shù)，使用不正確的URL或者不能提供必需的表單字段值。除此之外，其它開發(fā)人員可能不那么細心，他們應(yīng)該有些工具來克服自己的不足。
error-page 元素就是用來克服這些問題的。它有兩個可能的子元素，分別是：error-code和exception-type。第一個子元素error-code指出在給定的HTTP錯誤代碼出現(xiàn)時使用的URL。第二個子元素excpetion-type指出在出現(xiàn)某個給定的Java異常但未捕捉到時使用的URL。 error-code和exception-type都利用location元素指出相應(yīng)的URL。此URL必須以/開始。location所指出的位置處的頁面可通過查找HttpServletRequest對象的兩個專門的屬性來訪問關(guān)于錯誤的信息，這兩個屬性分別是： javax.servlet.error.status_code和javax.servlet.error.message。
可回憶一下，在web.xml內(nèi)以正確的次序聲明web-app的子元素很重要。這里只要記住，error-page出現(xiàn)在web.xml文件的末尾附近，servlet、servlet-name和welcome-file-list之后即可。

8.1 error-code元素
為了更好地了解error-code元素的值，可考慮一下如果不正確地輸入文件名，大多數(shù)站點會作出什么反映。這樣做一般會出現(xiàn)一個404錯誤信息，它表示不能找到該文件，但幾乎沒提供更多有用的信息。另一方面，可以試一下在www.microsoft.com、www.ibm.com 處或者特別是在www.bea.com 處輸出未知的文件名。這是會得出有用的消息，這些消息提供可選擇的位置，以便查找感興趣的頁面。提供這樣有用的錯誤頁面對于Web應(yīng)用來說是很有價值得。事實上，http://www.plinko.net/404/ 就是把整個站點專門用于404錯誤頁面這個內(nèi)容。這個站點包含來自全世界最好、最糟和最搞笑的404頁面。
程序清單5-13給出一個JSP頁面，此頁面可返回給提供位置程序名的客戶機。程序清單5-14給出指定程序清單5-13作為返回404錯誤代碼時顯示的頁面的web.xml。請注意，瀏覽器中顯示的URL仍然是客戶機所提供的。錯誤頁面是一種后臺實現(xiàn)技術(shù)。
最后一點，請記住IE5的缺省配置顯然不符合HTTP規(guī)范，它忽略了服務(wù)器生成的錯誤消息，而是顯示自己的標準出錯信息。可轉(zhuǎn)到其Tools菜單，選擇 Internet Options，單擊Advanced，取消Show Friendly HTTP Error Message來解決此問題。

程序清單5-13 NotFound.jsp

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<HTML>

<HEAD><TITLE>404: Not Found</TITLE></HEAD>

<H2>Error!</H2>

I'm sorry, but I cannot find a page that matches

<%= request.getRequestURI() %> on the system. Maybe you should

try one of the following:

<UL>

<LI>Go to the server's <A HREF="/">home page</A>.

<LI>Search for relevant pages.<BR>

Keywords: <INPUT TYPE="TEXT" NAME="q"><BR>

</CENTER>

</FORM>

<LI>Admire a random multiple of 404:

<%= 404*((int)(1000*Math.random())) %>.

<LI>Try a <A HREF="http://www.plinko.net/404/rndindex.asp"

TARGET="_blank">

random 404 error message</A>. From the amazing and

amusing plinko.net <A HREF="http://www.plinko.net/404/">

404 archive</A>.

</UL>

</BODY></HTML>

程序清單5-14 web.xml（指出HTTP錯誤代碼的錯誤頁面的摘錄）

1

<?xml version="1.0" encoding="ISO-8859-1"?>
2

<!DOCTYPE web-app
3

PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
4

"http://java.sun.com/dtd/web-app_2_3.dtd">
5

6

<web-app>
7

<error-page>
8

<error-code>404</error-code>
9

<location>/NotFound.jsp</location>
10

</error-page>
11

<!--

-->
12

</web-app>
13

14

8.2 exception-type元素
error -code元素處理某個請求產(chǎn)生一個特定的HTTP狀態(tài)代碼時的情況。然而，對于servlet或JSP頁面返回200但產(chǎn)生運行時異常這種同樣是常見的情況怎么辦呢？這正是exception-type元素要處理的情況。只需提供兩樣?xùn)|西即可：即提供如下的一個完全限定的異常類和一個位置：

1

<error-page>
2

<exception-type>packageName.className</exception-type>
3

<location>/SomeURL</location>
4

</error-page>

這樣，如果Web應(yīng)用中的任何servlet或JSP頁面產(chǎn)生一個特定類型的未捕捉到的異常，則使用指定的URL。此異常類型可以是一個標準類型，如 javax.ServletException或java.lang.OutOfMemoryError，或者是一個專門針對你的應(yīng)用的異常。
例如，程序清單5-15給出了一個名為DumbDeveloperException的異常類，可用它來特別標記經(jīng)驗較少的程序員（不是說你的開發(fā)組中一定有這種人）所犯的錯誤。這個類還包含一個名為dangerousComputation的靜態(tài)方法，它時不時地生成這種類型的異常。程序清單5-16給出對隨機整數(shù)值調(diào)用dangerousCompution的一個JSP頁面。在拋出此異常時，如程序清單5-18的web.xml版本中所給出的 exception-type所指出的那樣，對客戶機顯示DDE.jsp（程序清單5-17）。圖5-16和圖5-17分別給出幸運和不幸的結(jié)果。
程序清單5-15 DumbDeveloperException.java

1

package moreservlets;
2

3

/** Exception used to flag particularly onerous
4

programmer blunders. Used to illustrate the
5

exception-type web.xml element.
6

* <P>
7

* Taken from More Servlets and JavaServer Pages
8

* from Prentice Hall and Sun Microsystems Press,
9

* http://www.moreservlets.com/.
10

* © 2002 Marty Hall; may be freely used or adapted.
11

*/
12

13

public class DumbDeveloperException extends Exception {
14

public DumbDeveloperException() {
15

super("Duh. What was I *thinking*?");
16

}
17

18

public static int dangerousComputation(int n)
19

throws DumbDeveloperException {
20

if (n < 5) {
21

return(n + 10);
22

} else {
23

throw(new DumbDeveloperException());
24

}
25

}
26

}
27

28

程序清單5-16 RiskyPage.jsp

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<HTML>

<HEAD><TITLE>Risky JSP Page</TITLE></HEAD>

<H2>Risky Calculations</H2>

<%@ page import="moreservlets.*" %>

<% int n = ((int)(10 * Math.random())); %>

<UL>

<LI>dangerousComputation(n):

<%= DumbDeveloperException.dangerousComputation(n) %>

</UL>

</BODY></HTML>

程序清單5-17 DDE.jsp

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<HTML>

<H2>Dumb Developer</H2>

We're brain dead. Consider using our competitors.

</BODY></HTML

程序清單5-18 web.xml（為異常指定錯誤頁面的摘錄）

1

<?xml version="1.0" encoding="ISO-8859-1"?>
2

<!DOCTYPE web-app
3

PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
4

"http://java.sun.com/dtd/web-app_2_3.dtd">
5

6

<web-app>
7

<!--

-->
8

<servlet> … </servlet>
9

<!--

-->
10

<error-page>
11

<exception-type>
12

moreservlets.DumbDeveloperException
13

</exception-type>
14

<location>/DDE.jsp</location>
15

</error-page>
16

<!--

-->
17

</web-app>
18

19

9 提供安全性

利用web.xml中的相關(guān)元素為服務(wù)器的內(nèi)建功能提供安全性。
9.1 指定驗證的方法
使用login-confgi元素規(guī)定服務(wù)器應(yīng)該怎樣驗證試圖訪問受保護頁面的用戶。它包含三個可能的子元素，分別是：auth-method、realm -name和form-login-config。login-config元素應(yīng)該出現(xiàn)在web.xml部署描述符文件的結(jié)尾附近，緊跟在 security-constraint元素之后。
l auth-method
login-config的這個子元素列出服務(wù)器將要使用的特定驗證機制。有效值為BASIC、DIGEST、FORM和CLIENT-CERT。服務(wù)器只需要支持BASIC和FORM。
BASIC 指出應(yīng)該使用標準的HTTP驗證，在此驗證中服務(wù)器檢查Authorization頭。如果缺少這個頭則返回一個401狀態(tài)代碼和一個WWW- Authenticate頭。這導(dǎo)致客戶機彈出一個用來填寫Authorization頭的對話框。此機制很少或不提供對攻擊者的防范，這些攻擊者在 Internet連接上進行窺探（如通過在客戶機的子網(wǎng)上執(zhí)行一個信息包探測裝置），因為用戶名和口令是用簡單的可逆base64編碼發(fā)送的，他們很容易得手。所有兼容的服務(wù)器都需要支持BASIC驗證。
DIGEST指出客戶機應(yīng)該利用加密Digest Authentication形式傳輸用戶名和口令。這提供了比BASIC驗證更高的防范網(wǎng)絡(luò)截取得的安全性，但這種加密比SSL（HTTPS）所用的方法更容易破解。不過，此結(jié)論有時沒有意義，因為當(dāng)前很少有瀏覽器支持Digest Authentication，所以servlet容器不需要支持它。
FORM 指出服務(wù)器應(yīng)該檢查保留的會話cookie并且把不具有它的用戶重定向到一個指定的登陸頁。此登陸頁應(yīng)該包含一個收集用戶名和口令的常規(guī)HTML表單。在登陸之后，利用保留會話級的cookie跟蹤用戶。雖然很復(fù)雜，但FORM驗證防范網(wǎng)絡(luò)窺探并不比BASIC驗證更安全，如果有必要可以在頂層安排諸如 SSL或網(wǎng)絡(luò)層安全（如IPSEC或VPN）等額外的保護。所有兼容的服務(wù)器都需要支持FORM驗證。
CLIENT-CERT規(guī)定服務(wù)器必須使用HTTPS（SSL之上的HTTP）并利用用戶的公開密鑰證書（Pulic Key Certificat）對用戶進行驗證。這提供了防范網(wǎng)絡(luò)截取的很強的安全性，但只有兼容J2EE的服務(wù)器需要支持它。
l realm-name
此元素只在auth-method為BASIC時使用。它指出瀏覽器在相應(yīng)對話框標題使用的、并作為Authorization頭組成部分的安全域的名稱。
l form-login-config
此元素只在auth-method為FORM時適用。它指定兩個頁面，分別是：包含收集用戶名及口令的HTML表單的頁面（利用form-login- page子元素），用來指示驗證失敗的頁面（利用form-error-page子元素）。由form-login-page給出的HTML表單必須具有一個j_security_check的ACTION屬性、一個名為j_username的用戶名文本字段以及一個名為j_password的口令字段。
例如，程序清單5-19指示服務(wù)器使用基于表單的驗證。Web應(yīng)用的頂層目錄中的一個名為login.jsp的頁面將收集用戶名和口令，并且失敗的登陸將由相同目錄中名為login-error.jsp的頁面報告。

程序清單5-19 web.xml（說明login-config的摘錄）

1

<?xml version="1.0" encoding="ISO-8859-1"?>
2

<!DOCTYPE web-app
3

PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
4

"http://java.sun.com/dtd/web-app_2_3.dtd">
5

6

<web-app>
7

<!--

-->
8

<security-constraint>

</security-constraint>
9

<login-config>
10

<auth-method> FORM </auth-method>
11

<form-login-config>
12

<form-login-page>/login.jsp</form-login-page>
13

<form-error-page>/login-error.jsp</form-error-page>
14

</form-login-config>
15

</login-config>
16

<!--

-->
17

</web-app>
18

19

9.2 限制對Web資源的訪問
現(xiàn) 在，可以指示服務(wù)器使用何種驗證方法了。"了不起，"你說道，"除非我能指定一個來收到保護的URL，否則沒有多大用處。"沒錯。指出這些URL并說明他們應(yīng)該得到何種保護正是security-constriaint元素的用途。此元素在web.xml中應(yīng)該出現(xiàn)在login-config的緊前面。它包含是個可能的子元素，分別是：web-resource-collection、auth-constraint、user-data- constraint和display-name。下面各小節(jié)對它們進行介紹。
l web-resource-collection
此元素確定應(yīng)該保護的資源。所有security-constraint元素都必須包含至少一個web-resource-collection項。此元素由一個給出任意標識名稱的web-resource-name元素、一個確定應(yīng)該保護的URL的url-pattern元素、一個指出此保護所適用的 HTTP命令（GET、POST等，缺省為所有方法）的http-method元素和一個提供資料的可選description元素組成。例如，下面的 Web-resource-collection項（在security-constratint元素內(nèi)）指出Web應(yīng)用的proprietary目錄中所有文檔應(yīng)該受到保護。

1

<security-constraint>
2

<web-resource-coolection>
3

<web-resource-name>Proprietary</web-resource-name>
4

<url-pattern>/propritary/*</url-pattern>
5

</web-resource-coolection>
6

<!--

-->
7

</security-constraint>
8

重要的是應(yīng)該注意到，url-pattern僅適用于直接訪問這些資源的客戶機。特別是，它不適合于通過MVC體系結(jié)構(gòu)利用 RequestDispatcher來訪問的頁面，或者不適合于利用類似jsp:forward的手段來訪問的頁面。這種不勻稱如果利用得當(dāng)?shù)脑捄苡泻?處。例如，servlet可利用MVC體系結(jié)構(gòu)查找數(shù)據(jù)，把它放到bean中，發(fā)送請求到從bean中提取數(shù)據(jù)的JSP頁面并顯示它。我們希望保證決不直接訪問受保護的JSP頁面，而只是通過建立該頁面將使用的bean的servlet來訪問它。url-pattern和auth-contraint元素可通過聲明不允許任何用戶直接訪問JSP頁面來提供這種保證。但是，這種不勻稱的行為可能讓開發(fā)人員放松警惕，使他們偶然對應(yīng)受保護的資源提供不受限制的訪問。
l auth-constraint
盡管web-resource-collention元素質(zhì)出了哪些URL應(yīng)該受到保護，但是auth-constraint元素卻指出哪些用戶應(yīng)該具有受保護資源的訪問權(quán)。此元素應(yīng)該包含一個或多個標識具有訪問權(quán)限的用戶類別role- name元素，以及包含（可選）一個描述角色的description元素。例如，下面web.xml中的security-constraint元素部門規(guī)定只有指定為Administrator或Big Kahuna（或兩者）的用戶具有指定資源的訪問權(quán)。

1

<security-constraint>
2

<web-resource-coolection>

</web-resource-coolection>
3

<auth-constraint>
4

<role-name>administrator</role-name>
5

<role-name>kahuna</role-name>
6

</auth-constraint>
7

</security-constraint>
8

重要的是認識到，到此為止，這個過程的可移植部分結(jié)束了。服務(wù)器怎樣確定哪些用戶處于任何角色以及它怎樣存放用戶的口令，完全有賴于具體的系統(tǒng)。
例如，Tomcat使用install_dir/conf/tomcat-users.xml將用戶名與角色名和口令相關(guān)聯(lián)，正如下面例子中所示，它指出用戶joe（口令bigshot）和jane（口令enaj）屬于administrator和kahuna角色。

1

<tomcat-users>
2

<user name="joe" password="bigshot" roles="administrator,kahuna" />
3

<user name="jane" password="enaj" roles="kahuna" />
4

</tomcat-users>
5

l user-data-constraint
這個可選的元素指出在訪問相關(guān)資源時使用任何傳輸層保護。它必須包含一個transport-guarantee子元素（合法值為NONE、 INTEGRAL或CONFIDENTIAL），并且可選地包含一個description元素。transport-guarantee為NONE值將對所用的通訊協(xié)議不加限制。INTEGRAL值表示數(shù)據(jù)必須以一種防止截取它的人閱讀它的方式傳送。雖然原理上（并且在未來的HTTP版本中），在 INTEGRAL和CONFIDENTIAL之間可能會有差別，但在當(dāng)前實踐中，他們都只是簡單地要求用SSL。例如，下面指示服務(wù)器只允許對相關(guān)資源做 HTTPS連接：

1

<security-constraint>
2

<!--

-->
3

<user-data-constraint>
4

<transport-guarantee>CONFIDENTIAL</transport-guarantee>
5

</user-data-constraint>
6

</security-constraint>
7

display-name
security-constraint的這個很少使用的子元素給予可能由GUI工具使用的安全約束項一個名稱。
9.3 分配角色名
迄今為止，討論已經(jīng)集中到完全由容器（服務(wù)器）處理的安全問題之上了。但servlet以及JSP頁面也能夠處理它們自己的安全問題。
例如，容器可能允許用戶從bigwig或bigcheese角色訪問一個顯示主管人員額外緊貼的頁面，但只允許bigwig用戶修改此頁面的參數(shù)。完成這種更細致的控制的一種常見方法是調(diào)用HttpServletRequset的isUserInRole方法，并據(jù)此修改訪問。
Servlet的 security-role-ref子元素提供出現(xiàn)在服務(wù)器專用口令文件中的安全角色名的一個別名。例如，假如編寫了一個調(diào)用 request.isUserInRole（"boss"）的servlet，但后來該servlet被用在了一個其口令文件調(diào)用角色manager而不是boss的服務(wù)器中。下面的程序段使該servlet能夠使用這兩個名稱中的任何一個。

1

<servlet>
2

<!--

-->
3

<security-role-ref>
4

<role-name>boss</role-name> 
5

<role-link>manager</role-link> 
6

</security-role-ref>
7

</servlet>
8

也可以在web-app內(nèi)利用security-role元素提供將出現(xiàn)在role-name元素中的所有安全角色的一個全局列表。分別地生命角色使高級IDE容易處理安全信息。

10 控制會話超時

如果某個會話在一定的時間內(nèi)未被訪問，服務(wù)器可把它扔掉以節(jié)約內(nèi)存。可利用HttpSession的setMaxInactiveInterval方法直接設(shè)置個別會話對象的超時值。如果不采用這種方法，則缺省的超時值由具體的服務(wù)器決定。但可利用session-config和session-timeout元素來給出一個適用于所有服務(wù)器的明確的超時值。超時值的單位為分鐘，因此，下面的例子設(shè)置缺省會話超時值為三個小時（180分鐘）。

1

<session-config>
2

<session-timeout>180</session-timeout>
3

</session-config>
4

11 Web應(yīng)用的文檔化

越來越多的開發(fā)環(huán)境開始提供 servlet和JSP的直接支持。例子有Borland Jbuilder Enterprise Edition、Macromedia UltraDev、Allaire JRun Studio（寫此文時，已被Macromedia收購）以及IBM VisuaAge for Java等。
大量的web.xml元素不僅是為服務(wù)器設(shè)計的，而且還是為可視開發(fā)環(huán)境設(shè)計的。它們包括icon、display-name和discription等。
可回憶一下，在web.xml內(nèi)以適當(dāng)?shù)卮涡蚵暶鱳eb-app子元素很重要。不過，這里只要記住icon、display-name和description是web.xml的web-app元素內(nèi)的前三個合法元素即可。
l icon
icon元素指出GUI工具可用來代表Web應(yīng)用的一個和兩個圖像文件。可利用small-icon元素指定一幅16 x 16的GIF或JPEG圖像，用large-icon元素指定一幅32 x 32的圖像。下面舉一個例子：

1

<icon>
2

<small-icon>/images/small-book.gif</small-icon>
3

<large-icon>/images/tome.jpg</large-icon>
4

</icon>
5

l display-name
display-name元素提供GUI工具可能會用來標記此Web應(yīng)用的一個名稱。下面是個例子。

1

<display-name>Rare Books</display-name>
2

l description
3

description元素提供解釋性文本，如下所示：
4

<description>
5

This Web application represents the store developed for
6

rare-books.com, an online bookstore specializing in rare
7

and limited-edition books.
8

</description>

12 關(guān)聯(lián)文件與MIME類型

服務(wù)器一般都具有一種讓W(xué)eb站點管理員將文件擴展名與媒體相關(guān)聯(lián)的方法。例如，將會自動給予名為mom.jpg的文件一個image/jpeg的MIME類型。但是，假如你的Web應(yīng)用具有幾個不尋常的文件，你希望保證它們在發(fā)送到客戶機時分配為某種MIME類型。mime-mapping元素（具有extension和mime-type子元素）可提供這種保證。例如，下面的代碼指示服務(wù)器將application/x-fubar的MIME類型分配給所有以.foo結(jié)尾的文件。

1

<mime-mapping>
2

<extension>foo</extension>
3

<mime-type>application/x-fubar</mime-type>
4

</mime-mapping>
5

或許，你的Web應(yīng)用希望重載（override）標準的映射。例如，下面的代碼將告訴服務(wù)器在發(fā)送到客戶機時指定.ps文件作為純文本（text/plain）而不是作為PostScript（application/postscript）。

1

<mime-mapping>
2

<extension>ps</extension>
3

<mime-type>application/postscript</mime-type>
4

</mime-mapping>
5

13 定位TLD

JSP taglib元素具有一個必要的uri屬性，它給出一個TLD（Tag Library Descriptor）文件相對于Web應(yīng)用的根的位置。TLD文件的實際名稱在發(fā)布新的標簽庫版本時可能會改變，但我們希望避免更改所有現(xiàn)有JSP頁面。此外，可能還希望使用保持taglib元素的簡練性的一個簡短的uri。這就是部署描述符文件的taglib元素派用場的所在了。Taglib包含兩個子元素：taglib-uri和taglib-location。taglib-uri元素應(yīng)該與用于JSP taglib元素的uri屬性的東西相匹配。Taglib-location元素給出TLD文件的實際位置。例如，假如你將文件chart-tags- 1.3beta.tld放在WebApp/WEB-INF/tlds中。現(xiàn)在，假如web.xml在web-app元素內(nèi)包含下列內(nèi)容。

1

<taglib>
2

<taglib-uri>/charts.tld</taglib-uri>
3

<taglib-location>
4

/WEB-INF/tlds/chart-tags-1.3beta.tld
5

</taglib-location>
6

</taglib>
7

給出這個說明后，JSP頁面可通過下面的簡化形式使用標簽庫。
<%@ taglib uri="/charts.tld" prefix="somePrefix" %>

14 指定應(yīng)用事件監(jiān)聽程序

應(yīng)用事件監(jiān)聽器程序是建立或修改servlet環(huán)境或會話對象時通知的類。它們是servlet規(guī)范的版本2.3中的新內(nèi)容。這里只簡單地說明用來向Web應(yīng)用注冊一個監(jiān)聽程序的web.xml的用法。
注冊一個監(jiān)聽程序涉及在web.xml的web-app元素內(nèi)放置一個listener元素。在listener元素內(nèi)，listener-class元素列出監(jiān)聽程序的完整的限定類名，如下所示：

1

<listener>
2

<listener-class>package.ListenerClass</listener-class>
3

</listener>

雖然listener元素的結(jié)構(gòu)很簡單，但請不要忘記，必須正確地給出web-app元素內(nèi)的子元素的次序。listener元素位于所有的servlet 元素之前以及所有filter-mapping元素之后。此外，因為應(yīng)用生存期監(jiān)聽程序是serlvet規(guī)范的2.3版本中的新內(nèi)容，所以必須使用 web.xml DTD的2.3版本，而不是2.2版本。
例如，程序清單5-20給出一個名為ContextReporter的簡單的監(jiān)聽程序，只要Web應(yīng)用的Servlet-Context建立（如裝載Web應(yīng)用）或消除（如服務(wù)器關(guān)閉）時，它就在標準輸出上顯示一條消息。程序清單5-21給出此監(jiān)聽程序注冊所需要的web.xml文件的一部分。

程序清單5-20 ContextReporterjava

1

package moreservlets;
2

3

import javax.servlet.*;
4

import java.util.*;
5

6

/** Simple listener that prints a report on the standard output
7

* when the ServletContext is created or destroyed.
8

* <P>
9

* Taken from More Servlets and JavaServer Pages
10

* from Prentice Hall and Sun Microsystems Press,
11

* http://www.moreservlets.com/.
12

*/
14

15

public class ContextReporter implements ServletContextListener {
16

public void contextInitialized(ServletContextEvent event) {
17

System.out.println("Context created on " +
18

new Date() + ".");
19

}
20

21

public void contextDestroyed(ServletContextEvent event) {
22

System.out.println("Context destroyed on " +
23

new Date() + ".");
24

}
25

}
26

程序清單5-21 web.xml（聲明一個監(jiān)聽程序的摘錄）

1

<?xml version="1.0" encoding="ISO-8859-1"?>
2

<!DOCTYPE web-app
3

PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
4

"http://java.sun.com/dtd/web-app_2_3.dtd">
5

6

<web-app>
7

<!--

-->
8

<filter-mapping> … </filter-mapping>
9

<listener>
10

<listener-class>package.ListenerClass</listener-class>
11

</listener>
12

</servlet>
13

<!--

-->
14

</web-app>
15

16

15 J2EE元素

本節(jié)描述用作J2EE環(huán)境組成部分的Web應(yīng)用的web.xml元素。這里將提供一個簡明的介紹，詳細內(nèi)容可以參閱http://java.sun.com/j2ee/j2ee-1_3-fr-spec.pdf的Java 2 Plantform Enterprise Edition版本1.3規(guī)范的第5章。
l distributable
distributable 元素指出，Web應(yīng)用是以這樣的方式編程的：即，支持集群的服務(wù)器可安全地在多個服務(wù)器上分布Web應(yīng)用。例如，一個可分布的應(yīng)用必須只使用 Serializable對象作為其HttpSession對象的屬性，而且必須避免用實例變量（字段）來實現(xiàn)持續(xù)性。distributable元素直接出現(xiàn)在discription元素之后，并且不包含子元素或數(shù)據(jù)，它只是一個如下的標志。
<distributable />
l resource-env-ref
resource -env-ref元素聲明一個與某個資源有關(guān)的管理對象。此元素由一個可選的description元素、一個resource-env-ref- name元素（一個相對于java:comp/env環(huán)境的JNDI名）以及一個resource-env-type元素（指定資源類型的完全限定的類），如下所示：

1

<resource-env-ref>
2

<resource-env-ref-name>
3

jms/StockQueue
4

</resource-env-ref-name>
5

<resource-env-ref-type>
6

javax.jms.Queue
7

</resource-env-ref-type>
8

</resource-env-ref>
9

l env-entry
env -entry元素聲明Web應(yīng)用的環(huán)境項。它由一個可選的description元素、一個env-entry-name元素（一個相對于java: comp/env環(huán)境JNDI名）、一個env-entry-value元素（項值）以及一個env-entry-type元素（java.lang程序包中一個類型的完全限定類名，java.lang.Boolean、java.lang.String等）組成。下面是一個例子：

1

<env-entry>
2

<env-entry-name>minAmout</env-entry-name>
3

<env-entry-value>100.00</env-entry-value>
4

<env-entry-type>minAmout</env-entry-type>
5

</env-entry>
6

l ejb-ref
ejb -ref元素聲明對一個EJB的主目錄的應(yīng)用。它由一個可選的description元素、一個ejb-ref-name元素（相對于java: comp/env的EJB應(yīng)用）、一個ejb-ref-type元素（bean的類型，Entity或Session）、一個home元素（bean的主目錄接口的完全限定名）、一個remote元素（bean的遠程接口的完全限定名）以及一個可選的ejb-link元素（當(dāng)前bean鏈接的另一個 bean的名稱）組成。
l ejb-local-ref
ejb-local-ref元素聲明一個EJB的本地主目錄的引用。除了用local-home代替home外，此元素具有與ejb-ref元素相同的屬性并以相同的方式使用。

posted on 2007-07-10 10:13 冰封的愛閱讀(749) 評論(0) 編輯收藏所屬分類: J2EE

新用戶注冊刷新評論列表


只有注冊用戶登錄后才能發(fā)表評論。




網(wǎng)站導(dǎo)航: 博客園 IT新聞 Chat2DB C++博客博問管理
相關(guān)文章: java日期操作及 Timer定時器大型B/S系統(tǒng)的并發(fā)問題定義一個內(nèi)部類的比較器，比較兩個對象并且進行排序 Spring+hibernate+DWR整合獲得漢字拼音首字母(java版) 根據(jù)拼音首字母查詢?nèi)嗣?C#版) java開源項目在 Java 應(yīng)用程序中計劃重復(fù)執(zhí)行的任務(wù)(轉(zhuǎn)) 如何使用ejb3持久化中callback EJB3 QL查詢

<

2025年7月

>

日

一

二

三

四

五

六

29

30

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

1

2

3

4

5

6

7

8

9

常用鏈接

留言簿(3)

隨筆檔案

文章分類

文章檔案

相冊

冰封的相冊

常用鏈接

留言簿(3)

隨筆檔案

文章分類

文章檔案

相冊

搜索

最新評論

閱讀排行榜

評論排行榜