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
- Alterne para a perspectiva Java EE
(Janela > Abrir Perspectiva > Java EE).
- Na visualização Enterprise Explorer, selecione o arquivo WSDL que
foi criado ou importado.
- 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.
- 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:
- 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.
- 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.
- 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
- 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.
- 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
- 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.
- Publicar o Serviço da Web.
- 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.
- 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:
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.