Deployment Descriptor Example

The name for the connector deployment descriptor file is ra.xml. The ra.xml file contains the implementation information and the connector metadata.

External libraries, that contain methods the connector references, must be placed in the classpath of the application server. The SAP backend system connector, for example, needs the JCo libraries.

ra.xml file example:

Syntax Syntax

<?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>
  <!--Basic metadata of the connector-->
      <display-name>SAP Connector</display-name>
       <vendor-name>SAP</vendor-name>
       <spec-version>1.0</spec-version>
        <eis-type>SAP</eis-type>
         <version>1.0</version>
          <resourceadapter>
  <!--Implementation of the managed connection factory interface-->
               <managedconnectionfactoryclass>
                com.sap.SAPConnector.connection.SAPConnectionFactory
               </managedconnectionfactory-class>
  <!--Interface of the connector connection factory   -->
               <connectionfactoryinterface>
               javax.resource.cci.ConnectionFactory
               </connectionfactoryinterface>
  <!--Implementation of the connector connection factory interface-->
               <connectionfactory-impl-class>
               com.sap.SAPConnector.connection.CCIConnectionFactory
               </connectionfactory-impl-class>
  <!--Interface of the connector connection -->
               <connection-interface>javax.resource.cci.Connection</connection-interface>
  <!--Implementation of the connector connection interface-->
               <connection-impl-class>
               com.sap.SAPConnector.connection.CCIConnection
               </connection-impl-class>
  <!--Connection support offered by the connector-->
               <transaction-support>NoTransaction</transaction-support>
               <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>

End of the code.