Aplicação de serviço Web passando dados binários, parte 1: Visão geral

Neste tutorial, você cria um aplicativo da Web EE6 que contém um serviço da Web implementado como um bean de sessão sem estado. Um pacote com quatro arquivos JPEG é adicionado ao aplicativo da Web. O serviço da Web tem duas operações acessíveis pelos clientes, para obter imagens individuais e para obter um conjunto de todas as quatro imagens como miniaturas. Você adiciona métodos privados que convertem os arquivos JPEG para matrizes de bytes e convertem essas matrizes de bytes para objetos Imagem. Diferente do Java EE5, no EE6 você coloca esses métodos privados diretamente no serviço da Web, pois o serviço da Web também é um EJB.

Após criar o serviço da Web, ele implementará uma instância do GlassFish server 3.1 (devido a um bug, não é possível usar a versão 3.0.1.) O testador do serviço da Web embutido do NetBeans IDE é utilizado para visualizar a requisição SOAP de amostra e responder mensagens.

A infraestrutura do serviço JAX-WS padrão não pode informar aos clientes que os dados binários precisam ser interpretados como arquivos JPEG. Portanto, você gera uma cópia do Esquema XML e dos arquivos WSDL e edita o esquema XML para informar a qualquer cliente para esperar o tipo de conteúdo image/jpeg para o elemento de retorno. O código de serviço é alterado para utilizar o esquema e o WSDL personalizados.

Finalmente, você cria um aplicativo cliente Java que exibe as imagens em um álbum criado dos componentes do Swing.

É possível baixar uma versão completa de aplicativos de clientes e serviços do catálogo de amostras do NetBeans.

Nota: essa é a versão EE 6 deste tutorial. Para utilizar a versão EE 5 deste tutorial, consulte o Arquivo da documentação do NetBeans IDE 6.8.

Lições deste tutorial

1. => Visão geral
2. Criando o serviço da 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

Software necessário para o tutorial

Para seguir este tutorial, você precisa dos seguintes recursos e softwares.

Software ou recurso	Versão necessária
NetBeans IDE	Pacote de download do Java EE
Java Development Kit (JDK)	versão 6 ou versão 7
Servidor de aplicativos ou Web compatível com Java EE	GlassFish Server Open Source Edition 3.1 Aviso: Devido à questões com a versão final do GlassFish 3.0.1, é preciso usar a versão 3.1.
Imagens usadas neste tutorial	rose.jpg sunflower.jpg aster.jpg honeysuckle.jpg

Nota: o servidor do GlassFish pode ser instalado com o conjunto Java EE baixado do NetBeans IDE. Como alternativa, você pode visitar a página de downloads do servidor GlassFish.

Dica:como opção, para fins de solução de problemas, você pode baixar a amostra completa e inspecionar os códigos-fonte.

No fim deste tutorial, você terá um aplicativo Java Swing em execução que consome imagens JPEG via um serviço da Web, com o resultado exibido a seguir.

Próxima etapa:

Criando o serviço da Web

Veja também

Para obter informações detalhadas antes de usar este tutorial, consulte os seguintes recursos:

• Introdução aos serviços Web JAX-WS
• Desenvolvendo clientes de serviços Web
• Criando um cliente gráfico para Twitter
• Introdução aos aplicativos do Java EE 6
• Interoperabilidade avançada de serviços Web

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