A.5. Référence de configuration jboss-web.xml
Le fichier jboss-web.xml
se trouve dans WEB-INF
. 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.42. 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ée 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 l'interface 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 seront utilisés. Cet élément est nouveau dans JBoss EAP 6. |
disable-audit | Définir cet élément de booléen à false pour activer et à true pour désactiver l'auditing web. 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.43. É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
|
multipart-config |
L'élément, comme
@MultiPart , qui représente l'information multi-config.
|
Décrit un listener. Le tableau suivant liste les éléments enfants d'un <listener>
.
Tableau A.44. É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 quelle 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. Resssemble au <listener>, comprend des élément de param, nom de classe, et module.