Klassendesign

Resource Adapter erfahren Wiederverwendung als JavaEE Komponente. Auf der Ebene des Klassendesigns ist Wiederverwendung nicht vorgesehen - entsprechend sollten alle Klassen nicht für Vererbung ausgelegt sein und Abstraktionen sind überflüssig:

• Alle Resource Adapter Klassen und Interfaces werden einem Paket zugeordnet.
• Alle nicht öffentlichen Klassen und Methoden erhalten den Default-Modifier oder sind privat.
• Klassen werden typischerweise als final gekennzeichnet.

Namenskonventionen

Die für Clients oder den Server sichtbaren Klassen erhalten standardisierte Namen in dem das EIS als Bestandteil genannt wird. Ziel ist dabei möglichst einfach lesbarer Client-Code:

Outbound Resource Adapter:
:
<EISName>Connection 
<EISName>ConnectionImpl
<EISName>ConnectionFactory 
<EISName>ConnectionFactoryImpl
<EISName>ConnectionRequestInfo
ManagedConnectionImpl
ManagedConnectionFactoryImpl
ManagedConnectionMetaDataImpl
DefaultConnectionManager
LocalTransactionImpl
XAResourceImpl

Inbound Resource Adapter:
:
<EISName>ResourceAdapter
<EISName>MessageListener
<EISName>ActivationSpec

Nicht öffentliche Klassen brauchen keine Namenskonventionen.

Deployment

Das Deployment des Adapters geschieht in einem Archiv mit der Endung rar, das typischerweise diese Struktur hat:

/META-INF/ra.xml             // der Deploymentdeskriptor
/META-INF/some-server-ra.xml // serverspezifische Ergänzungen
/META-INF/MANIFEST.MF        // das Manifest des Archivs (optional)
/images/ra.jpg               // ein Icon für Toolsupport (optional)
/readme.txt                  // Release-Info
/ra.jar                      // die Klassen des Adapters, auch als Verzeichnis mit Paketstruktur
/eis.jar                     // die Java API des EIS (optional)
/utilities.jar               // Java Helferklassen
/windows.dll                 // native Bibliotheken (optional)
/unix.so