Mandato endptEnabler
El mandato endptEnabler para habilitar un conjunto de servicios web en un archivo EAR (Enterprise Archive). El mandato endptEnabler debe ejecutarse en los archivos EAR que contengan módulos EJB (Enterprise JavaBeans) habilitados para los servicios web.
Cada módulo de direccionador proporciona un punto final de servicio web para un transporte determinado. Por ejemplo, se puede añadir un módulo de direccionador HTTP para que el servicio web pueda recibir solicitudes a través del transporte HTTP. O puede añadir un módulo de direccionador JMS (Java™ Message Service) para que el servicio web pueda recibir solicitudes desde un tema o una cola JMS.
En su modalidad interactiva, endptEnabler le guía a través de los pasos necesarios para habilitar uno o más servicios de una aplicación. El mandato endptEnabler hace una copia de seguridad del archivo EAR original en caso de que necesitara eliminar o añadir servicios más adelante. Si el archivo EAR contiene un archivo JAR (Java archive) de enterprise bean habilitado para servicios web, debe ejecutar el mandato endptEnabler antes de desplegar el archivo EAR. Si no es así, no tiene que ejecutar el mandato.

Sintaxis de uso de endptEnabler
endptEnabler
[-verbose|-v]
[-quiet|-q]
[-help|-h|-?]
[-properties|-p nombrearchivo_propiedades]
[-transport|-t transportes-por_omisión]
[-enableHttpRouterSecurity]
[-enableClientCertSecurity]
[nombrearchivo-ear]
[-classpath|-cp]
- -verbose, -v
- Este parámetro detalla y muestra los mensajes de progreso cuando la herramienta endptEnabler procesa el archivo EAR. Esta opción de línea de mandatos se correlaciona con la propiedad global verbose.
- -quiet, -q
- Este parámetro se asegurar de que no se muestre ningún mensaje de progreso por módulo mientras la herramienta procesa el archivo EAR. Esta opción de línea de mandatos se correlaciona con la propiedad global quiet.
- -help, -h, -?
- Este parámetro muestra un mensaje breve de ayuda explicando las distintas opciones.
- -properties, -p <nombre_archivo_propiedades>
- Este parámetro lee las propiedades de nombre_archivo_propiedades y controla el comportamiento de la herramienta endptEnabler.
- -transport, -t <transportes_por_omisión>
- Este parámetro especifica la lista de transportes
predeterminada para los que se crean módulos de direccionador para cada archivo JAR de enterprise bean
contenido en el archivo EAR. Esta opción de línea de mandatos se correlaciona con la propiedad global de defaultTransports. Los siguientes son ejemplos de este parámetro:
-transport http (the default) -transport jms -t http,jms
- -enableHttpRouterSecurity
- Este parámetro permite añadir una política de seguridad para todos los usuarios autenticados, para proteger el módulo de direccionador HTTP si todos los módulos EJB están protegidos en el archivo JAR de enterprise bean. Esta opción de línea de mandatos se correlaciona con la propiedad global http.enableRouterSecurity.
- -enableClientCertSecurity
- Este parámetro le permite añadir la siguiente stanza login-config en el archivo web.xml para la autenticación de certificados, en lugar de basic-auth o form-login. Esta opción de línea de mandatos se correlaciona con la propiedad global http.enableClientCertSecurity.
<login-config> <auth-method>CLIENT-CERT</auth-method> </login-config>
Best practice: Utilice el parámetro -enableClientCertSecurity con el parámetro -enableHttpRouterSecurity. bprac
- <nombrearchivo-ear>
- Este parámetro especifica el nombre del archivo EAR que se va a ejecutar.
Si no se especifica el parámetro nombrearchivo_ear en la línea de mandatos, se utilizará la modalidad interactiva. En la modalidad interactiva, se deben entrar el nombre del archivo EAR, los nombres de los módulos de direccionador y otros valores importantes mientras se ejecuta el proceso. El siguiente diálogo es un ejemplo de la modalidad interactiva de endptEnabler.
En este diálogo, los datos de entrada del usuario aparecen con font de ancho fijo y los datos de salida de endptEnabler aparecen en negrita.
endptEnabler<intro> WSWS2004I: IBM WebSphere Application Server Release 5 WSWS2005I: Herramienta habilitadora de puntos finales para EAR de Servicios web. WSWS2007I: (C) COPYRIGHT International Business Machines Corp. 1997, 2003 WSWS2006I: Introduzca el nombre del archivo EAR: AddressBook.ear<intro> WSWS2003I: Realizando copia de seguridad del archivo EAR en: AddressBook.ear~ WSWS2016I: Cargando archivo EAR: AddressBook.ear WSWS2017I: Se ha encontrado el módulo EJB: AddressBookEJB.jar WSWS2029I: Entre el nombre del direccionador http del módulo EJB AddressBookEJB [AddressBookEJB_HTTPRouter.war]:<intro> WSWS2030I: Entre el directorio raíz de contexto de http para el módulo EJB AddressBookEJB [/AddressBookEJB]:<intro> WSWS2024I: Añadiendo direccionador http de módulo EJB AddressBookEJB.jar. WSWS2036I: Guardando el archivo EAR AddressBook.ear... WSWS2037I: Ha finalizado guardar el archivo EAR. WSWS2018I: Ha finalizado el proceso del archivo EAR AddressBook.ear.
Si se especifica el parámetro nombrearchivo_ear en la línea de mandatos, se utiliza la modalidad no interactiva. En la modalidad no interactiva, los nombres de los módulos de direccionador y otros valores importantes se determinan a partir de las propiedades especificadas por el usuario o de los valores predeterminados.
- -classpath, -cp
- Este parámetro permite especificar archivos JAR independientes en la classpath para el mandato endptEnabler.
Utilice este parámetro si el archivo EJB hace referencia a tipos Java en archivos JAR independientes que no existen en el archivo EAR. Puede especificar varios valores para este parámetro. Por
ejemplo:
endptEnabler -classpath C:\MyWork\Utility.jar;D:\SharedFiles\Hello.zip;HelloWorld.jar
Si no especifica este parámetro, es posible que encuentre un error similar al mensaje siguiente:
WSWS2021I: Omitiendo el módulo de enterprise bean nombre_módulo Porque no contiene servicios web.
Propiedades de endptEnabler
Con el mandato endptEnabler se puede controlar el comportamiento del tiempo de ejecución especificando un conjunto de propiedades con la opción de línea de mandatos -properties. Estas propiedades están organizadas de dos formas: global y por módulo. Las propiedades globales afectan al comportamiento general de la herramienta, y procesan varios módulos JAR de enterprise bean dentro del archivo EAR. Las propiedades por módulo afectan al proceso de un módulo JAR de enterprise bean determinado.
Nombre de propiedad | Descripción | Valor por omisión |
---|---|---|
verbose | Muestra los mensajes detallados de progreso. | False |
quiet | Muestra sólo mensajes breves de progreso. | False |
http.enableRouterSecurity | Permite añadir una política de seguridad para todos los usuarios autenticados, para proteger el módulo de direccionador HTTP si todos los módulos EJB están protegidos en el archivo JAR de enterprise bean. | False |
http.enableClientCertSecurity | Le permite añadir la siguiente stanza login-config en el archivo web.xml para la autenticación de certificados, en lugar de basic-auth o form-login:
|
False |
http.routerModuleNameSuffix | Especifica el sufijo utilizado para construir los nombres de módulos de direccionador HTTP predeterminado. El mandato endptEnabler añade la extensión .war. | _HTTPRouter |
jms.routerModuleNameSuffix | Especifica el sufijo utilizado para construir los nombres de módulos de direccionador JMS predeterminado. El mandato endptEnabler añade la extensión .jar. | _JMSRouter |
jms.defaultDestinationType | Especifica el tipo de destino predeterminado que se utiliza para todos los módulos de direccionador JMS añadidos al archivo EAR. Este tipo es queue o topic. | queue |
defaultTransports | Especifica la lista de transportes predeterminados para los que se crean módulos de direccionador. La lista puede contener los valores http y jms. Si hay varios valores, se separan con una coma. Por ejemplo: http, jms y http,jms. | http |
En la tabla siguiente se describen las propiedades por módulo soportadas por el mandato endptEnabler. La variable ejbJarName hace referencia al nombre de un módulo JAR de enterprise bean dentro del archivo EAR, sin la extensión .jar.
Nombre de propiedad | Descripción | Valor por omisión |
---|---|---|
|
Lista los transportes para los que se deben crear módulos de direccionador para un archivo JAR de enterprise bean determinado. La lista puede contener los valores http y jms. Si hay varios valores, se separan con una coma. Por ejemplo: http, jms y http,jms. | http |
|
Especifica el distintivo que omite la adición de un módulo de direccionador HTTP, aunque se añada por otros procedimientos basándose en otras propiedades. Los valores válidos son true y false. | false |
|
Especifica el nombre del módulo de direccionador HTTP para un archivo JAR de enterprise bean determinado. | nombreJarEjb_HTTPRouter |
|
Especifica la raíz de contexto asociada con el módulo de direccionador HTTP de un archivo JAR de enterprise bean determinado. | /nombreJarEjb |
|
Especifica el distintivo que omite la adición de un módulo de direccionador JMS, aunque se añada por otros procedimientos basándose en otras propiedades. Los valores válidos son true y false. | false |
|
Especifica el nombre del módulo de direccionador JMS para un archivo JAR de enterprise bean determinado. | nombreJarEjb_JMSRouter |
|
Especifica el nombre JNDI (Java Naming and Directory Interface) de la especificación de activación que se configura para el MDB (bean controlado por mensajes) del módulo de direccionador JMS. | null |
|
Especifica el nombre del puerto de escucha que se va a configurar para el MDB dentro del módulo de direccionador JMS. El puerto de escucha se configura sólo si no se especifica una propiedad activationSpecJndiName. | null |
|
Especifica el tipo de destino JMS asociado al MDB dentro del direccionador JMS. Los valores válidos son queue y topic. | queue |
|
Especifica el patrón de URL para los puertos. Si tiene un módulo EJB con el nombre indicado que tenga un puerto con el nombre local indicado, puede especificar el patrón de URL HTTP con esta propiedad. Esta propiedad sólo se aplica a módulos de direccionador HTTP. No tiene ningún efecto en módulos de direccionador JMS. | null |
Ejemplo de propiedades
StockQuoteEJB.transports=http,jms
StockQuoteEJB.http.routerModuleName=StockQuoteEJB_HTTP
StockQuoteEJB.http.contextRoot=/StockQuote
StockQuoteEJB.jms.routerModuleName=StockQuoteEJB_JMS
StockQuoteEJB.jms.destinationType=queue
Ejemplos 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