webxml配置简介.doc

部署描述符实际上是一个XML文件，包含了很多描述servlet/JSP应用的各个方面的元素，如servlet注册、servlet映射以及监听器注册。部署描述符从下面的XML头开始： ?xml version=1.0 encoding=ISO-8859-1? 这个头指定了XML的版本号以及所使用的编码。头的下面是DOCTYPE声明： !DOCTYPE web-appPUBLIC -//Sun Microsystems, Inc.//DTD Web Application 2.3//EN/dtd/web-app_2_3.dtd 这段代码指定文件类型定义(DTD)，可以通过它检查XML文档的有效性。下面显示的!DOCTYPE元素有几个特性，这些特性告诉我们关于DTD的信息：● web-app定义该文档(部署描述符，不是DTD文件)的根元素● PUBLIC意味着DTD文件可以被公开使用● -//Sun Microsystems, Inc.//DTD Web Application 2.3//EN意味着DTD由Sun Microsystems, Inc.维护。该信息也表示它描述的文档类型是DTD Web Application 2.3，而且DTD是用英文书写的。● URL/dtd/web-app_2_3.dtd表示D文件的位置。 注意：在部署描述符中， !--…--用于注释。部署描述符的根元素是web-app。DTD文件规定，web-app元素的子元素的语法如下： !ELEMENT web-app (icon?, display-name?, description?,distributable?, context-param*, filter*, filter-mapping*,listener*, servlet*, servlet-mapping*, session-config?,mime-mapping*, welcome-file-list?,error*, taglib*, resource-env-ref*, resource-ref*,security-constraint*, login-config?, security-role*,env-entry*,ejb-ref*, ejb-local-ref*) 正如您所看到的，这个元素含有23个子元素，而且子元素都是可选的。问号(？)表示子元素是可选的，而且只能出现一次。星号(*)表示子元素可在部署描述符中出现零次或多次。有些子元素还可以有它们自己的子元素。web.xml文件中web-app元素声明的是下面每个子元素的声明。下面的章节讲述部署描述符中可能包含的所有子元素。注意：在Servlet 2.3中，子元素必须按照DTD文件语法描述中指定的顺序出现。比如，如果部署描述符中的web-app元素有servlet和servlet- mapping两个子元素，则servlet子元素必须出现在servlet-mapping子元素之前。在Servlet 2.4中，顺序并不重要。下面对web.xml文件各元素进行详解 1. icon元素icon元素用来指定GIF格式或JPEG格式的小图标(16×16)或大图标(32×32)的文件名。 !ELEMENT icon (small-icon?, large-icon?)!ELEMENT small-icon (#PCDATA)!ELEMENT large-icon (#PCDATA) icon元素包括两个可选的子元素：small-icon子元素和large-icon子元素。文件名是Web应用归档文件(WAR)的根的相对路径。部署描述符并没有使用icon元素。但是，如果使用XML工具编辑部署描述符，XML编辑器可以使用icon元素。 2. display-name元素如果使用工具编辑部署描述符，display-name元素包含的就是XML编辑器显示的名称。 !ELEMENT display-name (#PCDATA) 下面是一个含有display-name元素的部署描述符： ?xml version=1.0 encoding=ISO-8859-1?!DOCTYPE web-appPUBLIC -//Sun Microsystems, Inc.//DTD Web Application 2.3//EN/dtd/web-app_2_3.dtd web-appdisplay-nameOnline Store Application/display-name/web-app 3. description元素可以使用description元素来提供有关部署描述符的信息。XML编辑器可以使