É 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
Execute o comando STRQSH (Start Qshell) para iniciar o Qshell.
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
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
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>".
- Execute o comando Java2WSDL seiInterface. Um
arquivo WSDL denominado seiInterface.wsdl é criado.
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.
- 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.
- (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.