Comando eclenhancer

A ferramenta otimizadora de entidade para aplicativos Java™ Persistence API (JPA) insere bytecode em um arquivo de classe de entidade que suporta o provedor JPA para gerenciar o estado de uma entidade. Use essa ferramenta da linha de comandos para aprimorar entidades no provedor de especificação Java™ Persistence API (JPA) 2.1, EclipseLink, para WebSphere Application Server.

A JPA com o servidor de aplicativos requerem que todas as classes de entidades sejam aprimoradas para que seu estado seja gerenciado. Em um ambiente gerenciado por contêiner, o aprimoramento automatizado é fornecido pelos contêineres. No entanto, em um ambiente do Java SE, nenhum contêiner gerencia a persistência e você poderá usar esse comando frequentemente, antes de compactar arquivos de aplicativos para teste. Após criar as entidades JPA, será possível executar a ferramenta eclenhancer para injetar o bytecode nas entidades antes de compactar o arquivo Java archive (JAR) no arquivo enterprise archive (EAR) para o aplicativo.

Sintaxe

Antes de executar o comando, você deve ter um arquivo persistence.xml no caminho da classe ou especificar seu local no argumento -persistenceinfo. Emita o comando a partir do subdiretório bin do diretório profile_root.

A sintaxe de comando é a seguinte:

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

Parâmetros

O otimizador aceita o conjunto padrão de argumentos da linha de comandos definidos pela estrutura de configuração juntamente com os argumentos necessários a seguir:
  • classpath <path>: especifica o local dos arquivos de origem Java para entrelaçar: um diretório ou um arquivo JAR. Se o arquivo persistence.xml não estiver nesse local, você deverá usar o atributo -persistenceinfo para especificar o local do persistence.xml.
Se o diretório não corresponder ao pacote de classe aprimorado, a estrutura do pacote será criada sob o diretório. Por padrão, o otimizador sobrescreve o arquivo .class original.
  • <origem>: especifique o local dos arquivos de origem Java para entrelaçar: um diretório ou um arquivo JAR. Se o arquivo persistence.xml não estiver nesse local, você deverá especificar o local do persistence.xml usando o atributo -persistenceinfo.
  • <destino>: especifica o local de saída: um diretório ou um arquivo JAR.

Uso

Para usar a ferramenta eclenhancer, é necessário definir as entidades para as especificações JPA, e deve-se compilar as entidades. É possível executar a ferramenta eclenhancer com relação às entidades antes de compactá-las em um arquivo JAR. Se as entidades já estiverem compactadas, será possível extrair os arquivos de classes de entidade, executar o otimizador e recriar o arquivo JAR.

Para aprimorar suas entidades:
  • Verifique se as entidades estão no caminho da classe. Inclua-as, se elas não estiverem no caminho da classe.
  • Execute o comando eclenhancer . Ele está localizado no diretório profile_root/bin.
As mensagens e os erros são registrados no console administrativo, conforme especificado nas configurações de log. Após iniciar o comando eclenhancer, os arquivo são aprimorados.

Exemplos

Par aprimorar entidades que estão localizadas em um 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

Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rejb_eclenhancer
Nome do arquivo: rejb_eclenhancer.html