Enterprise Java Beans für OSI TP / LU6.2 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) oder Java Annotations

• Application Server spezifischer Deployment Descriptor der EJB (bei Oracle WebLogic Server: weblogic-ejb-jar.xml)

• Application Server spezifischer Deployment Descriptor für den Resource Adapter (bei Oracle WebLogic Server: weblogic-ra.xml)

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 OSI TP / LU6.2-Kommunikation über das BeanConnect-Interface:
  net.fsc.jca.communication.EISOltpConnectionFactory

• Bei OSI TP / LU6.2-Kommunikation über das CCI-Interface:
  net.fsc.jca.communication.cci.BCOltpConnectionFactory

Der Ressourcentyp muss in folgenden Dateien angegeben werden:

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

• weblogic-ra.xml mit dem Tag <connection-factory-interface>

Die Abschnitte der Code-Datei der EJB sowie die der Dateien ejb-jar.xml, weblogic-ejb-jar.xml und weblogic-ra.xml, die für das Deployment der EJB relevant sind, werden nachfolgend ausführlich beschrieben. Die fettgedruckten (Teil-)Pfadnamen geben die Beziehungen zwischen den einzelnen Dateien an.

• 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.EISOltpConnectionFactory verwendet.

  
  

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

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

  
  

  Application Server spezifischer Deployment Descriptor der EJB (bei Oracle WebLogic Server weblogic-ejb-jar.xml):

  Hier werden dem EJB-Namen und den Ressource-Referenzen, die in der Datei ejb-jar.xml definiert sind, JNDI-Namen des Application Servers zugeordnet.

  
  

  <weblogic-enterprise-bean>
        <ejb-name>SimpleBeanConnect</ejb-name>
        <jndi-name>ejb/SimpleBeanConnect</jndi-name>
      <resource-description>
         <res-ref-name>comp/env/eis/Part1Dial</res-ref-name>
         <jndi-name>java:comp/env/eis/Part1Dial</jndi-name>
      </resource-description>
  </weblogic-enterprise-bean> 
  

• Deployment Descriptor für den Resource Adapter (bei Oracle WebLogic Server weblogic-ra.xml)

  Hier wird die Connection Factory für das Deployment in der Application Server Instanz konfiguriert und über den JNDI-Namen (hier: partner1Dial) mit der Ressourcenreferenz verknüpft. Über die Konfiguration der Connection Factory in der Application Server Instanz erhält der Resource Adapter die URL des Services (im folgenden CodeFragment: utm://echo und des EIS Partners.

  
  

  <outbound-resource-adapter>
     <connection-definition-group>
      <connection-factory-interface>
         net.fsc.jca.communication.EISOltpConnectionFactory
      </connection-factory-interface>
      <connection-instance>
        <jndi-name>eis/partner1Dial</jndi-name>
        <connection-properties>
        <properties>
         <property>
           <name>ConnectionURL</name>
           <value>utm://echo</value> (1)
         </property>
         ...
        </connection-properties>
      </connection-factory-interface>
      </connection-definition-group>
  </outbound-resource-adapter>
  

  
  

  ⁽¹⁾ Für CICS-Partner: <value>cics://echo</value>

  Der für <connection-factory-interface> angegebene Wert muss mit dem Wert übereinstimmen, der in der Datei ejb-jar.xml mit dem Tag <res-type> angegeben wurde.

  Auf dem Proxy ist ein zusätzlicher Konfigurationsschritt erforderlich. Für jeden Namen eines Outbound Communication Endpoints, der über die Konfigurations-Property connectionURL in der Datei weblogic-ra.xml angegeben ist, müssen Sie im Proxy einen entsprechenden Outbound Communication Endpoint mit demselben Namen konfigurieren. In der Definition des Outbound Communication Endpoints wird der symbolische Service-Name auf einen realen Service-Namen in der EIS Partneranwendung abgebildet. Die Konfiguration eines Outbound Communication Endpoints können Sie mit Hilfe der Management Console durchführen (siehe Outbound Communication Endpoints konfigurieren ).