Web-Service-Provider für die vermittelte Kommunikation
Kontext
Wenn ein Web-Service-Provider den Integration Server (IS) als Vermittler verwendet, empfängt der Provider seine Anfragen direkt vom IS. Der Provider verarbeitet dann diese Anfragen und sendet, wenn nötig, seine Antwort an den IS. Der IS wiederum sendet die Antwort an den entspechenden Service-Consumer.
Mit dem Adaptertyp PI WS können Sie synchrone und asynchrone Web-Service-Provider anlegen.
Vorgehensweise
Definieren Sie das Service-Interface im Enterprise Services Repository (ES Repository).
Im Enterprise Service Builder definieren Sie ein Inbound-Service-Interface. Das Inbound-Service-Interface setzt sich aus dem Interface-Pattern zustandslos , Operationen sowie Message-, Daten- und Fault-Typen zusammen. Weitere Informationen finden Sie unter Service-Interface , Interface-Pattern , Message-Typ und Fault-Message-Typ .
Konfigurieren Sie das Service-Interface im Integration Directory.
Legen Sie im Integration Builder die folgenden Komponenten an, um die Service-Interface-Kommunikation zwischen dem Provider-System und dem IS zu konfigurieren:
Legen Sie eine Empfänger-Kommunikationskomponente an, um Details für die Eingangsverarbeitung zu definieren und die Kommunikation zwischen dem Web-Service-Provider und dem IS zu aktivieren.
Legen Sie einen Empfänger-Kommunikationskanal an. Insbesondere können Sie mit dem Kommunikationskanal den Typ und die Konfiguration des für die Eingangsverarbeitung verwendeten Adapters definieren. Weitere Informationen finden Sie unter Kommunikationskanäle definieren .
Legen Sie eine Empfängerermittlung und eine Empfängervereinbarung an.
Eine Empfängervereinbarung enthält eine Referenz zu einem Kommunikationskanal. Sie definieren eine Empfängervereinbarung zwischen einem Sender und einem Empfänger für ein Inbound-Interface. Weitere Informationen finden Sie unter Empfängervereinbarung definieren und Empfängerermittlung definieren .
Wahlweise können Sie einen Empfänger-Partner anlegen. Weitere Informationen finden Sie unter Kommunikationspartner definieren .
Im SAP NetWeaver Developer Studio legen Sie den Web-Service (Inbound-Proxy) an:
Importieren Sie das WSDL-Dokument aus dem ES Repository. Weitere Informationen finden Sie unter Importing WSDL Documents in the SAP NetWeaver Developer Studio .
Legen Sie anhand des WSDL-Dokuments des im ES Repository modellierten relevanten Inbound-Service-Interface einen Outside-In-Web-Service an.
Das Web-Service-Framework generiert ein Gerüst der Implementierungs-Bean, das die Deklarationen der Web-Service-Methoden für die Operationen im WDSL-Dokument enthält. Weitere Informationen über das Anlegen von Outside-In-Web-Services finden Sie unter Creating Outside-In Web Services .
Geben Sie eine Implementierung der Business-Methoden des Web-Service an.
Nur bei asynchronen Web-Services fügen Sie dem Quelltext die folgende WS-RM-bezogene Annotation hinzu: @RelMessagingNW05DTOperation(enableWSRM=true)
Führen Sie das Deployment des Web-Service auf dem Anwendungsserver durch. Weitere Informationen finden Sie unter Building, Publishing and Removing Published Java EE Applications .
Konfigurieren Sie den Web-Service.
Konfigurieren Sie im Integration Builder den Empfänger-Kommunikationskanal, den Sie in Schritt 2 angelegt haben. Der Empfänger-Kommunikationskanal ist eine Ziel-URL, die auf die URL des Web-Service zeigt.
Bei asynchronen Web-Services legen Sie die Ziel-URL nach folgendem Schema an: http://[Host]:[Port]/[Service_Access_Path]?wsdl&mode=ws_policy
Im SAP NetWeaver Administrator legen Sie eine Laufzeitkonfiguration (genannt service endpoint) des Web-Service an.
Sie enthält die relevanten Laufzeiteinstellungen, wie z.B. die Authentifizierungsstufe, für den Web-Service.
Weitere Informationen zur Konfiguration des Web-Service im SAP NetWeaver Administrator finden Sie unter Configuring Individual Web Services und Configuration of Individual Web Services and Web Service Clients .