Anwendungsendpunkt konfigurieren

Eine WAB-Konfigurationsdatei wird zum Konfigurieren eines Webanwendungsbundles (WAB, Web Application Bundle) verwendet. Zum Konfigurieren eines WAB muss eine WABConfiguration als OSGi-Service registriert sein. Die WABConfiguration ist eine Markierungsschnittstelle, die keine Methoden hat. Die Konfiguration für ein WAB wird über die Registrierung der WABConfiguration als OSGi-Service mit den Serviceeigenschaften contextName und contextPath angegeben.

Informationen zu diesem Vorgang

Ein WAB gibt den Kontextpfad mithilfe des Manifestheaders des OSGi-Bundles, Web-ContextPath, an. Um anzugeben, dass ein WAB einen konfigurierbaren Kontextpfad hat, muss der Web-ContextPath-Headerwert mit dem Zeichen @ beginnen und der verbleibende Inhalt hinter dem Zeichen @ wird als contextName verwendet. Im folgenden Beispiel wird ein WAB mit einem konfigurierbaren Kontextpfad gezeigt:
Web-ContextPath: @myWABContextPath

Vorgehensweise

  1. Registrieren Sie einen WABConfiguration-Service mit dem contextName-Wert myWABContextPath, um den Kontextpfad zu konfigurieren. Sie können die deklarative Servicekomponente verwenden.
    @Component(
     configurationPid = "my.wab.configuration",
     configurationPolicy = ConfigurationPolicy.REQUIRE)
     public class MyWABConfiguration implements WABConfiguration {
     	 // Wird nur verwendet, um die Serviceeigenschaften "contextPath"
    	 // und "contextName" über die Konfigurationsverwaltung mit der PID
    	 // my.wab.configuration festzulegen.
     }
  2. Die folgende in der Datei metatype.xml enthaltene XML definiert die Konfigurationsoptionen für die Servicekomponente.
    <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>
    Dieser Metatyp gibt die Standardwerte für die Eigenschaften contextName und contextPath an. Wenn Sie keine weitere Konfiguration festlegen, werden die Standardwerte zum Konfigurieren des WAB-Kontextpfads verwendet.
    Anmerkung: Das Element <AD> mit der ID contextName hat internal als Namen und enthält ibm:final. Damit kann der Standardwert für die Servicekomponente angegeben werden, aber es ist nicht möglich, den Standardwert in der Konfigurationsdatei server.xml zu überschreiben. Der WAB-Kontextpfad kann dann mit dem folgenden Konfigurationselement in der Datei server.xml konfiguriert werden:
    <usr_myWAB contextPath="/myWab/path"/>

    Das Präfix usr_ ist erforderlich, wenn das Bundle mit der WABCconfiguration-Komponente als usr-Feature installiert wird. Wenn das Bundle mit einer Produkterweiterung installiert wird, besteht das Präfix aus dem Produktnamen mit anschließendem Zeichen _. Weitere Informationen zu Produkterweiterungen finden Sie unter Liberty:Produkterweiterung.


Symbol das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 01.12.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twlp_config_app_endpoint
Dateiname: twlp_config_app_endpoint.html