// 
//     Licensed to the Apache Software Foundation (ASF) under one
//     or more contributor license agreements.  See the NOTICE file
//     distributed with this work for additional information
//     regarding copyright ownership.  The ASF licenses this file
//     to you under the Apache License, Version 2.0 (the
//     "License"); you may not use this file except in compliance
//     with the License.  You may obtain a copy of the License at
// 
//       http://www.apache.org/licenses/LICENSE-2.0
// 
//     Unless required by applicable law or agreed to in writing,
//     software distributed under the License is distributed on an
//     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
//     KIND, either express or implied.  See the License for the
//     specific language governing permissions and limitations
//     under the License.
//

= Anexo SOAP Binário Ponto a Ponto 2: Criando o Web Service
:jbake-type: tutorial
:jbake-tags: tutorials 
:jbake-status: published
:icons: font
:syntax: true
:source-highlighter: pygments
:toc: left
:toc-title:
:description: Anexo SOAP Binário Ponto a Ponto 2: Criando o Web Service - Apache NetBeans
:keywords: Apache NetBeans, Tutorials, Anexo SOAP Binário Ponto a Ponto 2: Criando o Web Service

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

É possível fazer download de uma amostra completa do Web service do link:https://netbeans.org/projects/samples/downloads/download/Samples%252FWeb%2520Services%252FWeb%2520Service%2520Passing%2520Binary%2520Data%2520--%2520EE6%252FFlowerAlbumService.zip[+Catálogo de Amostras do NetBeans+].

*Lições Deste Tutorial*

image::images/netbeans-stamp-80-74-73.png[title="O conteúdo desta página se aplica ao NetBeans IDE 7.2, 7.3, 7.4 e 8.0"]

1. link:./flower_overview.html[+Visão Geral+]
2. => Criando o Web Service
3. link:flower-code-ws.html[+Codificando e Testando o Web Service+]
4. link:./flower_wsdl_schema.html[+ Modificando o Esquema e os Arquivos WSDL para Passar Dados Binários+]
5. link:./flower_swing.html[+ Criando o Cliente Swing+]


[start=1]
1. <<create-web-app,Criando a Aplicação Web>>
2. <<add-ws,Adicionando o Web Service>>


[[create-web-app]]
== Criando a Aplicação Web

Nesta seção, você criará uma aplicação Web Java EE. Para esta aplicação, você adicionará as imagens que o Web service passará como dados binários.

*Para criar a aplicação Web:*

1. Selecione Arquivo > Novo Projeto (Ctrl-Shift-N no Linux e no Windows, ⌘-Shift-N no MacOS). O Assistente de Novo Projeto será exibido. Selecione Aplicação Web na categoria Java Web e clique em Próximo. A página Nome e Localização será aberta.
2. Digite  ``FlowerAlbumService``  no campo Nome do Projeto. Selecione a localização que deseja para este projeto. Mantenha as definições default das outras opções e clique em Próximo. A página Servidor e Definições será aberta.
3. Selecione o servidor GlassFish Server e Java EE versão Java EE 6 Web ou Java EE 7 Web.
4. Clique em Finalizar. O projeto  ``FlowerAlbumService``  será criado e aparecerá na janela Projetos.
5. Clique com o botão direito do mouse no nó Pacotes de Código-Fonte e selecione Novo > Pacote Java.

Se preferir, selecione Novo > Outro e selecione Pacote Java na categoria Java do assistente de Novo Arquivo.


[start=6]
. Nomeie o pacote  ``org.flower.resources`` . Clique em Finalizar.
image::images/new-package.png[]

[start=7]
. Copie as imagens a seguir para  ``org.flower.resources`` :
* link:images/rose.jpg[+rose.jpg+]
* link:images/sunflower.jpg[+sunflower.jpg+]
* link:images/aster.jpg[+aster.jpg+]
* link:images/honeysuckle.jpg[+honeysuckle.jpg+]

O projeto agora tem o pacote  ``org.flower.resources``  no Pacote de Código-Fonte. Nenhum outro conteúdo foi adicionado.

image::images/project-w-resources.png[]


[[add-ws]]
== Adicionando o Web Service

Nesta seção, você criará um Web service na aplicação 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 leva o nome de uma flor e tem 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 Web service:*

1. Na janela Projetos, clique com o botão direito do mouse no nó do projeto  ``FlowerAlbumService``  e selecione Novo > Web Service. Como alternativa, escolha Novo > Outro e selecione Web Service em Web Services no assistente Novo Arquivo. O assistente Novo Web Service será aberto.
2. No assistente Novo Web Service, digite  ``FlowerService``  em Nome do Web Service e  ``org.flower.service``  em Nome do Pacote. Selecione Criar Web Service do Início. Selecione Implementar Serviço como Bean de Sessão Sem Estado. Clique em Finalizar. 
image::images/new-service.png[]

O Web service aparecerá 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.

image::images/project-w-service-and-resources.png[]

[start=3]
. Abra  ``FlowerService.java``  no editor. Alterne para a view de Design. Um form aparecerá, no qual você pode adicionar operações e elementos de qualidade de serviço ao Web service.
image::images/flower-service-empty-design.png[]

[start=4]
. Clique em Adicionar Operação. O assistente Adicionar Operação será aberto.

[start=5]
. Nomeie a operação  ``getFlower`` . No campo Tipo de Retorno, digite ou navegue para  ``java.awt.Image`` .

[start=6]
. Na guia Parâmetros, clique em Adicionar. Nomeie o parâmetro  ``nome``  e aceite o tipo  ``java.lang.String``  default. 
image::images/add-getflower-param.png[]

[start=7]
. Abra a guia Exceções. Adicione uma  ``IOException`` .
image::images/io-exception.png[]

[start=8]
. Clique em OK e feche o assistente. Em seguida, clique novamente em Adicionar Operação e adicione uma operação com as seguintes propriedades:
* *Nome:* getThumbnails
* *Tipo de retorno:* java.util.List
* *Exceção: * IOException

A view de Design agora mostra as operações  ``getFlower``  e  ``getThumbnails`` . Alterne para View de Lista das duas operações e veja todos os parâmetros delas.

image::images/flower-service-full-design.png[]


==  


== Próxima etapa:

link:./flower-code-ws.html[+Codificando e Testando o Web Service+]

link:/about/contact_form.html?to=3&subject=Feedback:%20Flower%20Creating%20WS%20EE6[+Enviar Feedback neste Tutorial+]


Para enviar comentários e sugestões, obter suporte e se manter informado sobre os mais recentes desenvolvimentos das funcionalidades de desenvolvimento Java EE do NetBeans IDE, link:../../../community/lists/top.html[+inscreva-se na lista de notícias nbj2ee@netbeans.org+].