webxml详解元素含义及加载顺序.doc

部署描述符实际上是一个XML文件，包含了很多描述servlet/JSP应用的各个方面的元素，如servlet注册、servlet映射以及监听器注册。 XML头 部署描述符从下面的XML头开始： ?xml version=1.0 encoding=ISO-8859-1? 这个头指定了XML的版本号以及所使用的编码。 DOCTYPE声明 头的下面是DOCTYPE声明： !DOCTYPE web-app PUBLIC -//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 部署描述符的根元素是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文件各元素进行详解: 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元素。 display-name元素 如果使用工具编辑部署描述符，display-name元素包含的就是XML编辑器显示的名称。 !ELEMENT display-name (#PCDATA) 下面是一个含有display-name元素的部署描述符： ?xml version=1.0 encoding=ISO-8859-1? !DOCTYPE web-app PUBLIC -//Sun Microsystems, Inc.//DTD Web Application 2.3//EN /dtd/web-app_2_3.dtd web-app display-nameOnline Store Application/display-name /web-app description元素 可以使用desc