Criando um serviço da web a partir de um Java bean usando o ambiente de tempo de execução do IBM WebSphere JAX-WS

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 Importar > Geral > Sistema de Arquivos 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

  1. Alterne para a perspectiva Java EE (Janela > Abrir Perspectiva > Java EE).
  2. Na visualização Enterprise Explorer, selecione o bean que você criou ou importou para a pasta de origem de seu projeto da web.
  3. 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.
  4. 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:
    1. 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.
    2. 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
    3. 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.
    4. 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.
    5. 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
    6. 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.
  5. Configuração de Serviço da Web Bottom-Up do WebSphere JAX-WS:
    • Delegar nome de classe: Insira o nome de classe da implementação de Java delegada ou aceite o padrão. A classe delegada é um wrapper que contém todos os métodos do Java bean, bem como a anotação JAX-WS que o tempo de execução reconhece como um serviço da web. Ela é gerada no mesmo pacote que o bean original.
    • Estilo de mapeamento de Java para WSDL: O estilo define o estilo de codificação para as mensagens enviadas para e a partir do serviço da web. O estilo de parâmetro determina se os parâmetros do método representam todo o corpo da mensagem ou se os parâmetros são elementos agrupados dentro de um elemento de nível superior denominado após a operação. As combinações válidas são RPC, Documento/Agrupado ou Documento/Vazio.
    • Gerar anotações @WebParam para parâmetros de métodos: Se você selecionar essa caixa de seleção, os parâmetros em uma declaração de método terá a anotação @WebParam configurada para os respectivos argumentos. A anotação @WebParam customiza o mapeamento de um parâmetro individual para uma parte da mensagem de serviço da Web e um elemento XML. Para obter mais detalhes sobre a anotação @WebParam, procure javax.jws.WebParam no tópico Anotações do JAX-WS disponível no Centro de Informações para o WebSphere Application Server.
      Dica: É possível ativar essa opção por padrão na página Preferência, indo para a barra de ferramentas e selecionando Janela > Preferências > WebSphere > Geração de Códigos do JAX-WS. Selecione a caixa de seleção Gerar anotações @WebParam para parâmetros de método sob a seção De Baixo para Cima.
    • Ative a ligação SOAP 1.2: Se você não selecionar essa opção, as ligações SOAP 1.1 serão usadas. Para obter informações adicionais sobre as diferenças entre SOAP 1.1 e 1.2, consulte : Visão Geral de SOAP
    • Ativar o suporte a MTOM: Se você selecionar essa caixa de opção, o SOAP Message Transmission Optimization Mechanism será ativado para otimizar a transmissão de conteúdo binário. Para obter mais informações sobre o MTOM, consulte: Visão Geral de MTOM
    • Gerar arquivo WSDL para o projeto: Como as anotações na classe delegada são usadas para informar ao tempo de execução que o bean é um serviço da web, um arquivo WSDL estático não é mais gerado para seu projeto automaticamente. O tempo de execução pode gerar dinamicamente um arquivo WSDL a partir de informações no bean. Selecione essa opção para gerar um arquivo WSDL estático para o serviço da web. Esta é uma opção conveniente se você planeja criar o cliente em um momento posterior ou publicar o WSDL para outros usuários. Você pode configurar o WSDL utilizando a próxima página do assistente.
    • Gerar Descritor de Implementação de Serviço da Web: Para a implementação dos serviços da web JAX-WS, as informações são geradas dinamicamente pelo tempo de execução; descritores de implementação estáticos não são mais necessários. Selecionar essa caixa de seleção irá gerá-los.
    • Permitir extensões do fornecedor: Se você selecionar essa caixa de seleção, a opção -extension será incluída no comando wsgen ou wsimport. A opção -extension especifica se deve-se ativar ou aceitar extensões customizadas para a funcionalidade não determinada pela especificação JAX-WS. O uso das extensões pode resultar em aplicativos não portáteis ou que não interoperam com outras implementações. Para obter detalhes, consulte os tópicos Comando wsgen para aplicativos JAX-WS e Comando wsimport para aplicativos JAX-WS disponíveis no Centro de Informações para o WebSphere Application Server.
    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.
  6. 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
  7. 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.
  8. 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
  9. 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.
  10. 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.
  11. 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:
  1. Clique com o botão direito no projeto e clique em Propriedades > Caminho de Construção Java > Bibliotecas
  2. Clique em Incluir Biblioteca > Biblioteca de Usuário > Bibliotecas de Usuário
  3. Crie uma biblioteca de usuário e inclua seu jar do utilitário nela.
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: twsbeanjaxws.html