Informationen zum Endpunkt-URL für JMS-Bindungen konfigurieren

WebSphere Application Server unterstützt die Verwendung der JMS-API (Java Message Service) für den Transport von Web-Service-Anforderungen als Alternative zu HTTP.

Vorbereitende Schritte

Der Anwendungsserver unterstützt die Verwendung der JMS-API (Java Message Service) für den Transport von Web-Service-Anforderungen als Alternative zum HTTP-Transport. Lesen Sie die Informationen zur Verwendung von Java™ Message Service (JMS) als Transport für Web-Service-Anforderungen, um mehr darüber zu erfahren, wie Web-Service-Clients und -Server über JMS-Warteschlangen- und Topics anstelle von HTTP-Verbindungen kommunizieren können.

Sie können die Administrationskonsole oder Eigenschaftendateien verwenden, um URL-Fragmente für den JMS-Endpunkt zu konfigurieren und zu verwalten. Informationen zur Verwendung von Eigenschaftendateien für die Definition und Verwaltung der URL-Fragmente finden Sie in der Dokumentation zur Arbeit mit Eigenschaftendateien für die URL-Fragmente von Web-Service-Endpunkten.

Diese Task beschreibt die Verwendung der Administrationskonsole für die Konfiguration von Endpunkt-URL-Informationen für JMS-Bindungen.

Informationen zu diesem Vorgang

Sie müssen einen Serviceendpunkt konfigurieren, um Web-Service-Clients mit den Web-Services, die sich unter den zu assemblierenden Komponenten befinden, oder mit externen Web-Services zu verbinden. Sie können die Informationen zum Endpunkt-URL für JMS während der Anwendungsinstallation konfigurieren.

In dieser Task geben Sie das URL-Präfix für den JMS-Endpunkt an, das für alle Web-Service-fähigen EJB-JAR-Dateien, die zur Anwendung gehören, verwendet werden soll. Die JMS-Endpunkt-URLs sind in den WSDL-Dateien (Web Services Description Language) enthalten, die für Clients veröffentlicht werden.

Sie können HTTP-URL-Standardpräfixe für Web-Services, auf die über HTTP zugegriffen wird, in der Anzeige "Informationen zum HTTP-Endpunkt-URL angeben" der Administrationskonsole angeben. Diese Präfixe werden verwendet, um die Endpunktadressen zu bilden, die in den veröffentlichten WSDL-Dateien enthalten sind.

Sie können die JMS-URL-Präfixe in der Administrationskonsole in der Anzeige "Informationen zum JMS- und EJB-Endpunkt-URL angeben" während oder nach der Anwendungsinstallation angeben.

Diese Task gilt für JAX-WS- (Java API for XML-Based Web Services) und JAX-RPC-Web-Services (Java API for XML-based RPC).

Gehen Sie zum Konfigurieren der JMS-URL-Präfixe wie folgt vor:

Vorgehensweise

  1. Öffnen Sie die Administrationskonsole.
  2. Klicken Sie auf Anwendungen > Unternehmensanwendungen > Anwendungsinstanz > Informationen zum JMS- und EJB-Endpunkt-URL angeben.
  3. Suchen Sie die Liste der Web-Service-Module, die über den JMS-Transport zugänglich sind.
  4. Geben Sie im Feld URL-Fragment das JMS-URL-Fragment ein. Geben Sie ein URL-Fragment ein, das als Präfix im Anfangsabschnitt des URL fungiert und über die Prüfung der Implementierungsinformationen des Web-Service abgerufen wird. Nähere Informationen finden Sie im Einsatzszenario, das dieser Task folgt.

    Mit dem eingegebenen Wert wird das Positionsattribut des Portelements "soap:address" in der WSDL-Datei definiert, die mit der Datei Anwendungsname_ExtendedWSDLFiles.zip oder Anwendungsname_WSDLFiles.zip in der Anzeige "WSDL-ZIP-Dateien veröffentlichen" veröffentlicht wird.

Ergebnisse

Sie haben einen Web-Service, der über den JMS-Transport zugänglich und mit JMS-Bindungen konfiguriert ist.

Beispiel

Angenommen, eine Anwendung mit dem Namen "StockQuoteService" enthält eine EJB-JAR-Datei "StockQuoteEJB" mit Web-Services enthält, die über den JMS-Transport zugänglich sind.

Sehen Sie sich das Beispiel in den Informationen zur Verwendung von SOAP over Java Message Service für den Transport von Web-Services an, in dem eine Warteschlange mit dem JNDI-Namen (Java Naming and Directory Interface) jms/StockQuote_Q und eine Verbindungsfactory mit dem JNDI-Namen jms/StockQuote_CF für Ihre Anwendung definiert werden.

In diesem Beispiel geben Sie in der Anzeige "Informationen zu JMS- und EJB-Endpunkt-URLs angeben" die folgende Zeichenfolge als JMS-URL-Präfix an:
jms:/queue?destination=jms/StockQuote_Q&connectionFactory=jms/StockQuote_CF  
Der WSDL-Publisher verwendet diese URL-Teilzeichenfolge, um den eigentlichen JMS-URL für jede Portkomponente zu erstellen, die im Modul definiert ist. Die Zeichenfolge targetService=<Portname> wird am Ende des JMS-URL hinzugefügt, z. B.:
jms:/queue?destination=jms/StockQuote_Q&connectionFactory=jms/StockQuote_CF&targetService=getQuote  

Die veröffentlichte WSDL-Datei wird von Clients für den Aufruf des Web-Service verwendet.

Nächste Schritte

Veröffentlichen Sie die WSDL-Dateien, um die implementierte Web-Service-Anwendung für die Clients verfügbar zu machen.

Symbol, das den Typ des Artikels anzeigt. Taskartikel



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