Desenvolvendo Ligações do Cliente a partir de um Arquivo WSDL para um Cliente de Serviços da Web JAX-RPC

É possível desenvolver ligações de cliente a partir de um arquivo Web Services Description (WSDL) para um cliente de serviços da Web JAX-RPC.

Antes de Iniciar

Para desenvolver as ligações de cliente a partir de um arquivo WSDL para aplicativos de serviço da Web, você deve obter a Uniform Resource Locator (URL) do arquivo WSDL a usar. Você precisa de ligações e descritores de implementação para que um cliente use um serviço da Web.

[Windows][z/OS]Se o arquivo WSDL for um arquivo local, a URL será semelhante ao seguinte exemplo: file:drive:\path\file_name.wsdl.

[Linux][AIX][HP-UX][Solaris][IBM i]Se o arquivo WSDL for um arquivo local, a URL será semelhante ao seguinte exemplo: file:/path/file_name.wsdl.

Você também pode especificar os arquivos locais utilizando o caminho do sistema de arquivos absoluto ou relativo.

As ligações de cliente são geradas usando a opção -role develop-client em conjunto com a opção -container do comando WSDL2Java . A opção -container usa os seguintes parâmetros:
  • -container client

    Gera ligações e descritores de implementação para um cliente que reside no contêiner de cliente aplicativo.

  • -container ejb

    Gera ligações e descritores de implementação para um cliente que é um enterprise bean no módulo Enterprise JavaBeans (EJB).

  • -container web

    Gera ligações e descritores de implementação para um cliente que reside no contêiner da Web.

[z/OS]A ferramenta de linha de comandos WSDL2Java não é suportada na plataforma z/OS. Esta funcionalidade é fornecida pelas ferramentas de montagem fornecidas com a versão z/OS do produto. Leia sobre a ferramenta de linha de comandos WSDL2Java para aplicativos Java™ API for XML-based Remote Procedure Call (JAX-RPC) para saber mais sobre essa ferramenta.

Sobre Esta Tarefa

Desenvolva ligações de cliente de um aplicativo WSDL executando o comando apropriado.

Boas Práticas Boas Práticas: Recomenda-se usar espaços de nomes absolutos em seu WSDL ou esquema. Por padrão, a ferramenta WSDL2Java não permite o uso de espaços de nomes relativos. Espaços de nomes relativos foram reprovados pelo XML Plenary Interest Group e o uso de espaços de nomes relativos faz com que a Assinatura Digital XML falhe, como requerido pela especificação do Canonical XML Versão 1.0. Você pode converter qualquer espaço de nome relativo em espaço de nome absoluto. Para obter mais informações sobre como usar o espaço de nomes com a ferramenta WSDL2Java, consulte o comando WSDL2Java para obter a documentação de aplicativos JAX-RPC. bprac

Procedimento

Execute o comando WSDL2Java -verbose -role develop-client -container type wsdlURL,

em que type é ejb para um cliente enterprise EJB, web para um cliente JavaBeans ou client para um aplicativo cliente.

É possível utilizar as seguintes combinações na linha de comandos:
  • -container web
  • -container ejb
  • -container client
Como a opção verbose é especificada, uma lista de todos os arquivos gerados é exibida quando o comando é executado.

Resultados

Você tem as ligações e descritores de implementação que um cliente precisa para usar um serviço da Web.

Exemplo

O exemplo a seguir utiliza o enterprise bean AddressBook e o arquivo da WSDL AddressBook.wsdl. Depois de gerar as ligações a partir do comando WSDL2Java -verbose -role develop-client -container client AddressBook.wsdl , os seguintes arquivos são gerados:
Parsing XML file:  file:e:/example/app/topdown/step1/AddressBook.wsdl 
WSWS3185I: Info: Parsing XML file:  AddressBook.wsdl
WSWS3282I: Info: Generating addr\Address.java.
WSWS3282I: Info: Generating addr\Phone.java.
WSWS3282I: Info: Generating addr\StateType.java.
WSWS3282I: Info: Generating addr\AddressBook.java.
WSWS3282I: Info: Generating addr\AddressBookService.java.
WSWS3282I: Info: Generating META-INF\ibm-webservicesclient-bnd.xmi.
WSWS3282I: Info: Generating META-INF\AddressBook_mapping.xml.
WSWS3282I: Info: Generating META-INF\ibm-webservicesclient-ext.xmi.

O que Fazer Depois

Conclua a implementação do cliente gravando seu aplicativo cliente e, em seguida, montando os artefatos do cliente.

.

Í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=twbs_devclientbindings
Nome do arquivo: twbs_devclientbindings.html