Modules Web : éditeur de descripteur de déploiement 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.
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.

- 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.
- Ordre absolu
- Utilisez l'ordre absolu pour forcer un ordre d'analyse des fragments Web ou analyser un sous-ensemble des fragments Web. La configuration de l'ordre absolu s'applique à Web 3.x et plus.
- 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.
- Source de données
- Configurez les informations de source de données de sorte que la source de données soit disponible pour l'application.
- 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.
- Configuration de la session
- Définit les attributs de session pour l'application Web.
- 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 les différentes pages à onglets de l'éditeur de descripteur de déploiement Web. Lorsque vous indiquez des informations de déploiement, l'éditeur incorpore automatiquement le balisage XML approprié dans web.xml.
- 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 d'extensions et de liaison 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.
Le fichier web.xml peut être automatiquement mis à jour pour refléter les modifications dans votre projet Web. Par exemple, lorsque vous utilisez l'assistant de nouveau servlet pour créer un nouveau servlet dans un projet Web, l'assistant place l'entrée de servlet appropriée dans le fichier web.xml .