Einen neuen Proxy-Service erstellen

Sie können das Web-Service-Gateway als reinen Proxy für Ihren Service konfigurieren und mit JAX-RPC-Handlerlisten die Endpunkte für eingehende Anforderungsnachrichten an den Service definieren.

Vorbereitende Schritte

Eine Taskübersicht zum Konfigurieren des Web-Service-Gateways in einer Konfiguration von busfähigen Web-Services finden Sie im Artikel Web-Services über den Service Integration Bus aktivieren.

Sie konfigurieren jeden Proxy-Service für eine bestimmte Gatewayinstanz. Deshalb müssen Sie die Gatewayinstanz erstellen, um Proxy-Services für diese Instanz konfigurieren zu können.

Legen Sie die Methode fest, die Sie für die Konfiguration dieser Ressourcen verwenden möchten. Sie können einen neuen Proxy-Service, wie in dieser Task beschrieben, über die Administrationskonsole erstellen, oder Sie können den Befehl 'createWSGWProxyService' verwenden.

Informationen zu diesem Vorgang

Wenn Sie einen neuen Proxy-Service erstellen, führt das Gateway in Bezug auf diesen Service keine andere Aktion aus, als diesen aufzurufen. Wenn Sie einen Proxy-Service konfigurieren, konfigurieren Sie auch eine JAX-RPC-Handlerliste, die javax.xml.rpc.service.endpoint.address verwendet, um den Zielendpunkt für den Service festzulegen. Anschließend ordnen Sie die Handlerliste dem eingehenden Port für den Proxy-Service zu.

Eine Proxy-Servicekonfiguration hat keine eigentlichen Zielservices und deshalb keine WSDL, die das Gateway verwenden kann, um den Serviceaufruf zu konfigurieren. Die Basisparameter für den Serviceaufruf (z. B. die zu verwendende Bindung) sind in einer Proxy-WSDL-Datei konfiguriert. Sie können die Standardwerte jedoch durch Bereitstellung einer eigenen generischen Proxy-WSDL-Datei überschreiben. Falls die JAX-RPC-Handlerliste nicht implementiert ist, versucht das Gateway, alle Anforderungen an die vorgetäuschte Webadresse zu senden, die in der Anweisung <soap:target address> in der Proxy-WSDL-Datei angegeben ist.

Ausführlichere Informationen finden Sie im Artikel JAX-RPC-Handler und Proxy-Operationen.

Führen Sie die folgenden Schritte aus, wenn Sie einen neuen Proxy-Service über die Administrationskonsole erstellen möchten:

Vorgehensweise

  1. Erstellen Sie einen JAX-RPC-Handler, der javax.xml.rpc.service.endpoint.address verwendet, um den Zielendpunkt für den Service zu definieren. Sie müssen entscheiden, ob der Zielendpunkt konfiguriert werden soll, und Sie müssen den JAX-RPC-Handler javax.xml.rpc.service.endpoint.address erstellen und konfigurieren.
  2. Erstellen Sie eine neue JAX-RPC-Handlerkonfiguration für den Handler, die den Zielendpunkt für diesen Service definiert.
  3. Erstellen Sie eine neue JAX-RPC-Handlerliste, wählen Sie den Handler aus, der den Zielendpunkt für diesen Service definiert, und fügen Sie ihn der Handlerliste hinzu.
  4. Starten Sie die Administrationskonsole.
  5. Klicken Sie im Navigationsfenster auf Serviceintegration -> Busse -> Busname -> [Weitere Eigenschaften] Web-Service-Gateway-Instanzen -> Instanzname -> Proxy-Services. Das Formular Proxy-Services erscheint.
  6. Klicken Sie auf Neu. Der Assistent "Neuer Proxy-Service" erscheint.
  7. Führen Sie in diesem Assistenten die folgenden Schritte aus, um den neuen Proxy-Service zu konfigurieren. Nähere Informationen zu den Eigenschaften, die Sie mit dem Assistenten definierten können, finden Sie im Artikel Einstellungen für Proxy-Services.
    1. Geben Sie den Namen des Proxy-Service, den Proxy-Port, die Serviceziele und Servicemediations an.
      Anmerkung:
      • Wählen Sie einen Namen für den Proxy-Service, der ihn unter allen Gateway- und Proxy-Services der aktuellen Gatewayinstanz eindeutig kennzeichnet. Wenn Sie einen Namen eingeben, der nicht eindeutig ist, wird eine Fehlernachricht angezeigt.
      • Der Proxy-Portpunkt ist der Punkt für das Proxy-Portziel.
      • Sie müssen keine Namen für Proxy-Ziele angeben. Wenn Sie eines dieser Felder leer lassen, wird ein Standardname generiert, wenn der Assistent die Operation durchführt. Die Standardnamen erscheinen nicht in der Anzeige. Sie werden wie folgt gebildet:
        • Der Name des Anforderungsziels entspricht dem Namen des Proxy-Service. Beispiel: myProxyService.
        • Der Name des Antwortziels entspricht dem Namen des Anforderungsziels mit dem Zusatz "Reply". Beispiel: myProxyServiceReply.
      • Die Liste der verfügbaren Mediationen enthält alle Mediationen, die derzeit im Service Integration Bus implementiert sind. Wenn Sie eine Mediation erstellt und im Bus implementiert haben, steht diese in beiden Listen zur Auswahl. Wenn Sie für den Proxy-Service keine Mediation verwenden möchten, wählen Sie in den gewünschten Listen die Option Ohne aus.
      • Busmember sind Anwendungsserver oder Cluster, die diesem Bus hinzugefügt werden. Die Eigenschaften Busmember für Anforderungsmediation und Busmember für Antwortmediation definieren die Busmember, denen die Mediation zugeordnet wird. Wenn Sie eine Mediation auswählen, müssen Sie sie einem Busmember zuordnen. Wenn Sie den Wert der Eigenschaft Anforderungsmediation oder Antwortmediation auf (ohne) setzen, müssen Sie auch den Eigenschaftswert des entsprechenden Busmembers auf (ohne) setzen.

        Wenn Sie dies nicht tun, zeigt die Administrationskonsole eine Fehlernachricht an.

      • Es wird eine generische Proxy-WSDL-Datei verwendet, um die Basisparameter für den Aufruf zu konfigurieren (z. B. die zu verwendende Bindung), aber Sie können die Standard-WSDL überschreiben, indem Sie im Feld URL der Proxy-WSDL für Überschreiben die Position Ihrer generischen WSDL-Ersatzdatei angeben.
    2. Wählen Sie die Endpunktlistener für die Eingangskonfiguration dieses Proxy-Service aus.
  8. Klicken Sie auf Fertig stellen.

Ergebnisse

Bei fehlerfreiem Abschluss der Verarbeitung wird die Liste der Proxy-Services für diese Gatewayinstanz mit dem neuen Proxy-Service aktualisiert. Andernfalls wird eine Fehlernachricht angezeigt.

Nächste Schritte

Stellen Sie sicher, dass alle Serviceanforderer den Abfragezeichenfolgeparameter operationMode an die Adresse des Proxy-Service anfügen. Gültige Werte für diesen Parameter sind oneway und requestResponse. Der Standardwert ist requestResponse. Beispiel:
  • Für HTTP: Die Webadresse des Proxy-Service ist wie folgt:
    http://Hostname:Portnummer/wsgwsoaphttp1/soaphttpengine
    /IhrBus/ProxyService/ProxyServiceInboundPort
    In diesem Fall geben die anfordernden Clients mit dem folgenden URL an, dass sie eine Einweganforderung senden:
    http://Hostname:Portnummer/wsgwsoaphttp1/soaphttpengine
    /IhrBus/ProxyService/ProxyServiceInboundPort?operationMode=oneway
  • Für JMS: Die JMS-Adresse des Proxy-Service ist wie folgt:
    jms:/queue?destination=jndi_queue&connectionFactory=
    jndi_factory&targetService=IhrBus/ProxyService/ProxyServiceInboundPort
    In diesem Fall geben die anfordernden Clients mit dem folgenden URL an, dass sie eine Einweganforderung senden:
    jms:/queue?destination=jndi_queue&connectionFactory=
    jndi_factory&targetService=
    IhrBus/ProxyService/ProxyServiceInboundPort&operationMode=oneway

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=twsg_proxy_new
Dateiname:twsg_proxy_new.html