Publicando arquivos WSDL usando scripts wsadmin

Os arquivos Web Services Description Language (WSDL) em cada módulo ativado para serviços da Web são publicados no local do sistema de arquivos que for especificado. É possível fornecer esses arquivos WSDL nos processos de desenvolvimento e configuração de clientes de serviços da Web para que eles possam chamar os seus serviços da Web.

Antes de Iniciar

Antes de publicar um arquivo WSDL, é possível configurar os serviços da Web para especificar as informações de terminal na forma de fragmentos de URL para ativar a especificação de URL completa de portas WSDL. Consulte as tarefas que descrevem as informações de configuração da URL do terminal.

Para publicar um arquivo WSDL (Web Services Description Language), é necessário um aplicativo corporativo, também conhecido como arquivo EAR (Enterprise Archive), que contém um módulo ativado para serviços da Web e foi implementado no WebSphere Application Server. Para saber mais, consulte as informações sobre a implementação de aplicativos de serviços da Web nos servidores de aplicativos.

Sobre Esta Tarefa

O propósito da publicação do arquivo WSDL, é fornecer aos clientes uma descrição do serviço da Web, incluindo a URL que identifica o local do serviço.

Após instalar um aplicativo de serviços da Web e modificar opcionalmente as informações de terminal, será possível precisar de arquivos WSDL contendo as informações de terminal atualizadas. É possível obter os arquivos WSDL atualizados publicando-os no sistema de arquivos. Se você é um desenvolvedor do cliente ou um administrador do sistema, será possível usar os arquivos WSDL para ativar os clientes para que se conectem a um serviço da Web.

A ferramenta wsadmin pode publicar os arquivos WSDL no modo local, por exemplo, -conntype NONE, ou remoto. No entanto, no modo local, coloque o aplicativo de destino no mesmo nó em que o comando wsadmin é chamado.

As etapas a seguir supõem que o aplicativo foi implementado e que o servidor de aplicativos está em execução.

Procedimento

  1. Inicie a ferramenta wsadmin no prompt de comandos utilizando os seguintes comandos:
    • [Windows]profile_root\bin\wsadmin
    • [Linux][IBM i][z/OS]profile_root/bin/wsadmin
  2. No prompt de comandos wsadmin, digite um dos dois comandos a seguir:
    • $AdminApp publishWSDLapp_name path_name
    • $AdminApp publishWSDLapp_name path_name soapAddressPrefixes
    em que:
    • app_name é o nome do aplicativo
    • path_name é o caminho absoluto para o arquivo compactado que contém os arquivos WSDL publicados. O arquivo compactado é salvo na máquina que executa o WebSphere Application Server, portanto, se o servidor estiver em execução em uma máquina diferente, será necessário obter o arquivo compactado a partir dessa máquina. A estrutura de diretório do arquivo compactado resultante é baseada nas informações a seguir:
      Application_file_name/module_file_name/META-INF/ ou WEB-INF/wsdl/WSDL_file_name
      Consulte o cenário de uso para obter um exemplo dessa estrutura de diretórios.
    • soapAddressPrefixes é um parâmetro do formato {{module {{binding partial-url}}}}. Esse parâmetro descreve as informações parciais de URL para cada ligação em uma base por módulo para o aplicativo.
      • module identifica o nome do módulo
      • binding é http ou jms (ambos em minúsculas)
      • partial-url é o endereço SOAP parcial para a ligação SOAP associada. Para uma ligação HTTP, o formato é http://host:port/ ou https://host:port.
        Para ligações JMS (Java Message Service), o formato é
        jms:/queue?destination=dest&connectionFactory=cf
        ou
        jms:/topic?destination=dest&connectionFactory=cf

    Utilize o comando $AdminApp publishWSDL app_Name path_Name para publicar arquivos WSDL com endereços de URL de terminal padrão. Se quiser modificar os prefixos do endereço SOAP do arquivo WSDL, utilize a outra forma do comando.

    Utilize o comando $AdminApp publishWSDL app_Name path_Name {{module {{binding partial-url}}}} para customizar o endereço SOAP WSDL para cada módulo. É possível especificar um prefixo de endereço diferente para cada ligação SOAP.

Resultados

Os arquivos WSDL de serviços da web são publicados em um arquivo compactado especificado. O arquivo compactado pode ser usado para criar um cliente de serviço da web que acessa o serviço implementado. Os arquivos WSDL publicados não contêm informações sobre ligação de Enterprise JavaBeans (EJB).

Exemplo

O comando para publicar os arquivos WSDL para um serviço da Web denominado WebServicesSamples pode ser $AdminApp publishWSDL WebServicesSamples c:/temp/samplesWsdl.zip

ou

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

A estrutura de diretório para este arquivo compactado criado é
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

O que Fazer Depois

Desenvolva um cliente de serviços da Web ou configure as informações de terminal para um serviço da Web existente.

Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_commandwsdl
Nome do arquivo: txml_commandwsdl.html