Stand-Alone Deployment als RAR (SAP-Bibliothek - SAP NetWeaver Exchange Infrastructure)

Stand-Alone Deployment als RAR

Verwendung

Die Vorgehensweise beim Deployment als Resource Adapter Archive (RAR) muss den Regeln, die in der JCA-Spezifikation beschrieben sind folgen.

Link auf externe Webseite

Die Verweise beziehen sich auf Kapitel zehn, insbesondere Kapitel 10.2 des Dokuments J2EE Connector Architecture Specification, Final Version 1.0.

Das Dokument kann im Internet unter java.sun.com/j2ee/connector bezogen werden.

Funktionsumfang

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

· Der connector-j2ee.engine.xml Deployment Descriptor (DD) wird benötigt, um Referenzen zu anderen J2EE-Einheiten, wie z.B. dem Adapter-Framework Messaging Service oder der Adapter-Framework CCI-Bibliothek herzustellen.

Hinweis

Eine komplette Beschreibung finden Sie im Java Reference Manual unter Deployment Descriptors

Der Inhalt sieht wie in folgendem Beispiel aus:

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

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

<connector-j2ee-engine>

<loader-references>

<loader-name>library:com.sap.aii.af.lib</loader-name>

<loader-name>library:com.sap.aii.messaging.runtime</loader-name>

<loader-name>library:com.sap.guid</loader-name>

<loader-name>library:sapxmltoolkit</loader-name>

<loader-name>library:com.sap.technology.basetech</loader-name>

<loader-name>service:com.com.sap.aii.adapter.xi.svc</loader-name>

<loader-name>service:com.sap.aii.af.cpa.svc</loader-name>

<loader-name>service:com.sap.aii.af.svc</loader-name>

<loader-name>interface:appcontext</loader-name>

</loader-references>

</connector-j2ee-engine>

· Sie müssen das log-configuration.xml hinzugefügen, falls das optionale Adapter-Framework Trace-API unterstützt werden soll. Siehe auch: Tracing, Logging und Monitoring

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

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>

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

type="TraceFormatter"/>

</log-formatters>

<log-destinations>

<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>

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

<associated-destinations>

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

</associated-destinations>

</log-controller>

</log-controllers>

</log-configuration>

Hinweis

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

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

· Die Datei MANIFEST.MF kann leer sein, sie muss aber vorhanden sein. Sie enthält keine notwendigen Informationen für den Deployment-Prozess. 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'>

<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>

<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>

Das Beispiel zeigt eine verkürzte Resource Adapter XML-Datei für den Adapter-Framework Beispiel Resource Adapter.

Hinweis

Sie müssen die im Beispiel oben fett gekennzeichneten Angaben durch die Angaben für Ihren eigenen Adapter ersetzen.

Der Adapter spezifiziert NoTransaction, da der Adapter die Transaktionskontrolle selbst implementiert. Siehe hierzu: Asynchrone Messages.

Wird der Resource Adapter in der Stand-Alone-Variante deployed, dann werden keine eigenen Adapter-Framework-Module deployed, sondern es werden die Standard-Module verwendet. Daher müssen die connectionfactory- und connection-Interfaces auf die CCI-Standard-Interfaces gesetzt werden.