Java-Proxies als Empfänger 

Verwendung

Sie wollen einen Service, der über den Integration Server angesprochen werden soll, auf dem SAP J2EE Server bereitstellen.

Integration

Die von der Java-Proxy-Generierung generierten Proxy-Beans und Proxy-Klassen müssen zusammen mit dem Anwendungsprogramm deployed werden. Dazu nehmen Sie sie in die gleiche EAR-Datei auf, in der sich die Klassen Ihrer Anwendung befinden. Die generierten Klassen sind von den Klassen der Java-Proxy-Runtime abhängig, die auf dem J2EE-Server installiert sein muss. Um diese Abhängigkeit für EJB-Anwendungen zu deklarieren, nehmen Sie folgende Pakete mit in die Deskriptor-Datei application-j2ee-engine.xml auf:

com.sap.aii.proxy.xiruntime
com.sap.aii.af.sdk.xi
com.sap.xi.util.misc
com.sap.guid

Alle Bibliotheksabhängigkeiten sind vom Typ weak und haben den Provider-Namen sap.com.

Voraussetzungen

Sie haben ein Inbound-Message-Interface für Ihren Service im Integration Repository angelegt. Mit Hilfe der Java-Proxy-Generierung haben Sie Server-Proxy-Beans und Server-Proxy-Klassen generiert, die Sie in Ihre Anwendung mit aufnehmen.

Wenn Sie vor SAP XI 3.0 FP Java-Server-Proxies generiert haben, beachten Sie unbedingt Hinweis 738625.

Funktionsumfang

Auf Empfängerseite horcht der JPR-Proxy-Server auf eingehende Messages vom Messaging-System. Der JPR Proxy-Server leitet die Message über die Java-Proxy-Laufzeit an die zugehörige Server-Bean weiter, die in JPR-Registry registriert sein muss. Diese Bean ruft über das generierte Server-Proxy-Interface die implementierende Klasse auf dem J2EE-Server auf (die generierten Klassen sind in hellgrau dargestellt):

Die implementierende Klasse muss folgende Eigenschaften haben:

·        Sie muss das generierte Server-Proxy-Interface implementieren.

·        Der Namen der implementierenden Klasse ist festgelegt. Er besteht aus dem Namen des Server-Proxy-Interface und dem Suffix Impl.

·        Die Klasse muss von der Klasse AbstractProxy abgeleitet sein.

Wenn Ihr Message-Interface den Namen MyInbound hat, dann wurde daraus das Java-Interface MyInbound_PortType generiert, das Sie über die Klasse MyInbound_PortTypeImpl implementieren müssen:

public class MyInbound_PortTypeImpl
                  extends AbstractProxy
                  implements MyInbound_PortType {...}

Um zusätzliche Services der Java-Proxy-Laufzeit zu nutzen, stellt die Laufzeit ein MessageSpecifier-Interface zur Verfügung. Über dieses Interface können Sie zum Beispiel Attachments mit der Message versenden. Siehe: Das MessageSpecifier-Interface.

Aktivitäten

...

       1.      Implementieren Sie das Server-Proxy-Interface.

       2.      Registrieren Sie das Server-Proxy-Interface beim Proxy-Server.