For z/OS platforms

Utilización de adaptadores locales optimizados para conectarse a una aplicación en un espacio de direcciones externo desde una aplicación Liberty

Utilice las API de adaptadores locales optimizados de WebSphere (WOLA) para conectarse a una aplicación en un espacio de direcciones externo desde una aplicación desplegada en el servidor Liberty.

Antes de empezar

Registre el espacio de direcciones externo con el grupo de WOLA. Para obtener más información, consulte Registro de un espacio de direcciones externo con un servidor Liberty local utilizando adaptadores locales optimizados.

Configure la aplicación en el espacio de direcciones externo como una tarea de servidor de los adaptadores locales optimizados llamando a las API Receive Request Any, Receive Request Specific o Host Service. Para obtener más información, consulte Las API de los adaptadores locales optimizados en Liberty for z/OS.

Procedimiento

  1. Habilite la aplicación Liberty para acceder a la fábrica de conexiones utilizando la inyección de recursos o una búsqueda JNDI.

    El ejemplo siguiente utiliza una aplicación Enterprise JavaBeans (EJB). Puede utilizar el mismo código en una aplicación web o servlet.

    • Para la inyección de recursos, utilice la anotación @Resource para hacer referencia a la fábrica de conexiones que ha definido en el archivo server.xml. El ejemplo siguiente hace referencia a la fábrica de conexiones eis/ola:
      @Resource(lookup = "eis/ola",
                          authenticationType = Resource.AuthenticationType.APPLICATION,
                          shareable = false)
          private ConnectionFactory cf;
    • Para la búsqueda de JNDI, cree una referencia de recursos en su aplicación que luego buscará en el enterprise bean.
      1. Cree una referencia de recursos en el archivo META-INF/ibm-ejb-jar-bnd.xml para la aplicación, en que binding-name coincida con el nombre JNDI de la fábrica de conexiones en el archivo server.xml.
        <session name="HSCBC016Bean">
            <resource-ref name="eis/ola" binding-name="eis/ola"/>
        </session>
      2. En la implementación de EJB, cree un objeto de fábrica de conexiones que busque la referencia de recursos que ha definido. Escriba un prefijo para el nombre de la referencia de recurso con java:comp/env/, tal como se muestra en el ejemplo siguiente:
        Context ctx = new InitialContext();
        ConnectionFactory cf = ctx.lookup("java:comp/env/eis/ola");
  2. Cree una especificación de conexiones creando un objeto ConnectionSpecImpl. Proporciona el nombre de registro del espacio de direcciones externo al que desea conectarse de una de estas formas:
    • Añada el nombre de registro como atributo en la fábrica de conexiones
    • Invoque al método ConnectionSpecImpl, setRegisterName, con el nombre de registro
    En el ejemplo siguiente se crea el objeto ConnectionSpecImpl y se proporciona el nombre de registro MyRES1:
    ConnectionSpecImpl csi = new ConnectionSpecImpl();
    csi.setRegisterName ("MyRES1");
  3. Cree una conexión con la fábrica de conexiones, tal como se muestra en el ejemplo siguiente:
    Connection con = cf.getConnection(csi);

Resultados

La aplicación Liberty está conectada a un espacio de direcciones externo y puede llamar a servicios que están alojados en el espacio de direcciones externo. Para obtener más información, consulte Utilización de las API de adaptadores locales optimizados de Liberty para invocar servicios en un espacio de direcciones externo.

Icono que indica el tipo de tema Tema de tarea

Nombre de archivo: twlp_dat_connect2wlpapp.html