corner imagecorner image
IDEPlatformPluginsDocs & SupportCommunityPartners

Anexo SOAP binário ponto a ponto 2: Criando o serviço Web

O objetivo desta lição é criar um aplicativo da Web que contenha um serviço da Web. Você implementará o serviço da Web como um bean de sessão sem estado.

É possível baixar uma amostra completa do serviço da Web a partir do Catálogo de amostras do NetBeans.

Lições deste tutorial

O conteúdo desta página se aplica ao NetBeans IDE 6.9-7.1
  1. Visão geral
  2. => Criando o serviço Web
  3. Codificando e testando o serviço da Web
  4. Modificando o esquema e os arquivos WSDL para passar dados binários
  5. Criando o cliente Swing

Conteúdos desta lição

  1. Criando o aplicativo da Web
  2. Adicionando o serviço da Web

Criando a aplicação Web

Nesta seção, você criará um aplicativo da Web EE6. Para este aplicativo, você adicionará as imagens que o serviço da Web passará como dados binários.

Para criar o aplicativo da Web:

  1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N no Linux e no Windows, ⌘-Shift-N no MacOS). É exibido o assistente para Novo projeto. Selecione Aplicativo da Web na categoria Java Web e clique em Próximo. A página Nome e localização é aberta.
  2. Digite FlowerAlbumService no campo Nome do projeto. Selecione a localização que deseja para este projeto. Mantenha as configurações padrão das outras opções e clique em Próximo. A página Servidor e configuração é aberta.
  3. Selecione o servidor GlassFish 3.1 e Java EE versão EE6 Web.

    Importante: o GlassFish Server Open Source Edition deve ser versão 3.1 b27 ou posterior. O arquivo de esquema personalizado que você criar em Modificando o esquema e os arquivos WSDL não funciona em versões anteriores do servidor GlassFish 3.0.1. Verifique a versão de seu servidor GlassFish na janela Serviços.

  4. Clique em Terminar. O projeto FlowerAlbumService é criado e aparece na janela Projetos.
  5. Clique com o botão direito do mouse no nó Pacotes de código-fonte e escolha Novo > Pacote Java. O assistente Novo pacote Java é aberto.
  6. Nomeie o pacote org.flower.resources. Clique em Terminar.
    Assistente Novo pacote mostrando o nome e o local do pacote org.flower.resources
  7. Copie as imagens a seguir para org.flower.resources:

O projeto agora possui o pacote org.flower.resources no Pacote de código-fonte. Nenhum outro conteúdo foi adicionado.

Projeto somente com as imagens de flores

Adicionando o serviço da Web

Nesta seção, você criará um serviço da Web no aplicativo da Web. Você criará o serviço como um bean de sessão sem estado. Você adicionará as operações da Web a seguir ao serviço:

  • Uma operação que obtém o nome de uma flor e sua Imagem associada.
  • Uma operação que obtém miniaturas de todas as imagens de flores e as retorna como uma Lista.

Para adicionar o serviço da Web:

  1. Na janela Projetos, clique com o botão direito do mouse no nó do projeto FlowerAlbumService e selecione Novo > Serviço da Web. Como alternativa, escolha Novo > Outro e selecione Serviço Web em Serviços Web no assistente para Novo arquivo. O assistente para Novo serviço Web se abre.
  2. No assistente Novo serviço da Web, digite FlowerService em Nome do serviço da Web e org.flower.service em Nome do pacote. Selecione Criar serviço da Web do Rascunho. Selecione Implementar serviços como Bean de sessão sem estado. Clique em Terminar.
    Assistente concluído de Novo serviço da Web

    O serviço da Web aparece em nós do projeto na janela Projetos. O diretório Pacotes de código-fonte inclui o pacote do serviço e o pacote de recursos.

    Janela Projetos mostrando imagens de flores e o serviço da Web
  3. Abra FlowerService.java no editor. Alterne para a visualização Desenho. Um formulário aparece, no qual é possível adicionar operações e elementos de qualidade de serviço ao serviço da Web.
    Visualização do desenho FlowerService, sem nada adicionado
  4. Clique em Adicionar operação. O assistente Adicionar operação é aberto.
  5. Nomeie a operação getFlower. No campo Tipo do retorno, digite ou navegue para java.awt.Image.
  6. Na aba Parâmetros, clique em Adicionar. Nomeie o parâmetro nome e aceite o tipo padrão java.lang.String.
    Aba Adicionar operação mostrando o nome e o tipo do retorno para a operação getFlower e o parâmetro nome
  7. Abra a aba Exceções. Adicione uma IOException.
    Navegando até a Exceção de IO
  8. Clique em OK e feche o assistente. A seguir, clique novamente em Adicionar operação e adicione uma operação com as propriedades a seguir:
    • Nome: getThumbnails
    • Tipo do retorno: java.util.List
    • Exceção: IOException

A visualização Desenho agora mostra as operações getFlower e getThumbnails. Alterne para Listar visualização de ambas as operações e veja todos os seus parâmetros.

Visualização do desenho do serviço Flor mostrando as operações

 

Próximo passo:

Codificando e testando o serviço da Web


Para enviar comentários e sugestões, obter suporte e se manter informado sobre os mais recentes desenvolvimento dos recursos de desenvolvimento de Java EE do NetBeans IDE, inscreva-se na lista de notícias .