Laufzeitumgebung (Java-Mappings) 

Verwendung

Über die Laufzeitumgebung für Java-Mappings führt der Integration Server (beziehungsweise das PCK) Java-Mapping-Programme aus. Sie können zusätzlich zur Mapping-API weitere Standard-Bibliotheken des SAP J2EE-Servers in hochgeladenen Java-Mapping-Programmen nutzen.

Voraussetzungen

Sie verwenden das SAP NetWeaver Developer Studio.

Um ein Mapping-Programm in ihrer Java-Entwicklungsumgebung schreiben zu können, muss die Java-Laufzeitumgebung (JRE) des SAP J2EE Servers mit der JRE-Version Ihrer Java-Entwicklungsumgebung konsistent sein.

Funktionsumfang

Die Mapping-Laufzeit-Umgebung besteht aus folgenden Laufzeitkomponenten:

·        Der Java Laufzeitumgebung (JRE) des SAP J2EE Servers.

·        Der Mapping-API (siehe: Java-Mapping)

¡        sapxmltoolkit
Das SAP XML Toolkit for Java beinhaltet eine Implementierung von JAXP.

¡        com.sap.mw.jco
Der SAP Java Connector erlaubt es ABAP-APIs aus dem Java Mapping heraus aufzurufen. Die zugehörige Javadoc-Dokumentation finden Sie im SAP Developer Network unter der Internetadresse https://www.sdn.sap.com/sdn/developerareas/ep.sdn?page=javadoc.htm.

¡        com.sap.tc.Logging
Der SAP Logging Service bietet eine Integration mit dem SAP Web AS Management-Werkzeugen. Die zugehörige Javadoc-Dokumentation finden Sie im SAP Developer Network unter der Internetadresse https://www.sdn.sap.com/sdn/developerareas/ep.sdn?page=javadoc.htm.

Java-Programme, die in einem Importierten Archiv hochgeladen werden, können Klassen aus dem JRE, aus der Mapping-API und diesen drei Standardbibliotheken verwenden.

Suchpfad für Klassen in Java-Mapping-Programmen (Integration Server)

Die Mapping-Laufzeitumgebung wird durch die Software-Komponentenversion und den Namensraum des auszuführenden Java-Mappings mitbestimmt. Zudem hat die Umgebung eine bestimmte Suchreihenfolge beim Laden der Klassen. Findet die Mapping-Laufzeitumgebung eine Klasse in einem Pfad, wird die Suche beendet und die nachfolgenden Pfade ignoriert. Es werden folgende Pfade in der hier angegebenen Reihenfolge durchsucht:

...

       1.      Die Pfade der JRE des J2EE Servers

       2.      Pfad, in dem die Mapping API abgelegt ist und der Pfad der Standardbibliotheken (SAP XML Toolkit, SAP Java Connector, SAP Logging Service), siehe oben.

       3.      Importierte Archive, die in dem gleichen Namensraum und der gleichen Software-Komponentenversion wie das auszuführende Java-Mapping liegen,

       4.      Importierte Archive, die in dem gleichen Namensraum und in einer unterliegenden Software-Komponentenversion liegen,

       5.      Importierte Archive, die in anderen Namensräumen der Software-Komponentenversion liegen,

       6.      Importierte Archive, die in anderen Namensräumen aber in unterliegenden Software-Komponentenversionen liegen.

Dabei ist zu beachten, dass eine Klasse nur dann aus den übrigen Namensräumen geladen werden kann, wenn sie dort eindeutig ist.

In den Klassen eines Importierten Archivs darf kein Class Loader verwendet werden.

Suchpfad für Klassen in Java-Mapping-Programmen (PCK)

Die Mapping-Laufzeitumgebung des PCK kennt keine Software-Komponentenversion Daher werden weniger Pfade beim Laden der Klassen durchsucht. Findet die Mapping-Laufzeitumgebung eine Klasse in einem Pfad, wird die Suche beendet und die nachfolgenden Pfade ignoriert. Es werden folgende Pfade in der hier angegebenen Reihenfolge durchsucht:

...

       1.      Die Pfade der JRE des J2EE Servers.

       2.      Pfad, in dem die Mapping API abgelegt ist und der Pfad der Standardbibliotheken (SAP XML Toolkit, SAP Java Connector, SAP Logging Service), siehe oben.

       3.      Importierte Archive, die in dem gleichen Namensraum wie das auszuführende Java-Mapping liegen.

       4.      Importierte Archive, die in anderen Namensräumen wie das auszuführende Java-Mapping liegen.

Dabei ist zu beachten, dass eine Klasse nur dann aus den übrigen Namensräumen geladen werden kann, wenn sie dort eindeutig ist.

In den Klassen eines Importierten Archivs darf kein Class Loader verwendet werden.

Aktivitäten

Zugriff auf die Laufzeitumgebung im SAP NW Developer Studio

·        Um auf die Mapping-API zugreifen zu können, müssen Sie die Jar-Datei aii_map_api.jar in Ihren Klassenpfad aufnehmen. Sie finden die Jar-Datei in dem Verzeichnis:

<SAP_install_dir>/<system_name>/<instance_name>/j2ee/cluster/server<number>/apps/sap.com/com.sap.xi.services/

·        Um die drei J2EE-Standardbibliotheken in den Klassenpfad des NetWeaver Developer Workplace aufzunehmen, rufen Sie in Ihrem Eclipse-Projekt die Funktion Set Additional Libraries... über das Kontext-Menü auf und wählen die Bibliotheken com.sap.tc.Logging, com.sap.mw.jco beziehungsweise sapxmltoolkit aus.