Stand-Alone Deployment als RAR

Folgen Sie beim Deployment als Resource Adapter Archive (RAR) den Regeln, die in der JCA-Spezifikation beschrieben sind.

Der Inhalt des RAR ist typischerweise:

META-INF\connector-j2ee-engine.xml

META-INF\log-configuration.xml

META-INF\Manifest.mf

META-INF\ra.xml

your_ra.jar

connector-j2ee.engine.xml

Um Referenzen zu anderen Einheiten, wie beispielsweise dem Adapter-Framework Messaging Service oder der Adapter-Framework CCI-Bibliothek herzustellen, wird der AS Java connector-j2ee.engine.xml Deployment Descriptor (DD) benötigt.

Weitere Informationen: Deployment Descriptors

Der Inhalt sieht wie in folgendem Beispiel aus und kann für einen Adapter des Adapter-Framework verwendet werden:

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE connector-j2ee-engine SYSTEM 'connector-j2ee-engine.dtd'>

<connector-j2ee-engine>

<loader-references>

<!-- Typically these SAP J2EE libs, etc. are used -->

<loader-name strength="hard">interface:appcontext</loader-name>

<loader-name strength="hard">service:engine.security.facade</loader-name>

<loader-name strength="hard">library:engine.j2ee14.facade</loader-name>

<loader-name strength="hard">library:com.sap.base.technology.facade</loader-name>

<!-- Use AF Facades in 7.1, never the single interfaces, libraries or services -->

<loader-name strength="hard">library:com.sap.aii.af.lib.facade</loader-name>

<loader-name strength="hard">interface:com.sap.aii.af.ifc.facade</loader-name>

<loader-name strength="hard">service:com.sap.aii.af.svc.facade</loader-name>

</loader-references>

</connector-j2ee-engine>

log-configuration.xml

Wollen Sie das optionale AS Java Logging-API unterstützen, fügen Sie log-configuration.xml hinzu.

Es macht die Trace-Objekte des Adapters gegenüber dem AS Java bekannt und enthält Vorgabewerte für Logging-Einstellungen.

Weitere Informationen: Tracing, Logging und Monitoring

Der Inhalt sieht wie in folgenden Beispiel aus:

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE log-configuration SYSTEM "log-configuration.dtd">

<log-configuration>

<log-formatters>

<!-- This formatter produces human readable messages. -->

<log-formatter name="trc" pattern="%26d %150l [%t] %10s: %m"

type="TraceFormatter"/>

</log-formatters>

<log-destinations>

<!-- Destination for Trace Information of this ra com.sap.aii.af.sample.adapter.ra -->

<log-destination count="5" effective-severity="DEBUG" limit="2000000" name="sample_ra.trc"   pattern="./log/applications/com.sap.aii.af.sample.adapter.ra/default.trc" type="FileLog">

<formatter-ref name="trc"/>

</log-destination>

</log-destinations>

<log-controllers>

<!-- Trace Location com.sap.aii.af.sample.adapter.ra -->

<log-controller name="com.sap.aii.af.sample.adapter.ra" effective-severity="ERROR">

<associated-destinations>

<destination-ref association-type="LOG" name="sample_ra.trc"/>

</associated-destinations>

</log-controller>

<!-- Logging Category: none, we use the default XILog -->

</log-controllers>

</log-configuration>

Ersetzen Sie im Beispiel oben fett gekennzeichnete Angaben durch die Angaben für Ihren eigenen Adapter.

Der Name des Log-Controller muss mit dem Package-Namen identisch sein.

Manifest.mf

Die Datei Manifest.mf kann leer sein, sie muss aber vorhanden sein. Sie enthält keine notwendigen Informationen für den Deployment-Prozess.

ra.xml

Die Datei RA.XML folgt den Regeln der JCA-Spezifikation. Sie könnte wie folgt aussehen:

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE connector PUBLIC '-//Sun Microsystems, Inc.//DTD Connector 1.0//EN' 'http://java.sun.com/dtd/connector_1_0.dtd'>

<connector>

<display-name>

sample_ra

</display-name>

<vendor-name>

sap.com

</vendor-name>

<spec-version>

1.0

</spec-version>

<eis-type>

XI AF Sample Resource Adapter

</eis-type>

<version>

1.4

</version>

<resourceadapter>

<managedconnectionfactory-class>

com.sap.aii.af.sample.adapter.ra.SPIManagedConnectionFactory

</managedconnectionfactory-class>

<connectionfactory-interface>

javax.resource.cci.ConnectionFactory

</connectionfactory-interface>

<connectionfactory-impl-class>

com.sap.aii.af.sample.adapter.ra.CCIConnectionFactory

</connectionfactory-impl-class>

<connection-interface>

javax.resource.cci.Connection

</connection-interface>

<connection-impl-class>

com.sap.aii.af.sample.adapter.ra.CCIConnection

</connection-impl-class>

<transaction-support>

NoTransaction

</transaction-support>

<config-property>

<config-property-name>

addressMode

</config-property-name>

<config-property-type>

java.lang.String

</config-property-type>

<config-property-value>

CPA

</config-property-value>

</config-property>

<config-property>

<config-property-name>

adapterType

</config-property-name>

<config-property-type>

java.lang.String

</config-property-type>

<config-property-value>

JCA

</config-property-value>

</config-property>

<config-property>

<config-property-name>

adapterNamespace

</config-property-name>

<config-property-type>

java.lang.String

</config-property-type>

<config-property-value>

http://sap.com/xi/XI/sample

</config-property-value>

</config-property>

<authentication-mechanism>

<authentication-mechanism-type>

BasicPassword

</authentication-mechanism-type>

<credential-interface>

javax.resource.spi.security.PasswordCredential

</credential-interface>

</authentication-mechanism>

<reauthentication-support>

false

</reauthentication-support>

</resourceadapter>

</connector>

Der Adapter spezifiziert NoTransaction , da er die Transaktionskontrolle selbst implementiert.

Weitere Informationen: Asynchrone Messages .

Deployen Sie den Resource Adapter in der Stand-Alone-Variante, werden keine eigenen Adapter-Framework-Module deployed, sondern es werden die Standard-Module verwendet. Setzen Sie dann die connectionfactory- und connection-Interfaces auf die CCI-Standard-Interfaces.