Configuration du conteneur Web pour l'accès aux fichiers statiques JavaServer Pages

Le conteneur Web recherche les fichiers statiques et les fichiers JavaServer Pages (JSP) dans quatre emplacements différents au maximum, en fonction de la configuration de l'application. Cette recherche permet de trouver la ressource appropriée pour servir une demande entrante et pour les résultats renvoyés par les API suivantes :
URL ServletContext.getResource(chemin Chaîne)
Set ServletContext.getResourcePaths(chemin Chaîne) 
Avertissement : Les fichiers statiques font l'objet d'une recherche uniquement lorsque la propriété fileServing est activée et que l'application n'inclut pas de mappage de servlet /*. De même, les fichiers JSP incluent des fichiers portant les extensions suivantes, en plus des autres modèles définis dans le fichier web.xml :
  • .jsp
  • .jspx
  • .jsw
  • .jsv
Les quatre emplacements, par ordre de priorité, sont les suivants :
Répertoire WAR de l'application
Le conteneur Web recherche d'abord la ressource demandée dans le répertoire WAR de l'application. Toutefois, vous ne pouvez pas prendre en charge de ressources sous les répertoires WEB-INF ou META-INF pour les demandes entrantes, bien qu'elles soient accessibles à l'aide des méthodes getResource() et getResourcePaths().
Répertoires de documents préfragmentés
Le conteneur Web effectue ensuite une recherche dans les répertoires de documents préfragmentés définis dans l'application. Définissez un répertoire de documents préfragmenté dans le fichier ibm-web-ext.xmi, qui se trouve dans le répertoire WEB-INF de l'application. Définissez un répertoire de documents préfragmenté pour les fichiers statiques ou les fichiers JSP, en procédant comme suit :
Fichiers statiques :
<fileServingAttributes xmi:id="<nom fourni par l'utilisateur>"
 name="preFragmentExtendedDocumentRoot"
 value="<user provided value>"/>
Fichiers JSP :
<jspAttributes xmi:id="<nom fourni par l'utilisateur>" name="preFragmentExtendedDocumentRoot" value=<valeur fournie par l'utilisateur>"/> 
Le <nom fourni par l'utilisateur> peut être une liste de répertoires et/ou une liste de fichiers JAR. Par exemple :
<fileServingAttributes name="extendedDocumentRoot"
      value="C:\EDR_directory,C:\my\path\to\jarEDR.jar"/>
Si le <nom fourni par l'utilisateur> contient uniquement une liste constituée d'un répertoire et que ce répertoire contient des fichiers JAR, le conteneur Web n'effectue pas de recherche dans ces fichiers JAR. Il recherche des fichiers statiques et des fichiers JSP dans ce répertoire uniquement, mais en dehors des fichiers JAR. Si les fichiers statiques ou JSP se trouvent dans un fichier JAR, ils ne peuvent pas figurer dans le dossier META-INF du fichier JAR, car il s'agit d'un dossier à accès restreint, et le <nom fourni par l'utilisateur> doit contenir un chemin d'accès complet vers le fichier JAR.
Avertissement : Les répertoires de documents préfragmentés sont une nouvelle fonction de WebSphere Application Server Version 9.0.
Répertoires META-INF/resources des fragments situés sous le répertoire WEB-INF/Lib dans le fichier WAR de l'application
Après avoir effectué la recherche dans les répertoires de documents préfragmentés, le conteneur Web lance une recherche dans les fragments Web. Un fragment Web contient un fichier JAR dans un répertoire WEB-INF/lib de l'application. Le fichier JAR peut inclure des ressources statiques dans un répertoire META-INF/resources, qui sont définies dans le fichier JAR. Pour empêcher le conteneur Web d'effectuer la recherche dans les répertoires META-INF/resources, affectez la valeur true à la propriété personnalisée de conteneur Web com.ibm.ws.webcontainer.SkipMetaInfResourcesProcessing. La valeur par défaut pour la propriété personnalisée est false.
com.ibm.ws.webcontainer.SkipMetaInfResourcesProcessing = true
Avertissement : Les répertoires META-INF/resources des fragments situés sous le répertoire WEB-INF/Lib dans le fichier WAR de l'application sont une nouvelle fonction de WebSphere Application Server Version 9.0.
Répertoires de documents étendus
Enfin, le conteneur Web effectue une recherche dans les applications définies en tant que répertoires de documents étendus. Les répertoires de documents étendus étaient disponibles dans les éditions antérieures et sont définis dans le fichier ibm-web-ext.xmi, qui se trouve dans le répertoire WEB-INF de l'application. Définissez un répertoire de documents pour les fichiers statiques ou les fichiers JSP, en procédant comme suit :
Fichiers statiques :
<fileServingAttributes xmi:id="<nom fourni par l'utilisateur>" name="extendedDocumentRoot"
 value="<valeur fournie par l'utilisateur>"/>
Fichiers JSP :
<jspAttributes xmi:id="<nom fourni par l'utilisateur>" name="extendedDocumentRoot" value=<valeur fournie par l'utilisateur>"/>
com.ibm.ws.webcontainer.SkipMetaInfResourcesProcessing = true
Le <nom fourni par l'utilisateur> peut être une liste de répertoires et/ou une liste de fichiers JAR. Par exemple :
<fileServingAttributes name="extendedDocumentRoot"
      value="C:\EDR_directory,C:\my\path\to\jarEDR.jar"/>
Si le <nom fourni par l'utilisateur> contient uniquement une liste constituée d'un répertoire et que ce répertoire contient des fichiers JAR, le conteneur Web n'effectue pas de recherche dans ces fichiers JAR. Il recherche des fichiers statiques et des fichiers JSP dans ce répertoire uniquement, mais en dehors des fichiers JAR. Si les fichiers statiques ou JSP se trouvent dans un fichier JAR, ils ne peuvent pas figurer dans le dossier META-INF du fichier JAR, car il s'agit d'un dossier à accès restreint, et le <nom fourni par l'utilisateur> doit contenir un chemin d'accès complet vers le fichier JAR.
Avertissement : Vous pouvez affecter la valeur true à la propriété personnalisée com.ibm.ws.webcontainer.ServeWelcomeFileFromExtendedDocumentRoot pour prendre en charge des pages de bienvenue statiques à partir d'un répertoire de documents étendu d'un fichier statique. La valeur par défaut pour la propriété personnalisée est false.
com.ibm.ws.webcontainer.ServeWelcomeFileFromExtendedDocumentRoot = true
http://fr.news.yahoo.com/photos/le-prince-albert-et-charlene-wittstock-1309531321-slideshow/#crsl=%252Fphotos%252Fle-prince-albert-et-charlene-wittstock-1309531321-slideshow%252Fprincess-charlene-wipes-away-tear-she-stands-next-photo-182247741.htmlLorsque la valeur true est affectée à la propriété com.ibm.ws.webcontainer.ServeWelcomeFileFromExtendedDocumentRoot, le conteneur Web recherche un fichier de bienvenue statique dans le répertoire de documents étendu d'un fichier statique, qui servira pour une demande contenant une URL partielle valide. Par exemple, si une demande spécifie uniquement le contexte d'application et qu'un fichier de bienvenue est indiqué sous la forme index.html, la propriété doit être définie si index.html doit être pris en charge à partir d'un document étendu de fichier statique.
com.ibm.ws.webcontainer.enablepartialurltoextendeddocumentroot = true
La valeur par défaut est false.

Lorsque la valeur true est affectée à cette propriété, le conteneur Web inclut le contenu d'un répertoire de documents étendu d'un fichier statique lorsqu'il indique si une demande entrante est destinée à une URL partielle valide. Par exemple, si une demande spécifie une URL qui se termine par /<application context>/<text> et que <text> n'est pas mappé sur un servlet ou un fichier statique, le conteneur Web considère cette URL comme une URL partielle valide uniquement si <text> est un répertoire valide de l'application. Par conséquent, si le répertoire <text> existe uniquement dans un répertoire de documents étendu de fichier statique, cette propriété doit être définie pour que l'URI soit considéré comme un URI partiel valide.

Important : Ces propriétés ne sont pas requises pour les répertoires de documents préfragmentés de fichier statique. De même, lors de la définition d'une URL partielle valide, le conteneur Web ne prend pas en compte les répertoires de documents étendus et préfragmentés JSP.

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rweb_jsp_staticfile
Nom du fichier : rweb_jsp_staticfile.html