Javax.servlet.RequestDispatcher.forward(ServletRequest request, ServletResponse response)
Javax.servlet.http.HttpServletResponse.sendRedirect(String location)
forward
作用于服务器端，重定向后客户端浏览器地址栏的URL不变Q无法通过get方式传递参敎ͼ不过可以通过HttpServletResponse. setAttribute(key, values)来做Q?/FONT>
JDK?FONT face="Times New Roman">DOC中的描述Q?/FONT>
Forwards a request from a servlet to another resource (servlet, JSP file, or HTML file) on the server. This method allows one servlet to do preliminary processing of a request and another resource to generate the response.
forward should be called before the response has been committed to the client (before response body output has been flushed). If the response already has been committed, this method throws an IllegalStateException. Uncommitted output in the response buffer is automatically cleared before the forward.
q个Ҏ(gu)允许一?FONT face="Times New Roman">servlet对一个请求作完处理后Qƈ使用另一个资源作响应?/FONT>
forward应该在向客户端发出响应之前被调用Q?FONT face="Times New Roman">response的输出流被刷C前）Q如果已l向客户端发Z响应Q这个方法将抛出一个?FONT face="Times New Roman">IllegalStateException”的异常。未发出响应response的输出缓冲区在调?FONT face="Times New Roman">forward会被自动的清I?/FONT>
得到RequestDispatcher引用的方法：
1?/FONT> javax.servlet.ServletContext.getRequestDispatcher(String path)
JDK?FONT face="Times New Roman">DOC中的描述Q?/FONT>
The pathname must begin with a "/" and is interpreted as relative to the current context root. Use getContext to obtain a RequestDispatcher for resources in foreign contexts. This method returns null if the ServletContext cannot return a RequestDispatcher.
用的最多，最Ҏ(gu)理解的方法，path必须是以?FONT face="Times New Roman">/”开_路径是相对于全局上下文\径，对应?FONT face="Times New Roman">web应用的根目录
2?FONT face="Times New Roman">javax.servlet.ServletRequest.getRequestDispatcher(String path)
JDK?FONT face="Times New Roman">DOC中的描述Q?/FONT>
The pathname specified may be relative, although it cannot extend outside the current servlet context. If the path begins with a "/" it is interpreted as relative to the current context root. This method returns null if the servlet container cannot return a RequestDispatcher.
可以是相对地址Q以当前资源的根目录Q但不能出当前资源根目录?/FONT>
可以是以?FONT face="Times New Roman">/”开头的地址Q当?FONT face="Times New Roman">root作ؓ根目录环境?/FONT>
2?/FONT> javax.servlet.ServletContext.getNamedDispatcher(String name)
JDK?FONT face="Times New Roman">DOC中的描述Q?/FONT>
Servlets (and JSP pages also) may be given names via server administration or via a web application deployment descriptor.
得到名ؓname的资源?/FONT>
ServletsQ也可是JSP 面Q可能会有个l定的名字，该名字是服务器或?FONT face="Times New Roman">web应用的部|描q?FONT face="Times New Roman">web.xml提供的?/FONT>
sendRedirect
工作在客LQ重定向后客L览器地址栏的URL变ؓ新的资源URLQ可以通过get方式传递参数?/FONT>
JDK?FONT face="Times New Roman">DOC的描qͼ
Sends a temporary redirect response to the client using the specified redirect location URL. This method can accept relative URLs; the servlet container must convert the relative URL to an absolute URL before sending the response to the client. If the location is relative without a leading '/' the container interprets it as relative to the current request URI. If the location is relative with a leading '/' the container interprets it as relative to the servlet container root.
If the response has already been committed, this method throws an IllegalStateException. After using this method, the response should be considered to be committed and should not be written to.
q个Ҏ(gu)可以接受相对?FONT face="Times New Roman">URLQ在发送响应之?FONT face="Times New Roman">servlet容器会将其{化ؓl对?FONT face="Times New Roman">URL。如果相对的URL不以?FONT face="Times New Roman">/”开_容器解释ؓ是相对当前请求的路径URIQ如果是以?FONT face="Times New Roman">/”开_则解释ؓ是相对于servlet容器的更目录环境?/FONT>
注意Q如果已l向客户端响应了hQ这个方法将抛出一个?FONT face="Times New Roman">IllegalStateException”的异常。调用了q个Ҏ(gu)后，q个响应是否被提交或是否提交完毕?/FONT>
sendRedirect比较单，参数location是代表重定向目标新资源?/FONT>
localtion可以有以下几U情况：
可以是绝对地址Q如:httpQ?/localhost:8080/servlet/a.jsp
可以是相对地址Q相对于当前讉K资源的根目录Q如Q?FONT face="Times New Roman">a.jsp
可以是以?FONT face="Times New Roman">/”开头的地址Q则认ؓ是先对该web应用的根目录Q如Q?FONT face="Times New Roman">/a.jsp
]]>
部v描述W文件就像所有XML文g一P必须以一个XML头开始。这个头声明可以使用的XML版本q给出文件的字符~码?BR>DOCYTPE声明必须立即出现在此头之后。这个声明告诉服务器适用的servlet规范的版本（?.2?.3Qƈ指定理此文件其余部分内容的语法的DTD(Document Type DefinitionQ文档类型定??BR>所有部|描q符文g的顶层（根）元素为web-app。请注意QXML元素不像HTMLQ他们是大小写敏感的。因此，web-App和WEB-APP都是不合法的Qweb-app必须用小写?BR>
2 部v描述W文件内的元素次?BR>
XML 元素不仅是大写敏感的，而且它们q对出现在其他元素中的次序敏感。例如，XML头必L文g中的W一，DOCTYPE声明必须是第二项Q而web- app元素必须是第三项。在web-app元素内，元素的次序也很重要。服务器不一定强制要求这U次序，但它们允许（实际上有些服务器是q样做的Q完全拒l执行含有次序不正确的元素的Web应用。这表示使用非标准元素次序的web.xml文g是不可移植的?BR>下面的列表给Z所有可直接出现在web-app元素内的合法元素所必需的次序。例如，此列表说明servlet元素必须出现在所有servlet-mapping元素之前。请注意Q所有这些元素都是可选的。因此，可以省略掉某一元素Q但不能把它放于不正的位置?BR>l icon icon元素指出IDE和GUI工具用来表示Web应用的一个和两个囑փ文g的位|?BR>l display-name display-name元素提供GUI工具可能会用来标记这个特定的Web应用的一个名U?BR>l description description元素l出与此有关的说明性文本?BR>l context-param context-param元素声明应用范围内的初始化参数?BR>l filter qo器元素将一个名字与一个实现javax.servlet.Filter接口的类相关联?BR>l filter-mapping 一旦命名了一个过滤器Q就要利用filter-mapping元素把它与一个或多个servlet或JSP面相关联?BR>l listener servlet API的版?.3增加了对事g监听E序的支持，事g监听E序在徏立、修改和删除会话或servlet环境时得到通知。Listener元素指出事g监听E序cR?BR>l servlet 在向servlet或JSP面制定初始化参数或定制URLӞ必须首先命名servlet或JSP面。Servlet元素是用来完成此项d的?BR>l servlet-mapping 服务器一般ؓservlet提供一个缺省的URLQ?/FONT>http://host/webAppPrefix/servlet/ServletName。但是，常常会更改这个URLQ以便servlet可以讉K初始化参数或更容易地处理相对URL。在更改~省URLӞ使用servlet-mapping元素?BR>l session-config 如果某个会话在一定时间内未被讉KQ服务器可以抛弃它以节省内存。可通过使用HttpSession的setMaxInactiveIntervalҎ(gu)明确讄单个会话对象的超时|或者可利用session-config元素制定~省时倹{?BR>l mime-mapping 如果Web应用h惛_Ҏ(gu)的文Ӟ希望能保证给他们分配特定的MIMEcdQ则mime-mapping元素提供q种保证?BR>l welcom-file-list welcome-file-list元素指示服务器在收到引用一个目录名而不是文件名的URLӞ使用哪个文g?BR>l error-page error-page元素使得在返回特定HTTP状态代码时Q或者特定类型的异常被抛出时Q能够制定将要显C的面?BR>l taglib taglib元素Ҏ(gu)记库描述W文ӞTag Libraryu Descriptor fileQ指定别名。此功能使你能够更改TLD文g的位|，而不用编辑用这些文件的JSP面?BR>l resource-env-ref resource-env-ref元素声明与资源相关的一个管理对象?BR>l resource-ref resource-ref元素声明一个资源工厂用的外部资源?BR>l security-constraint security-constraint元素制定应该保护的URL。它与login-config元素联合使用
l login-config 用login-config元素来指定服务器应该怎样l试图访问受保护面的用h权。它与sercurity-constraint元素联合使用?BR>l security-role security-role元素l出安全角色的一个列表，q些角色出现在servlet元素内的security-role-ref元素的role-name子元素中。分别地声明角色可高IDE处理安全信息更ؓҎ(gu)?BR>l env-entry env-entry元素声明Web应用的环境项?BR>l ejb-ref ejb-ref元素声明一个EJB的主目录的引用?BR>l ejb-local-ref ejb-local-ref元素声明一个EJB的本C目录的应用?BR>
3 分配名称和定制的UL
在web.xml中完成的一个最常见的Q务是对servlet或JSP面l出名称和定制的URL。用servlet元素分配名称Q用servlet-mapping元素定制的URL与刚分配的名U相兌?BR>3.1 分配名称
Z提供初始化参敎ͼ对servlet或JSP面定义一个定制URL或分配一个安全角Ԍ必须首先lservlet或JSP面一个名U。可通过 servlet元素分配一个名U。最常见的格式包括servlet-name和servlet-class子元素（在web-app元素内）Q如下所C：
<servlet>
<servlet-name>Test</servlet-name>
<servlet-class>moreservlets.TestServlet</servlet-class>
</servlet>
q表CZ于WEB-INF/classes/moreservlets/TestServlet的servlet已经得到了注册名Test。给 servlet一个名U具有两个主要的含义。首先，初始化参数、定制的URL模式以及其他定制通过此注册名而不是类名引用此servlet。其?可在 URL而不是类名中使用此名U。因此，利用刚才l出的定义，URL http://host/webAppPrefix/servlet/Test 可用?http://host/webAppPrefix/servlet/moreservlets.TestServlet 的场所?BR>误住：XML元素不仅是大写敏感的，而且定义它们的次序也很重要。例如，web-app元素内所有servlet元素必须位于所有servlet- mapping元素Q下一节介绍Q之前，而且q要位于5.6节和5.11节讨论的与过滤器或文档相关的元素Q如果有的话Q之前。类似地Qservlet 的servlet-name子元素也必须出现在servlet-class之前?.2?部v描述W文件内的元素次?详l介l这U必需的次序?BR>例如Q程序清?-1l出了一个名为TestServlet的简单servletQ它ȝ在moreservletsE序包中。因为此servlet是扎根在一个名为deployDemo的目录中的Web应用的组成部分，所以TestServlet.class攑֜deployDemo/WEB- INF/classes/moreservlets中。程序清?-2l出放|在deployDemo/WEB-INF/内的web.xml文g的一部分。此web.xml文g使用servlet-name和servlet-class元素名UTest与TestServlet.class相关联。图 5-1和图5-2分别昄利用~省URL和注册名调用TestServlet时的l果?BR>
E序清单5-1 TestServlet.java
package moreservlets;
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
/** Simple servlet used to illustrate servlet naming
* and custom URLs.
* <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 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>");
}
}
E序清单5-2 web.xmlQ说明servlet名称的摘录）
<?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>
3.2 定义定制的URL
大多数服务器h一个缺省的serlvet URLQ?BR>http://host/webAppPrefix/servlet/packageName.ServletName。虽然在开发中使用q个URL很方便，但是我们常常会希望另一个URL用于部v。例如，可能会需要一个出现在Web应用层的URLQ如Qhttp: //host/webAppPrefix/AnynameQ，q且在此URL中没有servletV位于顶层的URL化了相对URL的用。此外，对许多开发h员来_层URL看上L更长更麻烦的~省URL更简短?BR>事实上，有时需要用定制的URL。比如，你可能想关闭~省URL映射Q以便更好地强制实施安全限制或防止用h外地讉K无初始化参数的servlet。如果你止了缺省的URLQ那么你怎样讉Kservlet呢？q时只有使用定制的URL了?BR>Z分配一个定制的URLQ可使用servlet-mapping元素及其servlet-name和url-pattern子元素。Servlet- name元素提供了一个Q意名Uͼ可利用此名称引用相应的servletQurl-pattern描述了相对于Web应用的根目录的URL。url- pattern元素的值必M斜杠Q?Qv始?BR>下面l出一个简单的web.xml摘录Q它允许使用URL http://host/webAppPrefix/UrlTest而不?/FONT>http://host/webAppPrefix/servlet/Test?BR>http: //host/webAppPrefix/servlet/moreservlets.TestServlet。请注意Q仍焉要XML头?DOCTYPE声明以及web-app闭元素。此外，可回忆一下，XML元素出现地次序不是随意的。特别是Q需要把所有servlet元素攑֜所?servlet-mapping元素之前?BR><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模式q可以包含通配W。例如，下面的小E序指示服务器发送所有以Web应用的URL前缀开始，?.aspl束的请求到名ؓBashMS的servlet?BR><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面要{换成sevletQ自然希望就像命名servlet一样命名JSP面。毕竟，JSP面可能会从初始化参数、安全设|或定制的URL中受益，正如普通的serlvet那样。虽然JSP面的后台实际上是servletq句话是正确的，但存在一个关键的猜疑Q即Q你不知道JSP面的实际类名（因ؓpȝ自己挑选这个名字）。因此，Z命名JSP面Q可jsp-file元素替换为servlet-calss元素Q如下所C：
<servlet>
<servlet-name>Test</servlet-name>
<jsp-file>/TestPage.jsp</jsp-file>
</servlet>
命名JSP面的原因与命名servlet的原因完全相同：即ؓ了提供一个与定制讄Q如Q初始化参数和安全设|）一起用的名称Qƈ且，以便能更Ҏ(gu)z?JSP面的URLQ比方说Q以便多个URL通过相同面得以处理Q或者从URL中去?jsp扩展名）。但是，在设|初始化参数Ӟ应该注意QJSP面是利用jspInitҎ(gu)Q而不是initҎ(gu)d初始化参数的?BR>例如Q程序清?-3l出一个名为TestPage.jsp的简单JSP面Q它的工作只是打印出用来Ȁzd的URL的本地部分。TestPage.jsp攄在deployDemo应用的顶层。程序清?-4l出了用来分配一个注册名PageNameQ然后将此注册名?/FONT>http://host/webAppPrefix/UrlTest2/anything 形式的URL相关联的web.xml文gQ即QdeployDemo/WEB-INF/web.xmlQ的一部分?BR>
E序清单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>
E序清单5-4 web.xmlQ说明JSP命名的摘录Q?BR><?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 止Ȁzdservlet
对servlet或JSP面建立定制URL的一个原因是Q这样做可以注册?initQservletQ或jspInitQJSP面Q方法中d得初始化参数。但是，初始化参数只在是利用定制URL模式或注册名讉K servlet或JSP面时可以用，用缺省URL http://host/webAppPrefix/servlet/ServletName 讉K时不能用。因此，你可能会希望关闭~省URLQ这样就不会有h意外地调用初始化servlet了。这个过E有时称为禁止激zdservletQ因为多数服务器h一个用~省的servlet URL注册的标准servletQƈȀzȝ省的URL应用的实际servlet?BR>有两U禁止此~省URL的主要方法：
l 在每个Web应用中重新映?servlet/模式?BR>l 全局关闭Ȁzdservlet?BR>重要的是应该注意刎ͼ虽然重新映射每个Web应用中的/servlet/模式比彻底禁止激zservlet所做的工作更多Q但重新映射可以用一U完全可UL的方式来完成。相反，全局止Ȁzdservlet完全是针对具体机器的Q事实上有的服务器（如ServletExecQ没有这L选择。下面的讨论Ҏ(gu)个Web应用重新映射/servlet/ URL模式的策略。后面提供在Tomcat中全局止Ȁzdservlet的详l内宏V?BR>4.1 重新映射/servlet/URL模式
在一个特定的Web应用中禁止以http://host/webAppPrefix/servlet/ 开始的URL的处理非常简单。所需做的事情是建立一个错误消息servletQƈ使用前一节讨论的url-pattern元素所有匹配请求{向该 servlet。只要简单地使用Q?BR><url-pattern>/servlet/*</url-pattern>
作ؓservlet-mapping元素中的模式卛_?BR>例如Q程序清?-5l出了将SorryServlet servletQ程序清?-6Q与所有以http://host/webAppPrefix/servlet/ 开头的URL相关联的部v描述W文件的一部分?BR>
E序清单5-5 web.xmlQ说明JSP命名的摘录Q?BR><?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>
E序清单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 全局止ȀzdQTomcat
Tomcat 4中用来关闭缺省URL的方法与Tomcat 3中所用的很不相同。下面介l这两种Ҏ(gu)Q?BR>1Q禁止激zdQ?Tomcat 4
Tomcat 4用与前面相同的方法关闭激zdservletQ即利用web.xml中的url-mapping元素q行关闭。不同之处在于Tomcat使用了放?install_dir/conf中的一个服务器专用的全局web.xml文gQ而前面用的是存攑֜每个Web应用的WEB-INF目录中的标准 web.xml文g?BR>因此Qؓ了在Tomcat 4中关闭激zdservletQ只需在install_dir/conf/web.xml中简单地注释?servlet/* URL映射即可，如下所C：
<!--
<servlet-mapping>
<servlet-name>invoker</servlet-name>
<url-pattern>/servlet/*</url-pattern>
</servlet-mapping>
-->
再次提醒Q应该注意这个项是位于存攑֜install_dir/conf的Tomcat专用的web.xml文g中的Q此文g不是存放在每个Web应用的WEB-INF目录中的标准web.xml?BR>2Q禁止激zdQTomcat3
在Apache Tomcat的版?中，通过在install_dir/conf/server.xml中注释出InvokerInterceptor全局止~省 servlet URL。例如，下面是禁止用缺省servlet URL的server.xml文g的一部分?BR><!--
<RequsetInterceptor
className="org.apache.tomcat.request.InvokerInterceptor"
debug="0" prefix="/servlet/" />
-->
5 初始化和预装载servlet与JSP面
q里讨论控制servlet和JSP面的启动行为的Ҏ(gu)。特别是Q说明了怎样分配初始化参C及怎样更改服务器生存期中装载servlet和JSP面的时刅R?BR>5.1 分配servlet初始化参?BR>利用init-param元素向servlet提供初始化参敎ͼinit-param元素hparam-name和param-value子元素。例如，在下面的例子中，如果initServlet servlet是利用它的注册名QInitTestQ访问的Q它?yu)能够从其方法中调用getServletConfig(). getInitParameter("param1")获得"Value 1"Q调用getServletConfig().getInitParameter("param2")获得"2"?BR><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>
在涉及初始化参数Ӟ有几炚w要注意：
l q回倹{GetInitParameter的返回值L一个String。因此，在前一个例子中Q可对param2使用Integer.parseInt获得一个int?BR>l JSP中的初始化。JSP面使用jspInit而不是init。JSP面q需要用jsp-file元素代替servlet-class?BR>l ~省URL。初始化参数只在通过它们的注册名或与它们注册名相关的定制URL模式讉KServlet时可以用。因此，在这个例子中Qparam1?param2初始化参数将能够在用URL http://host/webAppPrefix/servlet/InitTest 时可用，但在使用URL http://host/webAppPrefix/servlet/myPackage.InitServlet 时不能用?BR>例如Q程序清?-7l出一个名为InitServlet的简单servletQ它使用initҎ(gu)讄firstName和emailAddress字段。程序清?-8l出分配名称InitTestlservlet的web.xml文g?BR>E序清单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>");
}
}
E序清单5-8 web.xmlQ说明初始化参数的摘录）
<?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>
5.2 分配JSP初始化参?BR>lJSP面提供初始化参数在三个斚w不同于给servlet提供初始化参数?BR>1Q用jsp-file而不是servlet-class。因此，WEB-INF/web.xml文g的servlet元素如下所C：
<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) 几乎L分配一个明的URL模式。对servletQ一般相应地使用?/FONT>http://host/webAppPrefix/servlet/ 开始的~省URL。只需CQ用注册名而不是原名称卛_。这对于JSP面在技术上也是合法的。例如，在上面给出的例子中，可用URL http://host/webAppPrefix/servlet/PageName 讉KRealPage.jsp的对初始化参数具有访问权的版本。但在用于JSP面Ӟ许多用户g不喜Ƣ应用常规的servlet的URL。此外，如果 JSP面位于服务器ؓ其提供了目录清单的目录中Q如Q一个既没有index.html也没有index.jsp文g的目录）Q则用户可能会连接到?JSP面Q单dQ从而意外地ȀzL初始化的面。因此，好的办法是用url-patternQ?.3节）JSP面的原URL与注册的 servlet名相兌。这P客户机可使用JSP面的普通名Uͼ但仍然激zd制的版本。例如，l定来自目1的servlet定义Q可使用下面?servlet-mapping定义Q?BR><servlet-mapping>
<servlet-name>PageName</servlet-name>
<url-pattern>/RealPage.jsp</url-pattern>
</servlet-mapping>
3QJSP用jspInit而不是init。自动从JSP面建立的servlet或许已经使用了intiҎ(gu)。因此，使用JSP声明提供一个initҎ(gu)是不合法的，必须制定jspInitҎ(gu)?BR>Z说明初始化JSP面的过E，E序清单5-9l出了一个名为InitPage.jsp的JSP面Q它包含一个jspInitҎ(gu)且放|于 deployDemo Web应用层次l构的顶层。一般，http://host/deployDemo/InitPage.jsp 形式的URL激zL面的不h初始化参数访问权的版本，从而将对firstName和emailAddress变量昄null。但是， web.xml文gQ程序清?-10Q分配了一个注册名Q然后将该注册名与URL模式/InitPage.jsp相关联?BR>
E序清单5-9 InitPage.jsp
<!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");
}
%>
E序清单5-10 web.xmlQ说明JSP面的init参数的摘录）
<?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>
5.3 提供应用范围内的初始化参?BR>一般，对单个地servlet或JSP面分配初始化参数。指定的servlet或JSP面利用ServletConfig的getInitParameterҎ(gu)dq些参数。但是，在某些情形下Q希望提供可׃Q意servlet或JSP面借助ServletContext的getInitParameterҎ(gu)d的系l范围内的初始化参数?BR>可利用context-param元素声明q些pȝ范围内的初始化倹{context-param元素应该包含param-name、param-value以及可选的description子元素，如下所C：
<context-param>
<param-name>support-email</param-name>
<param-value>blackhole@mycompany.com</param-value>
</context-param>
可回忆一下，Z保证可移植性，web.xml内的元素必须以正的ơ序声明。但q里应该注意Qcontext-param元素必须出现L与文档有关的元素Qicon、display-name或descriptionQ之后及filter、filter-mapping、listener?servlet元素之前?BR>5.4 在服务器启动时装载servlet
假如servlet或JSP面有一个要花很长时间执行的init QservletQ或jspInitQJSPQ方法。例如，假如init或jspInitҎ(gu)从某个数据库或ResourceBundle查找产量。这U情况下Q在W一个客hh时装载servlet的缺省行为将对第一个客h产生较长旉的gq。因此，可利用servlet的load-on- startup元素规定服务器在W一ơ启动时装蝲servlet。下面是一个例子?BR><servlet>
<servlet-name> ?</servlet-name>
<servlet-class> ?</servlet-class> <!-- Or jsp-file -->
<load-on-startup/>
</servlet>
可以为此元素体提供一个整数而不是用一个空的load-on-startup。想法是服务器应该在装蝲较大数目的servlet或JSP面之前装蝲较少数目的servlet或JSP面。例如，下面的servlet（攄在Web应用的WEB-INF目录下的web.xml文g中的web-app元素内）指C服务器首先装蝲和初始化SearchServletQ然后装载和初始化由位于Web应用的result目录中的index.jsp文g产生?servlet?BR><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 声明qo?BR>
servlet版本2.3引入了过滤器的概c虽然所有支持servlet API版本2.3的服务器都支持过滤器Q但Z使用与过滤器有关的元素，必须在web.xml中用版?.3的DTD?BR>qo器可截取和修改进入一个servlet或JSP面的请求或从一个servlet或JSP面发出的相应。在执行一个servlet或JSP面之前Q必L行第一个相关的qo器的doFilterҎ(gu)。在该过滤器对其FilterChain对象调用doFilterӞ执行链中的下一个过滤器。如果没有其他过滤器Qservlet或JSP面被执行。过滤器h对到来的ServletRequest对象的全部访问权Q因此，它们可以查看客户机名、查扑ֈ来的cookie{。ؓ了访问servlet或JSP面的输出，qo器可响应对象包裹在一个替w对象（stand-in objectQ中Q比方说把输出篏加到一个缓冲区。在调用FilterChain对象的doFilterҎ(gu)之后Q过滤器可检查缓冲区Q如有必要，对它进行修改，然后传送到客户机?BR>例如Q程序清?-11帝国难以了一个简单的qo器，只要讉K相关的servlet或JSP面Q它?yu)截取请求ƈ在标准输Z打印一个报告（开发过E中在桌面系l上q行Ӟ大多数服务器都可以用这个过滤器Q?BR>
E序清单5-11 ReportFilter.java
package moreservlets;
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.*;
/** Simple filter that prints a report on the standard output
* whenever the associated servlet or JSP page is accessed.
* <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 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() {}
}
一旦徏立了一个过滤器Q可以在web.xml中利用filter元素以及filter-nameQQ意名Uͼ、file-classQ完全限定的cdQ和Q可选的Qinit-params子元素声明它。请注意Q元素在web.xml的web-app元素中出现的ơ序不是L的；允许服务器（但不是必需的）强制所需的次序，q且实际中有些服务器也是q样做的。但q里要注意，所有filter元素必须出现在Q意filter-mapping元素之前Q?filter-mapping元素又必d现在所有servlet或servlet-mapping元素之前?BR>例如Q给定上q的ReportFilterc，可在web.xml中作Z面的filter声明。它把名UReporter与实际的cReportFilterQ位于moreservletsE序包中Q相兌?BR><filter>
<filter-name>Reporter</filter-name>
<filter-class>moresevlets.ReportFilter</filter-class>
</filter>
一旦命名了一个过滤器Q可利用filter-mapping元素把它与一个或多个servlet或JSP面相关联。关于此工作有两种选择?BR>首先Q可使用filter-name和servlet-name子元素把此过滤器与一个特定的servlet名（此servlet名必ȝ后在相同?web.xml文g中用servlet元素声明Q关联。例如，下面的程序片断指C系l只要利用一个定制的URL讉K名ؓSomeServletName 的servlet或JSP面Q就q行名ؓReporter的过滤器?BR><filter-mapping>
<filter-name>Reporter</filter-name>
<servlet-name>SomeServletName</servlet-name>
</filter-mapping>
其次Q可利用filter-name和url-pattern子元素将qo器与一lservlet、JSP面或静态内容相兌。例如，盔R的程序片D|C系l只要访问Web应用中的LURLQ就q行名ؓReporter的过滤器?BR><filter-mapping>
<filter-name>Reporter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
例如Q程序清?-12l出了将ReportFilterqo器与名ؓPageName的servlet相关联的web.xml文g的一部分。名?PageName依次又与一个名为TestPage.jsp的JSP面以及以模式http: //host/webAppPrefix/UrlTest2/ 开头的URL相关联。TestPage.jsp的源代码已经JSP面命名的谈论在前面??分配名称和定制的URL"中给出。事实上Q程序清?- 12中的servlet和servlet-name从该节原封不动地拿q来的。给定这些web.xml，可看C面的标准输出形式的调试报告（换行是ؓ了容易阅读）?BR>audit.irs.gov tried to access
http://mycompany.com/deployDemo/UrlTest2/business/tax-plan.html
on Tue Dec 25 13:12:29 EDT 2001.
E序清单5-12 Web.xmlQ说明filter用法的摘录）
<?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>
7 指定Ƣ迎?BR>
假如用户提供了一个像http: //host/webAppPrefix/directoryName/ q样的包含一个目录名但没有包含文件名的URLQ会发生什么事情呢Q用戯得到一个目录表Q一个错误？q是标准文g的内容？如果得到标准文g内容Q是 index.html、index.jsp、default.html、default.htm或别的什么东西呢Q?BR>Welcome-file-list 元素及其辅助的welcome-file元素解决了这个模p的问题。例如，下面的web.xmlҎ(gu)出，如果一个URLl出一个目录名但未l出文g名，服务器应该首先试用index.jspQ然后再试用index.html。如果两者都没有扑ֈQ则l果有赖于所用的服务器（如一个目录列表）?BR><welcome-file-list>
<welcome-file>index.jsp</welcome-file>
<welcome-file>index.html</welcome-file>
</welcome-file-list>
虽然许多服务器缺省遵循这U行为，但不一定必这栗因此，明确C用welcom-file-list保证可移植性是一U良好的习惯?BR>
8 指定处理错误的页?BR>
现在我了解到Q你在开发servlet和JSP面时从不会犯错误，而且你的所有页面是那样的清晎ͼ一般的E序员都不会被它们的搞糊涂。但是，是hM犯错误的Q用户可能会提供不合规定的参敎ͼ使用不正的URL或者不能提供必需的表单字D倹{除此之外，其它开发h员可能不那么l心Q他们应该有些工h克服自己的不?BR>error-page元素是用来克服q些问题的。它有两个可能的子元素，分别是：error-code和exception- type。第一个子元素error-code指出在给定的HTTP错误代码出现时用的URL。第二个子元素excpetion-type指出在出现某个给定的Java异常但未捕捉到时使用的URL。error-code和exception-type都利用location元素指出相应的URL。此 URL必须?开始。location所指出的位|处的页面可通过查找HttpServletRequest对象的两个专门的属性来讉K关于错误的信息，q两个属性分别是Qjavax.servlet.error.status_code和javax.servlet.error.message?BR>可回忆一下，在web.xml内以正确的次序声明web-app的子元素很重要。这里只要记住，error-page出现在web.xml文g的末Nq，servlet、servlet-name和welcome-file-list之后卛_?BR>
8.1 error-code元素
Z更好C解error-code元素的|可考虑一下如果不正确地输入文件名Q大多数站点会作Z么反映。这样做一般会出现一?04错误信息Q它表示不能扑ֈ该文Ӟ但几乎没提供更多有用的信息。另一斚wQ可以试一下在www.microsoft.com?/FONT>www.ibm.com 处或者特别是?/FONT>www.bea.com 处输出未知的文g名。这是会得出有用的消息，q些消息提供可选择的位|，以便查找感兴的面。提供这h用的错误面对于Web应用来说是很有h(hun)值得。事实上rm-error-page子元素）。由form-login-pagel出的HTML表单必须h一个j_security_check?ACTION属性、一个名为j_username的用户名文本字段以及一个名为j_password的口令字Dc?BR>例如Q程序清?-19指示服务器用基于表单的验证。Web应用的顶层目录中的一个名为login.jsp的页面将攉用户名和口oQƈ且失败的登陆由相同目录中名为login-error.jsp的页面报告?BR>
E序清单5-19 web.xmlQ说明login-config的摘录）
<?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>
9.2 限制对Web资源的访?BR>现在Q可以指C服务器使用何种验证Ҏ(gu)了?了不P"你说道，"除非我能指定一个来收到保护?URLQ否则没有多大用处?没错。指些URLq说明他们应该得CU保护正是security-constriaint元素的用途。此元素?web.xml中应该出现在login-config的紧前面。它包含是个可能的子元素Q分别是Qweb-resource-collection?auth-constraint、user-data-constraint和display-name。下面各节对它们进行介l?BR>l web-resource-collection
此元素确定应该保护的资源。所有security-constraint元素都必d含至一个web-resource-collectionV此元素׃个给ZQ意标识名U的web-resource-name元素、一个确定应该保护的URL的url-pattern元素、一个指出此保护所适用?HTTP命oQGET、POST{，~省为所有方法）的http-method元素和一个提供资料的可选description元素l成。例如，下面?Web-resource-collection（在security-constratint元素内）指出Web应用的proprietary目录中所有文档应该受C护?BR><security-constraint>
<web-resource-coolection>
<web-resource-name>Proprietary</web-resource-name>
<url-pattern>/propritary/*</url-pattern>
</web-resource-coolection>
<!-- ... -->
</security-constraint>
重要的是应该注意刎ͼurl-pattern仅适用于直接访问这些资源的客户机。特别是Q它不适合于通过MVC体系l构利用 RequestDispatcher来访问的面Q或者不适合于利用类似jsp:forward的手D|讉K的页面。这U不匀U如果利用得当的话很有好处。例如，servlet可利用MVC体系l构查找数据Q把它放到bean中，发送请求到从bean中提取数据的JSP面q显C它。我们希望保证决不直接访问受保护的JSP面Q而只是通过建立该页面将使用的bean的servlet来访问它。url-pattern和auth-contraint元素可通过声明不允怓Q何用L接访问JSP面来提供这U保证。但是，q种不匀U的行ؓ可能让开发h员放松警惕，使他们偶然对应受保护的资源提供不受限制的讉K?
l auth-constraint
管web-resource-collention元素质出了哪些URL应该受到保护Q但是auth-constraint元素却指出哪些用户应该具有受保护资源的访问权。此元素应该包含一个或多个标识h讉K权限的用L别role- name元素Q以及包含（可选）一个描q角色的description元素。例如，下面web.xml中的security-constraint元素部门规定只有指定为Administrator或Big KahunaQ或两者）的用户具有指定资源的讉K权?BR><security-constraint>
<web-resource-coolection> ... </web-resource-coolection>
<auth-constraint>
<role-name>administrator</role-name>
<role-name>kahuna</role-name>
</auth-constraint>
</security-constraint>
重要的是认识刎ͼ到此为止Q这个过E的可移植部分结束了。服务器怎样定哪些用户处于M角色以及它怎样存放用户的口令，完全有赖于具体的pȝ?BR>例如QTomcat使用install_dir/conf/tomcat-users.xml用户名与角色名和口令相兌Q正如下面例子中所C，它指出用户joeQ口令bigshotQ和janeQ口令enajQ属于administrator和kahuna角色?BR><tomcat-users>
<user name="joe" password="bigshot" roles="administrator,kahuna" />
<user name="jane" password="enaj" roles="kahuna" />
</tomcat-users>
l user-data-constraint
q个可选的元素指出在访问相兌源时使用M传输层保护。它必须包含一个transport-guarantee子元素（合法gؓNONE?INTEGRAL或CONFIDENTIALQ，q且可选地包含一个description元素。transport-guarantee为NONE值将Ҏ(gu)用的通讯协议不加限制。INTEGRALDC数据必M一U防止截取它的h阅读它的方式传送。虽然原理上Qƈ且在未来的HTTP版本中）Q在 INTEGRAL和CONFIDENTIAL之间可能会有差别Q但在当前实践中Q他们都只是单地要求用SSL。例如，下面指示服务器只允许对相兌源做 HTTPSq接Q?BR><security-constraint>
<!-- ... -->
<user-data-constraint>
<transport-guarantee>CONFIDENTIAL</transport-guarantee>
</user-data-constraint>
</security-constraint>
l display-name
security-constraint的这个很用的子元素给予可能由GUI工具使用的安全约束项一个名U?BR>9.3 分配角色?BR>q今为止Q讨论已l集中到完全由容器（服务器）处理的安全问题之上了。但servlet以及JSP面也能够处理它们自q安全问题?BR>例如Q容器可能允许用户从bigwig或bigcheese角色讉K一个显CZh员额外紧贴的面Q但只允许bigwig用户修改此页面的参数。完成这U更l致的控制的一U常见方法是调用HttpServletRequset的isUserInRoleҎ(gu)Qƈ据此修改讉K?BR>Servlet?security-role-ref子元素提供出现在服务器专用口令文件中的安全角色名的一个别名。例如，假如~写了一个调?request.isUserInRoleQ?boss"Q的servletQ但后来该servlet被用在了一个其口o文g调用角色manager而不是boss的服务器中。下面的E序D该servlet能够使用q两个名UC的Q何一个?BR><servlet>
<!-- ... -->
<security-role-ref>
<role-name>boss</role-name> <!-- New alias -->
<role-link>manager</role-link> <!-- Real name -->
</security-role-ref>
</servlet>
也可以在web-app内利用security-role元素提供出现在role-name元素中的所有安全角色的一个全局列表。分别地生命角色佉KUIDEҎ(gu)处理安全信息?BR>
10 控制会话时
如果某个会话在一定的旉内未被访问，服务器可把它扔掉以节U内存。可利用HttpSession的setMaxInactiveIntervalҎ(gu)直接讄个别会话对象的超时倹{如果不采用q种Ҏ(gu)Q则~省的超时值由具体的服务器军_。但可利用session-config和session- timeout元素来给Z个适用于所有服务器的明的时倹{超时值的单位为分钟，因此Q下面的例子讄~省会话时gؓ三个时Q?80分钟Q?BR><session-config>
<session-timeout>180</session-timeout>
</session-config>
11 Web应用的文档化
来多的开发环境开始提供servlet和JSP的直接支持。例子有Borland Jbuilder Enterprise Edition、Macromedia UltraDev、Allaire JRun StudioQ写此文Ӟ已被Macromedia收购Q以及IBM VisuaAge for Java{?BR>大量的web.xml元素不仅是ؓ服务器设计的Q而且q是为可视开发环境设计的。它们包括icon、display-name和discription{?BR>可回忆一下，在web.xml内以适当地次序声明web-app子元素很重要。不q，q里只要Cicon、display-name和description是web.xml的web-app元素内的前三个合法元素即可?BR>l icon
icon元素指出GUI工具可用来代表Web应用的一个和两个囑փ文g。可利用small-icon元素指定一q?6 x 16的GIF或JPEG囑փQ用large-icon元素指定一q?2 x 32的图像。下面D一个例子：
<icon>
<small-icon>/images/small-book.gif</small-icon>
<large-icon>/images/tome.jpg</large-icon>
</icon>
l display-name
display-name元素提供GUI工具可能会用来标记此Web应用的一个名U。下面是个例子?BR><display-name>Rare Books</display-name>
l description
description元素提供解释性文本，如下所C：
<description>
This Web application represents the store developed for
rare-books.com, an online bookstore specializing in rare
and limited-edition books.
</description>
12 兌文g与MIMEcd
服务器一般都h一U让Web站点理员将文g扩展名与媒体相关联的Ҏ(gu)。例如，会自动l予名ؓmom.jpg的文件一个image/jpeg的MIME cd。但是，假如你的Web应用h几个不寻常的文gQ你希望保证它们在发送到客户机时分配为某UMIMEcd。mime-mapping元素Q具?extension和mime-type子元素）可提供这U保证。例如，下面的代码指C服务器application/x-fubar的MIMEcd分配l所有以.fool尾的文件?BR><mime-mapping>
<extension>foo</extension>
<mime-type>application/x-fubar</mime-type>
</mime-mapping>
或许Q你的Web应用希望重蝲QoverrideQ标准的映射。例如，下面的代码将告诉服务器在发送到客户机时指定.ps文g作ؓU文本（text/plainQ而不是作为PostScriptQapplication/postscriptQ?BR><mime-mapping>
<extension>ps</extension>
<mime-type>application/postscript</mime-type>
</mime-mapping>
13 定位TLD
JSP taglib元素h一个必要的uri属性，它给Z个TLDQTag Library DescriptorQ文件相对于Web应用的根的位|。TLD文g的实际名U在发布新的标签库版本时可能会改变，但我们希望避免更Ҏ(gu)有现有JSP面。此外，可能q希望用保持taglib元素的简l性的一个简短的uri。这是部v描述W文件的taglib元素z场的所在了。Taglib包含两个子元素：taglib-uri和taglib-location。taglib-uri元素应该与用于JSP taglib元素的uri属性的东西相匹配。Taglib-location元素l出TLD文g的实际位|。例如，假如你将文gchart-tags- 1.3beta.tld攑֜WebApp/WEB-INF/tlds中。现在，假如web.xml在web-app元素内包含下列内宏V?BR><taglib>
<taglib-uri>/charts.tld</taglib-uri>
<taglib-location>
/WEB-INF/tlds/chart-tags-1.3beta.tld
</taglib-location>
</taglib>
l出q个说明后，JSP面可通过下面的简化Ş式用标{ֺ?BR><%@ taglib uri="/charts.tld" prefix="somePrefix" %>
14 指定应用事g监听E序
应用事g监听器程序是建立或修改servlet环境或会话对象时通知的类。它们是servlet规范的版?.3中的新内宏V这里只单地说明用来向Web应用注册一个监听程序的web.xml的用法?BR>注册一个监听程序涉及在web.xml的web-app元素内放|一个listener元素。在listener元素内，listener-class元素列出监听E序的完整的限定cdQ如下所C：
<listener>
<listener-class>package.ListenerClass</listener-class>
</listener>
虽然listener元素的结构很单，但请不要忘记Q必L地l出web-app元素内的子元素的ơ序。listener元素位于所有的servlet 元素之前以及所有filter-mapping元素之后。此外，因ؓ应用生存期监听程序是serlvet规范?.3版本中的新内容，所以必M?web.xml DTD?.3版本Q而不?.2版本?BR>例如Q程序清?-20l出一个名为ContextReporter的简单的监听E序Q只要Web应用的Servlet-Context建立Q如装蝲Web应用Q或消除Q如服务器关闭）Ӟ它就在标准输Z昄一条消息。程序清?-21l出此监听程序注册所需要的web.xml文g的一部分?BR>
E序清单5-20 ContextReporterjava
package moreservlets;
import javax.servlet.*;
import java.util.*;
/** Simple listener that prints a report on the standard output
* when the ServletContext is created or destroyed.
* <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 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() + ".");
}
}
E序清单5-21 web.xmlQ声明一个监听程序的摘录Q?BR><?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>
15 J2EE元素
本节描述用作J2EE环境l成部分的Web应用的web.xml元素。这里将提供一个简明的介绍Q详l内容可以参?/FONT>http://java.sun.com/j2ee/j2ee-1_3-fr-spec.pdf的Java 2 Plantform Enterprise Edition版本1.3规范的第5章?BR>l distributable
distributable 元素指出QWeb应用是以q样的方式编E的Q即Q支持集的服务器可安全地在多个服务器上分布Web应用。例如，一个可分布的应用必d使用 Serializable对象作ؓ其HttpSession对象的属性，而且必须避免用实例变量（字段Q来实现持箋性。distributable元素直接出现在discription元素之后Qƈ且不包含子元素或数据Q它只是一个如下的标志?BR><distributable />
l resource-env-ref
resource -env-ref元素声明一个与某个资源有关的管理对象。此元素׃个可选的description元素、一个resource-env-ref- name元素Q一个相对于java:comp/env环境的JNDI名）以及一个resource-env-type元素Q指定资源类型的完全限定的类Q，如下所C：
<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应用的环境项。它׃个可选的description元素、一个env-entry-name元素Q一个相对于java: comp/env环境JNDI名）、一个env-entry-value元素Q项|以及一个env-entry-type元素Qjava.langE序包中一个类型的完全限定cdQjava.lang.Boolean、java.lang.String{）l成。下面是一个例子：
<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元素声明对一个EJB的主目录的应用。它׃个可选的description元素、一个ejb-ref-name元素Q相对于java: comp/env的EJB应用Q、一个ejb-ref-type元素Qbean的类型，Entity或SessionQ、一个home元素Qbean的主目录接口的完全限定名Q、一个remote元素Qbean的远E接口的完全限定名）以及一个可选的ejb-link元素Q当前bean链接的另一?bean的名Uͼl成?BR>l ejb-local-ref
ejb-local-ref元素声明一个EJB的本C目录的引用。除了用local-home代替home外，此元素具有与ejb-ref元素相同的属性ƈ以相同的方式使用
]]>