JCA. J2EE Connector Architecture Version 1.5

Transkript

1 JCA J2EE Connector Architecture Version 1.5 Vorlesung: Applikationsserver Prof. Dr. Ch. Reich furtwangen.de furtwangen.de/~reich/appserver/index.html

2 JCA - Überblick J2EE Connector Adapter dienen dazu beliebige Altssystem (Legacy Systems), EIS (Enterprise Information Systems, z.b. SAP), Transaktionsmonitore oder Datenbanken an eine J2EE Anwendung anzubinden. JCA definiert eine Standardarchitektur. JCA definiert ein CCI (Common Client Interface) JCA ermöglicht es, dass Resourcen-Anbieter standardisierte Adapter für ein J2EE-System bereitzustellen.

3 Früher: Verbindung zu EIS erstellen EIS Beispiele: Mainframe Transaction Monitore; z.b. Tuxedo Enterprise Resource Planning (ERP); z.b. SAP DB-Systeme Früher kein standardisierter Zugriff.

4 Jetzt: Verbindung zu EIS standard. erstellen durch JCA

5 Der Resource Adapter Stellt die Verbindung zwischen J2EE und EIS her. Ist Teil des Application Servers Klassen werden in.rar (Resource Adapter Archive) gespeichert.

6 Connector Architecture

7 Connector Architecture

8 Vereinbarungen- Contracts Damit Resource-Adapter eines EIS-Provider als Plug-in des Application-Servers laufen kann hat man Contracts (Sicherheit, Transaktion,...) definiert. Resource-Adapter unterstützen 3 verschiedene Contracts (Version 1.0): System Contract legt fest, wie sich ein JCA kompatibler adapter gegenüber dem J2EE Container verhält. Es gibt: Connection Management Contract ermöglicht Verbindungs- Pooling zu einem EIS Transaction Management Contract ermöglicht das Verwalten von mehrere Resource-Manager mit dem Transaktions- Management des App.Servers. Security Contract unterstützt den Aufbau einer sicheren Umgebung bis zum EIS. Application Contract: Es sollte das CCI verwendet werden EIS Protocol Contract: Propritäre Vereinbarung

9 Vereinbarungen- Contracts fortf. Resource-Adapter unterstützen 3 verschiedene Contracts (Version 1.5): Lifecycle Management Contracts: Dadurch kann der Applikationsserver den Lebenszyclus des Resource-Adapters steuern (starten, stoppen) Work Management Contracts: Erlaubt dem Resource-Adapter eine Aufgabe dem Applikationsserver zur Ausführung zu übergeben. Transaction Infow Contracts: Erlaubt dem Resource-Adapter Transaktions der EIS in den Applikationsserver zu integrieren. Message Inflow Contracts: Erlaubt dem Resource-Adapter Nachrichten synchron oder asynchron an den Applikationsserver auszuliefern. Packaging von Resource-Adapter ist spezifiziert.

10 System Contracts: Connection Management Interface

11 Connection Management Connection Management Contract unterstützen Connection- Pooling des Resource-Adapters; Kann aber auch alles selbst machen. Applikationskomponenten (EJB, servlet, client) fragen JNDI nach einer ConnectionFactory mithilfe des Environment Naming Context (ENC). im p ort javax.resou rce.cci.con n ection Factory; im p ort javax.resou rce.cci.con n ection Factory; im p ort javax.n am in g.in itialcon text;... In itialcon text ctx = n ew In itialcon text(); Con n ection Factory fcty = (Con n ection Factory) ctx.looku p ( java:com p / en v/ eis/ m yeis ); Con n ection con n = fcty.getcon n ection (n ew MyEISCon n ection Sp ec(d ata));

12 Connection Management fortf. Mehrere Verbindungs-Handles können auf die gleiche physikalische Verbindung zeigen. Der Applikationsserver unterstützt Connection-Pooling (<res-sharing-scope>). Aus dem Pool an Verbindungen wählt er eine Verbindung (Aufruf: matchmanagedconnection()) nach folgenden Eigenschaften: Information, die mithilfe von getconnection() mitgegeben wurden (via ConnectionSpec bei CCI) Security Information (javax.security.auth.subject) Falls keine bestehende Verbindung genutzt werden kann, wird eine neue erstellt.

13 System Contracts: Transaction Management Interface

14 Transaction Management J2EE unterscheidet 2 Arten von Transaktionen Transaktionen extern kontrolliert sind XA oder JTA Transaktion (überer mehrere EIS hinweg) Der Resource Manager unterstütz oft nur one-phase commit der XA Transaktionen. Transaktionen vom Resource Manager selbst verwaltet nennt man: local transaction Ein Adapter sollte entweder beide Transaktionsarten unterstützen (<transaction-support>) oder gar keine. p ublic interface javax.resource.sp i.managed Connection { javax.transaction.xa.xaresource getxaresource() throws ResourceExcep tion; javax.resource.sp i.localtransaction getlocaltransaction() throws ResourceExcep tion;... }

15 Transaction Management Problem, wenn Adapter XA Transaktionen nicht unterstützen: Das Mischen von non-xa und XA fähigen RAs ist innerhalb eines Threads nicht erlaubt. Verschiedene RAs die entweder non-xa oder XA fähig sind können natürlich gemischt werden. Lokale Transaktionen sind auf den Container begrenzt (J2EE 1.3 Spez) Höhere Performanz wenn nur local transactions benutzt werden.

16 XA Transaction Management XA transactions können initialisiert oder terminiert (commit oder rollback) durch: Den Container (definiert im deployment descriptor) Explizit durch die Komponente; JTA- UserTransaction

17 Local Transaktions Management Local transactions sind entweder container-managed oder component-managed Komponenten kontrollieren Transaktionen mithilfe der RAspezifischen API (javax.resource.cci.localtransaction) Die Instanz LocalTransaction bekommt man durch die Verbindung. Wir component-managed von localen Transaktionen benutzt werden Ereignisse (ConnectionEventListener) nicht an den App.Server. gemeldet. p u blic in terface javax.resou rce.sp i.con n ection Even tlisten er { void localtran saction Started (Con n ection Even t even t); void localtran saction Com m itted (Con n ection Even t even t); void localtran saction Rolled back(con n ection Even t even t);... }

18 Application Contracts - Anwendungsvereinbarungen Application Contracts beziehen sich auf Benuzterinteraktion mit dem Resource Adapter. Im Idealfall erweitert der Contract die Standardschnittstelle der Connector Specification als Common Client Interface or CCI benannt Es gibt Standardschnittstellen für: Verbindungserzeugung Transaktionskontrolle Abfrage von Metadaten Die Unterstützung von CCI ist nicht unbedingt erforderlich. Firmen können auch ihre eigenen Schnittstellen liefern.

19 Sicherheitsvereinbarungen - Security Contracts Ein Applikationskomponentenhersteller hat 2 Möglichkeiten, festgelegt im deploymentdescriptor <res-auth>, um sich gegenüber einem EIS zu authentifizieren: Container: Authentifikation wird vom Deployer festgelegt Application: Authentifikation durch Parameter der getconnection()-methode. Adapter haben oft Defaultwerte bereits gesetzt. Bei der Application-Authentifikation werden die Auth.- Inforatmationen direkt an den ResourceManager weitergeleitet. Bei der Container-Authentifikation gibt es 2 Arten, einstellbar durch den deployment descriptor - <credential-interface>: PasswordCredential GenericCredential

20 Container Authentication JCA utilizes the JAAS APIs to pass authentication information The app server creates a javax.security.auth.subject object which contains a single principal and an instance of the correct Credential type The Subject instance is passed to the ManagedConnectionFactory matchmanagedconnection() or createmanagedconnection() methods by the app server The app server determines the contents of the Credential based on: The principal identification in effect at the time of getconnection() May be different from the authenticated user (e.g. EJB 2.0 runas)

21 Lifecyle Management Contract App.Server kann durch diese Vereinbarung RA managen. RA Methoden: void start(bootstrapcontext bc) void stop() Mithilfe des BootstrapConextes kann der RA herausfinden, welche Resourcen dem RA zur Verfügung stehen.

22 Work Management Contract Weiterleitung von Aufgaben an den App.Server. 2 Schnittstellen und 1 Klasse sind dabei wichtig: Work-Schnittstelle: RA kann Instanzen von Work erzeugen (Aufgaben), die der Applikationsserver zur Bearbeitung entgegennehmen kann. 2 Methoden: void run() void release()

23 Work Management Contract fortf. ExecutionContext-Klasse: Kann erzeugt werden und dem Applikationsserver zusätzlich zur Verfügung gestellt werden. WorkListener-Interface: Kann benutzt werden um den Applikationsserver Ereignisgesteuert zu informieren. Methoden: void workaccepted(workevent e) void workrejected(workevent e) void workstarted(workevent e) void workcompled(workevent e)

24 JCA Common Client Interface (CCI) Enterprise Application Integration Framework CCI API JDBC API Resource Adapter Resource Resource Adapter Adapter JDBC Treiber

25 JCA CCI Szenario Ein Adapter kann zur Laufzeit ausgetauscht werden, wenn auf eine andere Ressource zugegriffen werden soll. JCAs werden einem Ressource Archive (RAR) deployed. CCI wird vom Client (EJB) benutzt, um auf die entfernten Daten zugreifen zu können.

26 Common Client Interface CCI und JDBC Wie JDBC arbeitet CCI mit Daten-Records und einer Abfragesprache ähnlich zu SQL. Vergleich Funktion und deren Java-Klassen: Funktion JDBC (java.sql) CCI (javax.resource.cci) Verbindung erzeugen Befehl erzeugen Formatierungs -befehle DataSource Connection Statement ConnectionFactory+Conne ctionspec Connection Interaction + InteractionSpec Ergebnis ResultSet RecordFactory & Records

27 CCI Übersicht ConnectionFactory Provides an application component with a Connection instance to an EIS. Connection Represents the connection to the underlying EIS. ConnectionSpec Provides a means for an application component to pass connection-request-specific properties (e.g. password) to the ConnectionFactory when making a connection request. Interaction Provides a means for an application component to execute EIS functions, such as database stored procedures. InteractionSpec Holds properties pertaining to an application component s interaction with an EIS.

28 CCI Übersicht - Records Record The superclass for the different kinds of record instances. Record instances may be MappedRecord, IndexedRecord, or ResultSet instances, which all inherit from the Record interface RecordFactory Provides an application component with a Record instance. The create() methods of the factory takes a recordname as an argument The factory will utilize this name to reference meta information related to the construction of the record type IndexedRecord Represents an ordered collection of Record instances based on the java.util.list interface. The resource adapter may include additional means to create custom records

29 CCI Übersicht - ResultSet Die CCI ResultSet erweitern die JDBC ResultSet Bietet ähnliche Unterstützung für: durchscrollen der Ergebnisse, Typen-Mapping, Update-Funktion Man kann die Unterstützung folgender JDBC Typen nicht voraussetzen: Blob, Clob, Array, Ref, Distinct, Struct,... ResultSetInfo ermöglicht Informationen über die unterstützten ResultSets zu bekommen z.b.: Sichtbarkeit, Updatebarkeit, Einfügemöglichkeiten

30 Packaging und Deployment Resource Adapters werden in jar-dateien gepackt (Dateiendung.rar); Resource Adapter Archive muß alle Javadateien für die Ausführung enthalten. Rar-Archive enthalten den Deployment Descriptor - /META-INF/ra.xml

31 Inhalt des Deployment Descriptor Beschreibnung der Klassennamen <connection-interface> und <connection-impl-class> <connectionfactory-interface> und <connectionfactory-impl-class> <managedconnectionfactory-class> Sicherheitseinstellungen <authentication-mechanism-type>* - BasicPassword, Kerbv5, etc. <credential-interface> - PasswordCredential oder GenericCredential <reauthentication-support> - ManagedConnections Änderungen <security-permission> - Sicherheitszugriff (standard grant.policy syntax) Verschiedenes <license-required> <config-property> - verschieden Konfigurationswerte

32 JCA zu Literatur J2EE Connector Architecture and Enterprise Application Integration Rahul Sharma et. al. J2EE 1.3 tutorial fcs/index.html J2EE Connector Architecture - Enterprise Integration with IBM Connectors and Adapters IBM Redbook SG246122