A.5. Référence de Configuration jboss-web.xml
Le fichier jboss-web.xml
se trouve dans WEB-INF
ou dans le répertoire META-INF
de votre déploiement. Il contient des informations de configuration sur des fonctionnalités que le conteneur JBoss Web ajoute au Servlet 3.0. Les paramètres de configuration spécifiques à la spécification de Servlet 3.0 se trouvent dans web.xml
, dans le même répertoire.
jboss-web.xml
est l'élément <jboss-web>
.
La plupart des paramètres de configuration font correspondre les prérequis définis dans le fichier web.xml
de l'application à des ressources locales. Pour plus d'explications sur les paramètres de configuration de web.xml
consulter http://docs.oracle.com/cd/E13222_01/wls/docs81/webapp/web_xml.html.
web.xml
requiert jdbc/MyDataSource
, alors jboss-web.xml
fera sans doute correspondre la source de données globale java:/DefaultDS
pour remplir ce besoin. Le WAR utilise la source de données globale pour faire correspondre jdbc/MyDataSource
.
Tableau A.41. Attributs de Haut niveau Communs
Attribut | Description |
---|---|
env-entry |
Un mappage à
env-entry requis par web.xml .
|
ejb-ref |
Un mappage à
ejb-ref requis par web.xml .
|
ejb-local-ref |
Un mappage à
ejb-local-ref requis par web.xml .
|
service-ref |
Un mappage à
service-ref requis par web.xml .
|
resource-ref |
Un mappage à
resource-ref requis par web.xml .
|
resource-env-ref |
Un mappage à
resource-env-ref requis par web.xml .
|
message-destination-ref |
Un mappage à
message-destination-ref requis par web.xml .
|
persistence-context-ref |
Un mappage à
persistence-context-ref requis par web.xml .
|
persistence-unit-ref |
Un mappage à
persistence-unit-ref requis par web.xml .
|
post-construct |
Un mappage à
post-context requis par web.xml .
|
pre-destroy |
Un mappage à
pre-destroy requis par web.xml .
|
data-source |
Un mappage à
data-source requis par web.xml .
|
context-root | Le contexte root de l'application. La valeur par défaut est le nom du déploiement sans le suffixe .war . |
virtual-host | Le nom de l'hôte virtuel HTTP à partir duquel l'application accepte les requêtes. Se réfère au contenu de l'en-tête de l'Host HTTP. |
annotation | Décrit une annotation utilisée par l'application. Voir <annotation> pour plus d'information. |
listener | Décrit un listener utilisé par l'application. Voir <listener> pour plus d'information. |
session-config | Cet élément remplit la même fonction que l'élément <session-config> du fichier web.xml et est inclus dans un but de compatibilité seulement. |
valve | Décrit une valve utilisée par l'application. Voir <valve> pour plus d'information. |
overlay | Le nom d'une couche supplémentaire à ajouter à l'application. |
security-domain | Le nom du domaine de sécurité utilisé par l'application. Le domaine de sécurité lui-même est configuré à partir de la console de gestion basée web ou le Management CLI. |
security-role | Cet élément remplit la même fonction que l'élément <session-role> du fichier web.xml et est inclus dans un but de compatibilité seulement. |
use-jboss-authorization | Si cet élément est présent et contient la valeur non sensible à la casse "true", la pile d'autorisation web JBoss sera utilisée. S'il n'est pas présent ou contient une valeur non "true", alors seuls les mécanismes d'autorisation indiqués dans les spécifications Java Enterprise Edition specifications seront utilisés. Cet élément est nouveau dans JBoss EAP 6. |
disable-audit | Si cet élément vide est présent, l'auditing de sécurité web sera désactivé. Sinon, il sera activé. L'auditing de sécurité web ne fait pas partie de la spécification Java EE. Cet élément est nouveau dans JBoss EAP 6. |
disable-cross-context | Si sur false , l'application sera en mesure d'appeler un autre contexte d'application. La valeur par défaut est true . |
Décrit une annotation utilisée par l'application. Le tableau suivant liste les éléments enfants d'une <annotation>
.
Tableau A.42. Éléments de configuration d'une annotation
Attribut | Description |
---|---|
class-name |
Nom de la classe de l'annotation
|
servlet-security |
L'élément, comme
@ServletSecurity , qui représente la sécurité du servlet.
|
run-as |
L'élément, comme
@RunAs , qui représente l'information run-as
|
multi-part |
L'élément, comme
@MultiPart , qui représente l'information multi-part.
|
Décrit un listener. Le tableau suivant liste les éléments enfants d'un <listener>
.
Tableau A.43. Éléments de configuration d'un listener
Attribut | Description |
---|---|
class-name |
Nom de la classe du listener
|
listener-type |
Liste les éléments de
condition qui indiquent quel sorte de listener ajouter au contexte de l'application. Les choix valides sont les suivants :
|
module |
Le nom du module qui contient la classe du listener.
|
param |
Un paramètre. Contient deux éléments enfants,
<param-name> et <param-value> .
|
Décrit une valve de l'application. Contient les mêmes éléments de configuration que <listener>.