Configurando um Nome de Arquivo WSDL Implementado do Cliente de Serviço da Web Usando o Script wsadmin

Quando um aplicativo de serviço da Web é implementado no WebSphere Application Server, uma instância é criada para cada aplicativo ou módulo. A instância contém as informações de implementação para o módulo da Web ou o módulo Enterprise JavaBeans (EJB), incluindo as ligações de cliente.

Antes de Iniciar

Você deve ter os aplicativos de serviço da Web prontos para implementação ou já deve ter implementado o serviço da Web no WebSphere Application Server antes de iniciar esta tarefa.

Para concluir esta tarefa, você deve saber a topologia do endereço do terminal de URL dos servidores de serviços da Web e de qual serviço da Web o cliente depende. É possível visualizar os descritores de implementação no console administrativo para localizar informações de topologia. Para saber mais, consulte os descritores de visualização de implementação do servidor de serviços da Web nas informações do console administrativo.

Para obter informações adicionais sobre as opções da ferramenta wsadmin, consulte as informações sobre opções para os comandos install, installInteractive, edit, editInteractive, update e updateInteractive do objeto AdminApp.

Sobre Esta Tarefa

As ligações do cliente definem o nome do arquivo WSDL (Web Services Description Language) e as portas preferidas. O caminho relativo de um serviço da Web em um módulo é especificado dentro de um arquivo WSDL compatível que contém a URL real a ser usada para pedidos. O endereço é necessário somente se o arquivo WSDL original não contiver uma URL ou se um endereço diferente for necessário. Para um nó de extremidade de serviço com várias portas, é necessário definir um nome de arquivo WSDL alternativo.

As etapas a seguir descrevem como editar ligações para um serviço da Web após estas ligações serem implementadas em um servidor. Quando um serviço da Web se comunica com outro serviço da Web, você deve configurar as ligações do cliente para acessar o serviço da Web de recebimento de dados.

É possível usar a opção da linha de comandos WebServicesClientBindDeployedWsdl nessa tarefa para alterar o nó de extremidade. Um dos benefícios da utilização da opção da linha de comandos é que é possível evitar a desinstalação, modificando os arquivos EAR (Enterprise Archive) e reinstalando aplicativos para fazer mudanças na configuração de ligação. Outro benefício é a capacidade de customizar os aplicativos de ligações de serviços da Web para diferentes ambientes durante a instalação e evitar a necessidade de criar diferentes arquivos EAR de aplicativo para cada versão.

Diversas versões dos arquivos WSDL, cada uma com diferentes terminais de serviço, podem ser fornecidas durante a implementação e a montagem de um módulo de serviço da Web que estiver atuando como um cliente para um serviço da Web. Durante ou após a instalação, quando você estiver configurando o aplicativo instalado, a opção WebServicesClientBindDeployedWsdl pode ser utilizada para especificar quais dos arquivos da WSDL usar.

Como o arquivo da WSDL define todos os nós de extremidade ou implementações de serviço para todos os tipos de portas e as portas que o cliente pode usar, o arquivo WSDL implementado pode agrupar um conjunto de opções em uma WSDL. É possível substituir o nó de extremidade por porta.

É possível usar scripts Jacl ou Jython, mas esta tarefa supõe que você esteja utilizando Jacl. Para obter informações adicionais sobre como implementar e gerenciar usando script, consulte a introdução com informações sobre o script.

Para configurar ligações com o cliente com a ferramenta wsadmin, prossiga com as seguintes etapas:

Procedimento

  1. Ative um comando de script. Para obter informações adicionais, consulte as informações sobre como iniciar o cliente de script wsadmin.
  2. No prompt de comandos de wsadmin, digite a sintaxe do comando. É possível usar as opções install, installInteractive, edit ou editInteractive. O exemplo a seguir apresenta a sintaxe:
    $AdminApp edit <app_name> { 
    -WebServicesClientBindDeployedWsdl {{<nome_do_módulo> <nome_do_EJB> <serviço_da_Web> 
    <nome_do_arquivo_da_WSDL_implementado>}...} 
    O exemplo mostra vários módulos e nós de extremidade de URL porque é possível editar vários fragmentos de URL. onde:
    • app_name é o nome do aplicativo, por exemplo, WebServicesSample.ear
    • module_name é o nome do EJB ou do módulo da Web, por exemplo, AddressBookW2JE.jar
    • EJB_name será o nome do EJB se o módulo não for um módulo da Web, por exemplo, Exchange
    • web_service é o nome do serviço da Web, por exemplo, service/StockQuoteService
    • nome_do_arquivo_da_WSDL_implementado identifica o arquivo WSDL, relativo a este módulo, por exemplo, META-INF/wsdl/AlternativeStockQuoteFetcher.wsdl
  3. Salve as alterações da configuração com o comando $AdminConfig save:

Resultados

Suas ligações de cliente de serviço da Web estão configuradas.

Exemplo

O exemplo a seguir apresenta os nomes do aplicativo, módulo e arquivo WSDL implementado conforme são escritos na linha de comandos:
$AdminApp edit MultiEjbJar {-WebServicesClientBindDeployedWSDL {{ejbclientonly.jar Exchange 
service/StockQuoteService META-INF/wsdl/AlternateStockQuoteFetcher.wsdl}...}} 

O que Fazer Depois

Agora é possível concluir quaisquer outras configurações, iniciar ou reiniciar o aplicativo e verificar o comportamento esperado do serviço da Web.

Í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_clientbindingswsadmin
Nome do arquivo: txml_clientbindingswsadmin.html