< Anterior | Próximo >

Lição 2: Criando o serviço da web

Nesta lição, você aprenderá como criar o serviço da web da lista de endereços Java™ descendente a partir do arquivo WSDL importado na lição anterior.

Antes de Iniciar

Antes de iniciar, você deve concluir a Lição 1: Criando um projeto do servidor e da web .

Sobre Esta Tarefa

Procedimento

  1. Alterne para a perspectiva Java EE: Janela > Abrir Perspectiva >Outra > Java EE.
  2. Na visualização Explorador de Projetos, selecione o arquivo WSDL que importou na lição anterior.
  3. Clique com o botão direito no WSDL e selecione Serviços da Web > Gerar estrutura básica de Java bean.
  4. Página Serviços da Web: selecione Serviços da web do Java bean serviço da web descendente como seu tipo de serviço da web e assegure que AddressBook.wsdl esteja configurado como a definição de serviço. Escolha as seguintes opções:
    1. Selecione os estágios de desenvolvimento de serviços da web que você deseja concluir usando a régua de controle. A régua de controle configura os padrões nas páginas restantes do assistente, mas é possível substituir as configurações padrão em cada página enquanto você continua. Para esse tutorial, selecione Iniciar o Serviço. Isso criará todo o código necessário para o serviço da web, o implementará no servidor e tentará iniciar o servidor.
    2. Selecione seu servidor: clique no link do servidor e assegure que o Servidor WebSphere v8 esteja selecionado.
    3. Selecione o seu tempo de execução: assegure que o tempo de execução do IBM® JAX-WS esteja selecionado.
    4. Selecione o projeto de serviço: Selecione o projeto jwsAddressBook criado na lição anterior.
    5. Selecione o projeto EAR de serviço: Selecione o jwsAddressBookEAR criado na lição anterior.
    6. O cliente será criado posteriormente; portanto, assegure que a régua de controle do cliente esteja configurada como Nenhum cliente.
    Clique em Next.
  5. Página de Configuração de Serviço da Web De Cima para Baixo do WebSphere JAX-WS:
    • Pasta de Saída: Aceite o local padrão onde a estrutura Java gerada será gerada: jwsAddressBook/src.
    • Pacote de destino: Aceite o nome do pacote de destino
    • 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. Aceite o padrão.
    • 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. Aceite o padrão.
    • Versão do código JAX-WS a ser gerado: Iniciando com o WebSphere Application Server v8.0, é possível gerar o código de conformidade com o JAX-WS 2.1. Selecione 2.1 para esse tutorial.
    • Copiar WSDL no projeto: Selecione essa opção para copiar o arquivo WSDL no projeto de serviço. Como você criará o cliente posteriormente, selecione essa caixa de opção.
    • Gerar Classes JAXB serializáveis: No WebSphere Application Server v7.0 e acima, quando você ativa a máscara Java 6, você pode optar por gerar classes JAXB que implementam java.io.Serializable. As classes que não implementam essa interface não terão qualquer um de seus estados seriados ou desserializados. Não selecione isso para o tutorial.
    • Especifique arquivos de ligação do JAX-WS ou JAXB: isso permite utilizar arquivos de ligação customizados do JAX-WS ou JAXB. Não selecione isso para o tutorial.
    • Customizar nome da classe de implementação do serviço: isso permite alterar o nome da porta padrão para o mapeamento de nome de classe de implementação de serviço. Não selecione isso para o tutorial.
    • Gerar biblioteca de esquemas: Selecionar isso executará o Esquema JAX-WS para compilador Java para gerar um esquema. Não selecione essa opção para o tutorial.
    • Gerar descritor de implementação do serviço da Web: Para 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. A seleção desta caixa de seleção irá gerá-los. Esse tutorial não requer descritores de implementação.
    Clique em Next.

Resultados

Todos os códigos necessários para o serviço da web são gerados

Incluindo a Lógica de Negócios no Bean de Estrutura

Sobre Esta Tarefa

O bean de implementação de estrutura básica gerado pelo assistente de serviço da web AddressBookPortImpl.java não contém nenhuma lógica de negócios. Ele contém a anotação @javax.jws.WebService que informa ao tempo de execução que é um serviço da web JAX-WS.

Para criar a função do serviço da web da lista de endereços conforme esperado, é necessário d incluir código nesse bean. Ele deve ser aberto em um editor automaticamente após a geração do serviço da web mas, se não, ele poderá ser localizado em: jwsAddressBook/Java Resources/src/com.addressbook.

Procedimento

  1. Substitua o método saveAddress atual:
        public boolean saveAddress(PersonType person) {
            return false;
        }
    com o seguinte campo estático e método:
    	private static Hashtable<String,AddressType> addresses = new Hashtable<String,AddressType>();
        public boolean saveAddress(PersonType person) {
        	addresses.put(person.getName(),person.getAddress());
            return true;
        }
  2. Substitua o método findAddress atual:
        public AddressType findAddress(String name) throws FindAddressFault {
            return null;
        }
    pela seguinte:
        public AddressType findAddress(String name) throws FindAddressFault {
            return addresses.get(name);
        }
  3. Diversos marcadores de erro podem ser exibidos. Para corrigir isso, organize suas importações clicando em Ctrl+Shift+o. Selecione para importar java.util.Hashtable. Após isso ser feito, os erros devem ser esmaecidos.
  4. Salve o bean de implementação atualizado.

Testar o serviço da web usando o Generic Service Client

Sobre Esta Tarefa

O Generic Service Client permite que você teste um serviço da web sem a construção de um cliente. Você pode selecionar a operação que deseja testar, digitar as informações necessárias e o resultado será exibido na área de janela de Status.

Procedimento

  1. Selecione o arquivo WSDL gerado jwsAddressBook/WebContent/WEB-INF/wsdl/AddressBook.wsdl, clique com o botão direito e selecione Serviços da Web > Testar com o Generic Service Client. Como alternativa, você pode selecionar o serviço sob o nó Serviços do projeto ou o nó de serviços da web JAX-WS na visualização Serviços e ativar o Generic Service Client a partir de lá.
  2. Selecione a operação SaveAddress.
  3. Insira valores em cada um dos campos e clique em Chamar.
  4. Selecione a operação FindAddress.
  5. Insira o nome que você escolheu ao chamar a operação saveAddress e clique em Chamar.
  6. As informações que você salvou nesse nome serão exibidas na área de janela de Status.

Ponto de Verificação da Lição

Agora você está pronto para iniciar a Lição 3: Criando o cliente de serviço da web .

< Anterior | Próximo >
Icon that indicates the type of topic Tutorial lesson topic
Timestamp icon Last updated: last_date

File name: jaxwstd_exercise12.html