Web 部署描述符编辑器允许您为在 Web 开发环境中创建的模块指定部署信息。该信息将出现在 Web.xml 文件中。注意,使用 Web 部署描述符来设置部署描述符属性。不要使用它来处理 Web 资源内容。
Web 项目的 Web.xml 文件提供部署 Web 应用程序模块必需的信息。它用于从项目构建 WAR 文件。每当创建新的 Web 项目时,都会在项目的 Web content 文件夹下面的 WEB-INF 中自动创建一个很小的 Web.xml 文件。
Web 部署描述符编辑器是动态的并包括表示该部署描述符中的各种属性和设置的许多选项卡式页面(视图)。例如,可以单击 Servlet 选项卡来显示 Servlet 页,可在其中添加或除去在 Web 应用程序中使用的 servlet 和 JSP。Web 部署描述符编辑器包括下列选项卡式页面:
- 概述 - 提供 Web 部署描述符中的内容的简要总结,并允许您添加、除去或更改内容。
- Servlet - 允许您创建新的 servlet、将现有 servlet 或 JSP 文件添加至部署描述符或从部署描述符中除去 JSP 文件的所选 servlet。
- 过滤器 - 允许您创建新的过滤器、将现有过滤器添加至部署描述符或者从部署描述符中除去选择的过滤器。
- 安全性 - 允许您定义安全角色和安全性约束。
- 引用 - 允许您添加或除去对部署描述符的引用。以下是可以在此页上定义的引用类型:
- EJB 引用 - 创建对企业 bean 的引用。
- 服务引用 - 创建对 Web service 的引用
- 资源引用 - 创建对外部资源的引用
- 资源环境引用 - 创建对受管对象的引用。
- JSP 标记库
- WS 处理程序 - 允许您为所选端口组件添加和配置处理程序。这包括指定处理程序描述和显示名、指定实现详细信息、添加初始参数和添加 SOAP 头。
- 页面 - 允许您对部署描述符添加或除去欢迎页和错误页。还允许您定义
login-config 元素以及将异常类型添加至错误页。
- 变量 - 允许您添加或除去侦听器、环境变量、标记库引用、上下文参数和 MIME 映射。
- WS 扩展和 WS 绑定 - 仅当您创建了 Web Service 时这些页才会出现,它们允许您配置 Web Service 的扩展和绑定信息。
- 扩展 - 允许您指定 WebSphere® 扩展的设置(例如,启用重新装入)。其它设置包括
MIME 过滤器、JSP 属性、文件处理属性、调用程序属性和 servlet 高速缓存配置。
- 源代码 - 允许您直接编辑 Web.xml 源代码。
虽然您可以直接编辑 web.xml,但是我们建议您在
Web 部署描述符编辑器中编辑多个选项卡式页面。当在这些选项卡式页面中指定部署信息时,编辑器将自动合并 web.xml(或者相应的 .xmi 文件)中适当的 XML 标记。
除 Web.xml 文件中的配置信息之外,Web 项目中的其它部署描述符包括下列信息:
- 绑定信息 - 应用程序服务器需要绑定信息来将在应用程序中指定的部署信息绑定至特定实例。例如,它可能将外部依赖项或资源的逻辑名称映射至资源的实际物理 JNDI 名称。它还可能将安全角色信息映射至一组用户组或一组用户。
- IBM® 绑定和扩展信息(ibm-Web-bnd.xmi 和 ibm-Web-ext.xmi 文件)- 对 J2EE 应用程序、Web
应用程序和企业 bean 的标准描述符的附加项。该扩展使“企业版”或旧的(老一些的)系统可以在当前
WebSphere Application Server 环境中工作。还可以使用它们来指定应用程序行为,
这些行为是特定于供应商的、在当前规范中未定义的或期望包括在将来规范中的。
如果将 WAR 文件导入现有 Web 项目,则可包括在 WAR 文件中包括的部署描述符文件作为 Web 项目的新部署描述符。在部署更新的 Web 应用程序时将使用这些文件中已定义的任何特定部署信息。
可自动更新 Web.xml 文件来反映对 Web 项目的更改。例如,当使用“新建 servlet”向导以在 Web 项目中创建新的 servlet 时,该向导将适当的 servlet 条目放到 Web.xml 文件中。