Publicación de archivos WSDL utilizando scripts wsadmin

Los archivos WSDL (Web Services Description Language) de cada módulo habilitado para servicios web se publican en la ubicación del sistema de archivos que especifique. Puede proporcionar estos archivos WSDL a los procesos de desarrollo y configuración de clientes de servicios web para que puedan invocar los servicios web.

Antes de empezar

Antes de publicar un archivo WSDL, puede configurar servicios web para especificar la información de punto final en forma de fragmentos de URL para permitir la especificación completa del URL de puertos WSDL. Consulte las tareas que describen la configuración de la información del URL de punto final.

Para publicar un archivo de lenguaje de descripción de servicios web (WSDL), necesita una aplicación de empresa, también denominado archivo EAR (archivador empresarial), que contiene un módulo habilitado para servicios web y que se ha desplegado en WebSphere Application Server. Para obtener más información, consulte la información sobre cómo desplegar aplicaciones de servicios web en servidores de aplicaciones.

Acerca de esta tarea

El objetivo de la publicación del archivo WSDL es proporcionar a los clientes una descripción del servicio web, incluido el URL que identifica la ubicación del servicio.

Después de instalar una aplicación de servicios web y de modificar opcionalmente la información de punto final, quizá necesite archivos WSDL que contengan la información de punto final actualizada. Puede obtener los archivos WSDL actualizados publicándolos en el sistema de archivos. Si es un desarrollador de clientes o un administrador del sistema, puede utilizar los archivos WSDL para permitir que los clientes se conecten a un servicio web.

La herramienta wsadmin puede publicar los archivos WSDL en modalidad local, por ejemplo, -conntype NONE, o modalidad remota. Sin embargo, en modalidad local, busque la aplicación de destino en el mismo nodo donde se invoca el mandato wsadmin.

Los pasos siguientes presuponen que la aplicación se ha desplegado y que el servidor de aplicaciones se está ejecutando.

Procedimiento

  1. Inicie la herramienta wsadmin desde el indicador de mandatos utilizando los siguientes mandatos:
    • [Windows]raíz_perfil\bin\wsadmin
    • [Linux][IBM i][z/OS]raíz_perfil/bin/wsadmin
  2. En el indicador de mandatos de wsadmin, escriba uno de los dos mandatos:
    • $AdminApp publishWSDL nombre_aplicación nombre_vía_acceso
    • $AdminApp publishWSDLnombre_aplicación nombre_vía_acceso soapAddressPrefixes
    donde:
    • nombre_aplicación es el nombre de la aplicación
    • nombre_vía_acceso es la vía de acceso absoluta al archivo comprimido que contiene los archivos WSDL publicados. El archivo comprimido se guarda en la máquina que ejecuta WebSphere Application Server, por lo tanto, si el servidor se ejecuta en una máquina distinta, debe obtener el archivo comprimido desde esa máquina. La estructura de directorios del archivo comprimido resultante se basa en la siguiente información:
      Nombre_archivo_aplicación/nombre_archivo_módulo/META-INF/
      o WEB-INF/wsdl/nombre_archivo_WSDL 
      Consulte el escenario de uso para ver un ejemplo de esta estructura de directorios
    • soapAddressPrefixes es un parámetro con el formato {{módulo {{enlace url-parcial}}}}. Este parámetro describe la información de URL parcial para cada enlace para cada módulo para la aplicación.
      • módulo identifica el nombre del módulo
      • enlace puede ser http o jms (ambos en minúsculas)
      • url-parcial es la dirección SOAP parcial del enlace SOAP asociado. Para un enlace HTTP, el formato es http://host:puerto/ o https://host:puerto.
        Para los enlaces JMS (Java Message Service), el formato es
        jms:/queue?destination=dest&connectionFactory=cf
        o
        jms:/topic?destination=dest&connectionFactory=cf

    Utilice el mandato $AdminApp publishWSDL Nombre_aplicación Nombre_vía_acceso para publicar los archivos WSDL con direcciones de URL de punto final predeterminado. Si desea modificar los prefijos de direcciones SOAP del archivo WSDL, utilice el otro formato del mandato.

    Utilice el mandato $AdminApp publishWSDL nombre_aplicación nombre_vía_acceso {{módulo {{enlace url-parcial}}}} para personalizar la dirección WSDL SOAP de cada módulo. Puede especificar un prefijo de dirección diferente para cada enlace SOAP.

Resultados

Los archivos WSDL de los servicios web se publican en un archivo comprimido especificado. El archivo comprimido se puede utilizar para crear un cliente de servicios web que acceda al servicio desplegado. Los archivos WSDL publicados no contienen información de enlaces EJB (Enterprise JavaBeans).

Ejemplo

El mandato para publicar los archivos WSDL para un servicio web cuyo nombre es WebServicesSamples puede ser $AdminApp publishWSDL WebServicesSamples c:/temp/samplesWsdl.zip

o

$AdminApp publishWSDL WebServicesSamples c:/temp/sampleswsdl.zip { {AddressBookJ2WB.war {{http http://localhost:9080}}} {StockQuote.jar {{http https://localhost:9443}}} }

La estructura de directorios para este archivo comprimido creado es:
WebServicesSamples.ear/StockQuote.jar/META-INF/wsdl/StockQuoteFetcher.wsdl 
WebServicesSamples.ear/AddressBookW2JE.jar/META-INF/wsdl/AddressBookW2JE.wsdl 
WebServicesSamples.ear/AddressBookJ2WE.jar/META-INF/wsdl/AddressBookJ2WE.wsdl 
WebServicesSamples.ear/AddressBookJ2WB.war/WEB-INF/wsdl/AddressBookJ2WB.wsdl 
WebServicesSamples.ear/AddressBookW2JB.war/WEB-INF/wsdl/AddressBookW2JB.wsdl

Qué hacer a continuación

Desarrolle un cliente de servicios web o configure la información de punto de final para un servicio web existente.

Icon that indicates the type of topic Task topic



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