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元素之前。
-
<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模式还可以包含通配符。例如，下面的小程序指示服务器发送所有以Web应用的URL前缀开始，以..asp结束的请求到名为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>
<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页面要转换成sevlet，自然希望就像命名servlet一样命名JSP页面。毕竟，JSP页面可能会从初始化参数、安全设置或定制的URL中受益，正如普通的serlvet那样。虽然JSP页面的后台实际上是servlet这句话是正确的，但存在一个关键的猜疑：即，你不知道JSP页面的实际类名（因为系统自己挑选这个名字）。因此，为了命名JSP页面，可将jsp-file元素替换为servlet-calss元素，如下所示：
-
<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页面的原因与命名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
-
<!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（说明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>
<?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页面）方法中读取得初始化参数。但是，初始化参数只在是利用定制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页命名的摘录）
-
<?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-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.*;
-
-
-
-
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.*;
/** 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中用来关闭缺省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映射项即可，如下所示：
-
<!--
-
<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>
-->
再次提醒，应该注意这个项是位于存放在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文件的一部分。
-
<!--
-
<RequsetInterceptor
-
className="org.apache.tomcat.request.InvokerInterceptor"
-
debug="0" prefix="/servlet/" />
-
-->
<!--
<RequsetInterceptor
className="org.apache.tomcat.request.InvokerInterceptor"
debug="0" prefix="/servlet/" />
-->
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"。
-
<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>
在涉及初始化参数时，有几点需要注意：
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
-
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.*;
/** 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（说明初始化参数的摘录）
-
<?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>
分享到：
相关推荐
下面是 web.xml 配置文件的详细解释： 定义头和根元素 在 web.xml 文件中，第一个元素是 XML 头，用于声明 XML 版本和字符编码。紧接着是 DOCTYPE 声明，用于指定 Servlet 规范的版本和文档类型定义（DTD）。最后...
下面我们将详细探讨`web.xml`中涉及Spring MVC的主要配置项。 1. **监听器（Listener）** `web.xml`中的监听器允许我们在特定事件发生时执行代码，例如应用程序启动或关闭。在Spring MVC中，`org.springframework....
在J2EE应用程序开发中，`web.xml`文件被称为部署描述符，它是应用程序的核心配置文件。这个文件定义了Web应用的结构、行为以及服务器如何处理请求。本文将深入解析`web.xml`配置文件中的各个元素及其用法。 一、web...
以下是对web.xml配置文件中各个元素的详细说明： 1. **定义头和根元素** - **XML头**：文件开头必须包含XML声明，指定XML版本和字符编码，如`<?xml version="1.0" encoding="UTF-8"?>` - **DOCTYPE声明**：紧接着...
【Web.xml配置说明】 在B/S（Browser/Server，浏览器/服务器）项目中，Web.xml文件扮演着核心角色，它是Web应用程序的部署描述符。它包含了一系列配置信息，用于指导服务器如何运行和管理Web应用。以下是对Web.xml...
本文将详细介绍 Web.XML 文件的配置详解。 一、定义头和根元素 在 Web.XML 文件中，必须以一个 XML 头开始，声明 XML 版本和字符编码。接着是 DOCYTPE 声明，用于指定 Servlet 规范的版本和文档类型定义（DTD）。...
【web.xml配置详解】 在Java Web开发中，`web.xml`是Web应用程序的部署描述符，它是服务器理解和运行Web应用的关键配置文件。本文将详细解释`web.xml`配置的各个方面，帮助开发者更好地理解和掌握其使用。 1. **...
web.xml 配置详解，需要的下载了。。。Web.xml常用元素和在java web规范中说明.按照listner,filter,servlet的顺序初始化
Web.xml 文件是 Servlet 规范中定义的 web 应用的配置文件，它是 web 应用发布描述文件。在启动 WEB 项目时，WEB 容器会读取它的配置文件 web.xml。web.xml 文件的顶层元素是 <web-app>，所有其他子元素都必须定义在...
在Java Web开发中，`struts.xml`, `applicationContext.xml` 和 `web.xml` 是三个至关重要的配置文件，它们各自负责不同的职责，并协同工作来构建一个完整的应用框架。以下是关于这三个配置文件的详细说明。 首先，...
### 部署描述文件web.xml配置详解 #### 一、引言 在Java Web开发中，`web.xml`是一个非常重要的配置文件，它作为Web应用程序的部署描述符，负责管理与应用程序相关的各项配置信息。本文将深入解析`web.xml`的各项...
本文将深入探讨`web.xml 2.4`版本中的关键节点及其详细说明，帮助开发者更好地理解和运用这一配置文件。 ### 1. `web-app`节点 这是`web.xml`文件的根元素，定义了整个Web应用的基本信息。`version`属性用于指定`...
以下是对`web.xml`文件中主要元素的详细解释： 1. `<display-name>`: 这个元素用来指定Web应用的显示名称，通常用于管理和文档化目的。 2. `<description>`: 提供Web应用的简短说明或描述，有助于理解和维护。 3....
接下来，`<apps>`元素是整个配置的核心部分，它包含了所有部署在TongWeb上的Web应用程序的详细信息。每个`<web-app>`子元素代表一个独立的应用，如`console`、`heimdall`和`sysweb`等。这些元素的属性如`name`、`...
WEB.XML标准配置注解： <!--Servlet的映射，用来说明客户端IE中输入什么样的地址字符串对应到哪个Servlet的别名--> <!--在该例中在IE地址栏中firstservlet字符串对应到别名为firstservlet的servlet--> ...
Tomcat 中 web.xml 文件的详细说明 Tomcat 中的 web.xml 文件是用于配置 Web 应用的核心文件，它定义了 Web 应用的基本信息、Filter、Servlet、Session 等信息。本文将详细介绍 web.xml 文件的结构和各个元素的作用...
web.xml 配置详细讲解 Web.xml 是一个部署描述符文件，用于控制 Web 应用的行为。它是 Web 应用程序的核心配置文件，定义了 Web 应用的结构和行为。 XML 头和根元素 一个合法的 Web.xml 文件必须以 XML 头开始，...