In diesem Fenster können Sie SOAP/HTTP oder SOAP/JMS-Bindedetails
angeben.
Assistent zum Generieren von WSDL
Der Assistent
für die WSDL-Generierung zeigt die folgenden Fenster an:
Fenstereigenschaften
- Servicename
- Der Servicename ist der Wert für das Namensattribut des Serviceelements in
der generierten WSDL-Datei. Die genaue Verwendung des Namens ist von Produkten abhängig, von denen die WSDL-Datei anschließend benutzt wird, z. B. von SOAP-Toolkits oder UDDI-Repositorys. Wenn Sie
beispielsweise anschließend mit einem SOAP-Toolkit aus der WSDL-Datei einen Java™-Code generieren,
wird der Servicename üblicherweise zum Namen der Java-Schnittstelle.
- Portname
- Diese Eigenschaft ist der Name eines bestimmten WSDL-Ports für diesen Service. Er wird
normalerweise vom Servicenamen abgeleitet. Eine konventionelle Vorgehensweise wäre, einen
Servicenamen in der Form '<xyz>-Service' und einen Portnamen in der Form
'<xyz>-Provider' anzugeben.
Der Portname ist der Wert des Namensattributs des Portelements in der generierten WSDL-Datei. Die genaue Verwendung des Namens ist von Produkten abhängig, von denen die WSDL-Datei
anschließend benutzt wird, z. B. von SOAP-Toolkits oder UDDI-Repositorys. Wenn Sie beispielsweise
anschließend mit einem SOAP-Toolkit aus der WSDL-Datei einen Java-Code generieren, kann aus dem
Portnamen der Name einer Java-Klasse werden.
Sie können zwischen zwei Optionen auswählen:
- SOAP/HTTP
- Wählen Sie diese Option aus, um mithilfe vorhandener
Nachrichtendefinitionen eine neue WSDL-Definition mit einem HTTP-Transport zu generieren. Dies ist die Standardoption.
- SOAP/JMS
- Wählen Sie diese Option aus, um mithilfe vorhandener
Nachrichtendefinitionen eine neue WSDL-Definition mit einem JMS-Transport zu generieren.
Bei Auswahl von SOAP/HTTP werden die folgenden zusätzlichen Eigenschaften angezeigt:
- SOAP-Aktion
- Diese Eigenschaft legt den Wert für den HTTP-Header 'SoapAction' fest.
Es ist möglich, dass
eine Anwendung SoapAction als einen Mechanismus verwendet, um eine SOAP-Nachricht mit einer
Implementierungsmethode in Beziehung zu setzen. Dies ist häufig in Verbindung mit dem RPC-Format
von WSDL der Fall.
Wenn die WSDL-Definition mehrere Operationen enthalten soll und diese unterschiedliche SOAP-Aktionen verwenden, müssen Sie die eindeutigen SOAP-Aktionswerte nach der Generierung zur WSDL hinzufügen. Wenn alle Operationen dieselbe SOAP-Aktion verwenden, geben Sie an dieser Stelle den Wert an.
- Portadresse
- Diese Eigenschaft legt die Adresse fest, an der der Service zur Verfügung gestellt wird. Der Wert muss eine
gültige URL sein und die Portnummer einschließen, falls sich diese von der Nummer des HTTP-Standardports unterscheidet. Beispiel für eine Portadresse:
http://localhost:9080/wassoap/servlet/router
Bei Auswahl von SOAP/JMS werden die folgenden zusätzlichen Eigenschaften angezeigt:
- Ausgabestil
- Der Stil, in dem Sie den Namen des Ziels der JMS-Nachricht angeben. Der Standardwert ist jndi.
- Bestimmungsname
- Der Name des Ziels der JMS-Nachricht. Bei der Angabe dieser Eigenschaft muss die Eigenschaft Ausgabestil berücksichtigt werden.
- Name des JMS-Providers
- Wählen Sie in der Liste einen JMS-Providernamen aus. Wenn Sie in der Liste einen Namen auswählen, wird die Eigenschaft Ausgangskontextfactory automatisch mit der entsprechenden
Java-Klasse aktualisiert. Der Name muss dem Namen eines konfigurierbaren Service entsprechen, der für den Broker, für den Sie den Nachrichtenfluss implementieren, definiert ist.
- Ausgangskontextfactory
Der Ausgangspunkt für einen JNDI-Namespace. Eine JMS-Anwendung verwendet den Ausgangskontext, um die Verbindungsfactory sowie Warteschlangen
oder Themenobjekte für den JMS-Provider abzurufen und zu suchen. Wenn Sie in der Liste unter Name des JMS-Providers den Namen eines JMS-Providers auswählen, wird die Eigenschaft Ausgangskontextfactory automatisch mit der entsprechenden Java-Klasse aktualisiert. Der Standardwert lautet
com.sun.jndi.fscontext.RefFSContextFactory. Mit diesem Wert wird die dateibasierte
Ausgangskontextfactory für den JMS-Provider von
WebSphere MQ definiert.
- JNDI-Verbindungs-Factory
- Der Name der verwendeten Verbindungs-Factory. Dieser Name muss in der Bindungsdatei bereits vorhanden sein. Die JNDI-Verbindungsfactory ist eine JMS-Warteschlangenverbindungsfactory. Alternativ können Sie die generische JMS-Verbindungsfactory angeben.
- JNDI-URL
- Die JNDI-URL für den JMS-Provider.
- Zustellmodus
- Durch diese Eigenschaft wird der Permanenzmodus für eine Nachricht gesteuert.
Folgendes sind gültige Werte:
- Permanent: Die Nachricht bleibt auch bei einem Systemausfall des JMS-Providers erhalten.
- Nicht permanent: Die Nachricht geht bei einem Systemausfall des JMS-Providers verloren.
- Lebensdauer der Nachricht abfragen
- Diese Eigenschaft gibt (in Sekunden) den Zeitraum an, über den die ausgegebene JMS-Nachricht aufbewahrt wird. Mit dem Standardwert 0 wird angegeben, dass die
Nachricht nicht ablaufen darf.
- JMS-Nachrichtenpriorität abfragen
Diese Eigenschaft weist der Nachricht eine relative Bedeutung zu und kann von
einem empfangenden Web-Service zur Nachrichtenauswahl verwendet
werden.
Wählen Sie einen Wert zwischen 0 (niedrigste Priorität) und 9 (höchste Priorität) aus. Der Standardwert lautet 4, was einer mittleren Priorität entspricht. Bei Prioritäten im Bereich 0 - 4 handelt es sich um eine normale Zustellung. Bei Prioritäten im Bereich 5 - 9 erfolgt die Zustellung schneller.
- Zielname für Antwort
- Der Name der JMS-Zieladresse, an die die empfangende Anwendung eine Antwortnachricht senden muss. Der JMS-Bestimmungsname muss der Domäne des vom empfangenden Client verwendeten JMS-Providers bekannt sein, damit eine Antwortnachricht an diese JMS-Zieladresse zurückgegeben werden kann.
- JNDI-Parameter spezifizieren
- Geben Sie in dieser Tabelle als Name/Wert-Paar JNDI-Kontextparameter ein, die in die erzeugte WSDL-URI aufgenommen werden sollen. Wenn die Auswahl des Kontrollkästchens Use SOAP/JMS interoperability protocol (SOAP/JMS-Interoperabilitätsprotokoll verwenden) aufgehoben wird, wird die Tabelle JNDI-Parameter inaktiviert und ihre Werte werden nicht in der resultierenden WSDL generiert.
- Benutzerparameter spezifizieren
- Geben Sie in dieser Tabelle als Name/Wert-Paar weitere Benutzerparameter ein, die in die erzeugte WSDL-URI aufgenommen werden sollen.
- Verwenden Sie das SOAP/JMS-Interoperabilitätsprotokoll
- Dieses Kontrollkästchen ist standardmäßig ausgewählt. Ist dieses Kontrollkästchen ausgewählt, ist die generierte SOAP/JMS WSDL im W3C-Format, ansonsten ist es WSDL der IBM-Art. Wenn Sie dieses Kontrollkästchen löschen, wird die Tabelle JNDI-Parameter inaktiviert und ihre Werte werden in der resultierenden WSDL nicht erzeugt.