Utilisation des adaptateurs locaux optimisés pour la connexion à une application dans un espace adresse externe depuis une application Liberty

Utilisez les API WebSphere Optimized Local Adapters pour vous connecter à une application dans un espace adresse externe depuis une application déployée sur le serveur Liberty.

Avant de commencer

Enregistrez l'espace adresse externe avec le groupe WOLA. Pour plus d'informations, voir Enregistrement d'un espace adresse externe sur un serveur Liberty local à l'aide d'adaptateurs locaux optimisés.

Configurez l'application dans l'espace adresse externe en tant que tâche de serveur des adaptateurs locaux optimisés en appelant l'API Receive Request Any, Receive Request Specific ou Host Service. Pour plus d'informations, voir API d'adaptateurs locaux optimisés sur Liberty pour z/OS.

Procédure

  1. Autorisez l'application Liberty à accéder à la fabrique de connexions en utilisant l'injection de ressources ou une recherche JNDI.

    L'exemple suivant utilise une applications Enterprise JavaBeans (EJB). Vous pouvez utiliser le même code dans une application Web ou un servlet.

    • Pour l'injection de ressources, utilisez l'annotation @Resource afin de référencer la fabrique de connexions que vous avez définie dans le fichier server.xml. L'exemple suivant référence la fabrique de connexions eis/ola :
      @Resource(lookup = "eis/ola",
                          authenticationType = Resource.AuthenticationType.APPLICATION,
                          shareable = false)
          private ConnectionFactory cf;
    • Pour la recherche JNDI, créez une référence de ressource dans votre application que vous recherchez ensuite dans le bean enterprise.
      1. Créez une référence de ressource dans le fichier META-INF/ibm-ejb-jar-bnd.xml pour l'application, où l'élément binding-name correspond au nom JNDI de la fabrique de connexions dans le fichier server.xml.
        <session name="HSCBC016Bean">
            <resource-ref name="eis/ola" binding-name="eis/ola"/>
        </session>
      2. Dans l'implémentation d'EJB, créez un objet de fabrique de connexions qui recherche la référence de ressource que vous avez définie. Préfixez le nom de la référence de ressource par java:comp/env/ conformément à l'exemple suivant :
        Context ctx = new InitialContext();
        ConnectionFactory cf = ctx.lookup("java:comp/env/eis/ola");
  2. Créez une spécification de connexion en créant un objet ConnectionSpecImpl. Indiquez le nom d'enregistrement de l'espace adresse externe auquel établir la connexion de l'une des façons suivantes :
    • Ajoutez le nom d'enregistrement sous forme d'attribut dans la fabrique de connexions
    • Appelez la méthode ConnectionSpecImpl, setRegisterName, avec le nom d'enregistrement
    L'exemple suivant crée l'objet ConnectionSpecImpl et fournit le nom d'enregistrement MyRES1 :
    ConnectionSpecImpl csi = new ConnectionSpecImpl();
    csi.setRegisterName ("MyRES1");
  3. Créez une connexion avec la fabrique de connexions, comme dans l'exemple suivant :
    Connection con = cf.getConnection(csi);

Résultats

The Liberty application is connected to an external address space and can call services that are hosted on the external address space. For more information, see Utilisation des API des adaptateurs locaux optimisés Liberty pour l'appel des services dans un espace adresse externe.

Icône indiquant le type de rubrique Rubrique Tâche

Nom du fichier : twlp_dat_connect2wlpapp.html