Desenvolvendo um Arquivo WSDL para Aplicativos JAX-RPC

É possível desenvolver um arquivo Web Services Description Language (WSDL) para descrever as características do seu aplicativo de serviços da Web Java™ API for XML-based RPC (JAX-RPC) incluindo onde o serviço reside e como chamar o serviço usando um formato XML.

Antes de Iniciar

Dependendo de seu caminho de desenvolvimento, desenvolva uma interface de terminal em serviço a partir de uma implementação de JavaBeans ou desenvolva uma interface de terminal em serviço a partir de uma implementação de enterprise bean.

Sobre Esta Tarefa

Você precisa de um arquivo WSDL para utilizar serviços da Web. É possível desenvolver o seu próprio arquivo WSDL ou obter um de um provedor de serviços da Web por meio de email, download, ou de uma Uniform Resource Locator (URL). Esta documentação supõe que você esteja criando seu próprio arquivo WSDL.

Desenvolva um arquivo WSDL seguindo as ações listadas:

Procedimento

  1. [IBM i]Execute o comando STRQSH (Start Qshell) para iniciar o Qshell.
  2. [IBM i]Atualize a variável de ambiente CLASSPATH para incluir o local da classe de interface do terminal de serviço e outras classes referidas, por exemplo:
    export -s CLASSPATH=/myapp/myclass.class:/myapp/myjar.jar
  3. [AIX Solaris HP-UX Linux Windows][z/OS]Configure a classe da interface do terminal de serviço e as classes referidas em sua variável CLASSPATH.
    • Em sistemas Windows, configure CLASSPATH="%CLASSPATH%;<listar seus arquivos JAR (Java archive) e classes>".
    • Em sistemas UNIX e Linux, exporte CLASSPATH="$CLASSPATH:<listar os arquivos JAR e classes do aplicativo>".
  4. Execute o comando Java2WSDL seiInterface. Um arquivo WSDL denominado seiInterface.wsdl é criado.
    Configurações suportadas Configurações suportadas: A ferramenta de linha de comandos Java2WSDL não é suportada na plataforma z/OS. Esta funcionalidade é fornecida pelas ferramentas de montagem fornecidas com a versão z/OS do produto. Consulte a ferramenta de linha de comandos Java2WSDL para aplicativos JAX-RPC (Java API for XML-based Remote Procedure Call) para obter informações adicionais sobre essa ferramenta.sptcfg
    • Mova o arquivo WSDL para o subdiretório META-INF/wsdl se estiver usando o EJB (Enterprise JavaBeans).
    • Mova o arquivo WSDL para o subdiretório WEB-INF/wsdl se estiver usando JavaBeans.
  5. Edite o arquivo WSDL gerado e inspecione os nomes das partes. As partes do WSDL possuem nomes como arg_0_0. Modifique o arquivo WSDL para usar os nomes reais dos parâmetros Java.
  6. (Opcional) Utilize a ferramenta de comando Java2WSDL para gerar os nomes de partes corretos do arquivo WSDL. É possível gerar e definir automaticamente os nomes das partes corretas, utilizando a ferramenta de comando Java2WSDL. A geração e a configuração dos nomes de parte são feitas fornecendo informações adicionais para a ferramenta de comando Java2WSDL no formato de uma classe de implementação Java, que implementa os mesmos métodos da interface do terminal de serviço, sendo compilada com as informações de depuração ativadas. Os nomes dos parâmetros são armazenados no arquivo .class com as informações de depuração. Se sua classe de implementação for compilada com a depuração ativada, é possível usar o comando Java2WSDL -implClass seiImpl seiInterface para gerar um arquivo WSDL com os nomes de partes apropriados.

Resultados

Um arquivo WSDL que define os serviços da Web descritos pela interface de terminal em serviço.

Exemplo

Este exemplo utiliza o nome do arquivo JAR, AddressBook.jar, que contém uma classe denominada arquivo de classe AddressBook.class.

É preciso incluir o arquivo AddressBook.jar ao CLASSPATH para criar o arquivo WSDL. O arquivo JAR contém uma classe de implementação EJB compilada com as informações de depuração ativadas. Execute o comando Java2WSDL -implClass addr.AddressBookBean addr.AddressBook para criar o arquivo AddressBook.wsdl.

O que Fazer Depois

Dependendo de seu caminho de desenvolvimento, desenvolva modelos de descritor de implementação para o JavaBeans ou desenvolva modelos de descritor de implementação de serviços da Web para uma implementação de enterprise beans.

Í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_wsdl
Nome do arquivo: twbs_wsdl.html