Despliegue de aplicaciones SQLJ
Utilice SQLJ (lenguaje de consulta estructurado para Java™ Enterprise Edition) para desarrollar aplicaciones de acceso a datos que se conecten a bases de datos DB2®. SQLJ es un conjunto de extensiones de programación que permite utilizar el lenguaje de programación Java para incorporar sentencias que proporcionan solicitudes de base de datos SQL (lenguaje de consulta estructurado).
Acerca de esta tarea
El uso de SQLJ en la aplicación ofrece las siguientes ventajas en comparación con la alternativa de JDBC:
- Puede mejorar el rendimiento si se utilizan los pasos de personalización y enlace de DB2.
- Permite a las aplicaciones ejecutar SQL estático para poder utilizar políticas de mayor seguridad de granularidad fina, como por ejemplo permisos de nivel PACKAGE, en lugar del SQL dinámico que ofrece JDBC.
Procedimiento
- Cree un archivo .sqlj para realizar las operaciones de base de datos para la aplicación.
import java.sql.*; import javax.sql.*; import java.util.*; import javax.naming.; import sqlj.runtime.*; #sql context MyCtx; #sql iterator MyIter(String name); public class MyDB2SQLJProcedure { public static void myProcedure() throws Exception { DataSource ds = (DataSource) new InitialContext().lookup("java:comp/env/jdbc/myDS"); Connection con = ds.getConnection(); con.setAutoCommit(false); MyCtx ctx = new MyCtx(con); try { // Insertar algunos datos en la tabla 'mytable' en este punto. // Tenga en cuenta que las variables java 'key' y 'val' se sustituyen. int key = 1; String val = "one"; #sql [ctx] { INSERT into mytable VALUES (:key, :val) }; #sql [ctx] { COMMIT }; MyIter iter; #sql [ctx] iter = { SELECT name FROM mytable WHERE id=1 }; iter.next(); System.out.println("Found value: " + iter.name()); iter.close(); #sql [ctx] { COMMIT }; } finally { con.setAutoCommit(true); // Cuando SQLJ realiza operaciones transaccionales durante el cierre del contexto, presupone que autocommit es true ctx.close(); } } } - Adquiera las controladores necesarios para transformar los archivos SQLJ y transformar los archivos .sqlj
en archivos .java. Puede especificar un parámetro adicional, -db2optimize, para realizar transformaciones específicas
DB2, que podrían aumentar el rendimiento.
java -cp .:/sqlj/sqlj4.zip:/sqlj/db2jcc4.jar sqlj.tools.Sqlj -C-classpath=/sqlj/sqlj4.zip:/sqlj/db2jcc4.jar -db2optimize MyDB2SQLJProcedure.sqljAl ejecutar este mandato, recibirá los siguientes archivos de salida:- MyDB2SQLJProcedure.class
- MyDB2SQLJProcedure.java
- MyDB2SQLJProcedure_SJProfile0.ser
- MyDB2SQLJProcedure_SJProfileKeys.class
- MyCtx.class
- MyIter.class
- Opcional: Ejecute la herramienta de personalización de SQLJ de DB2 para personalizar y enlazar los archivos
.ser generados anteriormente y crear SQL estático en la base de datos que DB2 utiliza en
tiempo de ejecución. La fase de personalización crea cuatro paquetes de base de datos que contienen SQL-- estático, uno para cada nivel
de aislamiento.
java com.ibm.db2.jcc.sqlj.Customizer -url URL_JDBC -user NOMBRE_USUARIO -password CONTRASEÑA [-rootpkgname NOMBRE_PAQUETE] PERFIL_SERIALIZADO1 PERFIL_SERIALIZADO2...Donde:Ejemplo de uso:- URL_JDBC es el URL de JDBC que se utiliza para acceder al sistema DB2 en el que residen las tablas, con la sintaxis siguiente: jdbc:db2://nombre-host:puerto/nombre-base-datos
- NOMBRE_USUARIO es un nombre de usuario válido para el sistema DB2 en el que residen las tablas.
- CONTRASEÑA es la contraseña del NOMBRE_USUARIO especificado.
- NOMBRE_PAQUETE es un nombre de miembro PDS (conjunto de datos particionado) con una longitud máxima de siete caracteres. Cada uno de los cuatros paquetes creados por el personalizador de perfiles comienza por este nombre al que se añade al final un número del 1 al 4. Si sólo personaliza un perfil serializado, este valor toma de forma predeterminada un nombre de perfil serializado abreviado y el parámetro -rootpkgname no es necesario. Si personaliza más de un perfil serializado con el mismo mandato, no hay ningún valor por omisión y es necesario el parámetro -rootpkgname.
- PERFIL_SERIALIZADO# es el nombre del perfil serializado que está personalizando.
- Para personalizar más de un perfil serializado con el mismo mandato, liste los diversos archivos separados por espacios.
- Como alternativa, puede especificar el parámetro -rootpkgname para personalizar más de un perfil serializado con el mismo mandato.
java -cp .:/sqlj/sqlj4.zip:/sqlj/db2jcc4.jar com.ibm.db2.jcc.sqlj.Customizer -url jdbc:db2://localhost:50000/mydb -user dbuser1 -passworddbpass1 MyDB2SQLJProcedure_SJProfile0.serEjemplo de salida:[jcc][sqlj] Iniciar personalización [jcc][sqlj] Cargando perfil: MyDB2SQLJProcedure_SJProfile0 [jcc][sqlj] Personalización completada para el perfil MyDB2SQLJProcedure_SJProfile0.ser [jcc][sqlj] Iniciar enlace [jcc][sqlj] cargando perfil: MyDB2SQLJProcedure_SJProfile0 [jcc][sqlj] Valores predeterminados de controlador (el usuario puede alterarlos temporalmente): BLOCKING ALL VALIDATE BIND STATICREADONLY YES [jcc][sqlj] Opciones de controlador fijas: DATETIME ISO DYNAMICRULES BIND [jcc][sqlj] Enlazando paquete DB2SQL01 en el nivel de aislamiento UR [jcc][sqlj] Enlazando paquete DB2SQL02 en el nivel de aislamiento CS [jcc][sqlj] Enlazando paquete DB2SQL03 en el nivel de aislamiento RS [jcc][sqlj] Enlazando paquete DB2SQL04 en el nivel de aislamiento RR [jcc][sqlj] Enlace completado para MyDB2SQLJProcedure_SJProfile0 - Actualice el archivador de la aplicación para que incluya todos los archivos generados en el paso 2. Asegúrese de mantener la estructura de
directorios en la que se encuentran los perfiles. Por ejemplo, si la clase MyDB2SQLJProcedure tiene el nombre completo com.company.MyDB2SQLJProcedure, los
archivos generados deben colocarse en una carpeta com/company/ del módulo de aplicación adecuado.
Nota: Los archivos personalizados deben colocarse en una ubicación que forme parte de la variable classpath de la aplicación, y deben existir antes que los perfiles serializados del archivo JAR. Si decide sustituir los perfiles serializados del archivo JAR, mantenga la estructura de directorios en la que existen los perfiles.
- Para aplicaciones Java EE, habilite las características necesarias, defina una configuración de origen de datos
y aplique la biblioteca compartida necesaria al cargador de clases de la aplicación. Debe habilitarse la característica jdbc-4.1 en el
archivo server.xml para utilizar SQLJ. Si se encuentra un origen de datos utilizando JNDI, la característica jndi-1.0
también debe estar habilitada. Consulte el ejemplo siguiente:
<server> <featureManager> <feature>jdbc-4.1</feature> <feature>jndi-1.0</feature> </featureManager> <application location="myapp.war"> <classloader commonLibraryRef="DB2Lib"/> </application> <library id="DB2Lib"> <fileset dir="C:/DB2/java" includes="db2jcc4.jar db2jcc_license_cisuz.jar"/> </library> <dataSource id="myDS" jndiName="jdbc/myDS"> <jdbcDriver libraryRef="DB2Lib"/> <properties.db2.jcc databaseName="mydb" serverName="localhost" portNumber="50000" user="dbuser1" password="dbpass1"/> </dataSource> </server> - Para aplicaciones OSGi, habilite las características jdbc-4.1 y wab-1.0
para utilizar la aplicación OSGi. Si la aplicación utiliza JNDI, habilite también la característica jndi-1.0. Cree una
<osgiLibrary> que haga referencia a la biblioteca SQLJ. A continuación, configure la aplicación de modo que haga referencia a la
biblioteca OSGi que contiene los paquetes SQLJ necesarios. Vea el ejemplo siguiente del archivo server.xml:
<server> <featureManager> <feature>jdbc-4.1</feature> <feature>jndi-1.0</feature> <feature>wab-1.0</feature> </featureManager> <osgiApplication name="myapp" location="myapp.eba"/> <osgiLibrary libraryRef="DB2Lib"/> <library id="DB2Lib"> <fileset dir="C:/DB2/java" includes="db2jcc4.jar db2jcc_license_cisuz.jar"/> </library> <dataSource id="myDS" jndiName="jdbc/myDS"> <jdbcDriver libraryRef="DB2Lib"/> <properties.db2.jcc databaseName="mydb" serverName="localhost" portNumber="50000" user="dbuser1" password="dbpass1"/> </dataSource> </server>En el archivo MANIFEST.MF del módulo de aplicación para 'myapp', importe los paquetes SQLJ necesarios, que se suministran en el elemento <osgiLibrary>:Import-Package: javax.annotation, javax.sql, javax.naming, com.ibm.db2.jcc, com.ibm.db2.jcc.sqlj, sqlj.runtime, sqlj.runtime.error, sqlj.runtime.profile, sqlj.runtime.profile.ref, sqlj.runtime.profile.util, sqlj.runtime.ref, sqlj.runtime.util - Para el almacenamiento en caché de contexto SQLJ, es posible conseguir que WebSphere Application Server tradicional almacene
en caché un contexto SQLJ de DB2 con cada conexión agrupada. El almacenamiento
en caché de contexto SQLJ de DB2 puede generar un comportamiento más coherente con el producto, como por ejemplo la
limpieza de recursos que la aplicación o ha cerrado. También puede generar mejoras de rendimiento en las vías de acceso SQLJ. Para habilitar el
almacenamiento en caché de contexto SQLJ de DB2, debe configurar la propiedad de origen de datos
enableConnectionCasting con el valor true. Consulte el ejemplo siguiente:
<dataSource id="myDS" jndiName="jdbc/myDS" enableConnectionCasting="true">
Tema principal: Despliegue de aplicaciones de acceso a datos en Liberty
Tema de tarea
Última actualización: Friday, 16 September 2016http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_deploy_sqlj
Nombre de archivo:twlp_deploy_sqlj.html