Mandato de creación de apéndices

El mandato createEJBStubs crea clases stub para interfaces remotas de beans Enterprise JavaBeans (EJB) empaquetados en archivos de archivado Java (JAR), de archivado de aplicación web (WAR) o de archivado empresarial (EAR). También proporciona una opción para crear una clase stub única desde la clase de interfaz que se encuentra en un directorio o un archivo JAR. Se proporcionan varias opciones de mandato para empaquetar las clases stub generadas de distinta forma. Consulte las secciones Sintaxis y Ejemplos si desea más detalles.

Este mandato se encuentra en el directorio <INICIO_WAS>/bin como:
  • createEJBStubs.bat: plataformas Windows
  • createEJBStubs.sh - Plataformas basadas en UNIX
  • createEjbStubs: plataforma iSeries

El mandato busca en el archivo JAR, WAR o EAR de entrada, buscando módulos EJB que contienen beans con interfaces remotas. Cuando se encuentran interfaces remotas, las clases stub correspondientes se generan y empaquetan según las opciones de mandato especificadas. En el caso donde la entrada especificada es una clase de interfaz única, la herramienta presupone que esta clase es una clase de interfaz remota EJB y genera una clase stub remota.

Para muchos escenarios del lado de cliente, la característica de despliegue justo a tiempo (JIT) WebSphere Application Server genera dinámicamente las clases stub RMI-IIOP que son necesarias para la invocación de interfaces empresariales EJB 3.x remotas e interfaces empresariales anteriores a EJB 3.x remotas en una aplicación Java™ 7. Sin embargo, hay algunos escenarios donde el entorno de despliegue JIT no está disponible para generar dinámicamente estas clases. En estos escenarios, el mandato createEJBStubs se debe utilizar en lugar de generar e incorporar los archivos de clase stub del lado del cliente en la aplicación cliente. Si el entorno de cliente es uno de los siguientes, utilice el mandato createEJBStubs:
  • Clientes Java Standard Edition (SE) "básicos", donde una JVM (Java Virtual Machine) Java SE es el entorno de cliente.
  • Un contenedor WebSphere Application Server (contenedor web, contenedor EJB o contenedor de cliente de aplicaciones) de una versión anterior a la versión 7, sin el paquete de características para EJB 3.0 aplicado o interfaces empresariales anteriores a EJB 3.x no en una aplicación Java 7.
  • Entornos que no son de WebSphere Application Server.

La JVM que ejecuta el mandato createEJBStubs debe tener la propiedad del sistema java.io.tmpdir definida. La propiedad debe apuntar a un directorio en el que se pueda leer y grabar que exista.

Además de crear apéndices para contenido de bean empaquetado en archivos EAR y JAR, el mandato también crea apéndices para contenido de bean empaquetado en un archivo WAR. Si se especifica un archivo EAR como archivo de entrada y dicho archivo EAR contiene un archivo WAR con interfaces remotas, entonces se generan apéndices para dichas interfaces.

Los apéndices se colocan en el archivo WAR en la misma ubicación que la interfaz remota o la clase de bean a la que corresponden. Si la interfaz remota o clase de bean a la que corresponden se coloca suelta en la estructura de directorios WEB-INF/classes, entonces el apéndice se coloca allí también. Si la interfaz remota o clase de bean se empaqueta dentro de un archivo JAR en el directorio WEB-INF/lib, entonces el apéndice se inserta en ese mismo archivo JAR. Si se genera un apéndice para una interfaz remota que no está empaquetada dentro del archivo WAR, entonces se coloca suelta en la estructura de directorios WEB-INF/classes.

Un componente de cliente utiliza estos stubs para comunicarse con los componentes EJB que se ejecutan dentro del servidor. El componente de cliente debe utilizar instancias de apéndice creadas por la herramienta correcta.

Sintaxis

createEJBStubsnombre_clase_entrada | nombre_JAR_entrada | nombre_WAR_entrada | nombre_EAR_entrada [-help] [-newfile[archivo_nuevo]] [-updatefile[archivo_actualiz]] [-quiet] [-verbose] [-logfile archivo_registro] [-appendlog] [-cp vía_acceso_clases] [-trace]
createEJBStubs
Este es el mandato para crear clases stub EJB para un único archivo de clase de interfaz, un archivo JAR, un archivo WAR o un archivo EAR. Cuando se invoca sin argumentos, o sólo -help, el mandato createEJBStubs muestra una lista de las opciones que se pueden especificar y una lista de invocaciones de ejemplo con explicaciones detalladas.
nombre_clase_entrada o nombre_EAR_entrada o nombre_JAR_entrada o nombre_WAR_entrada

El primer parámetro es un elemento obligatorio para el mandato. Debe contener el archivo de clase de origen, JAR, WAR o EAR a procesar.

Este parámetro puede ser el nombre completo de una única clase de clase (p.e. com.ibm.myRemoteInterface). Tenga en cuenta que los segmentos de nombre de paquete están separados por los caracteres “.”, ningún nombre de vía de acceso continúa el nombre de clase y la extensión “.class” no se incluye. Para esta entrada de clase de interfaz, debe utilizar la opción de classpath (p. ej. –cp my_path o –cp my_path/my_interfaces.jar) para especificar dónde se encuentra la clase de interfaz. La clase stub generada se coloca en la estructura de directorios definida del paquete, empezando por el directorio actual en el que se invoca el mandato.

Este parámetro también puede ser un archivo JAR, WAR o EAR. En este caso, se debe especificar la vía de acceso (p.e. my_path/my_Server_App.ear). Las clases stub generadas se colocan en el mismo módulo o módulos que los bean, o en el mismo módulo o módulos que las clases de interfaz remota, según si se especifica la opción -updatefile. Consulte las secciones siguientes para obtener más información.

-help
Proporciona la sintaxis del mandato, incluyendo una lista con las opciones que se pueden especificar e invocaciones de ejemplo con explicaciones detalladas.
-newfile [archivo_nuevo]
Solicita que se genere un archivo nuevo que contenga el archivo original en el JAR, WAR o EAR de entrada más las clases stub. Cuando no se especifica esta opción, los apéndices se graban de nuevo en el archivo JAR, WAR o EAR original. Si se especifica esta opción, pero no se proporciona el nombre nuevo de archivo, se construye un nombre de archivo añadiendo "_withStubs" al nombre del archivo JAR, WAR o EAR. Esta opción no está permitida cuando el primer parámetro de entrada es una clase de interfaz.
-updatefile [archivo_actualiz]
Solicita que un segundo archivo (por ejemplo, además del archivo de entrada) se actualice con clases stub. Esta opción también proporciona un comportamiento de empaquetamiento distinto. Las clases stub se empaquetan en el mismo módulo o módulos que las clases de interfaz remota. Por contra, cuando no se especifica esta opción, las clases stub se empaquetan en el mismo módulo o módulos que las clases bean. Si se especifica esta opción, pero no se proporciona el nombre archivo_actualiz, sólo se actualiza el archivo JAR, WAR o EAR original con las clases stub. Esta opción no está permitida cuando el primer parámetro de entrada es una clase de interfaz.
-quiet
Solicita la supresión de mensajes. La opción -quiet no se puede especificar con las opciones -verbose o -trace. Los mensajes de error se siguen visualizando.
-verbose
Solicita que se generen mensajes informativos adicionales. La opción -verbose no se puede especificar con las opciones -quiet o -trace.
-logfile archivo_registro
Solicita que los mensajes se impriman en un archivo de registro además de en la consola. Si se especifica esta opción, el nombre archivo_registro se debe proporcionar también.
-appendlog
Solicita que los mensajes se añadan a un archivo de registro existente. Si se especifica esta opción, también se debe especificar la opción -logfile.
-cp vía_acceso_clases
Solicita que el cargador de clases incluya la classpath especificada donde se encuentran los archivos jar o clases adicionales, que son necesarios para la carga de clases de la interfaz remota. La classpath puede incluir varios segmentos en los que cada vía de acceso está separada de una vía de acceso anterior por el carácter separador predeterminado del sistema operativo para vías de acceso. Cada vía de acceso puede especificar un archivo JAR o un directorio. Si se especifica esta opción, el nombre vía_acceso_clases se debe proporcionar también.
-trace
Solicita que se genere una salida detallada de rastreo. Esto está pensado para recopilar información que el servicio técnico de IBM® utilizará para resolver problemas. La salida del rastreo (trace) sólo está disponible en inglés. Esta opción no se puede especificar con las opciones -quiet o -verbose.

Ejemplos

createEJBStubs com.ibm.myRemoteInterface -cp my_path

Genera la clase stub para una clase de interfaz remota y la coloca en la estructura de directorios definida por el paquete, empezando en el directorio actual. El directorio mi_vía_acceso se utiliza como la classpath. Si la clase de interfaz remota a procesar es un archivo JAR, se debe utilizar la sintaxis –cp my_path/mis_interfaces.jar para la especificación de la vía de acceso de clases.

createEJBStubs my_path/my_beans.jar -newfile –quiet

Genere las clases stub para todos los enterprise beans en el archivo my_beans.jar que tienen interfaces remotas. Tanto las clases stub generadas como el contenido del archivo JAR original se empaquetan en un archivo JAR nuevo denominado “mis_beans_withStubs.jar” ya que el parámetro de nombre opcional no se ha especificado junto con la opción -newfile. Los mensajes de salida se suprimen, salvo para notificaciones de error.

createEJBStubs my_path/my_Server_App.ear -logfile myLog.out

Genere las clases stub para todos los enterprise beans en el archivo my_Server_App.ear que tienen interfaces remotas. Las clases stub generadas se colocan en el archivo EAR original porque no se ha especificado la opción -newfile. Las clases stub se empaquetan en el mismo módulo o módulos que las clases bean, ya que no se ha especificado la opción -updatefile. Los mensajes se envían tanto al archivo de registro miRegistro.out como a la ventana de mandatos.

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

Genere las clases stub para todos los enterprise beans en el archivo my_Server_App.ear que tienen interfaces remotas. Las clases stub generadas se colocan en el archivo EAR original y en el archivo mis_interfaces_cliente.jar. Las clases stub se empaquetan en el mismo módulo o módulos que las clases de interfaz remota ya que se ha especificado la opción -updatefile.

createEJBStubs my_path/my_Server_App.ear –updatefile

Genere las clases stub para todos los enterprise beans en el archivo my_Server_App.ear que tienen interfaces remotas. Las clases stub generadas sólo se colocan en el archivo EAR original porque no se ha proporcionado el parámetro opcional de nombre de archivo de actualización con la opción -updatefile. Las clases stub se empaquetan en el mismo módulo o módulos que las clases de interfaz remota ya que se ha especificado la opción -updatefile.

createEJBStubs my_path/my_beans.war

Genere las clases stub para todos los beans que se han empaquetado en el archivo WAR y tienen interfaces remotas. La clase Bean1 se empaqueta suelta dentro de la estructura de directorios WEB-INF/classes y, por lo tanto, el apéndice correspondiente se coloca allí también. Del mismo modo, la clase Bean2 se empaqueta en el archivo miEJB.jar en el directorio WEB-INF/lib y, por lo tanto, el apéndice correspondiente se inserta en ese archivo JAR.

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rejb_3stubscmd2
File name: rejb_3stubscmd2.html