红帽全球峰会A.5. jboss-web.xml 配置参考
简介
jboss-web.xml 是你的部署的 WEB-INF 或 META-INF 里的一个文件。它包含 JBoss Web 容器对 Servlet 3.0 规格所添加的功能的配置信息。Servlet 3.0 规格所专有的设置位于相同目录下的 web.xml 里。
jboss-web.xml 文件里的顶层元素是 <jboss-web> 元素。
映射全局资源到 WAR 的要求
许多可用的设置将应用程序的 web.ml 里设置的要求映射到本地资源。关于 web.xml 设置的解释，请访问 http://docs.oracle.com/cd/E13222_01/wls/docs81/webapp/web_xml.html。
例如，如果
web.xml要求 jdbc/MyDataSource，jboss-web.xml 可能映射全局数据源 java:/DefaultDS 来满足这个要求。WAR 使用全局数据源 jdbc/MyDataSource 来满足要求。
| 属性 | 描述 |
|---|---|
| env-entry |
对
web.xml 要求的 env-entry 的映射。
|
| ejb-ref |
对
web.xml 要求的 ejb-ref 的映射。
|
| ejb-local-ref |
对
web.xml 要求的 ejb-local-ref 的映射。
|
| service-ref |
对
web.xml 要求的 service-ref 的映射。
|
| resource-ref |
对
web.xml 要求的 resource-ref 的映射。
|
| resource-env-ref |
对
web.xml 要求的 resource-env-ref 的映射。
|
| message-destination-ref |
对
web.xml 要求的 message-destination-ref 的映射。
|
| persistence-context-ref |
对
web.xml 要求的 persistence-context-ref 的映射。
|
| persistence-unit-ref |
对
web.xml 要求的 persistence-unit-ref 的映射。
|
| post-construct |
对
web.xml 要求的 post-context 的映射。
|
| pre-destroy |
对
web.xml 要求的 pre-destroy 的映射。
|
| data-source |
对
web.xml 要求的 data-source 的映射。
|
| context-root | 应用程序的根上下文。默认值是部署的名称（不带 .war 后缀）。 |
| virtual-host | 应用程序接受请求的 HTTP 虚拟主机的名称。它指向 HTTP Host 头部的内容。 |
| annotation | 描述应用程序使用的注解。更多信息请参考 <annotation>。 |
| listener | 描述应用程序使用的 listener。更多信息请参考 <listener>。 |
| session-config | 这个元素和 web.xml 的 <session-config> 元素的功能一样，包括它只是出于兼容性的考虑。 |
| valve | 描述应用程序使用的阀（Valve）。更多信息请参考 <valve>。 |
| overlay | 添加至应用程序的覆盖（Overlay）的名称。 |
| security-domain | 应用程序使用的安全域的名称。安全域自身是通过基于 Web 的管理控制台或管理 CLI 来配置的。 |
| security-role | 这个元素和 web.xml 的 <security-role> 元素的功能一样，它只是作为兼容性被包括的。 |
| use-jboss-authorization | 如果出现这个元素并包含了大小写敏感的值 “true”，JBoss Web 授权栈将被使用。如果它没出现或包含非 “true” 的值，那只会使用 Java EE 规格里指定的授权机制。这个元素是 JBoss EAP 6 里新引入的。 |
| disable-audit | 如果出现这个元素，Web 安全审计将被禁用。否则，它将被启用。Web 安全审计不是 Java EE 规格的一部分。这个元素是 JBoss EAP 6 里新引入的。 |
| disable-cross-context | 如果为 false，应用程序能够调用另外一个应用程序上下文。它默认为 true。 |
下面的元素都具有子元素。
<annotation>
描述应用程序使用的注解。下表列出了 <annotation> 的子元素。
| 属性 | 描述 |
|---|---|
| class-name |
注解的类名
|
| servlet-security |
代表了 servlet 安全性的元素，如
@ServletSecurity 。
|
| run-as |
代表了 run-as 信息的元素，如
@RunAs。
|
| multi-part |
代表了 multi-part 信息的元素，如
@MultiPart。
|
<listener>
描述 listener。下表列出了 <listener> 的子元素。
| 属性 | 描述 |
|---|---|
| class-name |
Listener 的类名
|
| listener-type | condition 元素的列表，表示添加哪种 listener 到应用程序的 Context 里。有效值为：
|
| module |
包含 listener 类的模块的名称。
|
| param |
包含两个子元素的参数：
<param-name> 和 <param-value>。
|
<valve>
描述应用程序的库。它包含和 <listener> 相同的配置元素。
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}