ra.xml
デプロイメント・ディスクリプタ・ファイルの要素階層は次のとおりです。許容される出現回数は要素名に続く中カッコ内に示されます。
<connector> {1} <display-name> {0 or 1} <vendor-name {0 or 1} <eis-type> {1} <resourceadapter-version> {1} <resourceadapter> {1} <resourceadapter-class> {1} <config-property> {0 or more} <config-property-name> {1} <config-property-type> {1} <config-property-value {0 or 1} <outbound-resourceadapter> {1} <connection-definition> {1 or more} <managedconnectionfactory-class{1} <config-property> {0 or more} <config-property-name> {1} <config-property-type> {1} <config-property-value {0 or 1} <connectionfactory-interface> {1} <connectionfactory-impl-class> {1} <connection-interface> {1} <connection-impl-class> {1} <transaction-support> {1} <authentication-mechanism> {1} <authentication-mechanism-type> {1} <credential-interface> {1} <reauthentication-support> {1} <inbound-resourceadapter> {1} <messageadapter> {1} <messagelistener> {1} <messagelistener-type> {1} <activationspec> {1} <activationspec-class> {1} <required-config-property> {0 or more} <config-property-name> {1} <adminobject> {1 or more} <adminobject-interface> {1} <adminobject-class> {1} <config-property> {0 or more} <config-property-name> {1} <config-property-type> {1} <config-property-value {0 or 1}
<messagelistener>
要素の<activationspec>
子要素は、アクティブ化仕様を指定するために使用します。情報には、アクティブ化仕様の完全修飾Javaクラス名と必要な一連の構成プロパティ名が含まれます。
<activationspec>
要素の<activationspec-class>
子要素は、アクティブ化仕様クラスの完全修飾Javaクラス名を指定するために使用します。このクラスは、javax.resource.spi.ActivationSpec
インタフェースを実装する必要があります。JavaBeanとなるには、このクラスの実装が必要です。
<resourceadapter>
要素の<adminobject>
子要素は、管理対象オブジェクトに関する情報を指定するために使用します。管理対象オブジェクトは、メッセージ・スタイルまたはメッセージ・プロバイダに固有です。これには、管理対象オブジェクトによって実装されるJavaタイプのインタフェース、そのJavaクラス名およびその構成プロパティに関する情報が含まれます。
<adminobject>
要素の<adminobject-class>
子要素は、管理対象オブジェクトによって実装されるJavaタイプのインタフェースの完全修飾名を指定するために使用します。
<adminobject>
要素の<adminobject-interface>
子要素は、管理対象オブジェクトによって実装されるJavaタイプのインタフェースの完全修飾名を指定するために使用します。
<outbound-resourceadapter>
要素の<authentication-mechanism>
子要素は、リソース・アダプタでサポートされている認証メカニズムを指定します。
BasicPassword
メカニズム・タイプでは、javax.resource.spi.security.PasswordCredential
インタフェースをサポートする必要があります。Kerbv5
メカニズム・タイプでは、org.ietf.jgss.GSSCredential
インタフェースまたは非推奨のjavax.resource.spi.security.GenericCredential
インタフェースをサポートする必要があります。
<authentication-mechanism>
要素の<authentication-mechanism-type>
子要素は、認証メカニズムを指定します。値は次のとおりです。
BasicPassword
Kerbv5
<config-property>
または<required-config-property>
要素の<config-property-name>
子要素は、構成プロパティの名前を定義し、文字列として入力されます。有効な名前は、リソース・アダプタまたは管理対象オブジェクトに固有です。
<config-property>
要素の<config-property-type>
子要素は、構成プロパティ値のデータ型を定義し、java.lang.String
として入力されます。
<outbound-resourceadapter>
要素の<connection-definition>
子要素は、接続ファクトリを定義するために、Java Connector Architecture仕様によって要求されるクラスおよびインタフェースを定義します。
<connection-definition>
要素の<connectionfactory-imlp-class>
子要素は、リソース・アダプタに固有のConnectionFactoryインタフェースを実装するConnectionFactoryクラスの完全修飾名を定義します。詳細は、http://java.sun.com/xml/ns/javaee/connector_1_6.xsd
を参照してください。
<resourceadapter>
要素、<adminobject>要素および<connection-definition>
要素の<config-property>
子要素は、リソース・アダプタの管理対象オブジェクトの構成プロパテを定義します。構成プロパティは、標準コネクタのデプロイメント・ディスクリプタに定義されているのと同じ方法で定義されます。
<connection-definition>
要素の<connectionfactory-interface>
子要素は、リソース・アダプタでサポートされているConnectionFactory
インタフェースの完全修飾名を指定します。詳細は、http://java.sun.com/xml/ns/javaee/connector_1_6.xsd
を参照してください。
<connection-definition>
要素の<connection-imlp-class>
子要素は、リソース・アダプタに固有の接続インタフェースを実装する接続クラスの完全修飾名を指定します。詳細は、http://java.sun.com/xml/ns/javaee/connector_1_6.xsd
を参照してください。
<connection-definition>
要素の<connection-interface>
子要素は、リソース・アダプタでサポートされている接続インタフェースの完全修飾名を指定します。
<outbound-resourceadapter>
要素の<authentication-mechanism>
子要素は、資格証明を表現するためにリソース・アダプタの実装がサポートするインタフェースを指定します。値は次のとおりです。
javax.resource.spi.security.PasswordCredential
org.ietf.jgss.GSSCredential
javax.resource.spi.security.GenericCredential
<resourceadapter>
要素の<inbound-resourceadapter>
子要素は、インバウンドのリソース・アダプタに関する情報を指定するために使用します。これには、<messageadapter>
要素を介して指定されたリソース・アダプタのライブラリの実装に固有の情報が含まれます。
<connection-definition>
要素の<managedconnectionfactory-class>
子要素は、javax.resource.spi.ManagedConnectionFactory
インタフェースを実装するJavaクラスの完全修飾名を指定します。このJavaクラスは、コネクタ・アーキテクチャ指定の規約の、リソース・アダプタの実装の一部として指定されます。JavaBeanとなるには、このクラスの実装が必要です。詳細は、http://java.sun.com/xml/ns/javaee/connector_1_6.xsd
を参照してください。
<inbound-resourceadapter>
要素の<messageadapter>
子要素は、リソース・アダプタのメッセージング機能を指定するために使用します。これには、<messagelistener>
要素を介して指定されたリソース・アダプタのライブラリの実装に固有の情報が含まれます。
<messageadapter>
要素の<messagelistener>
子要素は、<messagelistener-type>
要素を介して指定されたメッセージ・リスナーの実装を指定するために使用します。
<messageadapter>
要素の<messagelistener-type>
子要素は、メッセージング・リソース・アダプタでサポートされている特定のメッセージ・リスナーを指定するために使用します。これには、Javaタイプのメッセージ・リスナー・インタフェースおよびアクティブ化仕様に関する情報が含まれます。
<outbound-resourceadapter>
要素の<reauthentication-support>
子要素は、リソース・アダプタの実装で既存の管理対象接続のインスタンスの再認証をサポートするかどうかを指定します。値はtrue
またはfalse
のいずれかです。
<resourceadapter>
要素の<outbound-resourceadapter>
子要素は、外部アプリケーション・サーバーからEnterprise Information System (EIS)に接続するために使用する構成を定義します。構成では、リソース・アダプタの接続ファクトリを定義します。
<outbound-resourceadapter>
要素の<transaction-support>
子要素は、リソース・アダプタによって提供されるトランザクション・サポートのレベルを指定します。値は次のいずれかになります。
NoTransaction
LocalTransaction
XATransaction