Criando uma estrutura básica de enterprise bean (EJB) a partir de um documento WSDL usando o ambiente de tempo de execução do WebSphere JAX-WS

O assistente de serviço da web ajuda na criação de um bean de estrutura básica 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. Você só pode utilizar um arquivo WSDL que contenha um elemento de serviço.
    Nota: Os serviços da web SOAP sobre JMS são suportados para o WebSphere Application Server V8.0 ou posterior; no entanto, o suporte não está disponível para o WebSphere Application Server Liberty. Se você deseja usar SOAP sobre JMS, o arquivo WSDL deve usar um dos valores de URI do atributo de transporte a seguir:
    • http://www.w3.org/TR/soapjms/
    • http://www.w3.org/2010/soapjms/
    Para obter mais informações sobre declarações do SOAP sobre JMS em arquivos WSDL, consulte as especificações em: SOAP sobre Java™ Message Service 1.0: Rascunho de Serviço
  • Criar um projeto EJB e incluí-lo em um novo projeto EAR.
  • Criar um projeto da web vazio se você estiver usando SOAP sobre HTTP como seus métodos de transporte, ou um projeto EJB se você estiver usando SOAP sobre JMS como seu método de transporte, para agir como o projeto de roteador. O projeto que você cria deve ser incluído no mesmo EAR que o projeto EJB que contém o enterprise bean. Para obter mais informações sobre módulos do roteador, consulte Criando módulos do roteador.
  • Se desejar usar SOAP sobre JMS, você deverá criar um servidor e uma configuração do servidor para JMS, conforme descrito em Criar um servidor e uma configuração do servidor para SOAP sobre JMS.

Sobre Esta Tarefa

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

Procedimento

  1. Alterne para a perspectiva Java EE (Janela > Abrir Perspectiva > Java EE).
  2. Na visualização Enterprise Explorer, selecione o arquivo WSDL que foi criado ou importado.
  3. Clique em Arquivo > New > Other . Selecione Web Services (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. Página Serviços da Web: selecione Serviço da Web EJB top-down 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 utilizando a régua de controle. Isso configurará diversos valores padrão nos painéis restantes do assistente:
      • Desenvolver: isto desenvolverá a implementação e definição do 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 cliente ou serviço da Web seja associado a um EAR quando exigido pelo servidor de aplicativos 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 o servidor: o servidor padrão é exibido. Se desejar implementar seu serviço em um servidor diferente, clique no link do servidor e especifique um servidor diferente.
    3. Selecione o tempo de execução: o tempo de execução padrão é exibido. Para implementar o serviço no tempo de execução do IBM® JAX-WS, clique no link de tempo de execução e selecione-o na janela que se abre.
      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
    4. Selecione o projeto do serviço: o projeto selecionado no espaço de trabalho é exibido. Apenas projetos EJB 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 do JAX-WS, o servidor e projetos 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 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. Monitorar o serviço da Web: isto enviará o tráfego do serviço da Web através 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.
    7. Publicar o Serviço da Web.
  5. Página Configuração de Serviço da Web EJB Top-Down do WebSphere JAX-WS:
    • Pasta de Saída: Insira o local no qual a estrutura básica EJB gerada será gerada ou aceite o padrão.
    • Pacote de destino: Insira o nome do pacote para o Java gerado ou aceite o padrão.
    • Ligação de serviço da Web EJB: selecione se seu serviço da web usará ligações HTTP ou JMS.
    • 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. De maneira mais simples, o elemento cujo nome é o mesmo que a operação (o elemento wrapper) é detalhado para que cada um de seus elementos de conteúdo se torne um parâmetro da assinatura do método Java gerada.
    • 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 do MTOM
    • Versão do código JAX-WS a ser gerado: o WebSphere Application Server tradicional V7.0 suporta o código compatível com o JAX-WS 2.0 ou 2.1. O WebSphere Application Server tradicional V8.0, V8.5 e WebSphere Application Server Liberty V8.5.5 suporta o código compatível com o JAX-WS 2.0, 2.1 ou 2.2.
    • Copiar WSDL no projeto: Selecione essa opção para copiar o arquivo WSDL no projeto de serviço, ou se o WSDL requerido será gerado dinamicamente pelo tempo de execução quando necessário. Esta é uma opção conveniente se você planeja criar o cliente em um momento posterior ou publicar o WSDL para outros usuários.
    • Gerar classes JAXB serializáveis: no WebSphere Application Server tradicional e 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 terão nenhum de seus estados seriados ou desserializados.
    • Especificar arquivo 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 opção para utilizá-los para criar este serviço da Web. Se isto for selecionado, a próxima página do assistente permitirá que você navegue para os arquivos de declaração de ligação customizada.
    • Customizar nome da classe de implementação do serviço: Selecione essa caixa de seleção se desejar mudar o nome da porta padrão para o mapeamento de nome de classe de implementação de serviço.
    • Gerar biblioteca de esquema: isto permite gerar código de esquema em uma biblioteca de esquema. Se você selecionar uma biblioteca de esquema, em uma página posterior, você poderá customizar os mapeamentos entre os documentos ou grupos XSD de documentos XSD em um projeto.
    • Gerar descritor de implementação do serviço da Web: Para implementação de serviços da Web do 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 opçã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.
  6. Dependendo das opções escolhidas na página anterior, poderá ser solicitado que você customize a implementação do serviço da web nas páginas a seguir:
    1. Página Configuração de Ligação JMS do WebSphere JAX-WS: se você selecionou para seu serviço da web usar JMS como seu método de transporte, precisará inserir informações sobre a ligação nesta página.
      • Destino JMS: Selecione fila ou tópico como seu tipo de destino.
      • Nome JNDI de Destino: O nome JNDI da fila ou do tópico de destino.
      • Connection Factory do JMS: O nome JNDI da Connection Factory.
      • Nome do factory de contexto inicial: O nome do factory de contexto inicial a ser usado. Ele é mapeado para a propriedade java.naming.factory.initial.
      • URL do provedor JNDI: Ela é mapeada para a propriedade java.naming.provider.url.
      • Modo de entrega: Indica se a mensagem de solicitação deve ser persistente ou não.
      • Tempo de vida da mensagem de solicitação: O tempo de vida em milissegundos da mensagem de solicitação. Um valor 0 indica um tempo de vida infinito.
      • Prioridade da mensagem de solicitação do JMS: A prioridade do JMS associada à mensagem de solicitação. 0 é a prioridade mais baixa e 9 é a prioridade mais alta.
      • Nome de resposta: O nome do componente de porta ao qual a solicitação será despachada.
      • ID do usuário da connection factory: O ID do usuário a ser usado para obter acesso à connection factory.
      • Senha da connection factory: A senha a ser usada para obter acesso à connection factory.
      • Use o protocolo de interoperabilidade SOAP/JMS: Selecionar isso assegura que o serviço da web seja compatível com o protocolo descrito pelo W3C SOAP-JMS Binding Working Group. Para obter mais informações, consulte este site: Licença do SOAP-JMS Binding Working Group
      • Definir propriedades JMS customizadas: Selecionar isso ativará uma página, permitindo que você insira pares de valores da propriedade.
    2. Página das Declarações de Ligação Customizada: Se você tiver selecionado para especificar arquivos de ligação JAX-WS ou JAXB, poderá procurar os arquivos nessa página.
    3. Página Configuração da Implementação de Serviço: Para cada porta definida no arquivo WSDL, você pode inserir um nome para a classe de implementação de serviço ou aceitar o padrão.
    4. Página de configuração do projeto de esquema: Se você selecionou para gerar uma biblioteca de esquema, use esta página para customizar os mapeamentos entre os documentos e projetos XSD. Este recurso funcionará somente se todas as dependências do esquema estiverem em targetNamespaces diferentes; caso contrário, haverá erros de compilação em ObjectFactory.java.
  7. Página Configuração do Projeto de Roteador JAX-WS do WebSphere: Esta página é exibida quando o destino é o ambiente de tempo de execução do servidor do WebSphere Application Server, mas não o WebSphere Application Server Liberty V8.5.5.
    • Roteador HTTP: insira o nome do projeto que você deseja usar como o módulo roteador. Um módulo roteador fornece um terminal de serviço da web para um transporte específico.
    • Roteador JMS: insira o nome do projeto que você deseja usar como o módulo roteador. Um módulo roteador fornece um terminal de serviço da web para um transporte específico.
    • Mecanismo de implementação MDB: selecione a partir da especificação de ativação JMS ou da porta do listener como seu mecanismo de implementação do bean acionado por mensagens.
    • Nome JNDI da ActivationSpec: digite o nome JNDI da especificação de ativação que deve ser usado para implementar esse bean acionado por mensagens. Esse nome deve corresponder ao nome de uma especificação de ativação que você define para o WebSphere Application Server
    • Nome da porta de entrada do listener: insira o nome da porta do listener do módulo roteador.
  8. Página Testar Serviço da Web: se você selecionou para testar o serviço da web a partir da etapa 4a, 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 Generic Services Client. Observe que você pode usar somente o Web Services Explorer para testar serviços da web que usam transportes HTTP. 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.
  9. Página Configuração do Cliente de Serviço da Web JAX-WS do WebSphere: se você tiver selecionado para gerar um cliente, poderá especificar as opções a seguir 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ços 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 marcação dessa caixa de seleção permite 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 estiver 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 sob WEB-INF/wsdl e um file:relativeURL apontando para essa cópia será, então, injetado no bloco de inicialização estática 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 opçã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ê navegue para os arquivos de declaração de ligação customizada.
    • Customizar 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 do nome da classe de implementação do serviço
    • Gerar descritor de implementação do serviço da web: Para obter serviços da web JAX-WS, informações de implementação são geradas dinamicamente pelo tempo de execução; descritores de implementação estáticos não são mais necessários. Selecionar essa opção irá gerá-los.
    • Versão do código JAX-WS a ser gerado: Para o WebSphere Application Server V7.0, você tem a opção de gerar código compatível com JAX-WS 2.0 ou 2.1. Para o WebSphere Application Server V8.0, V8.5 e WebSphere Application Server Liberty V8.5.5, existe a opção de gerar um código compatível com o JAX-WS 2.0, 2.1 ou 2.2.
  10. Página das Declarações de Ligação Customizada: Se você tiver selecionado para especificar arquivos de ligação JAX-WS ou JAXB, poderá procurar os arquivos nessa página.
  11. Página de configuração de implementação do serviço: Página de Configuração de Geração de Proxy: Para cada porta definida, você pode inserir um nome para a classe de proxy ou aceitar o padrão.
  12. 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 testar o proxy por meio de uma JSP, poderá selecionar a pasta na qual a JSP estará localizada e 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 a 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

Após o serviço da web ter sido criado, o seguinte pode ocorrer dependendo das opções selecionadas:
  • O bean de implementação será aberto no editor Java. Isso contém o código de estrutura que pode ser usado para testar a função básica do serviço da web, ou você pode implementar a lógica de negócios necessária para seu serviço antes de testá-lo.
  • Se você tiver selecionado para testar o proxy gerado usando JSPs do JAX-WS 2.0, o proxy será ativado em um navegador da web na URL a seguir: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. Como esta é uma estrutura básica de Java bean com o método de implementação trivial, um valor de -3 será retornado.
  • 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.
  • 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.
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: tsklejbjaxws.html