Web 部署描述符编辑器可帮助您指定在 Web 开发环境中创建的模块的部署信息。
此信息将出现在
web.xml 文件中。
注: 您可以使用 Web 部署描述符来设置部署描述符属性。
不将其用于处理 Web 资源内容。
Web 项目的 web.xml 文件提供了部署 Web 应用程序模块时所需的信息。在从项目中构建 WAR 文件时,将用到该文件。每当您创建新的 Web 项目时,在该项目的 Web Content 文件夹下面的 WEB-INF 中至少会自动创建一个 web.xml 文件。
Web 部署描述符编辑器是动态的,并且包括用于表示部署描述符中各种属性和设置的许多部分。

Web 部署描述符编辑器包括以下部分:
- Web 应用程序结构
- 提供 Web 部署描述符中内容的简洁摘要,并允许您添加、移除或更改内容。
- 上下文参数
- Servlet 上下文定义正在运行 Servlet 的 Web 应用程序的服务器视图。此上下文还使 servlet 能够访问对其可用的资源。
- 通过使用上下文,servlet 可以记录事件日志,获取 URL 对资源的引用以及设置和存储在此上下文中的其他 servlet 可以使用的属性。这些属性为其上下文声明 Web 应用程序的参数。它们传送设置信息,例如 Web 管理员的电子邮件地址或用于存放关键数据的系统的名称。
- EJB 本地引用
- 创建通过其本地主页和本地接口对企业 bean 进行访问的引用。
- EJB 引用
- 创建通过其远程主页和远程接口对企业 bean 进行访问的引用。
- 环境变量
- 为应用程序声明环境条目。
- 错误页面
- 错误页位置使 servlet 能够根据指定的错误状态码或异常类型查找 URI 以及对客户机提供URI 服务。
- 如果错误处理程序是其他 servlet 或 JSP 文件,那么使用这些属性。这些属性指定错误代码或异常类型与 Web 应用程序中资源的路径之间的映射。
容器将按列表的定义顺序来检查列表,并尝试按状态码或异常类来匹配错误条件。在第一次成功匹配错误条件时,容器将传送回位置属性中定义的资源。
- 日志过滤器
- 定义过滤器类及其初始化属性。
- 创建新的过滤器,将现有过滤器添加至部署描述符,或者从部署描述符中移除所选过滤器。
- 过滤器映射
- 定义映射至 URL 样式或 servlet 的过滤器。
- JSP 配置
- 添加资源集合或标记库。
- 侦听器
- 定义应用程序侦听器。
- 语言环境编码映射列表
- 将语言环境名称映射到编码名称。
- 登录配置
- 配置用户的认证方式。如果指定了登录配置,那么用户必须经过认证才能访问由安全性约束参数约束的资源。
- 消息目的地
- 指定消息驱动的 bean 的目标。
- 消息目标引用
- 指定 J2C 管理对象的 Java™ 命名和目录接口 (JNDI) 名以将消息目标引用绑定到消息驱动的 bean。将应用程序中的每个消息目标引用映射到受管对象。
- MIME 映射
- 定义扩展和 MIME 类型之间的映射。
- 持久性上下文引用
- 指定持久性上下文的生存期。
- 持久性单元引用
- 指定 persistence.xml 文件。
- 发布结构
- 定义在依赖关系注入初始化之后运行的方法。
- 预破坏
- 定义用于通知容器正在移除实例的回调通知。
- 资源环境引用
- 定义 Web 应用程序中对相关联的受管对象的资源的引用。
- 资源引用
- 定义查找名称对外部资源的引用。
- 安全性约束
- 安全性约束确定保护 Web 内容的方式。这些属性使安全性约束与一个或多个 Web 资源集合关联。
- 约束由 Web 资源集合、授权约束和用户数据约束组成。
- Web 资源集合是一组资源(URL 模式)和关于那些资源的 HTTP 方法。包含与 URL 模式(在 Web 资源集合中描述)匹配的请求路径的所有请求都服从于此约束。如果未指定 HTTP 方法,那么安全性约束会应用到所有的 HTTP 方法。
- 授权约束是一组必须授予用户访问由 Web 资源集合描述的资源的角色。如果未授予用户(该用户请求访问指定的 URI)至少一个在授权约束中指定的角色,那么会拒绝此用户访问该资源。
- 用户数据约束指示客户机或服务器的传输层通信过程必须满足保证内容完整性(防止在转移过程中篡改)或者保证机密性(防止在转移过程中读取)的要求。
- 安全角色
- 定义安全角色。
- 安全引用
- 对安全角色的引用,定义备用角色名。
- servlet
- 创建新的 Servlet,将现有 Servlet 或 JSP 文件添加至部署描述符,或者从部署描述符中移除 JSP 文件的所选 Servlet。
- 欢迎文件列表
- 配置当找不到文件时提供服务的缺省 Web 页面的已排序列表。
- 欢迎文件是一组相关 HTML 文件的入口点文件(例如,index.html)。
- 欢迎文件是通过使用一组部分 URI 来定位的。找不到初始 URI 时,Web 容器使用部分 URI 来查找有效文件。
- 源文件
- 直接编辑 web.xml 源代码。
使用 Web 部署描述符编辑器中的多个选项卡式页面来编辑 web.xml 文件。当您在这些部分中指定部署信息时,编辑器会自动整合 web.xml 中的相应 XML 标记。
除了
web.xml 文件中的配置信息外,Web 项目中的其他部署描述符还包括以下信息:
- 绑定信息
- 这是应用程序服务器将应用程序内指定的部署信息绑定至特定实例时所需的信息。例如,它还会将外部依赖项或资源的逻辑名映射至该资源的实际物理 JNDI 名称。它还将安全角色信息映射至一个组集或用户集。
- IBM® 绑定和扩展信息(ibm-web-bnd.xml 和 ibm-web-ext.xml 文件)
- Java EE 应用程序、Web 应用程序及企业 Bean 的标准描述符的新增项。这些扩展允许 Java Platform,
Enterprise Edition 或旧系统在当前 WebSphere® Application Server 环境中工作。它们还用于指定特定于供应商的应用程序行为、在当前规范中未定义的应用程序行为以及要求在将来规范中包括的应用程序行为。
如果将 WAR 文件导入到现有 Web 项目中,那么您可以包括 WAR 文件中所包含的部署描述符文件作为 Web 项目的新部署描述符。当您部署已更新的 Web 应用程序时,将使用这些文件中已定义的任何特定部署信息。
可以自动更新 web.xml 文件以反映对 Web 项目的更改。例如,当您使用“新建 Servlet”向导在 Web 项目中创建新的 Servlet 时,该向导会将相应的 Servlet 条目放入 web.xml 文件。