3.2 定義定制的URL
大多數(shù)服務(wù)器具有一個缺省的serlvet URL:
http://host /webAppPrefix/servlet/packageName.ServletName。雖然在開發(fā)中使用這個URL很方便,但是我們常常會希望 另一個URL用于部署。例如,可能會需要一個出現(xiàn)在Web應(yīng)用頂層的URL(如,http: //host/webAppPrefix/Anyname),并且在此URL中沒有servlet項。位于頂層的URL簡化了相對URL的使用。此外,對 許多開發(fā)人員來說,頂層URL看上去比更長更麻煩的缺省URL更簡短。
事實上,有時需要使用定制的URL。比如,你可能想關(guān)閉缺省URL映射,以便更好地強制實施安全限制或防止用戶意外地訪問無初始化參數(shù)的servlet。如果你禁止了缺省的URL,那么你怎樣訪問servlet呢?這時只有使用定制的URL了。
為 了分配一個定制的URL,可使用servlet-mapping元素及其servlet-name和url-pattern子元素。Servlet- name元素提供了一個任意名稱,可利用此名稱引用相應(yīng)的servlet;url-pattern描述了相對于Web應(yīng)用的根目錄的URL。url- pattern元素的值必須以斜杠(/)起始。
下面給出一個簡單的web.xml摘錄,它允許使用URL http://host/webAppPrefix/UrlTest而不是http://host/webAppPrefix/servlet/Test或
http: //host/webAppPrefix/servlet/moreservlets.TestServlet。請注意,仍然需要XML頭、 DOCTYPE聲明以及web-app封閉元素。此外,可回憶一下,XML元素出現(xiàn)地次序不是隨意的。特別是,需要把所有servlet元素放在所有 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前綴開始,以..asp結(jié)束的請求到名為BashMS的servlet。
- <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頁面
因為JSP頁面要轉(zhuǎn)換成sevlet,自然希望就像命名servlet一樣命名JSP頁面。畢竟,JSP
頁面可能會從初始化參數(shù)、安全設(shè)置或定制的URL中受益,正如普通的serlvet那樣。雖然JSP頁面的后臺實際上是servlet這句話是正確的,但
存在一個關(guān)鍵的猜疑:即,你不知道JSP頁面的實際類名(因為系統(tǒng)自己挑選這個名字)。因此,為了命名JSP頁面,可將jsp-file元素替換為
servlet-calss元素,如下所示:
- <servlet>
- <servlet-name>Test</servlet-name>
- <jsp-file>/TestPage.jsp</jsp-file>
- </servlet>
命名JSP頁面的原因與命名servlet的原因完全相同:即為了提供一個與定制設(shè)置(如,初始化參數(shù)和安全設(shè)置)一起使用的名稱,并且,以便能更
改激活
JSP頁面的URL(比方說,以便多個URL通過相同頁面得以處理,或者從URL中去掉.jsp擴展名)。但是,在設(shè)置初始化參數(shù)時,應(yīng)該注意,JSP頁
面是利用jspInit方法,而不是init方法讀取初始化參數(shù)的。
例如,程序清單5-3給出一個名為TestPage.jsp的簡單JSP
頁面,它的工作只是打印出用來激活它的URL的本地部分。TestPage.jsp放置在deployDemo應(yīng)用的頂層。程序清單5-4給出了用來分配
一個注冊名PageName,然后將此注冊名與http://host/webAppPrefix/UrlTest2/anything
形式的URL相關(guān)聯(lián)的web.xml文件(即,deployDemo/WEB-INF/web.xml)的一部分。
程序清單5-3 TestPage.jsp
- <!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(說明JSP頁命名的摘錄)
- <?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>
4 禁止激活器servlet
對servlet或JSP頁面建立定制URL的一個原因是,這樣做可以注冊從
init(servlet)或jspInit(JSP頁面)方法中讀取得初始化參數(shù)。但是,初始化參數(shù)只在是利用定制URL模式或注冊名訪問
servlet或JSP頁面時可以使用,用缺省URL http://host/webAppPrefix/servlet/ServletName
訪問時不能使用。因此,你可能會希望關(guān)閉缺省URL,這樣就不會有人意外地調(diào)用初始化servlet了。這個過程有時稱為禁止激活器servlet,因為
多數(shù)服務(wù)器具有一個用缺省的servlet URL注冊的標準servlet,并激活缺省的URL應(yīng)用的實際servlet。
有兩種禁止此缺省URL的主要方法:
l 在每個Web應(yīng)用中重新映射/servlet/模式。
l 全局關(guān)閉激活器servlet。
重
要的是應(yīng)該注意到,雖然重新映射每個Web應(yīng)用中的/servlet/模式比徹底禁止激活servlet所做的工作更多,但重新映射可以用一種完全可移植
的方式來完成。相反,全局禁止激活器servlet完全是針對具體機器的,事實上有的服務(wù)器(如ServletExec)沒有這樣的選擇。下面的討論對每
個Web應(yīng)用重新映射/servlet/ URL模式的策略。后面提供在Tomcat中全局禁止激活器servlet的詳細內(nèi)容。
4.1 重新映射/servlet/URL模式
在
一個特定的Web應(yīng)用中禁止以http://host/webAppPrefix/servlet/
開始的URL的處理非常簡單。所需做的事情就是建立一個錯誤消息servlet,并使用前一節(jié)討論的url-pattern元素將所有匹配請求轉(zhuǎn)向該
servlet。只要簡單地使用:
<url-pattern>/servlet/*</url-pattern>
作為servlet-mapping元素中的模式即可。
例如,程序清單5-5給出了將SorryServlet servlet(程序清單5-6)與所有以http://host/webAppPrefix/servlet/ 開頭的URL相關(guān)聯(lián)的部署描述符文件的一部分。
程序清單5-5 web.xml(說明JSP頁命名的摘錄)
- <?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>
程序清單5-6 SorryServlet.java
- package moreservlets;
- import java.io.*;
- import javax.servlet.*;
- import javax.servlet.http.*;
- /** Simple servlet used to give error messages to
- * users who try to access default servlet URLs
- * (i.e., http://host/webAppPrefix/servlet/ServletName)
- * in Web applications that have disabled this
- * behavior.
- * <P>
- * Taken from More Servlets and JavaServer Pages
- * from Prentice Hall and Sun Microsystems Press,
- * http://www.moreservlets.com/.
- * © 2002 Marty Hall; may be freely used or adapted.
- */
- 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中用來關(guān)閉缺省URL的方法與Tomcat 3中所用的很不相同。下面介紹這兩種方法:
1.禁止激活器: Tomcat 4
Tomcat
4用與前面相同的方法關(guān)閉激活器servlet,即利用web.xml中的url-mapping元素進行關(guān)閉。不同之處在于Tomcat使用了放在
install_dir/conf中的一個服務(wù)器專用的全局web.xml文件,而前面使用的是存放在每個Web應(yīng)用的WEB-INF目錄中的標準
web.xml文件。
因此,為了在Tomcat 4中關(guān)閉激活器servlet,只需在install_dir/conf/web.xml中簡單地注釋出/servlet/* URL映射項即可,如下所示:
- <!--
- <servlet-mapping>
- <servlet-name>invoker</servlet-name>
- <url-pattern>/servlet/*</url-pattern>
- </servlet-mapping>
- -->
再次提醒,應(yīng)該注意這個項是位于存放在install_dir/conf的Tomcat專用的web.xml文件中的,此文件不是存放在每個Web應(yīng)用的WEB-INF目錄中的標準web.xml。
2.禁止激活器:Tomcat3
在Apache
Tomcat的版本3中,通過在install_dir/conf/server.xml中注釋出InvokerInterceptor項全局禁止缺省
servlet URL。例如,下面是禁止使用缺省servlet URL的server.xml文件的一部分。
- <!--
- <RequsetInterceptor
- className="org.apache.tomcat.request.InvokerInterceptor"
- debug="0" prefix="/servlet/" />
- -->
5 初始化和預(yù)裝載servlet與JSP頁面
這里討論控制servlet和JSP頁面的啟動行為的方法。特別是,說明了怎樣分配初始化參數(shù)以及怎樣更改服務(wù)器生存期中裝載servlet和JSP頁面的時刻。
5.1 分配servlet初始化參數(shù)
利
用init-param元素向servlet提供初始化參數(shù),init-param元素具有param-name和param-value子元素。例如,
在下面的例子中,如果initServlet
servlet是利用它的注冊名(InitTest)訪問的,它將能夠從其方法中調(diào)用getServletConfig().
getInitParameter("param1")獲得"Value
1",調(diào)用getServletConfig().getInitParameter("param2")獲得"2"。
- <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ù)時,有幾點需要注意:
l 返回值。GetInitParameter的返回值總是一個String。因此,在前一個例子中,可對param2使用Integer.parseInt獲得一個int。
l JSP中的初始化。JSP頁面使用jspInit而不是init。JSP頁面還需要使用jsp-file元素代替servlet-class。
l
缺省URL。初始化參數(shù)只在通過它們的注冊名或與它們注冊名相關(guān)的定制URL模式訪問Servlet時可以使用。因此,在這個例子中,param1和
param2初始化參數(shù)將能夠在使用URL http://host/webAppPrefix/servlet/InitTest
時可用,但在使用URL http://host/webAppPrefix/servlet/myPackage.InitServlet
時不能使用。
例如,程序清單5-7給出一個名為InitServlet的簡單servlet,它使用init方法設(shè)置firstName和emailAddress字段。程序清單5-8給出分配名稱InitTest給servlet的web.xml文件。
程序清單5-7 InitServlet.java
- package moreservlets;
- import java.io.*;
- import javax.servlet.*;
- import javax.servlet.http.*;
- /** Simple servlet used to illustrate servlet
- * initialization parameters.
- * <P>
- * Taken from More Servlets and JavaServer Pages
- * from Prentice Hall and Sun Microsystems Press,
- * http://www.moreservlets.com/.
- * © 2002 Marty Hall; may be freely used or adapted.
- */
- 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(說明初始化參數(shù)的摘錄)
- <?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>