web.xml配置详细说明(中)

来源:互联网 发布:热门小说软件下载 编辑:程序博客网 时间:2024/06/05 07:56

 3.2 定义定制的URL
大多数服务器具有一个缺省的serlvet URL:
http://host/webAppPrefix/servlet/packageName.ServletName。虽然在开发中使用这个URL很方便,但是我们常常会希望另一个URL用于部署。例如,可能会需要一个出现在Web应用顶层的URL(如,http: //host/webAppPrefix/Anyname),并且在此URL中没有servlet项。位于顶层的URL简化了相对URL的使用。此外,对许多开发人员来说,顶层URL看上去比更长更麻烦的缺省URL更简短。
事实上,有时需要使用定制的URL。比如,你可能想关闭缺省URL映射,以便更好地强制实施安全限制或防止用户意外地访问无初始化参数的servlet。如果你禁止了缺省的URL,那么你怎样访问servlet呢?这时只有使用定制的URL了。
为了分配一个定制的URL,可使用servlet-mapping元素及其servlet-name和url-pattern子元素。Servlet- name元素提供了一个任意名称,可利用此名称引用相应的servlet;url-pattern描述了相对于Web应用的根目录的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元素出现地次序不是随意的。特别是,需要把所有servlet元素放在所有 servlet-mapping元素之前。

Java代码
  1. <servlet>   
  2. <servlet-name>Test</servlet-name>   
  3. <servlet-class>moreservlets.TestServlet</servlet-class>   
  4. </servlet>   
  5. <!-- ... -->   
  6. <servlet-mapping>   
  7. <servlet-name>Test</servlet-name>   
  8. <url-pattern>/UrlTest</url-pattern>   
  9. </servlet-mapping>  

URL模式还可以包含通配符。例如,下面的小程序指示服务器发送所有以Web应用的URL前缀开始,以..asp结束的请求到名为BashMS的servlet。

Java代码
  1. <servlet>   
  2. <servlet-name>BashMS</servlet-name>   
  3. <servlet-class>msUtils.ASPTranslator</servlet-class>   
  4. </servlet>   
  5. <!-- ... -->   
  6. <servlet-mapping>   
  7. <servlet-name>BashMS</servlet-name>   
  8. <url-pattern>/*.asp</url-pattern>   
  9. </servlet-mapping>  


3.3 命名JSP页面
因为JSP页面要转换成sevlet,自然希望就像命名servlet一样命名JSP页面。毕竟,JSP页面可能会从初始化参数、安全设置或定制的URL中受益,正如普通的serlvet那样。虽然JSP页面的后台实际上是servlet这句话是正确的,但存在一个关键的猜疑:即,你不知道JSP页面的实际类名(因为系统自己挑选这个名字)。因此,为了命名JSP页面,可将jsp-file元素替换为servlet-calss元素,如下所示:

Java代码
  1. <servlet>   
  2. <servlet-name>Test</servlet-name>   
  3. <jsp-file>/TestPage.jsp</jsp-file>   
  4. </servlet>  

命名JSP页面的原因与命名servlet的原因完全相同:即为了提供一个与定制设置(如,初始化参数和安全设置)一起使用的名称,并且,以便能更改激活 JSP页面的URL(比方说,以便多个URL通过相同页面得以处理,或者从URL中去掉.jsp扩展名)。但是,在设置初始化参数时,应该注意,JSP页面是利用jspInit方法,而不是init方法读取初始化参数的。
例如,程序清单5-3给出一个名为TestPage.jsp的简单JSP页面,它的工作只是打印出用来激活它的URL的本地部分。TestPage.jsp放置在deployDemo应用的顶层。程序清单5-4给出了用来分配一个注册名PageName,然后将此注册名与http://host/webAppPrefix/UrlTest2/anything 形式的URL相关联的web.xml文件(即,deployDemo/WEB-INF/web.xml)的一部分。

程序清单5-3 TestPage.jsp

Java代码
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">   
  2. <HTML>   
  3. <HEAD>   
  4. <TITLE>   
  5. JSP Test Page   
  6. </TITLE>   
  7. </HEAD>   
  8. <BODY BGCOLOR="#FDF5E6">   
  9. <H2>URI: <%= request.getRequestURI() %></H2>   
  10. </BODY>   
  11. </HTML>  



程序清单5-4 web.xml(说明JSP页命名的摘录)

Java代码
  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>   
  9. <servlet-name>PageName</servlet-name>   
  10. <jsp-file>/TestPage.jsp</jsp-file>   
  11. </servlet>   
  12. <!-- ... -->   
  13. <servlet-mapping>   
  14. <servlet-name> PageName </servlet-name>   
  15. <url-pattern>/UrlTest2/*</url-pattern>   
  16. </servlet-mapping>   
  17. <!-- ... -->   
  18. </web-app>  



4 禁止激活器servlet

对servlet或JSP页面建立定制URL的一个原因是,这样做可以注册从 init(servlet)或jspInit(JSP页面)方法中读取得初始化参数。但是,初始化参数只在是利用定制URL模式或注册名访问 servlet或JSP页面时可以使用,用缺省URL http://host/webAppPrefix/servlet/ServletName 访问时不能使用。因此,你可能会希望关闭缺省URL,这样就不会有人意外地调用初始化servlet了。这个过程有时称为禁止激活器servlet,因为多数服务器具有一个用缺省的servlet URL注册的标准servlet,并激活缺省的URL应用的实际servlet。
有两种禁止此缺省URL的主要方法:
l 在每个Web应用中重新映射/servlet/模式。
l 全局关闭激活器servlet。
重要的是应该注意到,虽然重新映射每个Web应用中的/servlet/模式比彻底禁止激活servlet所做的工作更多,但重新映射可以用一种完全可移植的方式来完成。相反,全局禁止激活器servlet完全是针对具体机器的,事实上有的服务器(如ServletExec)没有这样的选择。下面的讨论对每个Web应用重新映射/servlet/ URL模式的策略。后面提供在Tomcat中全局禁止激活器servlet的详细内容。
4.1 重新映射/servlet/URL模式
在一个特定的Web应用中禁止以http://host/webAppPrefix/servlet/ 开始的URL的处理非常简单。所需做的事情就是建立一个错误消息servlet,并使用前一节讨论的url-pattern元素将所有匹配请求转向该 servlet。只要简单地使用:
<url-pattern>/servlet/*</url-pattern>
作为servlet-mapping元素中的模式即可。
例如,程序清单5-5给出了将SorryServlet servlet(程序清单5-6)与所有以http://host/webAppPrefix/servlet/ 开头的URL相关联的部署描述符文件的一部分。

程序清单5-5 web.xml(说明JSP页命名的摘录)

Java代码
  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>   
  9. <servlet-name>Sorry</servlet-name>   
  10. <servlet-class>moreservlets.SorryServlet</servlet-class>   
  11. </servlet>   
  12. <!-- ... -->   
  13. <servlet-mapping>   
  14. <servlet-name> Sorry </servlet-name>   
  15. <url-pattern>/servlet/*</url-pattern>   
  16. </servlet-mapping>   
  17. <!-- ... -->   
  18. </web-app>  



程序清单5-6 SorryServlet.java

Java代码
  1. package moreservlets;   
  2.   
  3. import java.io.*;   
  4. import javax.servlet.*;   
  5. import javax.servlet.http.*;   
  6.   
  7. /** Simple servlet used to give error messages to
  8. * users who try to access default servlet URLs
  9. * (i.e., http://host/webAppPrefix/servlet/ServletName)
  10. * in Web applications that have disabled this
  11. * behavior.
  12. * <P>
  13. * Taken from More Servlets and JavaServer Pages
  14. * from Prentice Hall and Sun Microsystems Press,
  15. * http://www.moreservlets.com/.
  16. * © 2002 Marty Hall; may be freely used or adapted.
  17. */  
  18.   
  19. public class SorryServlet extends HttpServlet {   
  20. public void doGet(HttpServletRequest request,   
  21. HttpServletResponse response)   
  22. throws ServletException, IOException {   
  23. response.setContentType("text/html");   
  24. PrintWriter out = response.getWriter();   
  25. String title = "Invoker Servlet Disabled.";   
  26. out.println(ServletUtilities.headWithTitle(title) +   
  27. "<BODY BGCOLOR=/"#FDF5E6/">/n" +   
  28. "<H2>" + title + "</H2>/n" +   
  29. "Sorry, access to servlets by means of/n" +   
  30. "URLs that begin with/n" +   
  31. "http://host/webAppPrefix/servlet//n" +   
  32. "has been disabled./n" +   
  33. "</BODY></HTML>");   
  34. }   
  35.   
  36. public void doPost(HttpServletRequest request,   
  37. HttpServletResponse response)   
  38. throws ServletException, IOException {   
  39. doGet(request, response);   
  40. }   
  41. }  


4.2 全局禁止激活器:Tomcat
Tomcat 4中用来关闭缺省URL的方法与Tomcat 3中所用的很不相同。下面介绍这两种方法:
1.禁止激活器: Tomcat 4
Tomcat 4用与前面相同的方法关闭激活器servlet,即利用web.xml中的url-mapping元素进行关闭。不同之处在于Tomcat使用了放在 install_dir/conf中的一个服务器专用的全局web.xml文件,而前面使用的是存放在每个Web应用的WEB-INF目录中的标准 web.xml文件。
因此,为了在Tomcat 4中关闭激活器servlet,只需在install_dir/conf/web.xml中简单地注释出/servlet/* URL映射项即可,如下所示:

Java代码
  1. <!--   
  2. <servlet-mapping>   
  3. <servlet-name>invoker</servlet-name>   
  4. <url-pattern>/servlet/*</url-pattern>   
  5. </servlet-mapping>   
  6. -->  

再次提醒,应该注意这个项是位于存放在install_dir/conf的Tomcat专用的web.xml文件中的,此文件不是存放在每个Web应用的WEB-INF目录中的标准web.xml。
2.禁止激活器:Tomcat3
在Apache Tomcat的版本3中,通过在install_dir/conf/server.xml中注释出InvokerInterceptor项全局禁止缺省 servlet URL。例如,下面是禁止使用缺省servlet URL的server.xml文件的一部分。

Java代码
  1. <!--   
  2. <RequsetInterceptor   
  3. className="org.apache.tomcat.request.InvokerInterceptor"  
  4. debug="0" prefix="/servlet/" />   
  5. -->  


5 初始化和预装载servlet与JSP页面

这里讨论控制servlet和JSP页面的启动行为的方法。特别是,说明了怎样分配初始化参数以及怎样更改服务器生存期中装载servlet和JSP页面的时刻。
5.1 分配servlet初始化参数
利用init-param元素向servlet提供初始化参数,init-param元素具有param-name和param-value子元素。例如,在下面的例子中,如果initServlet servlet是利用它的注册名(InitTest)访问的,它将能够从其方法中调用getServletConfig(). getInitParameter("param1")获得"Value 1",调用getServletConfig().getInitParameter("param2")获得"2"。

Java代码
  1. <servlet>   
  2. <servlet-name>InitTest</servlet-name>   
  3. <servlet-class>moreservlets.InitServlet</servlet-class>   
  4. <init-param>   
  5. <param-name>param1</param-name>   
  6. <param-value>value1</param-value>   
  7. </init-param>   
  8. <init-param>   
  9. <param-name>param2</param-name>   
  10. <param-value>2</param-value>   
  11. </init-param>   
  12. </servlet>  

在涉及初始化参数时,有几点需要注意:
l 返回值。GetInitParameter的返回值总是一个String。因此,在前一个例子中,可对param2使用Integer.parseInt获得一个int。
l JSP中的初始化。JSP页面使用jspInit而不是init。JSP页面还需要使用jsp-file元素代替servlet-class。
l 缺省URL。初始化参数只在通过它们的注册名或与它们注册名相关的定制URL模式访问Servlet时可以使用。因此,在这个例子中,param1和 param2初始化参数将能够在使用URL http://host/webAppPrefix/servlet/InitTest 时可用,但在使用URL http://host/webAppPrefix/servlet/myPackage.InitServlet 时不能使用。
例如,程序清单5-7给出一个名为InitServlet的简单servlet,它使用init方法设置firstName和emailAddress字段。程序清单5-8给出分配名称InitTest给servlet的web.xml文件。
程序清单5-7 InitServlet.java

Java代码
  1. package moreservlets;   
  2.   
  3. import java.io.*;   
  4. import javax.servlet.*;   
  5. import javax.servlet.http.*;   
  6.   
  7. /** Simple servlet used to illustrate servlet
  8. * initialization parameters.
  9. * <P>
  10. * Taken from More Servlets and JavaServer Pages
  11. * from Prentice Hall and Sun Microsystems Press,
  12. * http://www.moreservlets.com/.
  13. * © 2002 Marty Hall; may be freely used or adapted.
  14. */  
  15.   
  16. public class InitServlet extends HttpServlet {   
  17. private String firstName, emailAddress;   
  18.   
  19. public void init() {   
  20. ServletConfig config = getServletConfig();   
  21. firstName = config.getInitParameter("firstName");   
  22. emailAddress = config.getInitParameter("emailAddress");   
  23. }   
  24.   
  25. public void doGet(HttpServletRequest request,   
  26. HttpServletResponse response)   
  27. throws ServletException, IOException {   
  28. response.setContentType("text/html");   
  29. PrintWriter out = response.getWriter();   
  30. String uri = request.getRequestURI();   
  31. out.println(ServletUtilities.headWithTitle("Init Servlet") +   
  32. "<BODY BGCOLOR=/"#FDF5E6/">/n" +   
  33. "<H2>Init Parameters:</H2>/n" +   
  34. "<UL>/n" +   
  35. "<LI>First name: " + firstName + "/n" +   
  36. "<LI>Email address: " + emailAddress + "/n" +   
  37. "</UL>/n" +   
  38. "</BODY></HTML>");   
  39. }   
  40. }  


程序清单5-8 web.xml(说明初始化参数的摘录)

Java代码
  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>   
  9. <servlet-name>InitTest</servlet-name>   
  10. <servlet-class>moreservlets.InitServlet</servlet-class>   
  11. <init-param>   
  12. <param-name>firstName</param-name>   
  13. <param-value>Larry</param-value>   
  14. </init-param>   
  15. <init-param>   
  16. <param-name>emailAddress</param-name>   
  17. <param-value>Ellison@Microsoft.com</param-value>