Zugriff auf JavaDoc und Quelltext des Beispieladapters/-moduls 

Verwendung

Die JavaDoc liefert syntaktische Beschreibungen des Adapter-Framework.

Sie können den Beispieladapter und das Beispielmodul als Einstieg in die eigene Adapterentwicklung verwenden.

Integration

Die JavaDoc, der Beispieladapter und das Beispielmodul werden mit dem Adapter-Framework ausgeliefert.

Aktivitäten

Kopieren Sie die JAR-Datei (Java Archive) des Beispieladapters lokal auf ihren Computer. Die JAR-Datei enthält die JavaDoc und den Quellltext des Beispieladapters.

·        Kopieren Sie die Datei sample_ra.jar von <serverDir>\apps\sap.com\com.sap.aii.af.sample.ra\connector\connectors\sample_ra.rar auf Ihren Computer in ein eigenes Verzeichnis.

<serverDir> ist z.B. C:\usr\sap\J2E\JC00\j2ee\cluster\server0.

·        Extrahieren Sie die JAR-Datei in dasselbe Verzeichnis.

·        Öffnen Sie index.html, um die JavaDoc anzuzeigen.

·        Der Quelltext für den Beispieladapter befindet sich im Unterverzeichnis com\sap\aii\af\sample\adapter\ra.

Die folgende Beschreibung bezieht sich an vielen Stellen auf den Beispieladapter. Der Quellkode des Adapters selbst ist nicht Bestandteil der Beschreibung, sondern es erfolgt aus der Beschreibung ein Verweis auf die entsprechende Stelle im Quellkode des Beispieladapters.

SPIManagedConnectionFactory.java:CS_TXMGR zeigt, wie ein Adapter auf den J2EE Transaction Manager zugreifen kann.

Öffnen Sie die Datei SPIManagedConnectionFactory.java in der von Ihnen bevorzugten Entwicklungsumgebung, um die relevante Stelle im Quellkode zu finden.

Suche Sie dann nach CS_TXMGR. Der Kode befindet sich zwischen den Kommentarzeilen // CS_TXMGR START und // CS_TXMGR END.

·        Die hier referenzierten UML-Klassendiagramme finden Sie ebenfalls in der JAR-Datei. Sie beginnen mit uml und sind im Windows MetaFile-Format abgelegt. Sie können die Klassendiagramme in Word importieren.

Uml_ra.wmf enthält das Klassendiagramm des Beispieladapters.

·        Gehen Sie analog für das Beispielmodul vor. Sie finden es unter: <serverDir>\apps\sap.com\com.sap.aii.af.sample.module\EJBContainer\applicationjars\sample_module.jar. Es enthält auch den Quelltext, während die JavaDoc zentral beim Beispieladapter abgelegt ist.