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]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
eclenhancer.sh
[argumentos] <source> <target>
![[Windows]](../images/windows.gif)
eclenhancer.bat
[argumentos] <source> <target>
Parámetros
- 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.
- <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.
- 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.
Ejemplos
Para mejorar entidades que se encuentran en un JAR:
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
$ 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]](../images/windows.gif)
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