1、ServletJSP深入详解基于Tomcat的Web开发 第三章全格式已整理Servlet/JSP深入详解:基于Tomcat的Web开发-第三章 本章要点 掌握配置任意目录下的Web应用程序 掌握以WAR文件的形式发布Web应用程序 掌握与Servlet配置相关的元素的使用Web应用程序的开发分为设计开发与配置部署两个阶段。通过部署,实现了组件与组件之间的松耦合,降低了Web应用程序的维护难度。本章主要介绍以下几个主题: 如何配置任意目录下的Web应用程序 如何以WAR文件的形式发布Web应用程序 与Servlet配置相关的元素的使用3.1 配置任意目录下的Web应用程序一个Web容器可以运行
2、多个Web应用程序,每个Web应用程序都有一个唯一的上下文根,上下文根如何部署是和具体的Web容器相关的。对于Tomcat来说,%CATALINA_HOME%webapps目录下的每一个子目录都是一个独立的Web应用程序,这个子目录的名字就是这个Web应用程序的上下文根。例如,第2章的Web应用程序位于%CATALINA_HOME%webappsch02目录,上下文根就是ch02。在部署和访问Web应用程序时,通过上下文路径(context path)来区分不同的Web应用程序。上下文路径以斜杠(/)开头,但结束没有斜杠(/)。在默认上下文中,这个路径将是空字符串。例如:/ch02是第2章的W
3、eb应用程序的上下文路径,凡是发往/ch02路径的请求,都会交由这个路径下的Web应用程序的资源来进行响应。在第2章中,我们将开发的Web应用程序放在了%CATALINA_HOME%webapps目录下,当Tomcat启动时,会自动加载webapps目录下的Web应用程序,所以在这个目录下的Web应用程序不需要进行其他的配置就可以直接访问了。但是,我们在开发的时候,经常会建立自己的开发目录,在开发阶段完成后,才进入正式的产品部署阶段。如果每当我们完成一个功能,需要测试运行的时候,都要将文件复制到webapps目录下对应的Web应用程序目录中,那未免太烦琐了。我们知道,在Web服务器中可以配置虚
4、拟目录,而虚拟目录所对应的真实目录可以在任何路径下。同样地,在Tomcat中,也有类似的配置,这主要是在XML配置文件中通过元素的设置来完成的。一个元素就表示一个Web应用程序,运行在特定的虚拟主机中。元素的常用属性如表3-1所示。表3-1 元素的常用属性属 性描 述className指定实现了org.apache.catalina.Context接口的类名。如果没有指定类名,将使用标准的实现。标准的实现类是org.apache. catalina.core.StandardContextcookies指示是否将Cookie应用于Session,默认值是truecrossContext如果设置
5、为true,在应用程序内部调用ServletContext.getContext()将成功返回运行在同一个虚拟主机中的其他Web应用程序的请求调度器。在注重安全的环境中,将该属性设为false,那么getContext()将总是返回null。默认值是falsedocBase指定Web应用程序的文档基目录或者WAR文件的路径名。可以指定目录的或WAR文件的绝对路径名,也可以指定相对于Host元素的appBase目录的路径名。该属性是必需的path指定Web应用程序的上下文路径。在一个特定的虚拟主机中,所有的上下文路径都必须是唯一的。如果指定一个上下文路径为空字符串(),则定义了这个虚拟主机的默认
6、Web应用程序,负责处理所有的没有分配给其他Web应用程序的请求reloadable如果设置为ture,Tomcat服务器在运行时,会监视WEB-INF/classes和WEB-INF/lib目录下类的改变,如果发现有类被更新,Tomcat服务器将自动重新加载该Web应用程序。这个特性在应用程序的开发阶段非常有用,但是它需要额外的运行时开销,所以在产品发布时不建议使用。该属性的默认值是falseunpackWAR如果为true,Tomcat在运行Web应用程序前将展开所有压缩的Web应用程序。默认值是true元素是元素的子元素,可以在%CATALINA_HOME%confserver.xml文
7、件中设置Context元素。例如,针对第2章的Web应用程序,可以做如下配置: 在元素中使用的属性的含义在表3-1中已经列出了,这里就不再讲述了。在Tomcat中,我们还可以把元素放在下列位置的文件中。 %CATALINA_HOME%confcontext.xml文件,在这个文件中设置的信息将被所有的Web应用程序所加载。 %CATALINA_HOME%confenginenamehostnamecontext.xml.default文件,enginename表示的是在server.xml文件中设置的元素的name属性的值,hostname表示的是在server.xml文件中设置的元素的nam
8、e属性的值,关于servet.xml文件的详细信息,可以参看附录C。在笔者的机器上,%CATALINA_HOME% confserver.xml文件中元素的name属性的值是Catalina,元素的name属性的值是localhost,你可以在%CATALINA_HOME%conf目录下依次创建Catalinalocalhost目录,然后在localhost目录下新建context.xml.default文件,在这个文件中设置的信息将被属于该虚拟主机的所有Web应用程序所加载。 可以为一个Web应用程序建立%CATALINA_HOME%confenginename hostnamexxx.xm
9、l文件,在这个XML文件中,元素的docBase属性通常是Web应用程序目录的绝对路径名,或者是Web应用程序归档文件的绝对路径名。 在Web应用程序的目录结构中增加META-INFcontext.xml文件。包含META-INF子目录的Web应用程序的目录层次结构如图3-1所示。在%CATALINA_HOME%webapps目录下的Web应用程序,如果没有在任何文件中设置元素,那么Tomcat将为这个Web应用程序自动生成元素。自动生成的元素的上下文路径将以斜杠(/)开始,后面紧跟Web应用程序所在目录的名字,如果目录的名字是ROOT,那么上下文路径将是一个空字符串()。所以在%CATALI
10、NA_HOME%webapps目录下的Web应用程序可以不经配置而直接使用。在%CATALINA_HOME%webapps目录下有一个ROOT目录,Tomcat为ROOT目录生成的元素的上下文路径是空字符串(),而我们知道,如果一个Web应用程序的上下文路径是空字符串(),则这个Web应用程序将作为虚拟主机的默认Web应用程序,负责处理所有的没有分配给其他Web应用程序的请求,这也就是为什么我们访问http:/localhost:8080/时,访问的是%CATALINA_ HOME%webappsROOT目录下的资源。如果我们想将开发的目录直接配置成Web应用程序运行的目录,而不是将这个目录复
11、制到%CATALINA_HOME%webapps目录下,可以在两处地方进行配置。例如,在笔者的机器上,本章的例子程序所在目录是F:JSPLessonch03,为了可以直接在这个目录下运行Web应用程序,我们编辑%CATALINA_HOME%confserver.xml文件,设置元素,如例3-1所示。例3-1 在server.xml中设置元素 使用docBase属性指定Web应用程序的真实路径。将属性reloadable设置为true,Tomcat在运行时会自动监测Servlet类的改动,如果发现有类被更新,Tomcat服务器将自动重新加载该Web应用程序。这样,在开发时,我们就不需要频繁重启T
12、omcat了。读者可以将ch03目录按照Web应用程序的目录层次结构建好,然后编写一个简单的输出“Hello World”的Servlet进行测试,步骤和第2章的实例程序的编写步骤是一样的。此外,我们还可以在%CATALINA_HOME%conf目录下依次创建Catalinalocalhost目录,然后在localhost目录下为ch03这个Web应用程序建立ch03.xml文件,编辑这个文件,输入如例3-2所示的内容。例3-2 ch03.xml读者可以用自己编写的Servlet类进行测试,在测试之前,要先把server.xml文件中设置的元素删除或注释起来。从Tomcat 5开始,不建议直接
13、在server.xml文件中配置元素,因为server.xml文件作为Tomcat的主要配置文件,一旦Tomcat启动后,将不会再读取这个文件,因此你无法在Tomcat服务器启动时发布Web应用程序。如果在其他地方配置元素,那么在Tomcat运行时,也可以发布Web应用程序。从Tomcat 5.5开始,在%CATALINA_HOME%confenginename hostname目录下创建XML配置文件来配置Web应用程序,Tomcat将以XML文件的文件名将作为Web应用程序的上下文路径,而不管你在元素的path属性中指定的上下文路径是什么。例如,文件名是ch03.xml,元素的path属性
14、设置为/hello,那么执行http:/localhost:8080/hello/helloworld将提示HTTP 404错误,如果执行http:/localhost:8080/ch03/helloworld将显示正确的输出信息。而Tomcat 5.5之前的版本则是以元素的path属性的值作为上下文的路径。由于Tomcat 5.5之后的版本是以XML配置文件的文件名作为Web应用程序的上下文路径的,因此在配置元素时,可以不使用path属性。%CATALINA_HOME%confweb.xml为运行在同一个Tomcat实例中的所有Web应用程序定义了默认值。当Tomcat加载一个Web应用程序
15、的时候,首先读取这个文件,然后再读取Web应用程序目录下的WEB-INF/web.xml文件。3.2 WAR文件如果一个Web应用程序的目录和文件非常多,那么将这个Web应用程序部署到另一台机器上,就不是很方便了,我们可以将Web应用程序打包成Web归档(WAR)文件,这个过程和把Java类文件打包成JAR文件的过程类似。利用WAR文件,可以把Servlet类文件和相关的资源集中在一起进行发布。在这个过程中,Web应用程序就不是按照目录层次结构来进行部署了,而是把WAR文件作为部署单元来使用。一个WAR文件就是一个Web应用程序,建立WAR文件,就是把整个Web应用程序(不包括Web应用程序层
16、次结构的根目录)压缩起来,指定一个.war扩展名。下面我们将第2章的Web应用程序打包成WAR文件,然后发布。WAR文件的创建与JAR文件的创建使用相同的命令。打开命令提示符,进入%CATALINA_HOME%webappsch02目录,执行下面的命令:jar -cvf ch02.war *这个命令将ch02目录下所有的子目录和文件都打包成一个名为ch02.war的归档文件。如果不想包含src目录及其下的Java源文件(在发布时不应该把Java源文件包含到WAR文件中),可以执行下面的命令:jar -cvf ch02.war *.html WEB-INF/要查看WAR文件的内容,可以执行下面的
17、命令:jar -tf ch02.war这个命令将列出WAR文件的内容,或者用WinRAR工具软件查看ch02.war文件的内容,如图3-2所示。图3-2 使用WinRAR查看ch02.war文件如果修改了某个Servlet类文件,需要替换WAR文件中的旧文件,可以执行下面的命令:jar -uf ch02.war WEB-INF/classes/org/sunxin/ch02/servlet/LoginServlet. class当然你也可以利用WinRAR软件来更新压缩包中的文件。如果我们将ch02.war文件放到%CATALINA_HOME%webapps目录下,在Tomcat启动时,会自动
18、解压这个WAR文件,按照打包前的目录层次结构生成与WAR文件的文件名同名的目录ch02及下面的子目录和文件。读者可以自己动手做一下实验,先删除在%CATALINA_HOME%webapps目录下的ch02目录,然后将ch02.war文件复制到%CATALINA_HOME%webapps目录下,启动Tomcat,你会看到在webapps目录下新产生了一个ch02目录。当然,我们也可以直接从WAR文件运行Web应用程序,打开%CATALINA_ HOME%confserver. xml文件,找到元素的配置处,如下所示:将unpackWARs属性的值设置为false,这样,Tomcat将直接运行WA
19、R文件。关于元素各属性的含义,请参看附录C或Tomcat的文档。删除Tomcat产生的目录ch02,重新启动Tomcat,查看%CATALINA_HOME%webapps目录,可以看到这次没有产生ch02目录,打开浏览器,输入以前访问过的URL进行测试。在建立WAR文件之前,需要建立正确的Web应用程序的目录层次结构。 建立WEB-INF子目录,并在该目录下建立classes与lib两个子目录。 将Servlet类文件放到WEB-INFclasses目录下,将Web应用程序所使用Java类库文件(即JAR文件)放到WEB-INFlib目录下。 建立web.xml文件,放到WEB-INF目录下。
20、 根据Web应用程序的需求,将JSP页面或静态HTML页面放到上下文根路径下或其子目录下。 如果有需要,建立META-INF目录,并在该目录下建立context.xml文件。只有在确保这些工作后都完成后,才开始建立WAR文件。要注意的是,虽然WAR文件和JAR文件的文件格式是一样的,并且都是使用jar命令来创建,但就其应用来说,WAR文件和JAR文件是有根本区别的。JAR文件的目的是把类和相关的资源封装到压缩的归档文件中,而对于WAR文件来说,一个WAR文件代表了一个Web应用程序,它可以包含Servlet、HTML页面、Java类、图像文件,以及组成Web应用程序的其他资源,而不仅仅是类的归
21、档文件。我们什么时候应该使用WAR文件呢?在开发阶段不适合使用WAR文件,因为在开发阶段,经常需要添加或删除Web应用程序的内容,更新Servlet类文件,而每一次改动后,重新建立WAR文件将是一件浪费时间的事情。在产品发布阶段,使用WAR文件是比较合适的,因为在这个时候,几乎不需要再做什么改动了。在开发阶段,我们通常将Servlet源文件放到Web应用程序目录的src子目录下,以便和Web资源文件区分。在建立WAR文件时,只需要将src目录从Web应用程序目录中移走,就可以打包了。3.3 与Servlet配置相关的元素3.3.1 元素及其子元素在web.xml文件中,元素及其可以包含的子元素
22、如图3-3所示。图3-3 元素及其子元素图3-3中的*表示可以有零个或多个子元素,?表示可以有零个或一个子元素,除此之外的元素为必备的元素。下面我们对元素的各个子元素的含义做一个说明。 为Servlet指定一个文本描述。 为Servlet指定一个简短的名字,这个名字可以被某些工具所显示。 为Servlet指定一个图标。这个图标可以在一些图形界面工具中用于表示该Servlet。 指定Servlet的名字,这个名字在同一个Web应用程序中必须是唯一的。这个元素在第2章的例子中已经使用过。 指定Servlet类的完整限定名。这个元素在第2章的例子中也已经使用过。 指定在Web应用程序中的JSP文件的
23、完整路径,该路径以斜杠(/)开始。如果要对一个JSP文件做URL映射,就会用到这个元素。 定义Servlet的初始化参数。如果使用了元素,则必须包含和元素,可以包含零个或多个元素。 为初始化参数提供一个文本描述。 定义初始化参数的名字。 定义初始化参数的值。 指定当Web应用程序启动时,Servlet被加载的次序。元素的内容必须是一个整数,如果这个值是一个负数,或者没有设定这个元素,Servlet容器将在客户端首次请求这个Servlet时加载它;如果这个值是正数或0,容器将在Web应用程序部署时加载和初始化这个Servlet,并且先加载数值小的Servlet,后加载数值大的Servlet。如果
24、某个Servlet需要在其他Servlet被加载之前加载,可以在部署描述符中使用这个元素。如果元素包含了元素和元素,则JSP文件将被预编译并加载。 指定用于执行组件的角色。如果使用了元素,可以包含零个或多个元素,必须包含元素。 指定一个文本描述。 指定用于执行组件的角色名。 声明在组件或部署的组件的代码中的安全角色引用。如果使用了元素,则必须包含元素,可以包含零个或多个元素,零个或一个元素。 为安全角色引用提供一个文本描述。 指定在代码中使用的安全角色的名字。 指定到一个安全角色的引用。3.3.2 元素及其子元素元素在Servlet和URL样式之间定义一个映射。它包含了两个子元素和,元素给出的
25、Servlet名字必须是在元素中声明过的Servlet的名字。元素指定对应于Servlet的URL路径,该路径是相对于Web应用程序上下文根的路径。例如: helloworld /helloServlet 2.5规范允许的子元素出现多次,之前的规范只允许一个元素包含一个子元素。我们看下面的例子: welcome /en/welcome /zh/welcome在配置了Servlet与URL样式之间的映射后,当Servlet容器接收到一个请求,它首先确定该请求应该由哪一个Web应用程序来响应。这是通过比较请求URI的开始部分与Web应用程序的上下文路径来确定的。映射到Servlet的路径是请求UR
26、I减去上下文的路径,Web应用程序的Context对象在去掉请求URI的上下文路径后,将按照下面的路径映射规则的顺序对剩余部分的路径进行处理,并且在找到第一个成功的匹配后,不再进行下一个匹配。 容器试着对请求的路径和Servlet映射的路径进行精确匹配,如果匹配成功,则调用这个Servlet来处理请求。 容器试着匹配最长的路径前缀,以斜杠(/)为路径分隔符,按照路径树逐级递减匹配,选择最长匹配的Servlet来处理请求。 如果请求的URL路径最后有扩展名,如.jsp,Servlet容器会试着匹配处理这个扩展名的Servlet。 如果按照前面3条规则没有找到匹配的Servlet,容器会调用Web应用程序默认
copyright@ 2008-2022 冰豆网网站版权所有
经营许可证编号:鄂ICP备2022015515号-1