[16.0.0.3 and later]

Configuration d'un noeud final d'application

Un fichier de configuration WAB est utilisé pour configurer un bundle d'applications Web (WAB - Web Application Bundle). Pour configurer un WAB, un composant WABConfiguration doit être enregistré comme service OSGi. Le composant WABConfiguration est une interface de marqueur qui ne possède pas de méthode. La configuration d'un WAB est spécifiée par l'enregistrement de WABConfiguration comme service OSGi par les propriétés de service contextName et contextPath.

Pourquoi et quand exécuter cette tâche

Un WAB spécifie le chemin de contexte à l'aide de l'en-tête de manifeste de bundle OSGi Web-ContextPath. Pour indiquer qu'un WAB possède un chemin de contexte configurable, la valeur de l'en-tête Web-ContextPath doit commencer par le caractère @ et le contenu restant après le caractère @ initial est utilisé comme contextName. L'exemple ci-dessous illustre un WAB avec un chemin de contexte configurable :
Web-ContextPath: @myWABContextPath

Procédure

  1. Enregistrez un service WABConfiguration à l'aide de la valeur contextName de myWABContextPath pour configurer le chemin de contexte. Vous pouvez utiliser le composant de service déclaratif.
    @Component(
     configurationPid = "my.wab.configuration",
     configurationPolicy = ConfigurationPolicy.REQUIRE)
     public class MyWABConfiguration implements WABConfiguration {
     	 // Only used to set "contextPath" and "contextName" service
    	 // properties from configuration admin using the pid
    	 // my.wab.configuration
     }
  2. Le XML suivant contenu dans le fichier metatype.xml définit les options de configuration du composant de service.
    <metatype:MetaData xmlns:metatype="http://www.osgi.org/xmlns/metatype/v1.1.0" 
                       xmlns:ibm="http://www.ibm.com/xmlns/appservers/osgi/metatype/v1.0.0"
                       localization="OSGI-INF/l10n/metatype">
     
        <OCD description="My WAB Configuration" name="My WAB Configuration" 
             id="my.wab.configuration" ibm:alias="myWAB">
     
            <AD name="Context Path" description="The Context Path"
                id="contextPath" required="true" type="String" default="/default/path" />
            <AD name="internal" description="internal"
                id="contextName" ibm:final="true" type="String" default="myWABContextPath" />
        </OCD>
        
        <Designate pid="my.wab.configuration">
            <Object ocdref="my.wab.configuration"/>
        </Designate>
     </metatype:MetaData>
    Ce métatype spécifie les valeurs par défaut des propriétés contextName et contextPath. Si vous ne spécifiez aucune configuration additionnelle, les valeurs par défaut sont utilisées pour configurer le chemin de contexte WAB.
    Remarque : L'élément <AD> avec l'ID contextName a internal comme nom et inclut ibm:final. Ceci permet de spécifier la valeur par défaut du composant de service mais ne permet pas de remplacer la valeur par défaut dans la configuration du fichier server.xml. Le chemin de contexte du WAB peut ensuite être configuré à l'aide de l'élément de configuration de server.xml suivant :
    <usr_myWAB contextPath="/myWab/path"/>

    Le préfixe usr_ est nécessaire si le bundle avec le composant WABCconfiguration est installé en tant que fonction usr. Si le bundle est installé avec une extension de produit, le préfixe est le nom de produit suivi du caractère _. Pour plus d'informations sur les extensions de produit, voir Extension de produit


Icône indiquant le type de rubrique Rubrique Tâche

Nom du fichier : twlp_config_app_endpoint.html