Red Hat SummitA.5. Referência da Configuração jboss-web.xml
Introdução
O jboss-web.xml é um arquivo com o seu diretório WEB-INF ou META-INF da implantação. Ele contém informação de configuração sobre os recursos que o contêiner do JBoss Web adiciona à especificação Servlet 3.0. As configurações específicas à especificação Servlet 3.0 são posicionadas no web.xml do mesmo diretório.
O elemento de nível superior no arquivo
jboss-web.xml é o elemento <jboss-web>.
Requerimentos WAR dos Recursos Globais de Mapeamento
Muitos dos requerimentos de mapeamento da configuração disponíveis configurados no web.ml do aplicativo aos recursos locais. As explicações das configurações web.xml podem ser encontradas no http://docs.oracle.com/cd/E13222_01/wls/docs81/webapp/web_xml.html.
Por exemplo, caso o
web.xml solicitar o jdbc/MyDataSource, o jboss-web.xml poderá mapear o java:/DefaultDS da fonte de dados global para preencher esta necessidade para o jdbc/MyDataSource.
| Função | Descrição |
|---|---|
| env-entry |
O mapeamento a um
env-entry solicitado pelo web.xml.
|
| ejb-ref |
O mapeamento a um
ejb-ref solicitado pelo web.xml.
|
| ejb-local-ref |
Um mapeamento a um
ejb-local-ref solicitado pelo web.xml.
|
| service-ref |
O mapeamento a um
service-ref solicitado pelo web.xml.
|
| resource-ref |
O mapeamento a um
resource-ref solicitado pelo web.xml.
|
| resource-env-ref |
O mapeamento a um
resource-env-ref solicitado pelo web.xml.
|
| message-destination-ref |
O mapeamento a um
message-destination-ref solicitado pelo web.xml.
|
| persistence-context-ref |
O mapeamento a um
persistence-context-ref solicitado pelo web.xml.
|
| persistence-unit-ref |
O mapeamento a um
persistence-unit-ref solicitado pelo web.xml.
|
| post-construct |
O mapeamento a um
post-context solicitado pelo web.xml.
|
| pre-destroy |
O mapeamento a um
pre-destroy solicitado pelo web.xml.
|
| data-source |
O mapeamento a um
data-source solicitado pelo web.xml.
|
| context-root | O contexto raiz do aplicativo. O valor default é o nome da implantação sem o sufixo .war. |
| virtual-host | O nome do host virtual HTTP que o aplicativo aceita as solicitações. Isto refere-se aos conteúdos do cabeçalho HTTP Host. |
| anotação | Descreve uma anotação usada pelo aplicativo. Refira-se ao <annotation> para maiores informações. |
| listener (ouvinte) | Descreve um ouvinte usado pelo aplicativo. Refira-se ao <listener> para maiores informações. |
| session-config | O elemento preenche a mesma função ao do elemento <session-config> do web.xml e é incluído apenas para compatibilidade. |
| valve | Descreve a válvula usada pelo aplicativo. Refira-se ao <valve> para maiores informações. |
| overlay | O nome da sobreposição para adição ao aplicativo. |
| security-domain | O nome do security domain usado pelo aplicativo. O próprio security domain é configurado no console baseado na web ou no Management CLI. |
| security-role | Este elemento preenche a mesma função como o elemento <security-role> do web.xml e é incluído apenas para a compatibilidade. |
| use-jboss-authorization | Caso este elemento estiver presente e conter o valor de insensibilidade do caso como "verdadeiro", a pilha de autorização do JBoss web será usada. Caso ele não estiver presente ou conter qualquer valor que não é "verdadeiro", apenas os mecanismos da autorização especificados nas especificações do Java Enterprise Edition serão usados. Este elemento é novo para o JBoss Enterprise Application Plataform 6. |
| disable-audit | Caso este elemento vazio estiver presente, a auditoria de segurança da web será desabilitada. Do contrário, isto será habilitado. A auditoria de segurança da web não faz parte da especificação do Java EE. Este elemento é novo no JBoss Enterprise Application Plataform 6. |
| disable-cross-context | Caso false, o aplicativo está apto a chamar outro contexto de aplicativo. O default é true. |
Os seguintes elementos de cada elemento filho.
<annotation>
Descreve uma anotação usada pelo aplicativo. A seguinte tabela lista os elementos filho de um <annotation>.
| Função | Descrição |
|---|---|
| class-name |
Nome da classe de anotação
|
| servlet-security |
O elemento, tal como
@ServletSecurity, que representa a segurança servlet.
|
| run-as |
O elemento, tal como
@RunAs, que representa a informação run-as.
|
| multi-part |
O elemento, tal como
@MultiPart, que representa a informação múltipla em partes.
|
<listener>
Descreve um ouvinte. A seguinte tabela lista os elementos filhos de um <listener>.
| Função | Descrição |
|---|---|
| class-name |
O nome da classe do ouvinte.
|
| listener-type |
Lista os elementos
condition que indicam qual o tipo de ouvinte deve ser adicionado ao Contexto do aplicativo. As escolhas válidas são:
|
| module |
O nome do módulo contendo a classe ouvinte.
|
| param |
O parâmetro. Isto contém dois elementos filhos,
<param-name> e <param-value>.
|
<valve>
Descreve a válvula do aplicativo. Ele contém os mesmos elementos de configuração como o <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}