Despliegue de aplicaciones que utilizan persistencia gestionada por contenedor (CMP) con la herramienta ejbdeploy

Incorpore sentencias SQLJ (Structured Query Language in Java™) en las aplicaciones para maximizar la eficacia de las transacciones con las bases de datos. Para que las aplicaciones puedan sacar partido de SQLJ, debe desplegar la aplicación y personalizar los perfiles SQLJ que se creen. El servidor de aplicaciones proporciona funciones para utilizar SQLJ como mecanismo de persistencia para enterprise beans que utilizan la persistencia gestionada por contenedor. Utilice la herramienta ejbdeploy para desplegar la aplicación.

Acerca de esta tarea

Puede desplegar aplicaciones SQLJ con la herramienta ejbdeploy para desplegar la aplicación de empresa en un entorno autónomo.
Como alternativa, el servidor de aplicaciones incluye soporte ampliado de SQLJ para aplicaciones que utilizan persistencia gestionada por contenedor (CMP). Las nuevas características son:
  • Despliegue de beans CMP durante la instalación de la aplicación en el servidor de aplicaciones.
  • Personalización y vínculo de perfiles SQLJ con la consola administrativa o con scripts.
  • Personalización y vínculo de aplicaciones SQLJ de nuevo sin tener que volver a instalar la aplicación.
Estas mejoras reducen la complejidad de la instalación, el despliegue y la personalización de las aplicaciones SQLJ tanto para persistencia gestionada por contenedor como para persistencia gestionada por bean. Consulte el tema sobre el despliegue de aplicaciones SQLJ que utilizan persistencia gestionada por contenedor (CMP) para obtener más información.

Procedimiento

  1. Cree una correlación descendente con una base de datos DB2.
  2. Desde el directorio de instalación de DB2, copie el archivo sqlj.zip a un directorio de la estación de trabajo.
  3. Modifique la vía de acceso de creación de Java del proyecto JAR del Enterprise Bean para que incluya el archivo sqlj.zip.
  4. Utilice Rational Application Developer o el conversor SQLJ de DB2 para convertir de forma automática SQLJ.
    • Utilice Rational Application Developer:
      1. Desde el navegador de proyecto, pulse EJB_JAR_PROJECT_NAME > SOURCE_FOLDER > META-INF > backends > versión_base_datos.
      2. Abra Map.mapxmi en el editor de correlaciones.
      3. En el panel Visión general, resalte el nombre del proyecto JAR en la columna Enterprise beans. Debe resaltar el nombre del proyecto JAR, no el nombre de uno de los beans de empresa que aparecen en la lista.
      4. En el panel Propiedades, expanda SQLJ.
      5. Establezca ¿Utiliza SQLJ? en True.
      6. Establezca Módulo del traductor en la vía de acceso plenamente cualificada del archivo sqlj.zip de la estación de trabajo.
      7. Guarde el archivo Map.mapxmi.
      8. Exporte el archivo EAR (Enterprise Archive).
    • Utilice el conversor SQLJ de DB2. Esta herramienta crea una versión .java del archivo .sqlj y un perfil serializado, con una extensión .ser, que se utiliza, más tarde, en el proceso. Consulte la documentación de DB2 para obtener más información en la herramienta de conversor SQLJ.
  5. Despliegue el archivo EAR con la herramienta ejbdeploy.
    1. Verifique que el directorio raíz_servidor_aplicaciones/bin esté en la variable classpath.
    2. Ejecute el programa de utilidad del mandato ejbdeploy con la opción -sqlj. El mandato ejbdeploy generará un archivo EAR con el nombre que especifique y un script Ant con el nombre nombre_aplicación.ear.xml.
      Por ejemplo:
      ejbdeploy d:\nombre_aplicación.ear           
                working d:\deployed_nombre_aplicación.ear 
                -sqlj           
                -dbvendor DB2UDB_V81           
                -cp "C:\PROGRA~1\IBM\SQLLIB\java\sqlj.zip"
      Avoid trouble Avoid trouble: Proporcione la ubicación del archivo sqlj.zip del conversor SQLJ con -cp, que es la opción de variable classpath. El mandato ejbdeploy no accede a sqlj.zip desde la variable classpath del sistema.gotcha
  6. Elija la opción de personalización.
    • Utilice el soporte SQLJ del servidor de aplicaciones. Instale la aplicación desplegada para personalizar los perfiles SQLJ con el servidor de aplicaciones o scripts.
      1. Instale la aplicación de empresa en el servidor de aplicaciones.
        Avoid trouble Avoid trouble: No seleccione Desplegar enterprise beans durante el proceso de instalación de aplicaciones en la consola administrativa. Si vuelve a desplegar los beans de empresa desde la consola administrativa, perderá los cambios de personalización que haya efectuado.gotcha
      2. Personalice los perfiles SQLJ.
        • Para obtener soporte sobre la consola administrativa, consulte el tema sobre personalización y enlace de perfiles para aplicaciones SQLJ (Structured Query Language in Java).
        • Para obtener soporte de scripts, lea el tema sobre el grupo de mandatos de gestión de aplicaciones para el objeto AdminTask.
    • Personalice y enlace los perfiles SQLJ con la herramienta db2sqljcustomize. Lea el tema sobre personalización y enlace de perfiles SQLJ con la herramienta db2sqljcustomize.

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_sqljdeploycmptool
File name: tdat_sqljdeploycmptool.html