Criando a estrutura básica de um Java bean a partir de um documento WSDL utilizando o ambiente de tempo de execução do WebSphere JAX-WS

O assistente de serviço da web auxiliar na criação de um bean de estrutura básica a partir de um documento WSDL existente. O bean de esboço contém um conjunto de métodos que correspondem às operações descritas no documento WSDL. Quando o bean é criado, cada método tem uma implementação trivial que você substitui editando o bean.

Antes de Iniciar

Pré-requisitos:
  • 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 descubra e importe um documento WSDL em um projeto. É possível usar um arquivo WSDL que contém um elemento de serviço.

Sobre Esta Tarefa

Para criar a estrutura básica de um Java™ bean a partir de um documento WSDL usando o ambiente de tempo de execução do WebSphere JAX-WS:

Procedimento

  1. Alterne para a perspectiva do Java EE (Janela > Perspectiva aberta > Java EE).
  2. Na visualização Enterprise Explorer, selecione o arquivo WSDL que foi criado ou importado.
  3. Clique em File (Arquivo) > New (Novo) > Other (Outro). Selecione Serviços da web para exibir os vários assistentes de serviços da web. Selecione o assistente Serviços da Web. Clique em Avançar.
  4. Página de Serviços da web: selecione Serviço da web de Java bean top-down como o tipo de serviço da web. Também é possível optar por 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. Página de Configuração de Serviço da Web De Cima para Baixo do WebSphere JAX-WS:
    • Pasta de saída: Insira o local no qual a estrutura básica Java foi gerada ou aceite o padrão.
    • Pacote de destino: Insira o nome do pacote do Java gerado ou aceite o padrão.
    • Ativar o estilo do wrapper: Ativa o mapeamento do estilo do wrapper do WSDL para o Java. Para documentos WSDL que implementam um padrão agrupado de documentos/literais, um elemento-raiz é declarado no esquema XML e é utilizado como um wrapper de operação para um fluxo de mensagens. Existem definições de elemento de wrapper separadas para o pedido e para a resposta. O elemento cujo nome é igual ao da operação (o elemento wrapper) é dividido, para que cada um de seus elementos de conteúdo se torne um parâmetro da assinatura de método Java gerada.
    • Gerar classes JAXB serializáveis: no WebSphere Application Server e no WebSphere Application Server Liberty V8.5.5, ao ativar a máscara Java 6, é possível optar por gerar classes JAXB, que implementam java.io.Serializable. As classes que não implementam essa interface não têm seus estados serializados ou desserializados.
    • Ativar o suporte a MTOM: Ao marcar essa caixa de seleção, o Message Transmission Optimization Mechanism SOAP será ativado para otimizar a transmissão de conteúdo binário. Para obter mais informações sobre o MTOM leia a Visão geral do MTOM
    • Versão do código JAX-WS a ser gerado: O WebSphere Application Server V7.0, suporta um código compatível com o JAX-WS 2.0 ou 2.1. O WebSphere Application Server V8.0, V8.5 e WebSphere Application Server Liberty V8.5.5, suportam o código compatível com o JAX-WS 2.0, 2.1 ou 2.2.
    • Copiar WSDL no projeto: Selecione para copiar o arquivo WSDL no projeto de serviço ou o WSDL requerido será gerado dinamicamente pelo tempo de execução, quando necessário. Essa opção é conveniente caso você planeje criar o cliente posteriormente ou publicar o WSDL para outros usuários.
    • Gerar classes JAXB serializáveis: no WebSphere Application Server e no WebSphere Application Server Liberty V8.5.5, ao ativar a máscara Java 6, é possível optar por gerar classes JAXB, que implementam java.io.Serializable. As classes que não implementam essa interface não têm seus estados serializados ou desserializados.
    • Especificar arquivos de ligação do JAX-WS ou JAXB: Se você tiver criado arquivos de ligação customizados JAX-WS ou JAXB, marque essa caixa de seleção para utilizá-los para criar esse serviço da web. Se essa caixa de seleção for marcada, a próxima página do assistente permitirá que você procure os arquivos de declaração de ligação customizados.
    • Customizar nome da classe de implementação de serviço: Marque essa caixa de seleção se quiser mudar o nome da porta padrão para o mapeamento de nome de classe da implementação de serviço.
    • Gerar biblioteca de esquema: permite a geração de um código de esquema em uma biblioteca de esquema. Ao selecionar uma biblioteca de esquema, em uma página posterior, será possível customizar os mapeamentos entre documentos XSD ou grupos de documentos XSD em um projeto.
    • Gerar descritor de implementação de serviço da web: Para a implementação de serviços da web do JAX-WS as informações são geradas dinamicamente pelo tempo de execução; não é mais necessário usar descritores de implementação estáticos; eles são gerados por meio da marcação dessa caixa de seleção.
    • 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.
  6. Dependendo das opções escolhidas na página anterior, pode ser solicitado que você customize a implementação do serviço da web nas seguintes páginas:
    1. Página Declarações de ligação customizadas: Ao optar por especificar arquivos de ligação do JAX-WS ou do JAXB, é possível procurar os arquivos nessa página.
    2. Página Configuração da implementação de serviço: Para cada porta definida no arquivo WSDL, é possível inserir um nome para a classe de implementação de serviço ou aceitar o padrão.
    3. Página Configuração do projeto de esquema: Ao optar por gerar uma biblioteca de esquema, use essa página para customizar os mapeamentos entre documentos e projetos XSD. Esse recurso funciona se todas as dependências de esquema estiverem em targetNamespaces diferentes; caso contrário, haverá erros de compilação em ObjectFactory.java.
  7. Página Testar serviço da web: Ao optar por testar o serviço da web, selecione o recurso de teste para o serviço da web gerado e clique em Ativar. Isso abre o serviço da web no Web Services Explorer ou no Cliente de serviços genéricos. Selecione a operação a ser testada, insira as informações necessárias e clique em Ir. O resultado é mostrado 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: Ao optar por gerar um cliente, é possível especificar as seguintes opções para ele nesta página:
    • Pasta de saída: O local onde o código do cliente é gerado
    • Pacote de destino: O assistente do cliente de serviços da web gera vários arquivos Java. Por padrão, ele cria um nome de pacote baseado no namespace especificado no arquivo WSDL. Para substituir esse comportamento padrão, é possível especificar seu próprio nome de pacote.
    • Gerar cliente móvel: marque essa caixa de seleção para mover o código do cliente de serviço da web de uma máquina para outra ou de uma instância do WebSphere Application Server ou do WebSphere Application Server Liberty V8.5.5 para outra. Se essa opção for selecionada, o documento WSDL e todo o esquema XML e outros documentos WSDL dos quais ele depende serão copiados para o projeto do cliente em WEB-INF/wsdl e uma file:relativeURL, apontando para essa cópia, será então injetada no bloco de inicialização estática da classe de serviço do JAX-WS.
    • Ativar chamada assíncrona para o cliente gerado: Ao optar por ativar um cliente assíncrono, para cada método no serviço da web, dois outros métodos serão criados. Esses são métodos de pesquisa e de retorno de chamada, que permitem que o cliente funcione de forma assíncrona.
    • Especificar arquivos de ligação do JAX-WS ou do JAXB: Se você tiver criado arquivos de ligação customizados do JAX-WS ou do JAXB, marque essa caixa de seleção para utilizá-los para criar o cliente de serviço da web. Se essa caixa de seleção for marcada, a próxima página do assistente permitirá que você procure os arquivos de declaração de ligação customizados.
    • Customizar nome da classe de proxy do cliente: Marque essa caixa de seleção se quiser mudar o nome da porta padrão para o mapeamento de nome da classe de implementação de serviço
  9. Página Declarações de ligação customizadas: Ao optar por especificar arquivos de ligação do JAX-WS ou do JAXB, é possível procurar os arquivos nessa página.
  10. Página Configuração da implementação de serviço: Página Configuração da 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 é iniciado em um navegador da web que permite testar a função.
    • 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: Ao optar por testar o proxy por meio de um JSP, é possível selecionar a pasta na qual o JSP está localizado e é possível selecionar os métodos que serão incluídos no JSP.
    • Métodos: Selecionar os métodos a serem expostos. Ao optar por ativar a chamada assíncrona, os métodos assíncronos também serão listados.
    • Executar teste no servidor: Inicia o servidor automaticamente.

Resultados

Após a criação do serviço da web, pode ocorrer o seguinte, dependendo das opções selecionadas:
  • O bean de implementação é aberto no editor Java. Isso contém o código de estrutura básica que pode ser usado para testar a função básica do serviço da web ou é possível implementar a lógica de negócios necessária para o serviço antes de testá-lo.
  • Ao optar por testar o proxy gerado utilizando JSPs do JAX-WS 2.0, o proxy será iniciado em um navegador da web na seguinte URL:http://localhost:port/WebProjectClient/sampleBeanName/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 é exibido na área de janela de resultados. Como essa é a estrutura básica de um Java bean com implementação de método trivial, um valor de -3 é retornado.
  • Ao optar por testar o proxy gerado usando o cliente de teste universal, ele será iniciado 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 a ser testado, insira um valor na área de janela Parâmetros e clique em Chamar. O resultado é gerado e exibido.
  • Ao optar por testar o serviço da web usando o Web Services Explorer, o Explorer será aberto. Selecione a operação a ser testada, insira as informações necessárias e clique em Ir. O resultado é exibido na área de janela Status.
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: tsklwsdljaxws.html