]]>
|
W一个处理所有直接由Tomcat服务器接收的web客户h. 1>className 指定实现org.apahce.catalina.Service接口的类.默认为org.apahce.catalina.core.StandardService
在可以包含如下元? , ,
在元素中可以包含如下子元?br />, , ,
W一个Connector元素定义了一个HTTP Connector,它通过8080端口接收HTTPh;W二个Connector元素定义了一个JD Connector,它通过8009端口接收由其它服务器转发q来的请? Connector元素q属?br />1>className指定实现Connector接口的类 |
]]>
DOCYTPE声明必须立即出现在此头之后。这个声明告诉服务器适用的servlet规范的版本（?.2?.3Qƈ指定理此文件其余部分内容的语法的DTD(Document Type DefinitionQ?/p>
文cd定义)?/p>
所有部|描q符文g的顶层（根）元素为web-app。请注意QXML元素不像HTMLQ他们是大小写敏感的。因此，web-App和WEB-APP都是不合法的Qweb-app必须用小写?/p>
2 部v描述W文件内的元素次?br />XML 元素不仅是大写敏感的，而且它们q对出现在其他元素中的次序敏感。例如，XML头必L文g中的W一，DOCTYPE声明必须是第二项Q而web- app元素必须是第三项。在
web-app元素内，元素的次序也很重要。服务器不一定强制要求这U次序，但它们允许（实际上有些服务器是q样做的Q完全拒l执行含有次序不正确的元素的Web应用。这表示
使用非标准元素次序的web.xml文g是不可移植的?/p>
下面的列表给Z所有可直接出现在web-app元素内的合法元素所必需的次序。例如，此列表说明servlet元素必须出现在所有servlet-mapping元素之前。请注意Q所有这些元素都
是可选的。因此，可以省略掉某一元素Q但不能把它放于不正的位置?/p>
2.1 Icon
icon元素指出IDE和GUI工具用来表示Web应用的一个和两个囑փ文g的位|?/p>
2.2 display-name
display-name元素提供GUI工具可能会用来标记这个特定的Web应用的一个名U?/p>
2.3 description
description元素l出与此有关的说明性文本?/p>
2.4 context-param
context-param元素声明应用范围内的初始化参数?/p>
2.5 filter
qo器元素将一个名字与一个实现javax.servlet.Filter接口的类相关联?/p>
2.6 filter-mapping
一旦命名了一个过滤器Q就要利用filter-mapping元素把它与一个或多个servlet或JSP面相关联?/p>
2.7 listener
servlet API的版?.3增加了对事g监听E序的支持，事g监听E序在徏立、修改和删除会话或servlet环境时得到通知。Listener元素指出事g监听E序cR?/p>
2.8 servlet
在向servlet或JSP面制定初始化参数或定制URLӞ必须首先命名servlet或JSP面。Servlet元素是用来完成此项d的?/p>
2.9 servlet-mapping
服务器一般ؓservlet提供一个缺省的URLQ?a href="http://host/webAppPrefix/servlet/ServletName">http://host/webAppPrefix/servlet/ServletName。但是，常常会更改这个URLQ以便servlet可以讉K初始化参数或更容易地处理相对
URL。在更改~省URLӞ使用servlet-mapping元素?/p>
2.10 session-config
如果某个会话在一定时间内未被讉KQ服务器可以抛弃它以节省内存。可通过使用HttpSession的setMaxInactiveIntervalҎ明确讄单个会话对象的超时|或者可利用
session-config元素制定~省时倹{?/p>
2.11 mime-mapping
如果Web应用h惛_Ҏ的文Ӟ希望能保证给他们分配特定的MIMEcdQ则mime-mapping元素提供q种保证?/p>
2.12 welcom-file-list
welcome-file-list元素指示服务器在收到引用一个目录名而不是文件名的URLӞ使用哪个文g?/p>
2.13 error-page
error-page元素使得在返回特定HTTP状态代码时Q或者特定类型的异常被抛出时Q能够制定将要显C的面?/p>
2.14 taglib
taglib元素Ҏ记库描述W文ӞTag Libraryu Descriptor fileQ指定别名。此功能使你能够更改TLD文g的位|，而不用编辑用这些文件的JSP面?/p>
2.15 resource-env-ref
resource-env-ref元素声明与资源相关的一个管理对象?/p>
2.16 resource-ref
resource-ref元素声明一个资源工厂用的外部资源?/p>
2.17 security-constraint
security-constraint元素制定应该保护的URL。它与login-config元素联合使用
2.18 login-config
用login-config元素来指定服务器应该怎样l试图访问受保护面的用h权。它与sercurity-constraint元素联合使用?/p>
2.19 security-role
security-role元素l出安全角色的一个列表，q些角色出现在servlet元素内的security-role-ref元素的role-name子元素中。分别地声明角色可高IDE处理安全信息更ؓ
Ҏ?/p>
2.20 env-entry
env-entry元素声明Web应用的环境项?/p>
2.21 ejb-ref
ejb-ref元素声明一个EJB的主目录的引用?/p>
2.22 ejb-local-ref
ejb-local-ref元素声明一个EJB的本C目录的应用?/p>
3 分配名称和定制的UL
在web.xml中完成的一个最常见的Q务是对servlet或JSP面l出名称和定制的URL。用servlet元素分配名称Q用servlet-mapping元素定制的URL与刚分配的名U相兌?/p>
3.1 分配名称
Z提供初始化参敎ͼ对servlet或JSP面定义一个定制URL或分配一个安全角Ԍ必须首先lservlet或JSP面一个名U。可通过 servlet元素分配一个名U。最常见的格式包?/p>
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模式以及?/p>
他定刉过此注册名而不是类名引用此servlet。其?可在 URL而不是类名中使用此名U。因此，利用刚才l出的定义，URL http://host/webAppPrefix/servlet/Test 可用?
http://host/webAppPrefix/servlet/moreservlets.TestServlet 的场所?/p>
误住：XML元素不仅是大写敏感的，而且定义它们的次序也很重要。例如，web-app元素内所有servlet元素必须位于所有servlet- mapping元素Q下一节介绍Q之前，而且q?/p>
要位?.6节和5.11节讨论的与过滤器或文档相关的元素Q如果有的话Q之前。类似地Qservlet 的servlet-name子元素也必须出现在servlet-class之前?.2节”部|描q符文g
内的元素ơ序”将详细介绍q种必需的次序?/p>
例如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果?/p>
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"
" <web-app> <!-- ?--> <servlet> <servlet-name>Test</servlet-name> <servlet-class>moreservlets.TestServlet</servlet-class> </servlet> <!-- ?--> </web-app> 3.2 定义定制的URL http://host/webAppPrefix/servlet/packageName.ServletName。虽然在开发中使用q个URL很方便，但是我们常常会希望另一个URL用于部v。例如，可能会需要一个出现在Web?/p> 用顶层的URLQ如Qhttp: //host/webAppPrefix/AnynameQ，q且在此URL中没有servletV位于顶层的URL化了相对URL的用。此外，对许多开发h员来_层URL看上L 更长更麻烦的~省URL更简短?/p> 事实上，有时需要用定制的URL。比如，你可能想关闭~省URL映射Q以便更好地强制实施安全限制或防止用h外地讉K无初始化参数的servlet。如果你止了缺省的URLQ那 么你怎样讉Kservlet呢？q时只有使用定制的URL了?/p> Z分配一个定制的URLQ可使用servlet-mapping元素及其servlet-name和url-pattern子元素。Servlet- name元素提供了一个Q意名Uͼ可利用此名称引用相应的servletQurl -pattern描述了相对于Web应用的根目录的URL。url- pattern元素的值必M斜杠Q?Qv始?/p> 下面l出一个简单的web.xml摘录Q它允许使用URL http://host/webAppPrefix/UrlTest而不?a href="http://host/webAppPrefix/servlet/Test">http://host/webAppPrefix/servlet/Test
大多数服务器h一个缺省的serlvet URLQ?/p>
http: //host/webAppPrefix/servlet/moreservlets.TestServlet。请注意Q仍焉要XML头?DOCTYPE声明以及web-app闭元素。此外，可回忆一下，XML元素出现地次序不是随
意的。特别是Q需要把所有servlet元素攑֜所?servlet-mapping元素之前?/p>
<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?/p>
<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ƈ且，以便能更Ҏz?JSP面的URLQ比方说Q?/p>
以便多个URL通过相同面得以处理Q或者从URL中去?jsp扩展名）。但是，在设|初始化参数Ӟ应该注意QJSP面是利用jspInitҎQ而不是initҎd初始化参数的?/p>
例如Q程序清?-3l出一个名为TestPage.jsp的简单JSP面Q它的工作只是打印出用来Ȁzd的URL的本地部分。TestPage.jsp攄在deployDemo应用的顶层。程序清?-4l出
了用来分配一个注册名PageNameQ然后将此注册名?a href="http://host/webAppPrefix/UrlTest2/anything">http://host/webAppPrefix/UrlTest2/anything 形式的URL相关联的web.xml文gQ即QdeployDemo/WEB-INF/web.xmlQ的一?/p>
分?/p>
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?/p>
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
" <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 或注册名讉K servlet或JSP面时可以用，用缺省URL http://host/webAppPrefix/servlet/ServletName 讉K时不能用。因此，你可能会希望关闭~省URLQ这样就不会有h 意外地调用初始化servlet了。这个过E有时称为禁止激zdservletQ因为多数服务器h一个用~省的servlet URL注册的标准servletQƈȀzȝ省的URL应用的实际servlet?/p> 有两U禁止此~省URL的主要方法： l 在每个Web应用中重新映?servlet/模式?/p> 4.1 全局关闭Ȁzdservlet?br />重要的是应该注意刎ͼ虽然重新映射每个Web应用中的/servlet/模式比彻底禁止激zservlet所做的工作更多Q但重新映射可以用一U完全可UL的方式来完成。相反，全局止Ȁ zdservlet完全是针对具体机器的Q事实上有的服务器（如ServletExecQ没有这L选择。下面的讨论Ҏ个Web应用重新映射/servlet/ URL模式的策略。后面提供在Tomcat?/p> 全局止Ȁzdservlet的详l内宏V?/p> 4.2 重新映射/servlet/URL模式 元素所有匹配请求{向该 servlet。只要简单地使用Q?/p> <url-pattern>/servlet/*</url-pattern> 作ؓservlet-mapping元素中的模式卛_?/p> 例如Q程序清?-5l出了将SorryServlet servletQ程序清?-6Q与所有以http://host/webAppPrefix/servlet/ 开头的URL相关联的部v描述W文件的一部分?/p> E序清单5-5 web.xmlQ说明JSP命名的摘录Q?/p> <?xml version="1.0" encoding="ISO-8859-1"?> <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" " <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.3 全局止ȀzdQTomcat 4.3.1 止ȀzdQ?Tomcat 4Tomcat 4用与前面相同的方法关闭激zdservletQ即利用web.xml中的url-mapping元素q行关闭。不同之处在于Tomcat使用了放? install_dir/conf中的一个服务器专用的全局web.xml文gQ而前面用的是存攑֜每个Web应用的WEB-INF目录中的标准 web.xml文g?/p> 因此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?/p> 4.3.2 止ȀzdQTomcat3在Apache Tomcat的版?中，通过在install_dir/conf/server.xml中注释出InvokerInterceptor全局止~省 servlet URL。例如，下面是禁?/p> 使用~省servlet URL的server.xml文g的一部分?/p> <!-- <RequsetInterceptor className="org.apache.tomcat.request.InvokerInterceptor" debug="0" prefix="/servlet/" /> --> 5 初始化和预装载servlet与JSP面 5.1 分配servlet初始化参?br />利用init-param元素向servlet提供初始化参敎ͼinit-param元素hparam-name和param-value子元素。例如，在下面的例子中，如果initServlet servlet是利用它的注册名 QInitTestQ访问的Q它能够从其方法中调用getServletConfig(). getInitParameter(”param1?获得”Value 1※I调用getServletConfig().getInitParameter(”param2?/p> )获得?‟?/p> <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要注意： ü q回倹{GetInitParameter的返回值L一个String。因此，在前一个例子中Q可对param2使用Integer.parseInt获得一个int?/p> ü JSP中的初始化。JSP面使用jspInit而不是init。JSP面q需要用jsp-file元素代替servlet-class?/p> ü ~省URL。初始化参数只在通过它们的注册名或与它们注册名相关的定制URL模式讉KServlet时可以用。因此，在这个例子中Qparam1?param2初始化参数将能够在用URL http://host/webAppPrefix/servlet/InitTest 时可用，但在使用URL http://host/webAppPrefix/servlet/myPackage.InitServlet 时不能用?/p> 例如Q程序清?-7l出一个名为InitServlet的简单servletQ它使用initҎ讄firstName和emailAddress字段。程序清?-8l出分配名称InitTestlservlet的web.xml文g?/p> 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" 面在技术上也是合法的。例如，在上面给出的例子中，可用URL http://host/webAppPrefix/servlet/PageName 讉KRealPage.jsp的对初始化参数具有访问权的版本。但在用?/p> JSP面Ӟ许多用户g不喜Ƣ应用常规的servlet的URL。此外，如果 JSP面位于服务器ؓ其提供了目录清单的目录中Q如Q一个既没有index.html也没有index.jsp文g的目 录）Q则用户可能会连接到?JSP面Q单dQ从而意外地ȀzL初始化的面。因此，好的办法是用url-patternQ?.3节）JSP面的原URL与注册的 servlet名相兌?/p> q样Q客h可用JSP面的普通名Uͼ但仍然激zd制的版本。例如，l定来自目1的servlet定义Q可使用下面?servlet-mapping定义Q?/p> <servlet-mapping> <servlet-name>PageName</servlet-name> <url-pattern>/RealPage.jsp</url-pattern> </servlet-mapping> 3QJSP用jspInit而不是init。自动从JSP面建立的servlet或许已经使用了intiҎ。因此，使用JSP声明提供一个initҎ是不合法的，必须制定jspInitҎ?/p> Z说明初始化JSP面的过E，E序清单5-9l出了一个名为InitPage.jsp的JSP面Q它包含一个jspInitҎ且放|于 deployDemo Web应用层次l构的顶层。一般， http://host/deployDemo/InitPage.jsp 形式的URL激zL面的不h初始化参数访问权的版本，从而将对firstName和emailAddress变量昄null。但是， web.xml文gQ程 序清?-10Q分配了一个注册名Q然后将该注册名与URL模式/InitPage.jsp相关联?/p> 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" " <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Ҏdq些参数。但是，在某些情形下Q希望提供可׃Q 意servlet或JSP面借助ServletContext 的getInitParameterҎd的系l范围内的初始化参数?/p> 可利用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?/p> descriptionQ之后及filter、filter-mapping、listener?servlet元素之前?/p> 5.4 在服务器启动时装载servlet Q在W一个客hh时装载servlet的缺省行为将对第一个客h产生较长旉的gq。因此，可利用servlet的load-on- startup元素规定服务器在W一ơ启动时装蝲servlet?/p> 下面是一个例子?/p> <servlet> <servlet-name> ?</servlet-name> <servlet-class> ?</servlet-class> <!-- Or jsp-file --> <load-on-startup/> </servlet> 可以为此元素体提供一个整数而不是用一个空的load-on-startup。想法是服务器应该在装蝲较大数目的servlet或JSP面之前装蝲较少数目的servlet或JSP面。例如，下面?/p> servlet（攄在Web应用的WEB-INF目录下的web.xml文g中的web-app元素内）指C服务器首先装蝲和初始化SearchServletQ然后装载和初始化由位于Web应用的result目录?/p> 的index.jsp文g产生?servlet?/p> <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?/p> qo器可截取和修改进入一个servlet或JSP面的请求或从一个servlet或JSP面发出的相应。在执行一个servlet或JSP面之前Q必L行第一个相关的qo器的doFilterҎ 。在该过滤器对其FilterChain对象调用doFilterӞ执行链中的下一个过滤器。如果没有其他过滤器Qservlet或JSP面被执行。过滤器h对到来的ServletRequest对象的全?/p> 讉K权，因此Q它们可以查看客h名、查扑ֈ来的cookie{。ؓ了访问servlet或JSP面的输出，qo器可响应对象包裹在一个替w对象（stand-in objectQ中Q比方说把输 出篏加到一个缓冲区。在调用FilterChain对象的doFilterҎ之后Q过滤器可检查缓冲区Q如有必要，对它进行修改，然后传送到客户机?/p> 例如Q程序清?-11帝国难以了一个简单的qo器，只要讉K相关的servlet或JSP面Q它截取请求ƈ在标准输Z打印一个报告（开发过E中在桌面系l上q行Ӟ大多数服 务器都可以用这个过滤器Q?/p> 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元?/p> 在web.xml的web-app元素中出现的ơ序不是L的；允许服务器（但不是必需的）强制所需的次序，q且实际中有些服务器也是q样做的。但q里要注意，所有filter元素必须?/p> 现在Lfilter-mapping元素之前Q?filter-mapping元素又必d现在所有servlet或servlet-mapping元素之前?/p> 例如Q给定上q的ReportFilterc，可在web.xml中作Z面的filter声明。它把名UReporter与实际的cReportFilterQ位于moreservletsE序包中Q相兌?/p> <filter> <filter-name>Reporter</filter-name> <filter-class>moresevlets.ReportFilter</filter-class> </filter> 一旦命名了一个过滤器Q可利用filter-mapping元素把它与一个或多个servlet或JSP面相关联。关于此工作有两种选择?/p> 首先Q可使用filter-name和servlet-name子元素把此过滤器与一个特定的servlet名（此servlet名必ȝ后在相同?web.xml文g中用servlet元素声明Q关联。例如，下面?/p> E序片断指示pȝ只要利用一个定制的URL讉K名ؓSomeServletName 的servlet或JSP面Q就q行名ؓReporter的过滤器?/p> <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的过滤器?/p> <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面以及以模?/p> http: //host/webAppPrefix/UrlTest2/ 开头的URL相关联。TestPage.jsp的源代码已经JSP面命名的谈论在前面?节”分配名U和定制的URL”中l出。事实上Q程序清?- 12 中的servlet和servlet-name从该节原封不动地拿q来的。给定这些web.xml，可看C面的标准输出形式的调试报告（换行是ؓ了容易阅读）?/p> audit.irs.gov tried to access 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" " <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?/p> 是标准文件的内容Q如果得到标准文件内容，?index.html、index.jsp、default.html、default.htm或别的什么东西呢Q?/p> Welcome-file-list 元素及其辅助的welcome-file元素解决了这个模p的问题。例如，下面的web.xmlҎ出，如果一个URLl出一个目录名但未l出文g名，服务器应该首先试?/p> index.jspQ然后再试用index.html。如果两者都没有扑ֈQ则l果有赖于所用的服务器（如一个目录列表）?/p> <welcome-file-list> <welcome-file>index.jsp</welcome-file> <welcome-file>index.html</welcome-file> </welcome-file-list> 虽然许多服务器缺省遵循这U行为，但不一定必这栗因此，明确C用welcom-file-list保证可移植性是一U良好的习惯 不合规定的参敎ͼ使用不正的URL或者不能提供必需的表单字D倹{除此之外，其它开发h员可能不那么l心Q他们应该有些工h克服自己的不?/p> 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?/p> javax.servlet.error.message?/p> 可回忆一下，在web.xml内以正确的次序声明web-app的子元素很重要。这里只要记住，error-page出现在web.xml文g的末Nq，servlet、servlet-name和welcome-file-list?/p> 后即可?/p> 9 error-code元素 提供更多有用的信息。另一斚wQ可以试一下在www.microsoft.com?a >www.ibm.com 择的位置Q以便查找感兴趣的页面。提供这h用的错误面对于Web应用来说是很有h值得。事实上rm-error-page子元素）。由form-login-pagel出的HTML表单必须h一?/p> j_security_check?ACTION属性、一个名为j_username的用户名文本字段以及一个名为j_password的口令字Dc?/p> 例如Q程序清?-19指示服务器用基于表单的验证。Web应用的顶层目录中的一个名为login.jsp的页面将攉用户名和口oQƈ且失败的登陆由相同目录中名为login- error.jsp的页面报告?/p> 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" " <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.1 限制对Web资源的访?br />现在Q可以指C服务器使用何种验证Ҏ了。”了不vQ”你说道Q”除非我能指定一个来收到保护?URLQ否则没有多大用处。”没错。指些URLq说明他们应该得CU保 护正是security-constriaint元素的用途。此元素?web.xml中应该出现在login-config的紧前面。它包含是个可能的子元素Q分别是Qweb-resource-collection?auth- constraint、user-data-constraint和display-name。下面各节对它们进行介l?/p> ü 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护?/p> <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或者不适合于利用类?/p> jsp:forward的手D|讉K的页面。这U不匀U如果利用得当的话很有好处。例如，servlet可利用MVC体系l构查找数据Q把它放到bean中，发送请求到从bean中提取数据的JSP?/p> 面ƈ昄它。我们希望保证决不直接访问受保护的JSP面Q而只是通过建立该页面将使用的bean的servlet来访问它。url-pattern和auth-contraint元素可通过声明不允怓Q何用 L接访问JSP面来提供这U保证。但是，q种不匀U的行ؓ可能让开发h员放松警惕，使他们偶然对应受保护的资源提供不受限制的讉K?/p> ü auth-constraint 管web-resource-collention元素质出了哪些URL应该受到保护Q但是auth-constraint元素却指出哪些用户应该具有受保护资源的访问权。此元素应该包含一个或多个标识h?/p> 问权限的用户cdrole- name元素Q以及包含（可选）一个描q角色的description元素。例如，下面web.xml中的security-constraint元素部门规定只有指定为Administrator?/p> Big KahunaQ或两者）的用户具有指定资源的讉K权?/p> <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ȝ?/p> 例如QTomcat使用install_dir/conf/tomcat-users.xml用户名与角色名和口令相兌Q正如下面例子中所C，它指出用户joeQ口令bigshotQ和janeQ口令enajQ属?/p> administrator和kahuna角色?/p> <tomcat-users> <user name="joe" password="bigshot" roles="administrator,kahuna" /> <user name="jane" password="enaj" roles="kahuna" /> </tomcat-users> ü user-data-constraint q个可选的元素指出在访问相兌源时使用M传输层保护。它必须包含一个transport-guarantee子元素（合法gؓNONE?INTEGRAL或CONFIDENTIALQ，q且可选地包含一?/p> description元素。transport-guarantee为NONE值将Ҏ用的通讯协议不加限制。INTEGRALDC数据必M一U防止截取它的h阅读它的方式传送。虽然原理上Qƈ且在未来?/p> HTTP版本中）Q在 INTEGRAL和CONFIDENTIAL之间可能会有差别Q但在当前实践中Q他们都只是单地要求用SSL。例如，下面指示服务器只允许对相兌源做 HTTPSq接Q?/p> <security-constraint> <!-- ... --> <user-data-constraint> <transport-guarantee>CONFIDENTIAL</transport-guarantee> </user-data-constraint> </security-constraint> ü display-name security-constraint的这个很用的子元素给予可能由GUI工具使用的安全约束项一个名U?/p> 9.2 分配角色?br />q今为止Q讨论已l集中到完全由容器（服务器）处理的安全问题之上了。但servlet以及JSP面也能够处理它们自q安全问题?/p> 例如Q容器可能允许用户从bigwig或bigcheese角色讉K一个显CZh员额外紧贴的面Q但只允许bigwig用户修改此页面的参数。完成这U更l致的控制的一U常见方法是调用 HttpServletRequset的isUserInRoleҎQƈ据此修改讉K?/p> Servlet?security-role-ref子元素提供出现在服务器专用口令文件中的安全角色名的一个别名。例如，假如~写了一个调?request.isUserInRoleQ”boss”）的servletQ但 后来该servlet被用在了一个其口o文g调用角色manager而不是boss的服务器中。下面的E序D该servlet能够使用q两个名UC的Q何一个?/p> <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Ҏ处理安全信息?/p> 10控制会话时 Q则~省的超时值由具体的服务器军_。但可利用session-config和session- timeout元素来给Z个适用于所有服务器的明的时倹{超时值的单位为分钟，因此Q下面的?/p> 子设|缺省会话超时gؓ三个时Q?80分钟Q?/p> <session-config> <session-timeout>180</session-timeout> </session-config> 11Web应用的文档化 Macromedia收购Q以及IBM VisuaAge for Java{?/p> 大量的web.xml元素不仅是ؓ服务器设计的Q而且q是为可视开发环境设计的。它们包括icon、display-name和discription{?/p> 可回忆一下，在web.xml内以适当地次序声明web-app子元素很重要。不q，q里只要Cicon、display-name和description是web.xml的web-app元素内的前三个合法元素即可?/p> ü 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> ü display-name display-name元素提供GUI工具可能会用来标记此Web应用的一个名U。下面是个例子?/p> <display-name>Rare Books</display-name> ü 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 个不d的文Ӟ你希望保证它们在发送到客户机时分配为某UMIMEcd。mime-mapping元素Q具?extension和mime-type子元素）可提供这U保证。例如，下面的代码指C服?/p> 器将application/x-fubar的MIMEcd分配l所有以.fool尾的文件?/p> <mime-mapping> <extension>foo</extension> <mime-type>application/x-fubar</mime-type> </mime-mapping> 或许Q你的Web应用希望重蝲QoverrideQ标准的映射。例如，下面的代码将告诉服务器在发送到客户机时指定.ps文g作ؓU文本（text/plainQ而不是作为PostScript Qapplication/postscriptQ?/p> <mime-mapping> <extension>ps</extension> <mime-type>application/postscript</mime-type> </mime-mapping> 13定位TLD 但我们希望避免更Ҏ有现有JSP面。此外，可能q希望用保持taglib元素的简l性的一个简短的uri。这是部v描述W文件的taglib元素z场的所在了。Taglib包含两个 子元素：taglib-uri和taglib-location。taglib-uri元素应该与用于JSP taglib元素的uri属性的东西相匹配。Taglib-location元素l出TLD文g的实际位|。例如，假如你将?/p> 件chart-tags- 1.3beta.tld攑֜WebApp/WEB-INF/tlds中。现在，假如web.xml在web-app元素内包含下列内宏V?/p> <taglib> <taglib-uri>/charts.tld</taglib-uri> <taglib-location> /WEB-INF/tlds/chart-tags-1.3beta.tld </taglib-location> </taglib> l出q个说明后，JSP面可通过下面的简化Ş式用标{ֺ?/p> <%@ taglib uri="/charts.tld" prefix="somePrefix" %> 14指定应用事g监听E序 用法?/p> 注册一个监听程序涉及在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元素之后?/p> 此外Q因为应用生存期监听E序是serlvet规范?.3版本中的新内容，所以必M?web.xml DTD?.3版本Q而不?.2版本?/p> 例如Q程序清?-20l出一个名为ContextReporter的简单的监听E序Q只要Web应用的Servlet-Context建立Q如装蝲Web应用Q或消除Q如服务器关闭）Ӟ它就在标准输Z?/p> CZ条消息。程序清?-21l出此监听程序注册所需要的web.xml文g的一部分?/p> 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?/p> <?xml version="1.0" encoding="ISO-8859-1"?> <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" Enterprise Edition版本1.3规范的第5章?/p> 15.1 distributable 作ؓ其HttpSession对象的属性，而且必须避免用实例变量（字段Q来实现持箋性。distributable元素直接出现在discription元素之后Qƈ且不包含子元素或数据Q它只是一个如 下的标志?/p> <distributable /> 15.2 resource-env-ref Q以及一个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> 15.3 env-entry 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> 15.4 ejb-ref 型，Entity或SessionQ、一个home元素Qbean的主目录接口的完全限定名Q、一个remote元素Qbean的远E接口的完全限定名）以及一个可选的ejb-link元素Q当前bean链接的另 一?bean的名Uͼl成?/p> 15.5 ejb-local-ref
对servlet 或JSP面建立定制URL的一个原因是Q这样做可以注册?initQservletQ或jspInitQJSP面Q方法中d得初始化参数。但是，初始化参数只在是利用定制URL模式
在一个特定的Web应用中禁止以http://host/webAppPrefix/servlet/ 开始的URL的处理非常简单。所需做的事情是建立一个错误消息servletQƈ使用前一节讨论的url-pattern
Tomcat 4中用来关闭缺省URL的方法与Tomcat 3中所用的很不相同。下面介l这两种ҎQ?/p>
q里讨论控制servlet和JSP面的启动行为的Ҏ。特别是Q说明了怎样分配初始化参C及怎样更改服务器生存期中装载servlet和JSP面的时刅R?/p>
<%!
假如servlet或JSP面有一个要花很长时间执行的init QservletQ或jspInitQJSPQ方法。例如，假如init或jspInitҎ从某个数据库或ResourceBundle查找产量。这U情况下
8 指定处理错误的页?br />现在我了解到Q你在开发servlet和JSP面时从不会犯错误，而且你的所有页面是那样的清晎ͼ一般的E序员都不会被它们的搞糊涂。但是，是hM犯错误的Q用户可能会提供
Z更好C解error-code元素的|可考虑一下如果不正确地输入文件名Q大多数站点会作Z么反映。这样做一般会出现一?04错误信息Q它表示不能扑ֈ该文Ӟ但几乎没
如果某个会话在一定的旉内未被访问，服务器可把它扔掉以节U内存。可利用HttpSession的setMaxInactiveIntervalҎ直接讄个别会话对象的超时倹{如果不采用q种Ҏ
来多的开发环境开始提供servlet和JSP的直接支持。例子有Borland Jbuilder Enterprise Edition、Macromedia UltraDev、Allaire JRun StudioQ写此文Ӟ已被
服务器一般都h一U让Web站点理员将文g扩展名与媒体相关联的Ҏ。例如，会自动l予名ؓmom.jpg的文件一个image/jpeg的MIME cd。但是，假如你的Web应用h?/p>
JSP taglib元素h一个必要的uri属性，它给Z个TLDQTag Library DescriptorQ文件相对于Web应用的根的位|。TLD文g的实际名U在发布新的标签库版本时可能会改变，
应用事g监听器程序是建立或修改servlet环境或会话对象时通知的类。它们是servlet规范的版?.3中的新内宏V这里只单地说明用来向Web应用注册一个监听程序的web.xml?/p>
distributable 元素指出QWeb应用是以q样的方式编E的Q即Q支持集的服务器可安全地在多个服务器上分布Web应用。例如，一个可分布的应用必d使用 Serializable对象
resource -env-ref元素声明一个与某个资源有关的管理对象。此元素׃个可选的description元素、一个resource-env-ref- name元素Q一个相对于java:comp/env环境的JNDI?/p>
env -entry元素声明Web应用的环境项。它׃个可选的description元素、一个env-entry-name元素Q一个相对于java: comp/env环境JNDI名）、一个env-entry-value元素Q项?/p>
ejb -ref元素声明对一个EJB的主目录的应用。它׃个可选的description元素、一个ejb-ref-name元素Q相对于java: comp/env的EJB应用Q、一个ejb-ref-type元素Qbean的类
ejb-local-ref元素声明一个EJB的本C目录的引用。除了用local-home代替home外，此元素具有与ejb-ref元素相同的属性ƈ以相同的方式使用
]]>
|
一.在web.xml中配|?/p> xml 代码
?filtercM?/p> java 代码
|
]]>
一、先从网上下载tomcatQ目前最新版本是5.57Q下载地址是：http://apache.freelamp.com/jakarta/tomcat-5/v5.5.7/bin/jakarta-tomcat-5.5.7.zipQ下载安装完后，在安装目录下有以下目录，主要介绍一下conf、common、webappsQ?br /> 如果你现在等不急了Q就想体验一下tomcat的魅力的话，把你的网|到webapps/ROOT目录下，然后再通过览器访问即可，默认如下格式Q?a href="http://localhost:8080/">http://localhost:8080/<你的|页>
1)webapps文g夹主要用于web应用E序部vQ比如你可以把你的应用程序包Q如war文g拷到该目录下Q容器会自动部v?br /> 2)conf文g夹下主要是放|tomcat的服务器的相关配|文?br /> 3)common文g夹主要是对容器全局变量的文件放|地方，如common/lib下就是放|一些需要全文配|的文g包?/p>
二、j2ee的相关部|规范：
一般来说作Z个符合规范的webE序Q会包括以下文g夹和文gQ?WEB-INF/Q主要是攄一些配|文件与不希望外部程序访问的隐私文gQ，在网l上是不允许讉K该文件夹的，如当你输入以?a href="http://localhost:8080/WEB-INF/">http://localhost:8080/WEB-INF/的话׃出现错误?br /> 在WEB-INF文g夹下有一个web.xml文gQ这是对当前应用E序的相兌|，资源L{，/WEN-INF/文g夹下有个classes子文件夹Q该文gҎ应用E序的根路径Q等于是classpath的\径）Q?WEN-INF下还要有个lib文g夹，主要是放|需要引入的包，应用E序导入的包先从q里开始寻找，其次到容器的全局路径?TOMCAT_HOME/common/lib下寻找?br /> 以下是基本文件夹:
/tomcat
/common
/lib
/classes
/conf
/webapps
/ROOT
web.xml
/WEB-INF
/lib
/classes
/你部|的E序?br /> web.xml
/WEB-INF
/lib
/classes
三、容器的配置Qserver.xml)
C目录/conf文g夹下server.xml文g是对web服务器的配置Q?br /> 以下是一些常见的讄Qhttp端口讄Q找C下：
<Connector port="8080" maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8443" acceptCount="100"
connectionTimeout="20000" disableUploadTimeout="true" />
?080端口改ؓ你喜Ƣ用的端口Q如常见?0Q以后你可以利用该端口q行讉K你的|站了：http://localhost/ 期中80是默认的Q可以不写，其他的一下配|，可以参观相关的内容，入门是q么单?br /> web.xml为servlet的一些相关配|，可以参照一下规范。可以看我写的其他文章?br /> l箋说一下server.xml文g的设|，
扑ֈ以下Q?br /> <Host name="localhost" appBase="webapps"
unpackWARs="true" autoDeploy="true"
xmlValidation="false" xmlNamespaceAware="false">
....
</Host>
在他们之间可以添加一?lt;Context>元素Q如Q?lt;Context path="/axis" reloadable="true" docBase="axis" workDir="webapps/axis/work"/>Q其中属性path代表是网l访问的上下文\径，reloadable表示可以在运行时在classes与lib文g夹下自动加蝲cdQdocBase属性表CZ的应用程序的路径Q在windows在如QdocBase="E:\Sun\axis"QworkDir表示是缓存文件的攄地点Q可以方便跨q_UL时不用重~译。这P你的应用E序可以放到硬盘上的Q意地方了。还有一个方法可以做到这点（推荐Q：~写一个xml文gQ然后放到tomcat目录/conf/Catalina/<相应的网?gt;/目录下，如：现在我有个应用程序ACMEWebQ我~了一个文件ACMEWeb.xml内容如下Q?br /> <Context path="/ACMEWeb" reloadable="true" docBase="E:\eclipseproject\ACMEWeb" workDir="E:\eclipseproject\ACMEWeb\work" />
我把它放Ctomcat目录/conf/Cataline/localhost下，在浏览器打开http://localhost/ACMEWeb ׃转向我放在E:\eclipseproject\ACMEWeb下的E序?
四、关于taglib的修改：
Q?Qservlet-2.4之后Qweb.xml文g有了一点修攏V首先是声明命名I间Q?
<web-app xmlns=" xmlns:xsi=" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee version="2.4"></web-app>
Q?Q其ơ是taglibQ与传统的有所改变Q对jsp的配|都被放|到<jsp-config>元素里了。可以用Altova xmlspy打开web.xml文gQ用taglib的话Q按照以下配|：
<jsp-config>
<taglib>
<taglib-uri>oscache</taglib-uri>
<taglib-location>/WEB-INF/oscache.tld</taglib-location>
</taglib>
</jsp-config>
]]>
(以oralceZQ假设你应用的上下文ҎQtest,jndi是jdbc/test)
<Context path="/test" docBase="E:\test" >
<Resource name="jdbc/test" auth="Container" type="javax.sql.DataSource"/>
<ResourceParams name="jdbc/test">
<parameter>
<name>username</name>
<value>system</value>
</parameter>
<parameter>
<name>password</name>
<value>manager</value>
</parameter>
<parameter>
<name>driverClassName</name>
<value>oracle.jdbc.driver.OracleDriver</value>
</parameter>
<parameter>
<name>url</name>
<value>jdbc:oracle:thin:@192.168.0.27:1521:titan</value>
</parameter>
</ResourceParams>
</Context>
]]>
<Context path="/testWeb" docBase="E:\WorkSpace\Test\testWeb" debug="0" reloadable="true">
</Context>
q样我就可以把源文g攑֜E盘下面，打开Tomcat后，可以输入“Http://localhost:8080:/testWeb”来q行讉K?/p>
Tomcat5.5.X里在conf文g加下server.xml中配|的虚礼目录
<Context path="/message" docBase="D:\JSP" debuy="0" reloadable="true"/>
上面是我配置的一个虚C目?/p>
注意 需要放?lt;Host></Host>之间
站点q样Q?br /> <Host name="127.0.0.2" appBase="D:\zqdl"
unpackWARs="true" autoDeploy="true"
xmlValidation="false" xmlNamespaceAware="false">
<Context path="/zqdl" docBase="D:\zqdl\zqdl" debuy="0" reloadable="true"/>
</Host>
]]>
1、安装Tomcat
参考Tomcat for window 的安装向|基本直接安装卛_Q注意：安装时会提示输入理用户名和密码Q这是以后会用到的用户名和密码，切记?br />
2、安装MySQL
默认安装卛_?br />
3、用Tomcat的Web理应用配置数据?br /> 启动Tomcat服务器，打开览器，输入http://localhost:8080/admin/Q其中localhost可能是一台机器的IP或是服务器名UͼQ进入管理界面的登陆面Q这时候请输入原来安装时要求输入的用户名和密码Q登陆到理界面Q?br />
选择ResourcesQData sourcesq入配置数据源界面，选择Data Source Actions Q?gt;选择Create New Data Source,q入配置详细信息界面Q内容如下：
JNDI Name: jdbc/MySQL
Data Source URL: jdbc:MySQL://192.168.0.16/SUBRDB
JDBC Driver Class: org.gjt.mm.MySQL.Driver
User Name: root
Password: ********
Max. Active Connections: 4
Max. Idle Connections: 2
Max. Wait for Connection: 500
Validation Query:
要求输入的JNDI Name{信息，其中除了JDBC DriverClass之外Q其他的可以Ҏ你的需要填写。比如Data Source URL的内容可能是Qjdbc:mysql:// IP或是名称/DataBaseNameQ其中DataBaseName是你的数据库名称QIP是你的数据库的所在的服务器的IP或是名称。最后点击SaveQ?gt;Commit Change.q样你的数据源的基本资料配置一半了?br />
4、web.xml?TOMCAT_HOME%\conf\Catalina\localhost下对应你的引用的配置文g修改
通过文g夹导航到%TOMCAT_HOME%\confQ打开web.xml,?lt;/web-app>的前面添加以下内容：
<resource-ref>
<description>DB Connection</description>
<res-ref-name>jdbc/mysql</res-ref-name>
<res-type>javax.sql.DataSource</res-type>
<res-auth>Container</res-auth>
</resource-ref>
注意res-ref-name填写的内容要与在上文提到的JNDI Name名称一致?br />
通过文g夹导航到%TOMCAT_HOME%\conf\Catalina\localhost下，扑ֈ你的web应用对应?xml文gQ如 ROOT.xmlQƈ在此文g的下d代码Q?br />
<ResourceLink name="jdbc/mysql" global="jdbc/mysql" type="javax.sql.DataSourcer"/>
到这里，配置工作基本完成了?br />
5、其他注意事?br /> 别忘了JDBC驱动E序mysql-connector-java-3.0.9-stable-bin.jar一定要攄到Tomcat的对应目?你的JDBC驱动可能版比W者高Q不q只要能与所使用的MySql对应可以了Q因为我发现版本太低的JDBC驱动不能支持4.0.*版本的MySQL数据库，攄?TOMCAT_HOME%\common\lib和应用的WEB-INF\lib下。两者有什么不同呢Q其实一看就明白了，common\li是所有的应用都可以用的库文件位|?br />
重启你的Tomcat服务?br />
6、编写测试代?br /> 在应用的目录下徏立一个Test.JSP文gQ代码如下：
<!doctype html public "-//w3c//dtd html 4.0 transitional//en"
"
<%@ page import="java.sql.*"%>
<%@ page import="javax.sql.*"%>
<%@ page import="javax.naming.*"%>
<%@ page session="false" %>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<title></title>
<%
out.print("我的试开?);
DataSource ds = null;
try{
InitialContext ctx=new InitialContext();
ds=(DataSource)ctx.lookup("java:comp/env/jdbc/MySQL");
Connection conn = ds.getConnection();
Statement stmt = conn.createStatement();
//提示Qusers必须是数据库已有的表Q?br />
//q里的数据库前文提及的Data Source URL配置里包含的数据库?br />
String strSql = " select * from users";
ResultSet rs = stmt.executeQuery(strSql);
while(rs.next()){
out.print(rs.getString(1));
}
out.print("我的试l束");
}
catch(Exception ex){
out.print(“出C外，信息??ex.getMessage());
ex.printStackTrace();
}
%>
</head>
<body>
</body>
</html>
q行l果Q?br />
我的试开?2345678我的试l束Q因为我的rs.getString(1) 在数据库是存放12345678
7、ȝ
配置q程及其单明了，q些配置免除了以往开发h员自己动手写数据源连接池的痛苦，q也是对开发过E的有力支持?
]]>