Comando endptEnabler
O comando endptEnabler é usado para ativar um conjunto de serviços da Web em um arquivo archive corporativo (EAR). O comando endptEnabler deve ser executado nos arquivos EAR contendo módulos do Enterprise JavaBeans (EJB) que são ativados para os serviços da Web.
Cada módulo do roteador fornece um terminal de serviço da Web para um transporte particular. Por exemplo, é possível incluir um módulo do roteador HTTP para que o serviço da Web possa receber solicitações sobre o transporte HTTP. Ou é possível incluir um módulo do roteador Java™ Message Service (JMS) para que o serviço da Web possa receber solicitações de uma fila ou tópico JMS.
No seu modo interativo, o comando endptEnabler o guiará pelas etapas requeridas para ativar um ou mais serviços em um aplicativo. O comando endptEnabler faz uma cópia de backup de seu arquivo EAR original caso seja necessário remover ou incluir serviços posteriormente. Se seu arquivo EAR contiver um arquivo Java archive (JAR) enterprise bean que esteja ativado para os serviços da Web, deverá executar o comando endptEnabler antes que o arquivo EAR seja implementado. Caso contrário, não é necessário executar o comando.

Sintaxe de Uso do endptEnabler
endptEnabler
[-verbose|-v]
[-quiet|-q]
[-help|-h|-?]
[-properties|-p properties-filename]
[-transport|-t default-transports]
[-enableHttpRouterSecurity]
[-enableClientCertSecurity]
[ear-filename]
[-classpath|-cp]
- -verbose, -v
- Esse parâmetro detalha e exibe as mensagens de progresso à medida que a ferramenta endptEnabler processa o arquivo EAR. Essa opção da linha de comandos é mapeada para a propriedade global verbose.
- -quiet, -q
- Esse parâmetro verifica se não há nenhuma exibição das mensagens de progresso por módulo à medida que a ferramenta endptEnabler processa o arquivo EAR. Essa opção da linha de comandos é mapeada para a propriedade global quiet.
- -help, -h, -?
- Esse parâmetro exibe uma breve mensagem de ajuda que explica as várias opções.
- -properties, -p <properties-filename>
- Esse parâmetro lê as propriedades a partir das propriedades properties-filename e controla o comportamento da ferramenta endptEnabler.
- -transport, -t <default-transports>
- Esse parâmetro especifica a lista
padrão de transportes para os quais os módulos do roteador são criados
para cada arquivo JAR de enterprise bean contido no arquivo EAR. Esta opção da linha de comandos é mapeada para a propriedade global defaultTransports. Estes
são exemplos desse parâmetro:
-transport http (o padrão) -transport jms -t http,jms
- -enableHttpRouterSecurity
- Esse parâmetro permite incluir uma política de segurança para todos os usuários autenticados para proteger o módulo roteador HTTP se todos os módulos EJB estiverem seguros no arquivo JAR do enterprise bean. Esta opção da linha de comandos é mapeada para a propriedade global http.enableRouterSecurity.
- -enableClientCertSecurity
- Este parâmetro permite incluir a sub-rotina login-config a seguir
no arquivo web.xml para autenticação de certificado,
em vez de basic-auth ou form-login. Esta opção da linha de comandos é mapeada
para a propriedade global http.enableClientCertSecurity.
<login-config> <auth-method>CLIENT-CERT</auth-method> </login-config>
Boas Práticas: Use o parâmetro -enableClientCertSecurity com o parâmetro -enableHttpRouterSecurity.bprac
- <ear-filename>
- Esse parâmetro especifica o nome do arquivo EAR a ser
processado.
Se o parâmetro ear-filename não for inserido na linha de comandos, o modo interativo será utilizado. No modo interativo, é solicitado que você forneça o nome do arquivo EAR, os nomes dos módulos roteadores e outros valores importantes à medida que o processamento ocorre. O diálogo a seguir é um exemplo do modo interativo endptEnabler.
Nesse diálogo, a entrada do usuário está na fonte de largura fixa e a saída do endptEnabler está em negrito.
endptEnabler<enter> WSWS2004I: IBM WebSphere Application Server Release 5 WSWS2005I: Ferramenta de Ativador de Nó de Extremidade do Web Services Enterprise Archive. WSWS2007I: (C) COPYRIGHT International Business Machines Corp. 1997, 2003 WSWS2006I: Digite o nome do arquivo EAR: AddressBook.ear<enter> WSWS2003I: Fazendo backup do arquivo EAR para: AddressBook.ear~ WSWS2016I: Carregando o arquivo EAR: AddressBook.ear WSWS2017I: Módulo da Web localizado: AddressBookEJB.jar WSWS2029I: Insira o nome do roteador http para o Módulo EJB AddressBookEJB [AddressBookEJB_HTTPRouter.war]:<enter> WSWS2030I: Digite a raiz de contexto http para o Módulo EJB AddressBookEJB [/AddressBookEJB]:<enter> WSWS2024I: Incluindo o roteador http para o Módulo EJB AddressBookEJB.jar. WSWS2036I: Salvando o arquivo EAR AddressBook.ear... WSWS2037I: Concluído o salvamento do arquivo EAR. WSWS2018I: Concluído o processamento do arquivo EAR AddressBook.ear.
Se o parâmetro ear-filename for inserido na linha de comandos, o modo não-interativo será utilizado. No modo não-interativo, os nomes de módulos roteadores e outros valores importantes são determinados a partir de propriedades especificadas pelo usuário ou valores padrão.
- -classpath, -cp
- Este parâmetro permite especificar
arquivos JAR separados no caminho da classe para o comando endptEnabler. Use este parâmetro se o arquivo EJB fizer referência a tipos Java em arquivos
JAR separados, que não existem no arquivo EAR. Podem ser especificados
vários valores para este parâmetro. Por exemplo:
endptEnabler -classpath C:\MyWork\Utility.jar;D:\SharedFiles\Hello.zip;HelloWorld.jar
Quando você não especificar este parâmetro, poderá encontrar um erro semelhante à seguinte mensagem:
WSWS2021I: Skipping the enterprise bean module module_name because it contains no web services.
Propriedades endptEnabler
Com o comando endptEnabler é possível controlar seu comportamento de tempo de execução especificando um conjunto de propriedades com a opção da linha de comandos -properties. Essas propriedades são organizadas de uma das duas formas a seguir: global e por módulo. As propriedades globais afetam o comportamento geral da ferramenta à medida que processa diversos módulos JAR de enterprise bean no arquivo EAR. As propriedades por módulo afetam o processamento de um módulo JAR de enterprise bean específico.
Nome da propriedade | Descrição | Valor Padrão |
---|---|---|
detalhado | Exibe mensagens de progresso detalhadas. | Falso |
quiet | Exibe breves mensagens de progresso. | Falso |
http.enableRouterSecurity | Permite incluir uma política de segurança para todos os usuários autenticados para proteger o módulo roteador HTTP se todos os módulos EJB estiverem seguros no arquivo JAR do enterprise bean. | Falso |
http.enableClientCertSecurity | Permite incluir a sub-rotina login-config
a seguir no arquivo web.xml para autenticação de certificado,
em vez de basic-auth ou form-login:
|
Falso |
http.routerModuleNameSuffix | Especifica o sufixo utilizado para construir nomes de módulos roteadores HTTP padrão. A extensão .war é incluída pelo comando endptEnabler. | _HTTPRouter |
jms.routerModuleNameSuffix | Especifica o sufixo utilizado para construir nomes de módulos roteadores JMS padrão. A extensão .jar é incluída pelo comando endptEnabler. | _JMSRouter |
jms.defaultDestinationType | Especifica o tipo de destino padrão a ser utilizado para todos os módulos de roteadores JMS incluídos no arquivo EAR. Este tipo é fila ou tópico. | fila |
defaultTransports | Especifica a lista de transportes padrão para a qual os módulos roteadores são criados. A lista pode conter os valores http e jms. Diversos valores são separados por vírgulas. Por exemplo: http, jms e http,jms. | http |
A tabela a seguir descreve as propriedades por módulo suportadas pelo comando endptEnabler. A variável ejbJarName refere-se ao nome de um módulo JAR de enterprise bean no arquivo EAR, sem a extensão .jar.
Nome da propriedade | Descrição | Valor Padrão |
---|---|---|
|
Lista os transportes para os quais módulos roteadores são criados para um arquivo JAR de enterprise bean específico. A lista pode conter os valores http e jms. Diversos valores são separados por vírgulas. Por exemplo: http, jms e http,jms. | http |
|
Especifica o sinalizador que ignora a inclusão de um módulo roteador HTTP, mesmo que seja incluído de modo diferente com base em outras propriedades. Os valores válidos são true e false. | false |
|
Especifica o nome do módulo roteador HTTP para um determinado arquivo JAR de enterprise bean. | ejbJarName_HTTPRouter |
|
Especifica a raiz de contexto associada ao nome do módulo roteador HTTP para um determinado arquivo JAR de enterprise bean. | /ejbJarName |
|
Especifica o sinalizador que ignora a inclusão de um módulo roteador JMS mesmo que seja incluído de modo diferente com base em outras propriedades. Os valores válidos são true e false. | false |
|
Especifica o nome do módulo roteador JMS para um determinado arquivo JAR de enterprise bean. | ejbJarName_JMSRouter |
|
Especifica o nome de JNDI (Java Naming and Directory Interface) da especificação de ativação configurada para o MDB (Message Driven Bean) no módulo roteador JMS. | nulo |
|
Especifica o nome da porta listener a ser configurada para o MDB no módulo roteador JMS. A porta listener é configurada apenas se uma propriedade activationSpecJndiName não for especificada. | nulo |
|
Especifica o tipo de destino JMS associado ao MDB no roteador JMS. Os valores válidos são fila e tópico. | fila |
|
Especifica o padrão de URL para portas. Se você tiver o módulo EJB com o nome indicado que tenha uma porta com o nome local indicado, poderá especificar o padrão da URL HTTP com essa propriedade. Essa propriedade só se aplica aos módulos roteadores HTTP. Ela não afeta os módulos roteadores de JMS. | nulo |
Exemplo de Propriedades
StockQuoteEJB.transports=http,jms
StockQuoteEJB.http.routerModuleName=StockQuoteEJB_HTTP
StockQuoteEJB.http.contextRoot=/StockQuote
StockQuoteEJB.jms.routerModuleName=StockQuoteEJB_JMS
StockQuoteEJB.jms.destinationType=queue
Exemplos de endptEnabler
endptEnabler MyApp.ear
endptEnabler -t jms,http MyApp.ear
endptEnabler -v -properties MyApp.props MyApp.ear
endptEnabler -q -t jms MyApp.ear
endptEnabler -v -t http,jms