Mandato eclenhancer

La herramienta de ampliador de entidad para aplicaciones Java™ Persistence API (JPA) inserta código de bytes en un archivo de clase de entidad que permite que el proveedor JPA gestione el estado de una entidad. Utilice esta herramienta de línea de mandatos para ampliar entidades en el proveedor de especificación Java™ Persistence API (JPA) 2.1, EclipseLink, para WebSphere Application Server.

JPA con el servidor de aplicaciones requiere que todas las clases de entidad se amplíen si se desea gestionar el estado de las mismas. En un entorno gestionado por contenedor, los contenedores proporcionan una ampliación automática. Sin embargo, en un entorno Java SE, ningún contenedor gestiona la persistencia y podría utilizar este mandato con frecuencia antes de empaquetar archivos de aplicación para la realización de pruebas. Tras crear las entidades JPA, puede ejecutar la herramienta de ampliador para inyectar código de bytes en las entidades antes de empaquetar el archivo de archivado Java (JAR) en el archivo de archivado empresarial (EAR) para la aplicación.

Sintaxis

Antes de ejecutar el mandato, debe tener un archivo persistence.xml en la vía de acceso de clase, o especificar su ubicación en el argumento -persistenceinfo. Emita el mandato desde el subdirectorio bin del directorio raíz_perfil.

La sintaxis del mandato es la siguiente:

[AIX][HP-UX][Linux][Solaris][z/OS]
eclenhancer.sh
[argumentos] <source> <target>
[Windows]
eclenhancer.bat
[argumentos] <source> <target>

Parámetros

El ampliador acepta el conjunto estándar de argumentos de la línea de mandatos definidos por el marco de la configuración junto con los argumentos necesarios siguientes:
  • classpath <vía de acceso>: Especifica la ubicación de los archivos de origen Java para entrelazar: ya sea un directorio o un archivo JAR. Si el archivo persistence.xml no está en esta ubicación, debe utilizar el atributo -persistenceinfo para especificar la ubicación del persistence.xml.
Si el directorio no coincide con el paquete de la clase ampliada, la estructura del paquete se creará debajo del directorio. De manera predeterminada, la herramienta de ampliación sobrescribe el archivo .class original.
  • <source>: Especifica la ubicación de los archivos de origen Java para entrelazar: ya sea un directorio o un archivo JAR. Si el archivo persistence.xml no está en esta ubicación, debe especificar la ubicación del persistence.xml mediante el atributo -persistenceinfo.
  • <target>: Especifica la ubicación de la salida: ya sea un directorio o un archivo JAR.

Uso

Para utilizar la herramienta de eclenhancer, tendrá que definir entidades en las especificaciones JPA, y debe compilar las entidades. Puede ejecutar la herramienta eclenhancer en las entidades antes de empaquetarlas en un archivo JAR. Si las entidades ya están empaquetadas, puede extraer los archivos de clase de entidad, ejecute el ampliador y vuelva a crear el archivo JAR.

Para mejorar las entidades:
  • Verifique que las entidades están en la vía de acceso de clase. Añádalas, si no están en la vía de acceso de clase.
  • Ejecute el mandato eclenhancer . Se encuentra en el directorio raíz_perfil/bin.
Se registrarán mensajes y errores en la consola administrativa, tal como se especifica en los valores del registro. Tras iniciar el mandato eclenhancer, los archivos se habrán mejorado.

Ejemplos

Para mejorar entidades que se encuentran en un JAR:

[AIX][HP-UX][Linux][Solaris][z/OS]
$ cd build
/home/user/myproject/build $ ${profile_root}/bin/eclenhancer.sh -persistenceinfo
/home/user/myproject/build/myjar-containing-persistencexml.jar -classpath
/classpath1;/classpath2 /home/user/myproject/build/myjar-source.jar
/home/user/myproject/build/myjar-target.jar
[Windows]
C:\myproject\build>%profile_root%\bin\eclenhancer.bat -persistenceinfo c:\myjar-
containing-persistencexml.jar -classpath c:\classpath1;c:\classpath2 c:\myjar-
source.jar c:\myjar-target.jar

Icon that indicates the type of topic Reference topic



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