Enterprise Java Beans für UPIC deployen

Beim Deployment einer EJB, die BeanConnect für Outbound-Kommunikation nutzen soll, müssen Sie die EJB mit dem BeanConnect Deployment verknüpfen. Die folgenden Dateien sind für das Deployment einer EJB relevant:

• Code-Datei der EJB (.java- oder .class-Datei)

• Standardisierter Deployment Descriptor der EJB (ejb-jar.xml)

• Application Server spezifischer Deployment Descriptor der EJB falls notwendig

• Application Server spezifischer Konfigurationsdatei oder Deployment Descriptor für den Resource Adapter falls notwendig

Beim Deployment einer EJB wird die vom Bean-Entwickler benutzte Ressourcenreferenz dem Application Server über den Deployment Descriptor der EJB bekannt gemacht. Zusätzlich wird der Ressourcenreferenz ein Ressourcentyp zugewiesen.

BeanConnect unterstützt die folgenden Ressourcentypen, welche die unterschiedlichen Verbindungsarten repräsentieren, die verwendet werden können:

• Bei UPIC-Kommunikation über das BeanConnect-Interface:
  net.fsc.jca.communication.EISUpicConnectionFactory

• Bei UPIC-Kommunikation über das CCI-Interface:
  net.fsc.jca.communication.cci.BCUpicConnectionFactory

Der Ressourcentyp muss in folgenden Dateien angegeben werden:

• ejb-jar.xml mit dem Tag <res-type>

Die Abschnitte der Code-Datei der EJB sowie die der Datei ejb-jar.xml, die für das Deployment der EJB relevant sind, werden nachfolgend ausführlich beschrieben.

• Code-Datei der EJB (.java- oder .class-Datei)

  Hier findet der JNDI-Lookup für das ConnectionFactory-Objekt über eine Ressourcenreferenz (kodierter Name) statt. Im folgenden Beispiel wird die Ressourcenreferenz eis/Part1Dial verwendet.

  ...
  cf=(EISConnectionFactory)
           ic.lookup("java:comp/env/eis/Part1Dial")
  ...

• Deployment Descriptor der EJB (ejb-jar.xml)

  Hier wird die Ressourcenreferenz (ConnectionFactory-Objekt) angegeben, auf die die EJB zugreift. Zusätzlich wird der Ressourcenreferenz ein Ressourcentyp zugewiesen. Im folgenden Beispiel wird als Ressourcentyp
net.fsc.jca.communication.EISUpicConnectionFactory verwendet.

  
  

  <session>
    <ejb-name>SimpleBeanConnect</ejb-name>
    ...
    <resource-ref>
      <res-ref-name>eis/Part1Dial</res-ref-name>
      <res-type>
        net.fsc.jca.communication.EISUpicConnectionFactory
      </res-type>
      <res-sharing-scope>Unshareable</res-sharing-scope>
     ...
    </resource-ref>
  </session>

  Beachten Sie, dass für <res-sharing-scope> immer Unshareable angegeben werden muss.

• Application Server spezifischer Deployment Descriptor der EJB falls notwendig:
  Hier werden den in der Datei ejb-jar.xml definierten EJB-Namen und RessourceReferenzen JNDI-Namen des Application Servers zugeordnet.

• Application Server spezifische Konfigurations-Datei oder Deployment Descriptor für den Resource Adapter, in der die Connection Factory definiert ist, falls notwendig