Mandato wsdeploy

Utilice el mandato wsdeploy para añadir clases de despliegue específicas del producto WebSphere a un archivo EAR (archivador empresarial) de aplicación empresarial compatible con servicios web o un archivo JAR (archivador Java™) de cliente de aplicación.

El mandato wsdeploy está soportado por las aplicaciones JAX-RPC (Java API for XML-based RPC). El modelo de programación de JAX-WS (Java API for XML-Based Web Services) implementado por el servidor de aplicaciones no soporta el mandato wsdeploy. Si la aplicación de servicios web sólo contiene puntos finales JAX-WS, no es necesario que ejecute el mandato wsdeploy, ya que este mandato sólo se utiliza para procesar puntos finales JAX-RPC.

Las clases de despliegue añadidas por la herramienta wsdeploy a un archivo JAR o a un archivo EAR compatible con servicios web incluyen:
  • Stubs
  • Serializadores y deserializadores
  • Implementaciones de interfaces de servicio
Este paso de despliegue se debe ejecutar al menos una vez y puede llevarse a cabo más a menudo. El despliegue puede llevarse a cabo por separado cono el mandato wsdeploy, las herramientas de ensamblaje o cuando se instala la aplicación. Cuando se utiliza el mandato wsadmin en la instalación, especifique la opción -deployws.
El mandato wsdeploy funciona de la siguiente manera:
  • Se examina cada uno de los módulos del archivo JAR o de la aplicación de empresa
  • Si el módulo contiene implementaciones de servicios web, indicadas por la presencia del descriptor de despliegue webservices.xml, se localizan los archivos WSDL (Web Services Description Language) asociados y se ejecuta el mandato WSDL2Java con la opción role deploy-server.
  • Si el módulo contiene clientes de servicios web, indicados por la presencia del descriptor de despliegue de cliente, se localizan los archivos WSDL asociados y el mandato wsdl2java se ejecuta con la opción deploy-client de rol.
  • Los archivos generados por el mandato WSDL2Java se compilan y se vuelven a empaquetar.
Consulte el mandato WSDL2Java para obtener información sobre los mandatos de aplicaciones JAX-RPC para tener más datos sobre los archivos que se generan para el despliegue.

Cuando se compilan los archivos generados, pueden hacer referencia a clases específicas de la aplicación fuera del archivo EAR o JAR, si éste no está autocontenido. En este caso, utilice la opción -jardir o -cp para especificar los archivos comprimidos o JAR adicionales que se añaden a la variable CLASSPATH cuando se compilan los archivos generados.

Sintaxis del mandato wsdeploy

La sintaxis del mandato se muestra en el siguiente ejemplo:
wsdeploy Nombre_archivo_entrada Nombre_archivo_salida [options]
Opciones necesarias:
  • nombre_archivo_entrada

    Especifica la vía de acceso del archivo EAR o JAR que se va a desplegar.

  • nombre_archivo_salida

    Especifica la vía de acceso del archivo EAR o JAR desplegado. Si el nombre_archivo_salida ya existe, se escribe encima de manera silenciosa. El nombre_archivo_salida puede ser el mismo que el nombre_archivo_entrada.

Otras opciones:
  • -jardir directorio

    Especifica un directorio que contiene archivos comprimidos o JAR. Todos los archivos comprimidos y JAR de este directorio se añaden a la variable CLASSPATH utilizada para compilar los archivos generados. Esta opción se puede especificar cero o más veces.

  • -cp entradas

    Especifica las entradas que se van a añadir a la CLASSPATH cuando se compilen las clases generadas. Las distintas entradas están separadas igual que lo estarían en la variable de entorno CLASSPATH.

  • -codegen

    Especifica generar pero sin compilar el código de despliegue. Esta opción especifica implícitamente la opción -keep.

  • -debug

    Incluye la información de depuración cuando se realiza la compilación, esto es cuando se utiliza javac -g para compilar.

  • -help

    Muestra un mensaje de ayuda y una salida.

  • -ignoreerrors

    No detiene el despliegue si aparecen errores de validación o compilación.

  • -keep

    No suprime los directorios de trabajo que contienen las clases generadas. Aparece un mensaje indicando el nombre del directorio de trabajo que se ha mantenido.

  • -novalidate

    No valida los descriptores de despliegue de servicios web en el archivo de entrada.

  • -trace

    Muestra información de proceso, incluidos los nombres de los archivos generados.

  • -compliancelevel nivel

    Establece el nivel de JDK para la conformidad del compilador. Los valores válidos son: 1.4, 5.0, 6.0 (valor predeterminado) y 7.0. Este distintivo es opcional.

En el siguiente ejemplo se muestra cómo se utilizan las opciones con el mandato wsdeploy:
wsdeploy x.ear x_deployed.ear -trace -keep  
Procesando módulo de servicio Web x_client.jar. Manteniendo directorio: f:\temp\Base53383.tmp para módulo:
x_client.jar. Analizando archivo XML: f:\temp\Base53383.tmp\WarDeploy.wsdl   
Generando f:\temp\Base53383.tmp\generatedSource\com\test\WarDeploy.java   
Generando f:\temp\Base53383.tmp\generatedSource\com\test\WarDeployLocator.java   
Generando f:\temp\Base53383.tmp\generatedSource\com\test\HelloWsBindingStub.java   
Compilando f:\temp\Base53383.tmp\generatedSource\com\test\WarDeploy.java. Compilando f:\temp\Base53383.tmp\generatedSource\com\test\WarDeployLocator.java. Compilando f:\temp\Base53383.tmp\generatedSource\com\test\HelloWsBindingStub.java. Terminado de procesar módulo x_client.jar.  
Es posible que se visualicen los mensajes siguientes:
  • El distintivo -f no es válido.

    La opción f no se ha reconocido como una opción válida.

  • El distintivo -c es ambiguo.

    Las opciones se pueden abreviar, pero la abreviatura debe ser única. En este caso, el mandato wsdeploy no puede determinar a qué opción se refiere.

  • Al distintivo -c le falta el parámetro -p.

    Se ha omitido un parámetro necesario para una opción.

  • Falta el parámetro p.

    Se ha omitido una opción necesaria.


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=rwbs_wsdeploy
File name: rwbs_wsdeploy.html