L'éditeur de descripteur de déploiement Web vous aide à spécifier les informations de déploiement
pour les modules créés dans l'environnement de développement Web.
Les informations apparaissent dans le fichier
web.xml.
Remarque : Vous utilisez le descripteur de déploiement Web
pour définir les attributs de descripteur de déploiement.
Vous ne l'utilisez pas pour manipuler le contenu de ressources Web.
Le fichier web.xml pour un projet Web fournit les informations
nécessaires au déploiement d'un module d'application Web. Il permet de créer un fichier WAR pour un projet. Lorsque vous créez un projet Web, un fichier minimal web.xml est créé automatiquement dans WEB-INF dans le dossier de contenu Web du projet.
L'éditeur de descripteur de déploiement Web est dynamique ; il inclut plusieurs
sections représentant divers paramètres et propriétés dans le descripteur de déploiement.

L'éditeur de descripteur de déploiement Web inclut les sections suivantes :
- Structure de l'application Web
- Fournit un bref récapitulatif du contenu dans le
descripteur de déploiement Web ; permet d'ajouter, de supprimer ou de modifier le contenu.
- Paramètres de contexte
- Un contexte de servlet définit une vue de serveur de
l'application Web dans laquelle le servlet s'exécute. Le contexte permet également à un servlet
d'accéder à des ressources disponibles pour lui.
- Grâce au contexte, un servlet peut consigner les événements dans un journal, obtenir les références URL de
ressources et définir et stocker des attributs que d'autres servlets du contexte peuvent utiliser. Ces propriétés déclarent les
paramètres d'une application Web pour son contexte. Ils transfèrent des informations de configuration, telles qu'une adresse de courrier électronique du Webmaster ou le nom d'un
système contenant des données critiques.
- Référence locale d'EJB
- Créez une référence à un bean d'entreprise accessible via son interface locale et d'accueil locale.
- Référence EJB
- Créez une référence à un bean d'entreprise accessible via son interface d'accueil et interface distante.
- Variable d'environnement
- Déclarez une entrée d'environnement pour l'application.
- Page d'erreur
- Les emplacements de page d'erreur permettent à un servlet de rechercher et prendre en charge un URI
pour un client en fonction d'un code de statut d'erreur spécifié ou type d'exception.
- Ces propriétés sont utilisées si le gestionnaire de traitement des erreurs est un autre
servlet ou un fichier JSP. Les propriétés spécifient un mappage entre un code d'erreur ou type d'exception et le chemin d'accès d'une ressource dans l'application Web.
Le conteneur examine la liste dans l'ordre défini et tente de rechercher la condition d'erreur selon son
code de statut ou sa classe d'exception. A la première correspondance réussie de la condition d'erreur, le conteneur re-prend en charge
la ressource définie dans la propriété d'emplacement.
- Filtre
- Définit une classe de filtre et ses attributs d'initialisation.
- Crée un nouveau filtre, ajoute un filtre existant au
descripteur de déploiement, ou supprime le filtre sélectionné du descripteur de déploiement.
- Mappage de filtre
- Définit le mappage de filtre avec un modèle d'URL ou servlet.
- Configuration JSP
- Ajoutez une collection de ressource ou une bibliothèque de balises.
- Programme d'écoute
- Définit un programme d'écoute de l'application.
- Liste des mappages d'encodage d'environnement local
- Mappe le nom de l'environnement local à un nom de codage.
- Configuration de la connexion
- Configure la manière dont un utilisateur est authentifié. Si l'option Configuration de connexion est spécifiée,
l'utilisateur doit s'authentifier pour accéder aux ressources
contraintes par le paramètre Contrainte de sécurité.
- Destination du message
- Spécifie la destination d'un bean géré par message.
- Référence de destination de message
- Spécifie le nom JDNI (Java™ Naming
and Directory Interface) de l'objet géré pour relier la référence de destination
de message aux beans gérés par le message.
Mappez chaque référence de destination de message dans votre application à un objet géré.
- Mappage MIME
- Définit le mappage entre une extension et un type MIME.
- Référence de contexte de persistance
- Spécifie la durée de vie du contexte de persistance.
- Référence d'unité de persistance
- Spécifie le fichier persistence.xml.
- Post-construction
- Définit la méthode exécutée après l'initialisation de l'injection de dépendance.
- Pré-destruction
- Définit la notification de rappel indiquant que l'instance
est supprimée par le conteneur.
- Référence d'environnement de ressource
- Définit la référence d'une ressource dans l'application Web à un objet géré et associé.
- Références de ressource
- Définit la référence d'un nom de recherche à une ressource externe.
- Contrainte de sécurité
- Les contraintes de sécurité déterminent comment le contenu Web doit être protégé.
Ces propriétés associent des contraintes de sécurité
à une ou plusieurs collections de ressources Web.
- Une contrainte se compose d'une collection de ressources Web, d'une
contrainte d'autorisation et d'une contrainte de données utilisateur.
- Une collection de ressources Web est un ensemble de ressources
(masques d'URL) et de méthodes HTTP pour ces ressources. Toutes les
requêtes contenant un chemin de requête correspondant au masque d'URL
décrit dans la collection de ressources Web sont soumises à la contrainte. Si aucune méthode HTTP n'est spécifiée, la contrainte
de sécurité s'applique à toutes les méthodes HTTP.
- Une contrainte d'autorisation est un ensemble de rôles dont les
utilisateurs doivent disposer pour accéder aux ressources décrites
par la collection de ressources Web. Si un utilisateur demandant l'accès à un URI (Uniform Resource Identifier) donné ne possède pas
au moins l'un des rôles spécifiés dans la contrainte d'autorisation,
il n'a pas accès à cette ressource.
- Une contrainte de données utilisateur indique que la couche
transport du processus de communication du client ou du serveur doit
garantir l'intégrité du contenu (pour empêcher les actions illégales
lors du transfert) ou la confidentialité (pour empêcher la lecture
lors du transfert).
- Rôle de sécurité
- Définit les rôles de sécurité.
- Référence sécurité
- Définit une référence d'un rôle de sécurité vers un autre nom de rôle.
- Servlet
- Crée un nouveau servlet, ajoute un servlet existant au
descripteur de déploiement, ou supprime le servlet sélectionné du fichier JSP du descripteur de déploiement.
- Liste des fichiers d'accueil
- Configure une liste ordonnée de pages Web par défaut qui sont prises en charge
lorsqu'un fichier est introuvable.
- Un fichier de bienvenue (index.html, par exemple) sert de point d'entrée
dans un groupe de fichiers HTML apparentés.
- La recherche des fichiers de bienvenue s'effectue à l'aide d'un groupe d'URI
partiels. Le
conteneur Web utilise les identificateurs URI partiels pour trouver un fichier valide lorsque l'URI initial est introuvable.
- Source
- Editez la source web.xml directement.
Editez le fichier web.xml en utilisant plusieurs pages à onglets
dans l'éditeur de descripteur de déploiement Web. Lorsque vous spécifiez les
informations de déploiement dans ces sections, l'éditeur incorpore automatiquement
le balisage XML approprié dans web.xml.
En plus des informations de configuration du fichier
web.xml,
d'autres descripteurs de déploiement d'un projet Web incluent les informations suivantes :
- Informations de
liaison
- Les informations sont requises par le serveur d'applications pour relier les
informations de déploiement spécifiées dans l'application
à une instance spécifique. Par exemple, il est possible de mapper le nom logique d'une dépendance
externe ou d'une ressource au nom JNDI physique de la ressource. Il
est également possible de mapper les informations de rôle de sécurité à un ensemble de groupes et d'utilisateurs.
- Informations sur les liaisons et extensions IBM®
(fichiers ibm-web-bnd.xml et ibm-web-ext.xml )
- Ajouts aux descripteurs standard pour les applications Java EE, les applications Web et les beans
d'entreprise. Les extensions permettent aux systèmes Java Platform,
Enterprise Edition ou existants (anciens) de fonctionner dans l'environnement actuel WebSphere Application Server. Elles sont également utilisées pour spécifier le comportement d'application spécifique au fournisseur, non défini dans une spécification actuelle, ou attendu dans une spécification ultérieure.
Si vous importez un fichier WAR dans un projet Web existant,
vous pouvez inclure les fichiers de descripteur de déploiement inclus au fichier
WAR en nouveau descripteur de déploiement de projet Web. Les informations de déploiement
spécifiques déjà définies dans ces fichiers
sont utilisées lors du déploiement de l'application Web mise à jour.
Le fichier web.xml peut être automatiquement mis à jour de sorte à refléter les modifications dans votre projet Web. Par exemple, lorsque vous utilisez l'assistant de nouveau servlet pour créer un servlet dans un projet Web, l'assistant place l'entrée de servlet appropriée
dans le fichier web.xml.