Comando Create stubs

O comando createEJBStubs cria classes de stub para interfaces remotas de beans Enterprise JavaBeans (EJB) Versão 3.0 compactados nos arquivos de Java™ (JAR) ou Archive corporativo (EAR). Fornece também uma opção para criar uma única classe stub a partir de uma classe de interface localizada em um diretório ou arquivo JAR. Diversas opções de comando são fornecidas para compactar as classes stub geradas de diferentes maneiras. Consulte as seções Sintaxe e Exemplos posteriormente neste tópico para obter mais detalhes.

Este comando está localizado no diretório <WAS_HOME>/bin como:
  • createEJBStubs.bat - plataformas Windows
  • createEJBStubs.sh - plataformas baseadas em Unix
  • createEjbStubs - plataforma iSeries

O comando procura o arquivo JAR ou EAR de entrada, procurando módulos EJB versão 3.0 que contêm beans com interfaces remotas. Quando interfaces remotas são encontradas, as classes stub correspondentes são geradas e compactadas de acordo com as opções de comando especificadas. No caso em que a entrada especificada é uma única classe de interface, a ferramenta presume que esta seja uma classe de interface remota EJB versão 3.0 e gera uma classe stub remota.

Para muitos cenários do lado do cliente, o recurso de implementação WebSphere Application Server Just-In-Time (JIT) gera dinamicamente as classes de stub RMI-IIOP que são necessárias para chamar as interfaces de negócios remotas EJB 3.0. Entretanto, em alguns cenários, o ambiente de implementação JIT não está disponível para gerar essas classes dinamicamente. Nesses cenários, o comando createEJBStubs deve ser utilizado no lugar para gerar e integrar os arquivos de classe de stub do lado do cliente em seu aplicativo cliente. Se o ambiente do cliente for um dos seguintes, utilize o comando createEJBStubs:
  • Clientes Java Standard Edition (SE) "Bare" nos quais uma Java Virtual Machine (JVM) Java SE é o ambiente do cliente.
  • Um contêiner do WebSphere Application Server (contêiner da Web, contêiner EJB ou contêiner do cliente do aplicativo) a partir de uma versão anterior à versão 7 ou sem o Feature Pack for EJB 3.0 aplicado.
  • Ambientes não WebSphere Application Server.

Sintaxe

createEJBStubs input_ class_ name | input_JAR_name | input_EAR_name [-help] [-newfile [new_file]] [-updatefile [update_file]] [-quiet] [-verbose] [-logfile log_file] [-appendlog] [-cp class_path] [-trace]
createEJBStubs
Esse é o comando para criar classes stub EJB para um arquivo de classe de interface única, um arquivo JAR ou um arquivo EAR. Quando chamado sem nenhum argumento, ou somente com –help, o comando createEJBStubs exibe uma lista de opções que podem ser especificadas, bem como uma lista de chamadas de exemplo com explicações detalhadas.
input_class_name ou input_EAR_name ou input_JAR_name

O primeiro parâmetro é um elemento obrigatório do comando. Ele deve conter o arquivo de classe de origem, JAR ou EAR a ser processado.

Esse parâmetro pode ser o nome completo de uma única classe de interface (por exemplo, com.ibm.myRemoteInterface). Observe que os segmentos do nome do pacote são separados por "." nenhum nome de caminho precede o nome da classe e a extensão ".class" não está incluída. Para esta entrada de classe de interface, você deve usar a opção de caminho da classe (por exemplo, –cp my_path, ou –cp my_path/my_interfaces.jar) para especificar onde a classe de interface será localizada. A classe stub gerada será colocada na estrutura de diretório definida pelo pacote, começando com o diretório atual no qual o comando é chamado.

Esse parâmetro pode também ser um arquivo JAR ou EAR. Nesse caso, o caminho deve ser especificado (por exemplo, my_path/my_Server_App.ear). As classes stub geradas serão colocadas no(s) mesmo(s) módulo(s) com os beans, ou com as classes de interface remota, dependendo da especificação da opção –updatefile. Os detalhes seguem posteriormente nesta seção.

-ajuda
Fornece a sintaxe de comando, incluindo uma lista de opções que podem ser especificadas, além de chamadas de exemplo com explicações detalhadas.
-newfile [new_file]
Solicita a geração de um novo arquivo contendo os arquivos originais no JAR ou EAR de entrada, além das classes stub. Quando essa opção não é especificada, os stubs são regravados no arquivo JAR ou EAR original. Se esta opção for especificada, mas o nome new_file não for fornecido, um novo nome do arquivo é construído ao anexaro nome do arquivo JAR ou EAR de entrada com "_withStubs". Essa opção não é permitida quando o primeiro parâmetro de entrada é uma classe de interface.
-updatefile [update_file]
Solicita que um segundo arquivo (por exemplo, além do arquivo de entrada) seja atualizado com classes stub. Essa opção também fornece um comportamento de pacote diferente. As classes stub são compactadas no(s) mesmo(s) módulo(s) que as classes de interface remota. Em comparação, quando essa opção não é especificada, as classes stub são compactadas no(s) mesmo(s) módulo(s) com as classes de bean. Se essa opção for especificada, mas o nome update_file não for fornecido, somente o arquivo original JAR ou EAR será atualizado com as classes stub. Essa opção não é permitida quando o primeiro parâmetro de entrada é uma classe de interface.
-quiet
Solicita a supressão de mensagens. A opção -quiet não pode ser especificada com as opções –verbose ou –trace. Mensagens de erro ainda serão exibidas.
-verbose
Solicita a saída de mensagens informativas adicionais. A opção -verbose não pode ser especificada com as opções -quiet ou –trace.
-logfile log_file
Solicita a impressão das mensagens em um arquivo de log além de no console. Se essa opção for especificada, o nome log_file também deverá ser fornecido.
-appendlog
Solicita que as mensagens sejam anexadas a um arquivo de log existente. Se essa opção for especificada, a opção log_option também deverá ser especificada.
-cp class_path
Solicita que o carregador de classe inclua o caminho de classe especificado em que arquivos adicionais jar ou de classe estão localizados, os quais são necessários para que as classes de interface remota sejam carregadas. O caminho de classe pode incluir vários segmentos em que cada caminho é separado de um caminho anterior pelo caractere separador de caminho padrão do sistema operacional. Cada caminho pode especificar um arquivo JAR ou um diretório. Se essa opção for especificada, o nome class_path também deverá ser fornecido.
-trace
Solicita que seja gerada saída de rastreio detalhada. Isto destina-se a coletar informações para uso pelo serviço IBM® para resolver problemas. A saída de rastreio é apenas em inglês. Essa opção não pode ser especificada com as opções –quiet ou –verbose.

Exemplos

createEJBStubs com.ibm.myRemoteInterface -cp my_path

Gere a classe stub para uma classe de interface remota e coloque-a na estrutura de diretório definida pelo pacote, começando no diretório atual. O diretório my_path será utilizado como caminho de classe. Se a classe de interface remota a ser processada estiver em um arquivo JAR, a sintaxe –cp my_path/my_interfaces.jar deverá ser utilizada como especificação do caminho de classe.

createEJBStubs my_path/my_beans.jar -newfile –quiet

Gere as classes stub para todos os enterprise beans de nível 3.0 no arquivo my_beans.jar que tem interfaces remotas. As classes stub geradas e o conteúdo original do arquivo JAR são compactados em um novo arquivo JAR denominado “my_beans_withStubs.jar” porque o parâmetro de nome new_file opcional não é especificado com a opção –newfile. As mensagens de saída são suprimidas, exceto para notificações de erro.

createEJBStubs my_path/my_Server_App.ear -logfile myLog.out

Gere as classes stub para todos os enterprise beans de nível 3.0 no arquivo my_Server_App.ear que tem interfaces remotas. As classes stub geradas são colocadas no arquivo EAR original porque a opção –newfile não é especificada. As classes stub são compactadas no(s) mesmo(s) módulo(s) que as classes de bean porque a opção –updatefile não é especificada. As mensagens são gravadas no arquivo de log myLog.out e na janela de comando.

createEJBStubs my_path/my_Server_App.ear -updatefile my_path/my_Client_interfaces.jar

Gere as classes stub para todos os enterprise beans de nível 3.0 no arquivo my_Server_App.ear que tem interfaces remotas. As classes stub geradas são colocadas no arquivo EAR original e no arquivo my_Client_interfaces.jar. As classes stub são compactadas no(s) mesmo(s) módulo(s) que as classes de interface remota porque a opção –updatefile é especificada.

createEJBStubs my_path/my_Server_App.ear –updatefile

Gere as classes stub para todos os enterprise beans de nível 3.0 no arquivo my_Server_App.ear que tem interfaces remotas. As classes stub geradas são colocadas apenas no arquivo EAR original porque o parâmetro de nome opcional update_file não é fornecido com a opção –updatefile. As classes stub são compactadas no(s) mesmo(s) módulo(s) que as classes de interface remota porque a opção –updatefile é especificada.

Í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_3stubscmd
Nome do arquivo: rejb_3stubscmd.html