溫馨提示×

您好,登錄后才能下訂單哦!

密碼登錄×
登錄注冊(cè)×
其他方式登錄
點(diǎn)擊 登錄注冊(cè) 即表示同意《億速云用戶服務(wù)條款》

怎么配置Web.xml

發(fā)布時(shí)間:2020-09-22 11:53:50 來(lái)源:億速云 閱讀:172 作者:小新 欄目:編程語(yǔ)言

小編給大家分享一下怎么配置Web.xml,相信大部分人都還不怎么了解,因此分享這篇文章給大家參考一下,希望大家閱讀完這篇文章后大有收獲,下面讓我們一起去了解一下吧!

1 定義頭和根元素

  部署描述符文件就像所有XML文件一樣,必須以一個(gè)XML頭開(kāi)始。這個(gè)頭聲明可以使用的XML版本并給出文件的字符編碼。
DOCYTPE聲明必須立即出現(xiàn)在此頭之后。這個(gè)聲明告訴服務(wù)器適用的servlet規(guī)范的版本(如2.2或2.3)并指定管理此文件其余部分內(nèi)容的語(yǔ)法的DTD(Document Type Definition,文檔類型定義)。
所有部署描述符文件的頂層(根)元素為web-app。請(qǐng)注意,XML元素不像HTML,他們是大小寫(xiě)敏感的。因此,web-App和WEB-APP都是不合法的,web-app必須用小寫(xiě)。

2 部署描述符文件內(nèi)的元素次序

  XML 元素不僅是大小寫(xiě)敏感的,而且它們還對(duì)出現(xiàn)在其他元素中的次序敏感。例如,XML頭必須是文件中的第一項(xiàng),DOCTYPE聲明必須是第二項(xiàng),而web- app元素必須是第三項(xiàng)。在web-app元素內(nèi),元素的次序也很重要。服務(wù)器不一定強(qiáng)制要求這種次序,但它們?cè)试S(實(shí)際上有些服務(wù)器就是這樣做的)完全拒絕執(zhí)行含有次序不正確的元素的Web應(yīng)用。這表示使用非標(biāo)準(zhǔn)元素次序的web.xml文件是不可移植的。
下面的列表給出了所有可直接出現(xiàn)在web-app元素內(nèi)的合法元素所必需的次序。例如,此列表說(shuō)明servlet元素必須出現(xiàn)在所有servlet-mapping元素之前。請(qǐng)注意,所有這些元素都是可選的。因此,可以省略掉某一元素,但不能把它放于不正確的位置。
l icon icon元素指出IDE和GUI工具用來(lái)表示W(wǎng)eb應(yīng)用的一個(gè)和兩個(gè)圖像文件的位置。
l display-name display-name元素提供GUI工具可能會(huì)用來(lái)標(biāo)記這個(gè)特定的Web應(yīng)用的一個(gè)名稱。
l description description元素給出與此有關(guān)的說(shuō)明性文本。
l context-param context-param元素聲明應(yīng)用范圍內(nèi)的初始化參數(shù)。
l filter 過(guò)濾器元素將一個(gè)名字與一個(gè)實(shí)現(xiàn)javax.servlet.Filter接口的類相關(guān)聯(lián)。
l filter-mapping 一旦命名了一個(gè)過(guò)濾器,就要利用filter-mapping元素把它與一個(gè)或多個(gè)servlet或JSP頁(yè)面相關(guān)聯(lián)。
l listener servlet API的版本2.3增加了對(duì)事件監(jiān)聽(tīng)程序的支持,事件監(jiān)聽(tīng)程序在建立、修改和刪除會(huì)話或servlet環(huán)境時(shí)得到通知。Listener元素指出事件監(jiān)聽(tīng)程序類。
l servlet 在向servlet或JSP頁(yè)面制定初始化參數(shù)或定制URL時(shí),必須首先命名servlet或JSP頁(yè)面。Servlet元素就是用來(lái)完成此項(xiàng)任務(wù)的。
l servlet-mapping 服務(wù)器一般為servlet提供一個(gè)缺省的URL:http://host/webAppPrefix/servlet/ServletName。但是,常常會(huì)更改這個(gè)URL,以便servlet可以訪問(wèn)初始化參數(shù)或更容易地處理相對(duì)URL。在更改缺省URL時(shí),使用servlet-mapping元素。
l session-config 如果某個(gè)會(huì)話在一定時(shí)間內(nèi)未被訪問(wèn),服務(wù)器可以拋棄它以節(jié)省內(nèi)存??赏ㄟ^(guò)使用HttpSession的setMaxInactiveInterval方法明確設(shè)置單個(gè)會(huì)話對(duì)象的超時(shí)值,或者可利用session-config元素制定缺省超時(shí)值。
l mime-mapping 如果Web應(yīng)用具有想到特殊的文件,希望能保證給他們分配特定的MIME類型,則mime-mapping元素提供這種保證。
l welcom-file-list welcome-file-list元素指示服務(wù)器在收到引用一個(gè)目錄名而不是文件名的URL時(shí),使用哪個(gè)文件。
l error-page error-page元素使得在返回特定HTTP狀態(tài)代碼時(shí),或者特定類型的異常被拋出時(shí),能夠制定將要顯示的頁(yè)面。
l taglib taglib元素對(duì)標(biāo)記庫(kù)描述符文件(Tag Libraryu Descriptor file)指定別名。此功能使你能夠更改TLD文件的位置,而不用編輯使用這些文件的JSP頁(yè)面。
l resource-env-ref resource-env-ref元素聲明與資源相關(guān)的一個(gè)管理對(duì)象。
l resource-ref resource-ref元素聲明一個(gè)資源工廠使用的外部資源。
l security-constraint security-constraint元素制定應(yīng)該保護(hù)的URL。它與login-config元素聯(lián)合使用
l login-config 用login-config元素來(lái)指定服務(wù)器應(yīng)該怎樣給試圖訪問(wèn)受保護(hù)頁(yè)面的用戶授權(quán)。它與sercurity-constraint元素聯(lián)合使用。
l security-role security-role元素給出安全角色的一個(gè)列表,這些角色將出現(xiàn)在servlet元素內(nèi)的security-role-ref元素的role-name子元素中。分別地聲明角色可使高級(jí)IDE處理安全信息更為容易。
l env-entry env-entry元素聲明Web應(yīng)用的環(huán)境項(xiàng)。
l ejb-ref ejb-ref元素聲明一個(gè)EJB的主目錄的引用。
l ejb-local-ref ejb-local-ref元素聲明一個(gè)EJB的本地主目錄的應(yīng)用。

3 分配名稱和定制的UL

在web.xml中完成的一個(gè)最常見(jiàn)的任務(wù)是對(duì)servlet或JSP頁(yè)面給出名稱和定制的URL。用servlet元素分配名稱,使用servlet-mapping元素將定制的URL與剛分配的名稱相關(guān)聯(lián)。
3.1 分配名稱
為了提供初始化參數(shù),對(duì)servlet或JSP頁(yè)面定義一個(gè)定制URL或分配一個(gè)安全角色,必須首先給servlet或JSP頁(yè)面一個(gè)名稱??赏ㄟ^(guò) servlet元素分配一個(gè)名稱。最常見(jiàn)的格式包括servlet-name和servlet-class子元素(在web-app元素內(nèi)),如下所示:

Xml代碼

<servlet>       <servlet-name>Test</servlet-name>       <servlet-class>moreservlets.TestServlet</servlet-class>   </servlet>   
<servlet><servlet-name>Test</servlet-name><servlet-class>moreservlets.TestServlet</servlet-class></servlet>

  這表示位于WEB-INF/classes/moreservlets/TestServlet的servlet已經(jīng)得到了注冊(cè)名Test。給 servlet一個(gè)名稱具有兩個(gè)主要的含義。首先,初始化參數(shù)、定制的URL模式以及其他定制通過(guò)此注冊(cè)名而不是類名引用此servlet。其次,可在 URL而不是類名中使用此名稱。因此,利用剛才給出的定義,URL http://host/webAppPrefix/servlet/Test 可用于 http://host/webAppPrefix/servlet/moreservlets.TestServlet 的場(chǎng)所。
請(qǐng)記?。篨ML元素不僅是大小寫(xiě)敏感的,而且定義它們的次序也很重要。例如,web-app元素內(nèi)所有servlet元素必須位于所有servlet- mapping元素(下一小節(jié)介紹)之前,而且還要位于5.6節(jié)和5.11節(jié)討論的與過(guò)濾器或文檔相關(guān)的元素(如果有的話)之前。類似地,servlet 的servlet-name子元素也必須出現(xiàn)在servlet-class之前。5.2節(jié)"部署描述符文件內(nèi)的元素次序"將詳細(xì)介紹這種必需的次序。
例如,程序清單5-1給出了一個(gè)名為TestServlet的簡(jiǎn)單servlet,它駐留在moreservlets程序包中。因?yàn)榇藄ervlet是扎根在一個(gè)名為deployDemo的目錄中的Web應(yīng)用的組成部分,所以TestServlet.class放在deployDemo/WEB- INF/classes/moreservlets中。程序清單5-2給出將放置在deployDemo/WEB-INF/內(nèi)的web.xml文件的一部分。此web.xml文件使用servlet-name和servlet-class元素將名稱Test與TestServlet.class相關(guān)聯(lián)。圖 5-1和圖5-2分別顯示利用缺省URL和注冊(cè)名調(diào)用TestServlet時(shí)的結(jié)果。

程序清單5-1 TestServlet.java

Java代碼

package moreservlets;       import java.io.*;    import javax.servlet.*;    import javax.servlet.http.*;       public class TestServlet extends HttpServlet {        public void doGet(HttpServletRequest request,    HttpServletResponse response)    throws ServletException, IOException {            response.setContentType("text/html");            PrintWriter out = response.getWriter();            String uri = request.getRequestURI();            out.println(ServletUtilities.headWithTitle("Test Servlet") +"<BODY BGCOLOR=\"#FDF5E6\">\n" +"<H2>URI: " + uri "</H2>\n" +"</BODY></HTML>");        }    }  
package moreservlets;import java.io.*;import javax.servlet.*;import javax.servlet.http.*;public class TestServlet extends HttpServlet {public void doGet(HttpServletRequest request,HttpServletResponse response)throws ServletException, IOException {response.setContentType("text/html");PrintWriter out = response.getWriter();String uri = request.getRequestURI();out.println(ServletUtilities.headWithTitle("Test Servlet") +"<BODY BGCOLOR=\"#FDF5E6\">\n" +"<H2>URI: " + uri "</H2>\n" +"</BODY></HTML>");}}

程序清單5-2 web.xml(說(shuō)明servlet名稱的摘錄)

Xml代碼

<?xml version="1.0" encoding="ISO-8859-1"?>   <!DOCTYPE web-app    PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"    "http://java.sun.com/dtd/web-app_2_3.dtd">   <web-app>   <!-- … -->   <servlet>       <servlet-name>Test</servlet-name>       <servlet-class>moreservlets.TestServlet</servlet-class>   </servlet>   <!-- … -->   </web-app>  
<?xml version="1.0" encoding="ISO-8859-1"?><!DOCTYPE web-appPUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN""http://java.sun.com/dtd/web-app_2_3.dtd"><web-app><!-- … --><servlet><servlet-name>Test</servlet-name><servlet-class>moreservlets.TestServlet</servlet-class></servlet><!-- … --></web-app>

3.2 定義定制的URL
大多數(shù)服務(wù)器具有一個(gè)缺省的serlvet URL:
host/webAppPrefix/servlet/packageName.ServletName。雖然在開(kāi)發(fā)中使用這個(gè)URL很方便,但是我們常常會(huì)希望另一個(gè)URL用于部署。例如,可能會(huì)需要一個(gè)出現(xiàn)在Web應(yīng)用頂層的URL(如,host/webAppPrefix/Anyname),并且在此URL中沒(méi)有servlet項(xiàng)。位于頂層的URL簡(jiǎn)化了相對(duì)URL的使用。此外,對(duì)許多開(kāi)發(fā)人員來(lái)說(shuō),頂層URL看上去比更長(zhǎng)更麻煩的缺省URL更簡(jiǎn)短。
事實(shí)上,有時(shí)需要使用定制的URL。比如,你可能想關(guān)閉缺省URL映射,以便更好地強(qiáng)制實(shí)施安全限制或防止用戶意外地訪問(wèn)無(wú)初始化參數(shù)的servlet。如果你禁止了缺省的URL,那么你怎樣訪問(wèn)servlet呢?這時(shí)只有使用定制的URL了。
為了分配一個(gè)定制的URL,可使用servlet-mapping元素及其servlet-name和url-pattern子元素。Servlet- name元素提供了一個(gè)任意名稱,可利用此名稱引用相應(yīng)的servlet;url-pattern描述了相對(duì)于Web應(yīng)用的根目錄的URL。url- pattern元素的值必須以斜杠(/)起始。
下面給出一個(gè)簡(jiǎn)單的web.xml摘錄,它允許使用URL host/webAppPrefix/UrlTest而不是host/webAppPrefix/servlet/Test或
host/webAppPrefix/servlet/moreservlets.TestServlet。請(qǐng)注意,仍然需要XML頭、 DOCTYPE聲明以及web-app封閉元素。此外,可回憶一下,XML元素出現(xiàn)地次序不是隨意的。特別是,需要把所有servlet元素放在所有 servlet-mapping元素之前。

Xml代碼

<servlet>       <servlet-name>Test</servlet-name>       <servlet-class>moreservlets.TestServlet</servlet-class>   </servlet>   <!-- ... -->   <servlet-mapping>       <servlet-name>Test</servlet-name>       <url-pattern>/UrlTest</url-pattern>   </servlet-mapping>  
<servlet><servlet-name>Test</servlet-name><servlet-class>moreservlets.TestServlet</servlet-class></servlet><!-- ... --><servlet-mapping><servlet-name>Test</servlet-name><url-pattern>/UrlTest</url-pattern></servlet-mapping>

URL模式還可以包含通配符。例如,下面的小程序指示服務(wù)器發(fā)送所有以Web應(yīng)用的URL前綴開(kāi)始,以..asp結(jié)束的請(qǐng)求到名為BashMS的servlet。

Xml代碼

<servlet>       <servlet-name>BashMS</servlet-name>       <servlet-class>msUtils.ASPTranslator</servlet-class>   </servlet>   <!-- ... -->   <servlet-mapping>       <servlet-name>BashMS</servlet-name>       <url-pattern>/*.asp</url-pattern>   </servlet-mapping>  
<servlet><servlet-name>BashMS</servlet-name><servlet-class>msUtils.ASPTranslator</servlet-class></servlet><!-- ... --><servlet-mapping><servlet-name>BashMS</servlet-name><url-pattern>/*.asp</url-pattern></servlet-mapping>

3.3 命名JSP頁(yè)面
  因?yàn)镴SP頁(yè)面要轉(zhuǎn)換成sevlet,自然希望就像命名servlet一樣命名JSP頁(yè)面。畢竟,JSP頁(yè)面可能會(huì)從初始化參數(shù)、安全設(shè)置或定制的URL中受益,正如普通的serlvet那樣。雖然JSP頁(yè)面的后臺(tái)實(shí)際上是servlet這句話是正確的,但存在一個(gè)關(guān)鍵的猜疑:即,你不知道JSP頁(yè)面的實(shí)際類名(因?yàn)橄到y(tǒng)自己挑選這個(gè)名字)。因此,為了命名JSP頁(yè)面,可將jsp-file元素替換為servlet-calss元素,如下所示:

Xml代碼

<servlet>       <servlet-name>Test</servlet-name>       <jsp-file>/TestPage.jsp</jsp-file>   </servlet>  
<servlet><servlet-name>Test</servlet-name><jsp-file>/TestPage.jsp</jsp-file></servlet>

  命名JSP頁(yè)面的原因與命名servlet的原因完全相同:即為了提供一個(gè)與定制設(shè)置(如,初始化參數(shù)和安全設(shè)置)一起使用的名稱,并且,以便能更改激活 JSP頁(yè)面的URL(比方說(shuō),以便多個(gè)URL通過(guò)相同頁(yè)面得以處理,或者從URL中去掉.jsp擴(kuò)展名)。但是,在設(shè)置初始化參數(shù)時(shí),應(yīng)該注意,JSP頁(yè)面是利用jspInit方法,而不是init方法讀取初始化參數(shù)的。
例如,程序清單5-3給出一個(gè)名為TestPage.jsp的簡(jiǎn)單JSP頁(yè)面,它的工作只是打印出用來(lái)激活它的URL的本地部分。TestPage.jsp放置在deployDemo應(yīng)用的頂層。程序清單5-4給出了用來(lái)分配一個(gè)注冊(cè)名PageName,然后將此注冊(cè)名與http://host/webAppPrefix/UrlTest2/anything 形式的URL相關(guān)聯(lián)的web.xml文件(即,deployDemo/WEB-INF/web.xml)的一部分。

程序清單5-3 TestPage.jsp

Html代碼

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">   <HTML>   <HEAD>   <TITLE>JSP Test Page</TITLE>   </HEAD>   <BODY BGCOLOR="#FDF5E6">   <H2>URI: <%= request.getRequestURI() %></H2>   </BODY>   </HTML>  
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><HTML><HEAD><TITLE>JSP Test Page</TITLE></HEAD><BODY BGCOLOR="#FDF5E6"><H2>URI: <%= request.getRequestURI() %></H2></BODY></HTML>

程序清單5-4 web.xml(說(shuō)明JSP頁(yè)命名的摘錄)

Xml代碼

<?xml version="1.0" encoding="ISO-8859-1"?>   <!DOCTYPE web-app    PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"    "http://java.sun.com/dtd/web-app_2_3.dtd">   <web-app>   <!-- ... -->   <servlet>       <servlet-name>PageName</servlet-name>       <jsp-file>/TestPage.jsp</jsp-file>   </servlet>   <!-- ... -->   <servlet-mapping>       <servlet-name> PageName </servlet-name>       <url-pattern>/UrlTest2/*</url-pattern>   </servlet-mapping>   <!-- ... -->   </web-app>  
<?xml version="1.0" encoding="ISO-8859-1"?><!DOCTYPE web-appPUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN""http://java.sun.com/dtd/web-app_2_3.dtd"><web-app><!-- ... --><servlet><servlet-name>PageName</servlet-name><jsp-file>/TestPage.jsp</jsp-file></servlet><!-- ... --><servlet-mapping><servlet-name> PageName </servlet-name><url-pattern>/UrlTest2/*</url-pattern></servlet-mapping><!-- ... --></web-app>

4 禁止激活器servlet

  對(duì)servlet或JSP頁(yè)面建立定制URL的一個(gè)原因是,這樣做可以注冊(cè)從 init(servlet)或jspInit(JSP頁(yè)面)方法中讀取得初始化參數(shù)。但是,初始化參數(shù)只在是利用定制URL模式或注冊(cè)名訪問(wèn) servlet或JSP頁(yè)面時(shí)可以使用,用缺省URL http://host/webAppPrefix/servlet/ServletName 訪問(wèn)時(shí)不能使用。因此,你可能會(huì)希望關(guān)閉缺省URL,這樣就不會(huì)有人意外地調(diào)用初始化servlet了。這個(gè)過(guò)程有時(shí)稱為禁止激活器servlet,因?yàn)槎鄶?shù)服務(wù)器具有一個(gè)用缺省的servlet URL注冊(cè)的標(biāo)準(zhǔn)servlet,并激活缺省的URL應(yīng)用的實(shí)際servlet。
  有兩種禁止此缺省URL的主要方法:
l 在每個(gè)Web應(yīng)用中重新映射/servlet/模式。
l 全局關(guān)閉激活器servlet。
重要的是應(yīng)該注意到,雖然重新映射每個(gè)Web應(yīng)用中的/servlet/模式比徹底禁止激活servlet所做的工作更多,但重新映射可以用一種完全可移植的方式來(lái)完成。相反,全局禁止激活器servlet完全是針對(duì)具體機(jī)器的,事實(shí)上有的服務(wù)器(如ServletExec)沒(méi)有這樣的選擇。下面的討論對(duì)每個(gè)Web應(yīng)用重新映射/servlet/ URL模式的策略。后面提供在Tomcat中全局禁止激活器servlet的詳細(xì)內(nèi)容。

4.1 重新映射/servlet/URL模式
  在一個(gè)特定的Web應(yīng)用中禁止以http://host/webAppPrefix/servlet/ 開(kāi)始的URL的處理非常簡(jiǎn)單。所需做的事情就是建立一個(gè)錯(cuò)誤消息servlet,并使用前一節(jié)討論的url-pattern元素將所有匹配請(qǐng)求轉(zhuǎn)向該 servlet。只要簡(jiǎn)單地使用:

Xml代碼

<url-pattern>/servlet/*</url-pattern>  
<url-pattern>/servlet/*</url-pattern>

作為servlet-mapping元素中的模式即可。

例如,程序清單5-5給出了將SorryServlet servlet(程序清單5-6)與所有以http://host/webAppPrefix/servlet/ 開(kāi)頭的URL相關(guān)聯(lián)的部署描述符文件的一部分。

程序清單5-5 web.xml(說(shuō)明JSP頁(yè)命名的摘錄)

Xml代碼

<?xml version="1.0" encoding="ISO-8859-1"?>   <!DOCTYPE web-app    PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"    "http://java.sun.com/dtd/web-app_2_3.dtd">   <web-app>   <!-- ... -->   <servlet>       <servlet-name>Sorry</servlet-name>       <servlet-class>moreservlets.SorryServlet</servlet-class>   </servlet>   <!-- ... -->   <servlet-mapping>       <servlet-name> Sorry </servlet-name>       <url-pattern>/servlet/*</url-pattern>   </servlet-mapping>   <!-- ... -->   </web-app>  
<?xml version="1.0" encoding="ISO-8859-1"?><!DOCTYPE web-appPUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN""http://java.sun.com/dtd/web-app_2_3.dtd"><web-app><!-- ... --><servlet><servlet-name>Sorry</servlet-name><servlet-class>moreservlets.SorryServlet</servlet-class></servlet><!-- ... --><servlet-mapping><servlet-name> Sorry </servlet-name><url-pattern>/servlet/*</url-pattern></servlet-mapping><!-- ... --></web-app>

程序清單5-6 SorryServlet.java

Java代碼

package moreservlets;       import java.io.*;    import javax.servlet.*;    import javax.servlet.http.*;       public class SorryServlet extends HttpServlet {        public void doGet(HttpServletRequest request,    HttpServletResponse response)    throws ServletException, IOException {            response.setContentType("text/html");            PrintWriter out = response.getWriter();            String title = "Invoker Servlet Disabled.";            out.println(ServletUtilities.headWithTitle(title) +"<BODY BGCOLOR=\"#FDF5E6\">\n" +"<H2>" + title + "</H2>\n" +    "Sorry, access to servlets by means of\n" +"URLs that begin with\n" +"http://host/webAppPrefix/servlet//n" +"has been disabled.\n" + "</BODY></HTML>");            }           public void doPost(HttpServletRequest request,HttpServletResponse response)throws ServletException, IOException {            doGet(request, response);        }    }  
package moreservlets;import java.io.*;import javax.servlet.*;import javax.servlet.http.*;public class SorryServlet extends HttpServlet {public void doGet(HttpServletRequest request,HttpServletResponse response)throws ServletException, IOException {response.setContentType("text/html");PrintWriter out = response.getWriter();String title = "Invoker Servlet Disabled.";out.println(ServletUtilities.headWithTitle(title) +"<BODY BGCOLOR=\"#FDF5E6\">\n" +"<H2>" + title + "</H2>\n" +"Sorry, access to servlets by means of\n" +"URLs that begin with\n" +"http://host/webAppPrefix/servlet//n" +"has been disabled.\n" + "</BODY></HTML>");}public void doPost(HttpServletRequest request,HttpServletResponse response)throws ServletException, IOException {doGet(request, response);}}

4.2 全局禁止激活器:Tomcat
Tomcat 4中用來(lái)關(guān)閉缺省URL的方法與Tomcat 3中所用的很不相同。下面介紹這兩種方法:

1.禁止激活器: Tomcat 4
Tomcat 4用與前面相同的方法關(guān)閉激活器servlet,即利用web.xml中的url-mapping元素進(jìn)行關(guān)閉。不同之處在于Tomcat使用了放在 install_dir/conf中的一個(gè)服務(wù)器專用的全局web.xml文件,而前面使用的是存放在每個(gè)Web應(yīng)用的WEB-INF目錄中的標(biāo)準(zhǔn) web.xml文件。
因此,為了在Tomcat 4中關(guān)閉激活器servlet,只需在install_dir/conf/web.xml中簡(jiǎn)單地注釋出/servlet/* URL映射項(xiàng)即可,如下所示:

Xml代碼

<servlet-mapping>       <servlet-name>invoker</servlet-name>       <url-pattern>/servlet/*</url-pattern>   </servlet-mapping>  
<servlet-mapping><servlet-name>invoker</servlet-name><url-pattern>/servlet/*</url-pattern></servlet-mapping>

再次提醒,應(yīng)該注意這個(gè)項(xiàng)是位于存放在install_dir/conf的Tomcat專用的web.xml文件中的,此文件不是存放在每個(gè)Web應(yīng)用的WEB-INF目錄中的標(biāo)準(zhǔn)web.xml。

2.禁止激活器:Tomcat3
在Apache Tomcat的版本3中,通過(guò)在install_dir/conf/server.xml中注釋出InvokerInterceptor項(xiàng)全局禁止缺省 servlet URL。例如,下面是禁止使用缺省servlet URL的server.xml文件的一部分。

Xml代碼

<!--    <RequsetInterceptor className="org.apache.tomcat.request.InvokerInterceptor" debug="0" prefix="/servlet/" />   -->  
<!--<RequsetInterceptor className="org.apache.tomcat.request.InvokerInterceptor" debug="0" prefix="/servlet/" />-->

5 初始化和預(yù)裝載servlet與JSP頁(yè)面

這里討論控制servlet和JSP頁(yè)面的啟動(dòng)行為的方法。特別是,說(shuō)明了怎樣分配初始化參數(shù)以及怎樣更改服務(wù)器生存期中裝載servlet和JSP頁(yè)面的時(shí)刻。

5.1 分配servlet初始化參數(shù)
利用init-param元素向servlet提供初始化參數(shù),init-param元素具有param-name和param-value子元素。例如,在下面的例子中,如果initServlet servlet是利用它的注冊(cè)名(InitTest)訪問(wèn)的,它將能夠從其方法中調(diào)用getServletConfig(). getInitParameter("param1")獲得"Value 1",調(diào)用getServletConfig().getInitParameter("param2")獲得"2"。

Xml代碼

<servlet>       <servlet-name>InitTest</servlet-name>       <servlet-class>moreservlets.InitServlet</servlet-class>           <init-param>               <param-name>param1</param-name>               <param-value>value1</param-value>           </init-param>           <init-param>               <param-name>param2</param-name>               <param-value>2</param-value>           </init-param>   </servlet>  
<servlet><servlet-name>InitTest</servlet-name><servlet-class>moreservlets.InitServlet</servlet-class><init-param><param-name>param1</param-name><param-value>value1</param-value></init-param><init-param><param-name>param2</param-name><param-value>2</param-value></init-param></servlet>

在涉及初始化參數(shù)時(shí),有幾點(diǎn)需要注意:
l 返回值。GetInitParameter的返回值總是一個(gè)String。因此,在前一個(gè)例子中,可對(duì)param2使用Integer.parseInt獲得一個(gè)int。
l JSP中的初始化。JSP頁(yè)面使用jspInit而不是init。JSP頁(yè)面還需要使用jsp-file元素代替servlet-class。
l 缺省URL。初始化參數(shù)只在通過(guò)它們的注冊(cè)名或與它們注冊(cè)名相關(guān)的定制URL模式訪問(wèn)Servlet時(shí)可以使用。因此,在這個(gè)例子中,param1和 param2初始化參數(shù)將能夠在使用URL http://host/webAppPrefix/servlet/InitTest 時(shí)可用,但在使用URL http://host/webAppPrefix/servlet/myPackage.InitServlet 時(shí)不能使用。
例如,程序清單5-7給出一個(gè)名為InitServlet的簡(jiǎn)單servlet,它使用init方法設(shè)置firstName和emailAddress字段。程序清單5-8給出分配名稱InitTest給servlet的web.xml文件。

程序清單5-7 InitServlet.java

Java代碼

package moreservlets;       import java.io.*;    import javax.servlet.*;    import javax.servlet.http.*;       public class InitServlet extends HttpServlet {        private String firstName, emailAddress;           public void init() {            ServletConfig config = getServletConfig();            firstName = config.getInitParameter("firstName");            emailAddress = config.getInitParameter("emailAddress");        }           public void doGet(HttpServletRequest request,HttpServletResponse response)throws ServletException, IOException {            response.setContentType("text/html");            PrintWriter out = response.getWriter();            String uri = request.getRequestURI();            out.println(ServletUtilities.headWithTitle("Init Servlet") +"<BODY BGCOLOR=\"#FDF5E6\">\n" +"<H2>Init Parameters:</H2>\n" +"<UL>\n" +"<LI>First name: " + firstName + "\n" +"<LI>Email address: " + emailAddress + "\n" +"</UL>\n" + "</BODY></HTML>");        }    }  
package moreservlets;import java.io.*;import javax.servlet.*;import javax.servlet.http.*;public class InitServlet extends HttpServlet {private String firstName, emailAddress;public void init() {ServletConfig config = getServletConfig();firstName = config.getInitParameter("firstName");emailAddress = config.getInitParameter("emailAddress");}public void doGet(HttpServletRequest request,HttpServletResponse response)throws ServletException, IOException {response.setContentType("text/html");PrintWriter out = response.getWriter();String uri = request.getRequestURI();out.println(ServletUtilities.headWithTitle("Init Servlet") +"<BODY BGCOLOR=\"#FDF5E6\">\n" +"<H2>Init Parameters:</H2>\n" +"<UL>\n" +"<LI>First name: " + firstName + "\n" +"<LI>Email address: " + emailAddress + "\n" +"</UL>\n" + "</BODY></HTML>");}}

程序清單5-8 web.xml(說(shuō)明初始化參數(shù)的摘錄)

Xml代碼

<?xml version="1.0" encoding="ISO-8859-1"?>   <!DOCTYPE web-app    PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"    "http://java.sun.com/dtd/web-app_2_3.dtd">      <web-app>   <!-- ... -->   <servlet>       <servlet-name>InitTest</servlet-name>           <servlet-class>moreservlets.InitServlet</servlet-class>           <init-param>               <param-name>firstName</param-name>               <param-value>Larry</param-value>           </init-param>           <init-param>               <param-name>emailAddress</param-name>               <param-value>Ellison@Microsoft.com</param-value>           </init-param>       </servlet>   <!-- ... -->   </web-app>  
<?xml version="1.0" encoding="ISO-8859-1"?><!DOCTYPE web-appPUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN""http://java.sun.com/dtd/web-app_2_3.dtd"><web-app><!-- ... --><servlet><servlet-name>InitTest</servlet-name><servlet-class>moreservlets.InitServlet</servlet-class><init-param><param-name>firstName</param-name><param-value>Larry</param-value></init-param><init-param><param-name>emailAddress</param-name><param-value>Ellison@Microsoft.com</param-value></init-param></servlet><!-- ... --></web-app>

5.2 分配JSP初始化參數(shù)
給JSP頁(yè)面提供初始化參數(shù)在三個(gè)方面不同于給servlet提供初始化參數(shù)。
1)使用jsp-file而不是servlet-class。因此,WEB-INF/web.xml文件的servlet元素如下所示:

Xml代碼

<servlet>       <servlet-name>PageName</servlet-name>       <jsp-file>/RealPage.jsp</jsp-file>           <init-param>               <param-name>...</param-name>               <param-value>...</param-value>           </init-param>   ...    </servlet>  
<servlet><servlet-name>PageName</servlet-name><jsp-file>/RealPage.jsp</jsp-file><init-param><param-name>...</param-name><param-value>...</param-value></init-param>...</servlet>

2) 幾乎總是分配一個(gè)明確的URL模式。對(duì)servlet,一般相應(yīng)地使用以http://host/webAppPrefix/servlet/ 開(kāi)始的缺省URL。只需記住,使用注冊(cè)名而不是原名稱即可。這對(duì)于JSP頁(yè)面在技術(shù)上也是合法的。例如,在上面給出的例子中,可用URL http://host/webAppPrefix/servlet/PageName 訪問(wèn)RealPage.jsp的對(duì)初始化參數(shù)具有訪問(wèn)權(quán)的版本。但在用于JSP頁(yè)面時(shí),許多用戶似乎不喜歡應(yīng)用常規(guī)的servlet的URL。此外,如果 JSP頁(yè)面位于服務(wù)器為其提供了目錄清單的目錄中(如,一個(gè)既沒(méi)有index.html也沒(méi)有index.jsp文件的目錄),則用戶可能會(huì)連接到此 JSP頁(yè)面,單擊它,從而意外地激活未初始化的頁(yè)面。因此,好的辦法是使用url-pattern(5.3節(jié))將JSP頁(yè)面的原URL與注冊(cè)的 servlet名相關(guān)聯(lián)。這樣,客戶機(jī)可使用JSP頁(yè)面的普通名稱,但仍然激活定制的版本。例如,給定來(lái)自項(xiàng)目1的servlet定義,可使用下面的 servlet-mapping定義:

Xml代碼

<servlet-mapping>       <servlet-name>PageName</servlet-name>       <url-pattern>/RealPage.jsp</url-pattern>   </servlet-mapping>  
<servlet-mapping><servlet-name>PageName</servlet-name><url-pattern>/RealPage.jsp</url-pattern></servlet-mapping>

3)JSP頁(yè)使用jspInit而不是init。自動(dòng)從JSP頁(yè)面建立的servlet或許已經(jīng)使用了inti方法。因此,使用JSP聲明提供一個(gè)init方法是不合法的,必須制定jspInit方法。
為了說(shuō)明初始化JSP頁(yè)面的過(guò)程,程序清單5-9給出了一個(gè)名為InitPage.jsp的JSP頁(yè)面,它包含一個(gè)jspInit方法且放置于 deployDemo Web應(yīng)用層次結(jié)構(gòu)的頂層。一般,http://host/deployDemo/InitPage.jsp 形式的URL將激活此頁(yè)面的不具有初始化參數(shù)訪問(wèn)權(quán)的版本,從而將對(duì)firstName和emailAddress變量顯示null。但是, web.xml文件(程序清單5-10)分配了一個(gè)注冊(cè)名,然后將該注冊(cè)名與URL模式/InitPage.jsp相關(guān)聯(lián)。

程序清單5-9 InitPage.jsp

Html代碼

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">   <HTML>   <HEAD><TITLE>JSP Init Test</TITLE></HEAD>   <BODY BGCOLOR="#FDF5E6">   <H2>Init Parameters:</H2>   <UL>   <LI>First name: <%= firstName %>   <LI>Email address: <%= emailAddress %>   </UL>   </BODY></HTML>   <%!    private String firstName, emailAddress;       public void jspInit() {    ServletConfig config = getServletConfig();    firstName = config.getInitParameter("firstName");    emailAddress = config.getInitParameter("emailAddress");    }    %>  
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><HTML><HEAD><TITLE>JSP Init Test</TITLE></HEAD><BODY BGCOLOR="#FDF5E6"><H2>Init Parameters:</H2><UL><LI>First name: <%= firstName %><LI>Email address: <%= emailAddress %></UL></BODY></HTML><%!private String firstName, emailAddress;public void jspInit() {ServletConfig config = getServletConfig();firstName = config.getInitParameter("firstName");emailAddress = config.getInitParameter("emailAddress");}%>

程序清單5-10 web.xml(說(shuō)明JSP頁(yè)面的init參數(shù)的摘錄)

Xml代碼

<?xml version="1.0" encoding="ISO-8859-1"?>   <!DOCTYPE web-app    PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"    "http://java.sun.com/dtd/web-app_2_3.dtd">   <web-app>   <!-- ... -->       <servlet>           <servlet-name>InitPage</servlet-name>               <jsp-file>/InitPage.jsp</jsp-file>                   <init-param>                       <param-name>firstName</param-name>                       <param-value>Bill</param-value>                   </init-param>                   <init-param>                       <param-name>emailAddress</param-name>                       <param-value>gates@oracle.com</param-value>                   </init-param>           </servlet>   <!-- ... -->         <servlet-mapping>           <servlet-name> InitPage</servlet-name>           <url-pattern>/InitPage.jsp</url-pattern>       </servlet-mapping>   <!-- ... -->   </web-app>  
<?xml version="1.0" encoding="ISO-8859-1"?><!DOCTYPE web-appPUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN""http://java.sun.com/dtd/web-app_2_3.dtd"><web-app><!-- ... --><servlet><servlet-name>InitPage</servlet-name><jsp-file>/InitPage.jsp</jsp-file><init-param><param-name>firstName</param-name><param-value>Bill</param-value></init-param><init-param><param-name>emailAddress</param-name><param-value>gates@oracle.com</param-value></init-param></servlet><!-- ... --><servlet-mapping><servlet-name> InitPage</servlet-name><url-pattern>/InitPage.jsp</url-pattern></servlet-mapping><!-- ... --></web-app>

5.3 提供應(yīng)用范圍內(nèi)的初始化參數(shù)
一般,對(duì)單個(gè)地servlet或JSP頁(yè)面分配初始化參數(shù)。指定的servlet或JSP頁(yè)面利用ServletConfig的getInitParameter方法讀取這些參數(shù)。但是,在某些情形下,希望提供可由任意servlet或JSP頁(yè)面借助ServletContext的getInitParameter方法讀取的系統(tǒng)范圍內(nèi)的初始化參數(shù)。
可利用context-param元素聲明這些系統(tǒng)范圍內(nèi)的初始化值。context-param元素應(yīng)該包含param-name、param-value以及可選的description子元素,如下所示:

Xml代碼

<context-param>       <param-name>support-email</param-name>       <param-value>blackhole@mycompany.com</param-value>   </context-param>  
<context-param><param-name>support-email</param-name><param-value>blackhole@mycompany.com</param-value></context-param>

可回憶一下,為了保證可移植性,web.xml內(nèi)的元素必須以正確的次序聲明。但這里應(yīng)該注意,context-param元素必須出現(xiàn)任意與文檔有關(guān)的元素(icon、display-name或description)之后及filter、filter-mapping、listener或 servlet元素之前。

5.4 在服務(wù)器啟動(dòng)時(shí)裝載servlet
假如servlet或JSP頁(yè)面有一個(gè)要花很長(zhǎng)時(shí)間執(zhí)行的init (servlet)或jspInit(JSP)方法。例如,假如init或jspInit方法從某個(gè)數(shù)據(jù)庫(kù)或ResourceBundle查找產(chǎn)量。這種情況下,在第一個(gè)客戶機(jī)請(qǐng)求時(shí)裝載servlet的缺省行為將對(duì)第一個(gè)客戶機(jī)產(chǎn)生較長(zhǎng)時(shí)間的延遲。因此,可利用servlet的load-on- startup元素規(guī)定服務(wù)器在第一次啟動(dòng)時(shí)裝載servlet。下面是一個(gè)例子。

Xml代碼

<servlet>       <servlet-name> … </servlet-name>       <servlet-class> … </servlet-class> <!-- Or jsp-file -->   <load-on-startup/>   </servlet>  
<servlet><servlet-name> … </servlet-name><servlet-class> … </servlet-class> <!-- Or jsp-file --><load-on-startup/></servlet>

可以為此元素體提供一個(gè)整數(shù)而不是使用一個(gè)空的load-on-startup。想法是服務(wù)器應(yīng)該在裝載較大數(shù)目的servlet或JSP頁(yè)面之前裝載較少數(shù)目的servlet或JSP頁(yè)面。例如,下面的servlet項(xiàng)(放置在Web應(yīng)用的WEB-INF目錄下的web.xml文件中的web-app元素內(nèi))將指示服務(wù)器首先裝載和初始化SearchServlet,然后裝載和初始化由位于Web應(yīng)用的result目錄中的index.jsp文件產(chǎn)生的 servlet。

Xml代碼

<servlet>       <servlet-name>Search</servlet-name>       <servlet-class>myPackage.SearchServlet</servlet-class> <!-- Or jsp-file -->           <load-on-startup>1</load-on-startup>   /servlet>   <servlet>           <servlet-name>Results</servlet-name>           <servlet-class>/results/index.jsp</servlet-class> <!-- Or jsp-file -->           <load-on-startup>2</load-on-startup>   </servlet>  
<servlet><servlet-name>Search</servlet-name><servlet-class>myPackage.SearchServlet</servlet-class> <!-- Or jsp-file --><load-on-startup>1</load-on-startup>/servlet><servlet><servlet-name>Results</servlet-name><servlet-class>/results/index.jsp</servlet-class> <!-- Or jsp-file --><load-on-startup>2</load-on-startup></servlet>

6 聲明過(guò)濾器

servlet版本2.3引入了過(guò)濾器的概念。雖然所有支持servlet API版本2.3的服務(wù)器都支持過(guò)濾器,但為了使用與過(guò)濾器有關(guān)的元素,必須在web.xml中使用版本2.3的DTD。
過(guò)濾器可截取和修改進(jìn)入一個(gè)servlet或JSP頁(yè)面的請(qǐng)求或從一個(gè)servlet或JSP頁(yè)面發(fā)出的相應(yīng)。在執(zhí)行一個(gè)servlet或JSP頁(yè)面之前,必須執(zhí)行第一個(gè)相關(guān)的過(guò)濾器的doFilter方法。在該過(guò)濾器對(duì)其FilterChain對(duì)象調(diào)用doFilter時(shí),執(zhí)行鏈中的下一個(gè)過(guò)濾器。如果沒(méi)有其他過(guò)濾器,servlet或JSP頁(yè)面被執(zhí)行。過(guò)濾器具有對(duì)到來(lái)的ServletRequest對(duì)象的全部訪問(wèn)權(quán),因此,它們可以查看客戶機(jī)名、查找到來(lái)的cookie等。為了訪問(wèn)servlet或JSP頁(yè)面的輸出,過(guò)濾器可將響應(yīng)對(duì)象包裹在一個(gè)替身對(duì)象(stand-in object)中,比方說(shuō)把輸出累加到一個(gè)緩沖區(qū)。在調(diào)用FilterChain對(duì)象的doFilter方法之后,過(guò)濾器可檢查緩沖區(qū),如有必要,就對(duì)它進(jìn)行修改,然后傳送到客戶機(jī)。
例如,程序清單5-11帝國(guó)難以了一個(gè)簡(jiǎn)單的過(guò)濾器,只要訪問(wèn)相關(guān)的servlet或JSP頁(yè)面,它就截取請(qǐng)求并在標(biāo)準(zhǔn)輸出上打印一個(gè)報(bào)告(開(kāi)發(fā)過(guò)程中在桌面系統(tǒng)上運(yùn)行時(shí),大多數(shù)服務(wù)器都可以使用這個(gè)過(guò)濾器)。

程序清單5-11 ReportFilter.java

Java代碼

package moreservlets;       import java.io.*;    import javax.servlet.*;    import javax.servlet.http.*;    import java.util.*;       public class ReportFilter implements Filter {        public void doFilter(ServletRequest request,ServletResponse response,FilterChain chain)throws ServletException, IOException {            HttpServletRequest req = (HttpServletRequest)request;            System.out.println(req.getRemoteHost() +" tried to access " +req.getRequestURL() +" on " + new Date() + ".");            chain.doFilter(request,response);        }           public void init(FilterConfig config)throws ServletException {}           public void destroy() {}    }  
package moreservlets;import java.io.*;import javax.servlet.*;import javax.servlet.http.*;import java.util.*;public class ReportFilter implements Filter {public void doFilter(ServletRequest request,ServletResponse response,FilterChain chain)throws ServletException, IOException {HttpServletRequest req = (HttpServletRequest)request;System.out.println(req.getRemoteHost() +" tried to access " +req.getRequestURL() +" on " + new Date() + ".");chain.doFilter(request,response);}public void init(FilterConfig config)throws ServletException {}public void destroy() {}}

一旦建立了一個(gè)過(guò)濾器,可以在web.xml中利用filter元素以及filter-name(任意名稱)、file-class(完全限定的類名)和(可選的)init-params子元素聲明它。請(qǐng)注意,元素在web.xml的web-app元素中出現(xiàn)的次序不是任意的;允許服務(wù)器(但不是必需的)強(qiáng)制所需的次序,并且實(shí)際中有些服務(wù)器也是這樣做的。但這里要注意,所有filter元素必須出現(xiàn)在任意filter-mapping元素之前, filter-mapping元素又必須出現(xiàn)在所有servlet或servlet-mapping元素之前。
例如,給定上述的ReportFilter類,可在web.xml中作出下面的filter聲明。它把名稱Reporter與實(shí)際的類ReportFilter(位于moreservlets程序包中)相關(guān)聯(lián)。

Xml代碼

<filter>       <filter-name>Reporter</filter-name>       <filter-class>moresevlets.ReportFilter</filter-class>   </filter>  
<filter><filter-name>Reporter</filter-name><filter-class>moresevlets.ReportFilter</filter-class></filter>

一旦命名了一個(gè)過(guò)濾器,可利用filter-mapping元素把它與一個(gè)或多個(gè)servlet或JSP頁(yè)面相關(guān)聯(lián)。關(guān)于此項(xiàng)工作有兩種選擇。
首先,可使用filter-name和servlet-name子元素把此過(guò)濾器與一個(gè)特定的servlet名(此servlet名必須稍后在相同的 web.xml文件中使用servlet元素聲明)關(guān)聯(lián)。例如,下面的程序片斷指示系統(tǒng)只要利用一個(gè)定制的URL訪問(wèn)名為SomeServletName 的servlet或JSP頁(yè)面,就運(yùn)行名為Reporter的過(guò)濾器。

Xml代碼

<filter-mapping>       <filter-name>Reporter</filter-name>       <servlet-name>SomeServletName</servlet-name>   </filter-mapping>  
<filter-mapping><filter-name>Reporter</filter-name><servlet-name>SomeServletName</servlet-name></filter-mapping>

其次,可利用filter-name和url-pattern子元素將過(guò)濾器與一組servlet、JSP頁(yè)面或靜態(tài)內(nèi)容相關(guān)聯(lián)。例如,相面的程序片段指示系統(tǒng)只要訪問(wèn)Web應(yīng)用中的任意URL,就運(yùn)行名為Reporter的過(guò)濾器。

Xml代碼

<filter-mapping>       <filter-name>Reporter</filter-name>       <url-pattern>/*</url-pattern>   </filter-mapping>  
<filter-mapping><filter-name>Reporter</filter-name><url-pattern>/*</url-pattern></filter-mapping>

例如,程序清單5-12給出了將ReportFilter過(guò)濾器與名為PageName的servlet相關(guān)聯(lián)的web.xml文件的一部分。名字 PageName依次又與一個(gè)名為TestPage.jsp的JSP頁(yè)面以及以模式http: //host/webAppPrefix/UrlTest2/ 開(kāi)頭的URL相關(guān)聯(lián)。TestPage.jsp的源代碼已經(jīng)JSP頁(yè)面命名的談?wù)撛谇懊娴?節(jié)"分配名稱和定制的URL"中給出。事實(shí)上,程序清單5- 12中的servlet和servlet-name項(xiàng)從該節(jié)原封不動(dòng)地拿過(guò)來(lái)的。給定這些web.xml項(xiàng),可看到下面的標(biāo)準(zhǔn)輸出形式的調(diào)試報(bào)告(換行是為了容易閱讀)。

程序清單5-12 Web.xml(說(shuō)明filter用法的摘錄)

Xml代碼

<?xml version="1.0" encoding="ISO-8859-1"?>   <!DOCTYPE web-app    PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"    "http://java.sun.com/dtd/web-app_2_3.dtd">   <web-app>       <filter>           <filter-name>Reporter</filter-name>           <filter-class>moresevlets.ReportFilter</filter-class>       </filter>       <!-- ... -->       <filter-mapping>           <filter-name>Reporter</filter-name>           <servlet-name>PageName</servlet-name>       </filter-mapping>   <!-- ... -->       <servlet>           <servlet-name>PageName</servlet-name>           <jsp-file>/RealPage.jsp</jsp-file>       </servlet>   <!-- ... -->       <servlet-mapping>           <servlet-name> PageName </servlet-name>           <url-pattern>/UrlTest2/*</url-pattern>           </servlet-mapping>   <!-- ... -->   </web-app>  
<?xml version="1.0" encoding="ISO-8859-1"?><!DOCTYPE web-appPUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN""http://java.sun.com/dtd/web-app_2_3.dtd"><web-app><filter><filter-name>Reporter</filter-name><filter-class>moresevlets.ReportFilter</filter-class></filter><!-- ... --><filter-mapping><filter-name>Reporter</filter-name><servlet-name>PageName</servlet-name></filter-mapping><!-- ... --><servlet><servlet-name>PageName</servlet-name><jsp-file>/RealPage.jsp</jsp-file></servlet><!-- ... --><servlet-mapping><servlet-name> PageName </servlet-name><url-pattern>/UrlTest2/*</url-pattern></servlet-mapping><!-- ... --></web-app>

7 指定歡迎頁(yè)

假如用戶提供了一個(gè)像http: //host/webAppPrefix/directoryName/ 這樣的包含一個(gè)目錄名但沒(méi)有包含文件名的URL,會(huì)發(fā)生什么事情呢?用戶能得到一個(gè)目錄表?一個(gè)錯(cuò)誤?還是標(biāo)準(zhǔn)文件的內(nèi)容?如果得到標(biāo)準(zhǔn)文件內(nèi)容,是 index.html、index.jsp、default.html、default.htm或別的什么東西呢?
Welcome-file-list 元素及其輔助的welcome-file元素解決了這個(gè)模糊的問(wèn)題。例如,下面的web.xml項(xiàng)指出,如果一個(gè)URL給出一個(gè)目錄名但未給出文件名,服務(wù)器應(yīng)該首先試用index.jsp,然后再試用index.html。如果兩者都沒(méi)有找到,則結(jié)果有賴于所用的服務(wù)器(如一個(gè)目錄列表)。

Xml代碼

<welcome-file-list>       <welcome-file>index.jsp</welcome-file>       <welcome-file>index.html</welcome-file>   </welcome-file-list>  
<welcome-file-list><welcome-file>index.jsp</welcome-file><welcome-file>index.html</welcome-file></welcome-file-list>

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

8 指定處理錯(cuò)誤的頁(yè)面

現(xiàn)在我了解到,你在開(kāi)發(fā)servlet和JSP頁(yè)面時(shí)從不會(huì)犯錯(cuò)誤,而且你的所有頁(yè)面是那樣的清晰,一般的程序員都不會(huì)被它們的搞糊涂。但是,是人總會(huì)犯錯(cuò)誤的,用戶可能會(huì)提供不合規(guī)定的參數(shù),使用不正確的URL或者不能提供必需的表單字段值。除此之外,其它開(kāi)發(fā)人員可能不那么細(xì)心,他們應(yīng)該有些工具來(lái)克服自己的不足。
error-page元素就是用來(lái)克服這些問(wèn)題的。它有兩個(gè)可能的子元素,分別是:error-code和exception- type。第一個(gè)子元素error-code指出在給定的HTTP錯(cuò)誤代碼出現(xiàn)時(shí)使用的URL。第二個(gè)子元素excpetion-type指出在出現(xiàn)某個(gè)給定的Java異常但未捕捉到時(shí)使用的URL。error-code和exception-type都利用location元素指出相應(yīng)的URL。此 URL必須以/開(kāi)始。location所指出的位置處的頁(yè)面可通過(guò)查找HttpServletRequest對(duì)象的兩個(gè)專門的屬性來(lái)訪問(wèn)關(guān)于錯(cuò)誤的信息,這兩個(gè)屬性分別是: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ù)站點(diǎn)會(huì)作出什么反映。這樣做一般會(huì)出現(xiàn)一個(gè)404錯(cuò)誤信息,它表示不能找到該文件,但幾乎沒(méi)提供更多有用的信息。另一方面,可以試一下在http://www.microsoft.com/、http://www.ibm.com/ 處或者特別是在http://www.bea.com/ 處輸出未知的文件名。這是會(huì)得出有用的消息,這些消息提供可選擇的位置,以便查找感興趣的頁(yè)面。提供這樣有用的錯(cuò)誤頁(yè)面對(duì)于Web應(yīng)用來(lái)說(shuō)是很有價(jià)值得。事實(shí)上rm-error-page子元素)。由form-login-page給出的HTML表單必須具有一個(gè)j_security_check的 ACTION屬性、一個(gè)名為j_username的用戶名文本字段以及一個(gè)名為j_password的口令字段。
例如,程序清單5-19指示服務(wù)器使用基于表單的驗(yàn)證。Web應(yīng)用的頂層目錄中的一個(gè)名為login.jsp的頁(yè)面將收集用戶名和口令,并且失敗的登陸將由相同目錄中名為login-error.jsp的頁(yè)面報(bào)告。

程序清單5-19 web.xml(說(shuō)明login-config的摘錄)

Xml代碼

<?xml version="1.0" encoding="ISO-8859-1"?>   <!DOCTYPE web-app    PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"    "http://java.sun.com/dtd/web-app_2_3.dtd">      <web-app>   <!-- ... -->       <security-constraint> ... </security-constraint>       <login-config>           <auth-method> FORM </auth-method>           <form-login-config>               <form-login-page>/login.jsp</form-login-page>               <form-error-page>/login-error.jsp</form-error-page>           </form-login-config>       </login-config>   <!-- ... -->   </web-app>  
<?xml version="1.0" encoding="ISO-8859-1"?><!DOCTYPE web-appPUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN""http://java.sun.com/dtd/web-app_2_3.dtd"><web-app><!-- ... --><security-constraint> ... </security-constraint><login-config><auth-method> FORM </auth-method><form-login-config><form-login-page>/login.jsp</form-login-page><form-error-page>/login-error.jsp</form-error-page></form-login-config></login-config><!-- ... --></web-app>

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

Xml代碼

<security-constraint>       <web-resource-coolection>       <web-resource-name>Proprietary</web-resource-name>           <url-pattern>/propritary/*</url-pattern>       </web-resource-coolection>   <!-- ... -->   </security-constraint>  
<security-constraint><web-resource-coolection><web-resource-name>Proprietary</web-resource-name><url-pattern>/propritary/*</url-pattern></web-resource-coolection><!-- ... --></security-constraint>

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

Xml代碼

<security-constraint>       <web-resource-coolection> ... </web-resource-coolection>       <auth-constraint>           <role-name>administrator</role-name>           <role-name>kahuna</role-name>       </auth-constraint>   </security-constraint>  
<security-constraint><web-resource-coolection> ... </web-resource-coolection><auth-constraint><role-name>administrator</role-name><role-name>kahuna</role-name></auth-constraint></security-constraint>

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

Xml代碼

<tomcat-users>       <user name="joe" password="bigshot" roles="administrator,kahuna" />       <user name="jane" password="enaj" roles="kahuna" />   </tomcat-users>  
<tomcat-users><user name="joe" password="bigshot" roles="administrator,kahuna" /><user name="jane" password="enaj" roles="kahuna" /></tomcat-users>

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

Xml代碼

<security-constraint>   <!-- ... -->       <user-data-constraint>           <transport-guarantee>CONFIDENTIAL</transport-guarantee>       </user-data-constraint>   </security-constraint>  
<security-constraint><!-- ... --><user-data-constraint><transport-guarantee>CONFIDENTIAL</transport-guarantee></user-data-constraint></security-constraint>

l display-name
security-constraint的這個(gè)很少使用的子元素給予可能由GUI工具使用的安全約束項(xiàng)一個(gè)名稱。

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

Xml代碼

<servlet>   <!-- ... -->       <security-role-ref>           <role-name>boss</role-name> <!-- New alias -->           <role-link>manager</role-link> <!-- Real name -->       </security-role-ref>   </servlet>  
<servlet><!-- ... --><security-role-ref><role-name>boss</role-name> <!-- New alias --><role-link>manager</role-link> <!-- Real name --></security-role-ref></servlet>

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

10 控制會(huì)話超時(shí)

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

Xml代碼

<session-config>       <session-timeout>180</session-timeout>   </session-config>  
<session-config><session-timeout>180</session-timeout></session-config>

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

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

Xml代碼

<icon>       <small-icon>/images/small-book.gif</small-icon>       <large-icon>/images/tome.jpg</large-icon>   </icon>  
<icon><small-icon>/images/small-book.gif</small-icon><large-icon>/images/tome.jpg</large-icon></icon>

l display-name
display-name元素提供GUI工具可能會(huì)用來(lái)標(biāo)記此Web應(yīng)用的一個(gè)名稱。下面是個(gè)例子。
<display-name>Rare Books</display-name>
l description
description元素提供解釋性文本,如下所示:

Xml代碼

<description>   This Web application represents the store developed for rare-books.com, an online bookstore specializing in rare and limited-edition books.    </description>  
<description>This Web application represents the store developed for rare-books.com, an online bookstore specializing in rare and limited-edition books.</description>

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

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

Xml代碼

<mime-mapping>       <extension>foo</extension>       <mime-type>application/x-fubar</mime-type>   </mime-mapping>  
<mime-mapping><extension>foo</extension><mime-type>application/x-fubar</mime-type></mime-mapping>

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

Xml代碼

<mime-mapping>       <extension>ps</extension>       <mime-type>application/postscript</mime-type>   </mime-mapping>  
<mime-mapping><extension>ps</extension><mime-type>application/postscript</mime-type></mime-mapping>

13 定位TLD

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

Xml代碼

<taglib>       <taglib-uri>/charts.tld</taglib-uri>       <taglib-location>/WEB-INF/tlds/chart-tags-1.3beta.tld</taglib-location>   </taglib>  
<taglib><taglib-uri>/charts.tld</taglib-uri><taglib-location>/WEB-INF/tlds/chart-tags-1.3beta.tld</taglib-location></taglib>

給出這個(gè)說(shuō)明后,JSP頁(yè)面可通過(guò)下面的簡(jiǎn)化形式使用標(biāo)簽庫(kù)。
<%@ taglib uri="/charts.tld" prefix="somePrefix" %>

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

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

Xml代碼

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

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

程序清單5-20 ContextReporterjava

Java代碼

package moreservlets;       import javax.servlet.*;    import java.util.*;       public class ContextReporter implements ServletContextListener {        public void contextInitialized(ServletContextEvent event) {            System.out.println("Context created on " +  new Date() + ".");        }           public void contextDestroyed(ServletContextEvent event) {            System.out.println("Context destroyed on " +   new Date() + ".");        }    }  
package moreservlets;import javax.servlet.*;import java.util.*;public class ContextReporter implements ServletContextListener {public void contextInitialized(ServletContextEvent event) {System.out.println("Context created on " +  new Date() + ".");}public void contextDestroyed(ServletContextEvent event) {System.out.println("Context destroyed on " +   new Date() + ".");}}

程序清單5-21 web.xml(聲明一個(gè)監(jiān)聽(tīng)程序的摘錄)

Xml代碼

<?xml version="1.0" encoding="ISO-8859-1"?>   <!DOCTYPE web-app    PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"    "http://java.sun.com/dtd/web-app_2_3.dtd">   <web-app>   <!-- ... -->       <filter-mapping> … </filter-mapping>       <listener>           <listener-class>package.ListenerClass</listener-class>       </listener>       <servlet> ... </servlet>   <!-- ... -->   </web-app>  
<?xml version="1.0" encoding="ISO-8859-1"?><!DOCTYPE web-appPUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN""http://java.sun.com/dtd/web-app_2_3.dtd"><web-app><!-- ... --><filter-mapping> … </filter-mapping><listener><listener-class>package.ListenerClass</listener-class></listener><servlet> ... </servlet><!-- ... --></web-app>

15 J2EE元素

本節(jié)描述用作J2EE環(huán)境組成部分的Web應(yīng)用的web.xml元素。這里將提供一個(gè)簡(jiǎn)明的介紹,詳細(xì)內(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ù)器可安全地在多個(gè)服務(wù)器上分布Web應(yīng)用。例如,一個(gè)可分布的應(yīng)用必須只使用 Serializable對(duì)象作為其HttpSession對(duì)象的屬性,而且必須避免用實(shí)例變量(字段)來(lái)實(shí)現(xiàn)持續(xù)性。distributable元素直接出現(xiàn)在discription元素之后,并且不包含子元素或數(shù)據(jù),它只是一個(gè)如下的標(biāo)志。
<distributable />
l resource-env-ref
resource -env-ref元素聲明一個(gè)與某個(gè)資源有關(guān)的管理對(duì)象。此元素由一個(gè)可選的description元素、一個(gè)resource-env-ref- name元素(一個(gè)相對(duì)于java:comp/env環(huán)境的JNDI名)以及一個(gè)resource-env-type元素(指定資源類型的完全限定的類),如下所示:

Xml代碼

<resource-env-ref>       <resource-env-ref-name>jms/StockQueue</resource-env-ref-name>       <resource-env-ref-type>javax.jms.Queue</resource-env-ref-type>   </resource-env-ref>  
<resource-env-ref><resource-env-ref-name>jms/StockQueue</resource-env-ref-name><resource-env-ref-type>javax.jms.Queue</resource-env-ref-type></resource-env-ref>

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

Xml代碼

<env-entry>       <env-entry-name>minAmout</env-entry-name>       <env-entry-value>100.00</env-entry-value>       <env-entry-type>minAmout</env-entry-type>   </env-entry>  
<env-entry><env-entry-name>minAmout</env-entry-name><env-entry-value>100.00</env-entry-value><env-entry-type>minAmout</env-entry-type></env-entry>

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

給你的session加個(gè)監(jiān)聽(tīng)器

今天一個(gè)學(xué)生問(wèn)我怎么實(shí)現(xiàn)在網(wǎng)頁(yè)里顯示在線用戶的名稱——他已經(jīng)使用了session,但是無(wú)法處理用戶離開(kāi)的情況,然后導(dǎo)致在線用戶列表的無(wú)限增大。跟他說(shuō)了自己在application中進(jìn)行超時(shí)檢查,更新application的時(shí)候就比較當(dāng)前所有列表中的session是否超過(guò)自己指定的時(shí)間間隔。后來(lái)想了想,又給他提了使用給session加監(jiān)聽(tīng)器的方法。但是提的時(shí)候自己也沒(méi)有做過(guò),所以只是說(shuō)這種方式很復(fù)雜,建議他還是自己進(jìn)行超時(shí)檢查。剛才又看了看資料,發(fā)現(xiàn)實(shí)際上給session加監(jiān)聽(tīng)器的方式很簡(jiǎn)單,不禁覺(jué)得自己有點(diǎn)誤人子弟了,現(xiàn)在將方法寫(xiě)在這,借以告誡自己以后要嚴(yán)謹(jǐn)。
首先寫(xiě)一個(gè)SessionBinder類,它實(shí)現(xiàn)了HttpSessionBindingListener接口的valueBound方法和valueUnbound方法,示例代碼如下:

Java代碼

public class SessionBinder implements HttpSessionBindingListener {        public void valueBound(HttpSessionBindingEvent event){        //you can do anything you want!this method will be called when this binder is bind with any session.        }           public void valueUnbound(HttpSessionBindingEvent event) {        //you can do something while this session is invalidate        }    }  
public class SessionBinder implements HttpSessionBindingListener {public void valueBound(HttpSessionBindingEvent event){//you can do anything you want!this method will be called when this binder is bind with any session.}public void valueUnbound(HttpSessionBindingEvent event) {//you can do something while this session is invalidate}}

現(xiàn)在寫(xiě)好了SessionBinder,我們現(xiàn)在選擇在一個(gè)servlet中向session中加入這個(gè)監(jiān)聽(tīng)器——在jsp中的代碼書(shū)寫(xiě)與此相同
//省略前面的代碼,此操作可能發(fā)生在servlet的doGet方法中,也可能是doPost方法中

Java代碼

HttpSession session = req.getSession(true);//首先獲得需要加入監(jiān)聽(tīng)器的session對(duì)象,req是HttpRequest對(duì)象    SessionBinder sb = new SessionBinder();//建立一個(gè)監(jiān)聽(tīng)器對(duì)象    session.putValue("BinderObject",sb);//將監(jiān)聽(tīng)器加入此session中,從此時(shí)開(kāi)始執(zhí)行sb的valueBound方法  
    HttpSession session = req.getSession(true);//首先獲得需要加入監(jiān)聽(tīng)器的session對(duì)象,req是HttpRequest對(duì)象SessionBinder sb = new SessionBinder();//建立一個(gè)監(jiān)聽(tīng)器對(duì)象session.putValue("BinderObject",sb);//將監(jiān)聽(tīng)器加入此session中,從此時(shí)開(kāi)始執(zhí)行sb的valueBound方法

//省略后面的代碼
隨后,如果整個(gè)session超時(shí)或者被用戶中止之后,sb的valueUnbound自動(dòng)執(zhí)行

以上是怎么配置Web.xml的所有內(nèi)容,感謝各位的閱讀!相信大家都有了一定的了解,希望分享的內(nèi)容對(duì)大家有所幫助,如果還想學(xué)習(xí)更多知識(shí),歡迎關(guān)注億速云行業(yè)資訊頻道!

向AI問(wèn)一下細(xì)節(jié)

免責(zé)聲明:本站發(fā)布的內(nèi)容(圖片、視頻和文字)以原創(chuàng)、轉(zhuǎn)載和分享為主,文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng),如果涉及侵權(quán)請(qǐng)聯(lián)系站長(zhǎng)郵箱:is@yisu.com進(jìn)行舉報(bào),并提供相關(guān)證據(jù),一經(jīng)查實(shí),將立刻刪除涉嫌侵權(quán)內(nèi)容。

AI