O assistente de serviço da web auxilia na criação de um novo serviço
da web, configurando-o para implementação e implementando o serviço da web
em um servidor. Depois que o serviço da web é implementado, o assistente auxilia
na geração do proxy de cliente e do aplicativo de amostra para testar
o serviço da web. Quando você tiver concluído os testes, poderá publicar
seu serviço da web em um UDDI Business Registry usando o assistente de Exportação.
Antes de Iniciar
- Se você estiver usando o WebSphere Application Server, é altamente
recomendado que você inicie o servidor antes de executar o assistente de serviço da web,
porque pode levar vários minutos para iniciar o WebSphere Application Server dependendo
da velocidade de seu computador. Para iniciar o servidor, selecione-o na
visualização Servidores (Janela > Mostrar Visualização > Servidores),
clique com o botão direito e selecione Iniciar.
- Crie ou importe um bean para a pasta de origem Java™
de um projeto da web ou projeto Java.
Para importar, selecione a pasta Recursos Java:
src e, no menu Arquivo, selecione e procure a localização de seu pacote.
Sobre Esta Tarefa
Para criar um serviço da web a partir de um bean usando o ambiente de tempo de execução do IBM® WebSphere JAX-WS:
Procedimento
- Alterne para a perspectiva Java EE
(Janela > Abrir Perspectiva > Java EE).
- Na visualização Enterprise Explorer, selecione o bean que você
criou ou importou para a pasta de origem de seu projeto da web.
- Clique em Arquivo > Novo > Outro. Selecione Serviços da Web
para exibir os diversos assistentes de serviço da web. Selecione o
assistente Serviços da Web. Clique em Avançar.
- Na página Serviços da Web, selecione
Serviço da web Java bean
bottom-up como o tipo do serviço da web. Você pode, opcionalmente, fazer o seguinte:
- Selecione os estágios de desenvolvimento de serviços da web que você
deseja concluir usando a régua de controle. Isso configurará diversos valores padrão
nos painéis restantes do assistente:
- Desenvolver: isto desenvolverá a definição e implementação de WSDL
do serviço da web. Isto inclui tarefas como criar os módulos que irão conter o
código gerado, arquivos WSDL, descritores de implementação e arquivos
Java
quando apropriado.
- Montar: isto assegura que o projeto que hospedará o serviço ou cliente
da web seja associado a um EAR quando requerido pelo servidor do aplicativo
de destino.
- Implementar: isto criará o código de implementação para o serviço.
- Instalar: isto irá instalar e configurar o módulo da Web e EARs no servidor
de destino. Se quaisquer mudanças nos terminais do arquivo WSDL
forem necessárias, elas serão feitas nesse estágio.
- Iniciar: isto iniciará o servidor depois que o serviço tiver sido instalado
nele.
- Testar: isto fornecerá várias opções para testar o serviço,
tal como usar o Generic Services Client, o Web Service Explorer ou
JSPs de amostra.
- Selecione seu tempo de execução do Servidor: o servidor padrão será exibido.
Se desejar implementar o serviço em um servidor diferente, clique no
link do servidor e especifique um servidor diferente.
Esta
tarefa suporta os ambientes de tempo de execução do servidor a seguir:
- WebSphere Application Server V7.0 ou posterior
- WebSphere Application
Server Liberty V8.5.5
- Selecione o tempo de execução do serviço da web: o tempo de execução padrão
será exibido. Para implementar seu serviço para o tempo de execução do IBM WebSphere
JAX-WS, clique no link de tempo de execução e selecione-o na janela que se abre.
- Selecione o projeto de Serviço e o projeto EAR de Serviço:
o projeto selecionado em sua área de trabalho é exibido. Somente projetos da web
com a máscara Java 5,0, Java 6.0, ou Java
7.0 ativada são suportados. Para selecionar um projeto e EAR diferentes,
clique no link do projeto, ou insira um nome e permita que o assistente
crie um projeto para você. Assegure-se
de que o projeto selecionado como o Projeto de Cliente da Web seja diferente do Projeto
de Serviço da Web, ou o serviço será sobrescrito pelos artefatos gerados do cliente.
Para serviços da web JAX-WS, os projetos do servidor e do cliente podem compartilhar
o mesmo EAR.
- Se desejar criar um cliente, selecione o tipo de proxy
a ser gerado e repita as etapas 1 a 4 para o cliente. O
cliente pode ser criado posteriormente usando as etapas descritas em: Gerando um cliente de serviço da web a partir de um documento WSDL usando o ambiente de tempo de execução do IBM WebSphere JAX-WS
- Monitore o serviço da web: isto enviará o tráfego do serviço
da web por meio do Monitor TCP/IP, o que permite observar o
tráfego SOAP gerado pelo serviço da web e testar esse tráfego
para conformidade com WS-I. Como alternativa, é possível configurar manualmente um monitor
TCP/IP conforme descrito em Usando o Monitor TCP/IP para Testar Serviços da Web.
- Configuração de Serviço da Web Bottom-Up do
WebSphere JAX-WS:
Nota: Se o bean já possui uma anotação @javax.jws.WebService,
a maioria dos campos nesta página será desativada, porque o assistente
não precisa gerar um bean delegado para você. Você só será capaz de
selecionar para gerar um arquivo WSDL. Se você tiver incluído apenas o @javax.jws.WebService em seu
Java bean e desejar ativar
outras opções, tais como a ligação SOAP 1.2 ou MTOM, deverá sair
do assistente e remover a anotação ou prosseguir para criar o
serviço da web usando a documentação de anotações. O assistente não permitirá
que você anexe novas anotações em um bean anotado parcialmente
pré-existente.
- Página Configuração da Interface WSDL do WebSphere
JAX-WS: Se, na página anterior,
você selecionou para gerar um arquivo WSDL, esta página será exibida, permitindo
que você configure o arquivo WSDL gerado. É possível configurar o
seguinte:
- Espaço de Nomes de Destino do WSDL
- Nome do serviço do WSDL
- Nome da porta WSDL
- Página Testar Serviço da Web: se você selecionou para testar o serviço
da web, selecione o recurso de teste para o serviço da web gerado e
clique em Ativar. Isso abrirá o serviço da web
no Web Services Explorer ou no Generic Services Client. Selecione a operação que deseja testar, digite as informações
necessárias e clique em Ir. O resultado será exibido na área de janela Status. Clique em Avançar.
- Página Configuração do Cliente de Serviços da Web do WebSphere
JAX-WS: se você tiver selecionado para gerar um cliente, poderá
especificar as seguintes opções para ele nesta página:
- Pasta de Saída: Este é o local no qual o código do cliente
será gerado
- Pacote de Destino: O assistente do cliente de serviço da web gera vários
arquivos Java. Por padrão, ele criará um nome de pacote baseado no espaço de nomes especificado no arquivo WSDL. Para substituir esse comportamento padrão, você pode especificar seu próprio nome de pacote.
- Gerar cliente móvel: A seleção dessa caixa de seleção permitiria
que você movesse seu código do cliente de serviço da web de uma máquina
para outra ou de uma instância do WebSphere
Application Server para outra. Se essa opção estiver selecionada, o documento WSDL e
todo o Esquema XML e outros documentos WSDL dos quais ele depende
serão copiados no projeto do cliente em WEB-INF/wsdl e um file:relativeURL apontando
para essa cópia será, então, injetado no bloco de inicialização estático
da classe de Serviço do JAX-WS.
- Ativar chamada assíncrona para cliente gerado: Se você selecionar
para ativar um cliente assíncrono, para cada método no serviço da web,
dois métodos adicionais serão criados. Esses são os métodos de sondagem e retorno de chamada que permitem que o cliente funcione assincronamente.
- Especificar arquivos de ligação do JAX-WS ou JAXB: Se você tiver criado arquivos
de ligação customizada JAX-WS ou JAXB, selecione essa caixa de seleção para usá-los
para criar o cliente de serviço da web. Se isto for selecionado, a próxima página do
assistente permitirá que você procure os arquivos de declaração de ligação
customizada.
- Customizar o nome da classe de proxy de cliente: Selecione essa caixa de seleção se
desejar mudar o nome da porta padrão para o mapeamento de nome da classe
de implementação do serviço
- A página Declarações de Ligação Customizadas: Se você tiver selecionado
para especificar arquivos de ligação JAX-WS ou JAXB, poderá procurar os arquivos
nessa página.
- Página Configuração de Geração de Proxy: Para cada porta definida,
é possível inserir um nome para a classe de proxy ou aceitar o padrão.
- Página de Teste do Cliente de Serviços da Web:
- Testar o proxy gerado: Se selecionado, o cliente de amostra
será ativado em um navegador da web, permitindo que você teste a funcionalidade.
- Selecione o recurso de teste.É possível testar o proxy gerado no cliente de serviço genérico ou no Web Service Explorer ou gerar e usar os JSPs de amostra do JAX-WS 2.0.
- Pasta: Se você selecionou para testar o proxy por meio de uma JSP, poderá
selecionar a pasta na qual a JSP estará localizada e você poderá selecionar
os métodos que serão incluídos na JSP.
- Métodos: Selecionar os métodos a serem expostos. Se você selecionou para ativar
chamada assíncrona, os métodos assíncronos deverão ser listados
também.
- Executar Teste no Servidor: isso iniciará o servidor para você automaticamente.
Resultados
Depois que o serviço da web tiver sido criado, o seguinte poderá
ocorrer, dependendo das opções selecionadas:
- Se você tiver selecionado para testar o proxy gerado usando JSPs do
serviço da web, o proxy será ativado em um navegador da web na seguinte URL: http://localhost:port/WebProjectClient/amostraBeanName/WebServiceName/TestClient.jsp É
possível usar esse aplicativo de amostra para testar o serviço da web selecionando
um método, inserindo um valor para o método e clicando em Chamar.
O resultado do método
será exibido na área de janela de resultados.
- Se você tiver selecionado para testar o proxy gerado usando o cliente
de teste universal, ele será ativado em uma janela do navegador em uma URL semelhante
à seguinte: http://localhost:port/UTC/preload?object=BeanPackage.BeanServiceProxy.
Em Objetos, expanda o stub de proxy para exibir os métodos do
serviço da web. Clique no método que você deseja testar, insira um valor
na área de janela Parâmetros e clique em Chamar. O resultado
será gerado automaticamente.
- Se você tiver selecionado para testar o serviço da web usando o Web Services
Explorer, o Explorer será aberto. Selecione a operação que deseja
testar, digite as informações necessárias e clique em Ir.
O resultado será exibido na área de janela Status.
Restrição: Ao gerar um serviço da web JAX-WS
a partir de um arquivo de classe que depende de outras classes contidas em
arquivos JAR separados, o projeto precisa fazer referência a esses arquivos jar externos
ou a partir das Dependências do Módulo Java EE
ou de Bibliotecas de Usuário. A utilização de dependências do Módulo Java EE é possível quando
os jars estão contidos no projeto EAR.
No caso em que
os jars fazem parte de uma Biblioteca Compartilhada configurada no WebSphere Application Server, uma Biblioteca
de Usuário deve ser usada para configurar o projeto para desenvolvimento antes de
gerar o serviço da web. Para incluir uma biblioteca de usuário no projeto:
- Clique com o botão direito no projeto e clique em
- Clique em
- Crie uma biblioteca de usuário e inclua seu jar do utilitário nela.