Mandato wsdbgen
El mandato da soporte a la utilización de la característica pureQuery en aplicaciones JPA (Java™ Persistence API).
El nombre de este mandato se ha cambiado por wsdbgen para las aplicaciones de Feature Pack for OSGi y JPA 2.0 y releases posteriores. El mandato se utiliza del mismo modo que el mandato wsdb2gen. El mandato, wsdb2gen, que se aplica solamente a DB2, funciona solamente para la base de datos DB2 en WebSphere Application Server V7.0. En este release, el mandato se puede utilizar para bases de datos DB2, Informix y Oracle. Debido a ello, se ha introducido un sinónimo: el mandato wsdbgen.
Los mandatos JPA (.bat en Windows o .sh en UNIX) se ejecutan desde el directorio raíz_perfil/bin, en lugar de hacerlo desde el directorio raíz_servidor_aplicaciones/bin para asegurarse de que tiene la última versión de los mandatos para su release.
Sintaxis
La sintaxis del mandato es la siguiente:
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
wsdbgen.sh [parámetros]
![[IBM i]](../images/iseries.gif)
wsdbgen [parámetros]
![[Windows]](../images/windows.gif)
wsdbgen.bat [parámetros]
Antes de ejecutar el mandato, el archivo persistence.xml debe estar en el directorio META-INF y este debe estar en la vía de acceso de clases.
Parámetros
- -help: este parámetro muestra la información de ayuda.
- -pu: nombre de la unidad de persistencia definida en el archivo persistence.xml.
- -collection: ID de colección que se asigna a los nombres de paquetes. El valor predeterminado es NULLID.
- -url: URL de la base de datos de destino.
Se utiliza para validar el SQL generado. Debe especificarse un URL en el archivo persistence.xml o como opción de mandato. Si se especifican ambos, se utilizará el URL especificado en la opción de mandato.
- -user: ID de usuario.
- -pw: la contraseña correspondiente para conectarse a la base de datos de destino.
Si este parámetro no se especifica, se utiliza el valor encontrado en el archivo persistence.xml.
- -package: si se especifica este parámetro, el parámetro -package toma el nombre del paquete con valor de serie y se genera un solo paquete de base de datos con el nombre especificado. Si no se especifica el parámetro -package, se genera un paquete para cada clase de entidad. El nombre de entidad se utiliza como nombre de paquete si no se especifica la opción -package. El límite de longitud del nombre es el límite de base de datos menos 1, por ejemplo: 128 - 1 = 127.
Uso
El archivo persistence.xml debe incluirse en la el archivo Java (JAR) de la aplicación y también se utiliza como entrada en el enlace DB2 para crear el paquete de DB2. El mandato requiere una conexión a una base de datos para validar el SQL generado. No es necesario que la base de datos sea la misma que la base de datos de tiempo de ejecución, pero debe ser de la misma versión y nivel de release.
- pdq.jar
- pdqmgmt.jar
- db2jcc.jar
- db2jcc_licence_cu.jar
Ejemplos
- DB2
wsdbgen.sh -pu payroll -collection prod1 -url jdbc:db2://myhostname:50000/proddb -user produser -pw secret
wsdbgen -pu payroll -collection prod1 -url jdbc:db2://myhostname:50000/proddb -user produser -pw secret
wsdbgen.bat -pu payroll -collection prod1 -url jdbc:db2:\\myhostname:50000\proddb -user produser -pw secret
- Informix
wsdbgen.sh -pu payroll -collection prod1 -url jdbc:ids://myhostname:9089/proddb -user produser -pw secret
wsdbgen -pu payroll -collection prod1 -url jdbc:ids://myhostname:9089/proddb -user produser -pw secret
wsdbgen.bat -pu payroll -collection prod1 -url jdbc:ids:\\myhostname:9089\proddb -user produser -pw secret