Mandato de creación de apéndices

El mandato createEJBStubs crea clases stub para interfaces remotas de beans EJB (Enterprise JavaBeans) Versión 3.0 empaquetados en archivos JAR (archivo Java™) o EAR (archivador empresarial). 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. Para obtener más detalles, consulte las secciones Sintaxis y ejemplos más adelante.

Este mandato se encuentra en el directorio <INICIO_WAS>/bin:
  • createEJBStubs.bat: plataformas Windows
  • createEJBStubs.sh: plataformas Unix
  • createEjbStubs: plataforma iSeries

El mandato busca en el archivo JAR o EAR de entrada, en busca de módulos EJB de la versión 3.0 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 en el que la entrada especificada es una sola clase de interfaz, la herramienta presupone que esta clase es una clase de interfaz remota EJB de la versión 3.0 y genera una clase stub remota.

En muchos escenarios en la parte del cliente, la característica de despliegue WebSphere Application Server Just-In-Time (JIT) genera dinámicamente las clases stub RMI-IIOP necesarias para la invocación de las interfaces empresariales EJB 3.0 remotas. No obstante, hay algunos escenarios en los que el entorno de despliegue JIT no está disponible para generar dinámicamente estas clases. En estos escenarios, hay que utilizar el mandato createEJBStubs en vez de generar e incluir los archivos de clase stub del cliente en su aplicación cliente. Si su entorno cliente es alguno de los siguientes, utilice el mandato createEJBStubs:
  • Los clientes "básicos"Java Standard Edition (SE), donde una Java SE Java Virtual Machine (JVM) es el entorno de cliente.
  • Un contenedor (contenedor web, contenedor EJB o contenedor de cliente de , aplicaciones) de WebSphere Application Server, de una versión anterior a la versión 7 o sin el Feature Pack for EJB 3.0 aplicado.
  • Entornos que no son de WebSphere Application Server.

Sintaxis

createEJBStubs nombre_clase_entrada | nombre_JAR_entrada | nombre_EAR_entrada [-help] [-newfile [archivo_nuevo]] [-updatefile [archivo_actualiz]] [-quiet] [-verbose] [-logfile log_file] [-appendlog] [-cp class_path] [-trace]
createEJBStubs
Este es el mandato para crear clases stub EJB para un único archivo de clase de interfaz, un archivo JAR 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, nombre_EAR_entrada o nombre_JAR_entrada

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

Este parámetro puede ser el nombre completo de una única clase de clase (p.e. com.ibm.myRemoteInterface). Observe que los segmentos de nombres de paquete se separan por caracteres ".", que el nombre de vía de acceso no sigue al nombre de clase y que 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 encontrar 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 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 colocarán 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. Se incluyen detalles más adelante en esta secció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 o EAR de entrada más las clases stub. Cuando no se especifica esta opción, los stub se graba de nuevo en el archivo JAR 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 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 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 podría 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.miInterfazRemota -cp mi_vía_acceso

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 utilizará 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 classpath.

createEJBStubs mi_vía_acceso/mis_beans.jar -newfile –quiet

Genera las clases stub para todos los enterprise bean de nivel 3.0 del archivo mis_beans.jar que tengan 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 mi_vía_acceso/mi_Servidor_Aplic.ear -logfile miRegistro.out

Genera las clases stub para todos los enterprise bean de nivel 3.0 del archivo mi_Servidr_Aplic.ear que tengan 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 mi_vía_acceso/mi_Servidor_Aplic.ear -updatefile mi_vía_acceso/mis_interfaces_cliente.jar

Genera las clases stub para todos los enterprise bean de nivel 3.0 del archivo mi_Servidr_Aplic.ear que tengan 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 mi_vía_acceso/mi_servidor_aplic.ear –updatefile

Genera las clases stub para todos los enterprise bean de nivel 3.0 del archivo mi_Servidr_Aplic.ear que tengan 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.

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_3stubscmd
File name: rejb_3stubscmd.html