Está en la página 1de 15

https://netbeans.org/kb/docs/javaee/javaee-gettingstarted_pt_BR.

html

Choose page language

NetBeans IDE NetBeans Platform Enterprise Plugins


Search

Docs & Support Community


HOME / Docs & Support

Introduo s Aplicaes Java EE


Este documento fornece uma breve introduo a algumas das funcionalidades apresentadas como parte da especificao

Edition 6 (Java EE 6). Para ilustrar as novas funcionalidades, este tutorial demonstrar como criar uma aplicao web Java

contenha uma fachada de bean de sesso sem estado EJB 3.1 para uma classe de entidade. Voc utilizar assistentes no

classe de entidade no bean de sesso. O cdigo gerado pelo assistente utiliza consultas as quais esto definidas na API d

parte do JPA 2.x e est contida na especificao Java EE 6. Em seguida, voc criar um bean gerenciado e nomeado que

de sesso, bem como uma camada de apresentao que utiliza o framework de view do Facelets como especificado no JS
Este tutorial baseado no post do blog Simplest Possible JSF 2 / EJB 3.1 / JPA Component - With WAR Deployment
pode encontrar exemplos adicionais de Java EE no projeto do Kenai de Adam Bien Java EE Patterns and Best Practices
World Java EE Patterns - Rethinking Best Practices", disponvel em http://press.adam-bien.com.
Exerccios do Tutorial
Criando o Projeto de Aplicao Web
Criando a Classe de Entidade e a Fachada de Sesso
Criando a Classe de Entidade
Criando a Fachada da Sesso
Criando as Pginas Bean Gerenciado JSF e JSF
Criando o Bean Gerenciado
Modificando a Pgina de ndice
Criando a Pgina de Resultados
Executando o Projeto
Fazendo Download do Projeto da Soluo
Para seguir este tutorial, so necessrios os recursos e o software a seguir.
Software ou Recurso

Verso Necessria

NetBeans IDE

Verso Java EE 7.2, 7.3, 7.4, 8.0

JDK (Java Development Kit)

verso 7 ou 8

GlassFish Server Open Source Edition 3.x, 4.x


Pr-requisitos

Este tutorial pressupe que voc tenha algum conhecimento bsico das tecnologias a seguir, ou alguma experincia de pr

1 de 15

https://netbeans.org/kb/docs/javaee/javaee-gettingstarted_pt_BR.html

elas:
Programao em Java
NetBeans IDE
Voc pode fazer download de um arquivo compactado zip do projeto finalizado.

Criando o Projeto de Aplicao Web

Neste exerccio ser criada uma aplicao web simples. Quando voc cria uma aplicao web, o GlassFish Server espe

continer Java EE de destino. O GlassFish Server compatvel com o Java EE e inclui as bibliotecas JSF 2.x que so nec
aplicao.

No assistente Novo Projeto, voc pode selecionar o Java EE 6 Web ou Java EE 7 como a verso Java EE. Java EE 6 Web

so perfis de Java EE leves que contm um subconjunto da plataforma Java EE completa. Os perfis Java EE Web foram c

aplicaes web que no requerem as tecnologias Java EE avanadas, como o suporte a interfaces remotas, a especifica
3.1 e a API Java Message Service (JMS).

Os perfis Web suportam o processamento da transao e o gerenciamento de persistncia que normalmente so utilizado

web corporativas. Voc pode utilizar os perfis Java EE Web para aplicaes Web que utilizam beans de sesso com uma i
sem uma interface. O perfil Java EE completo necessrio se a aplicao utilizar uma interface remota.
1. Selecione Arquivo > Novo Projeto (Ctrl-Shift-N; -Shift-N no Mac) no menu principal.
2. Selecione Aplicao Web na categoria Java Web e clique em Prximo.
3. Digite SimpleEE6App como o nome do projeto e defina a localizao do projeto.
4. Desmarque a opo Usar Pasta Dedicada, se ela estiver selecionada. Clique em Prximo.

(Para este tutorial, no h motivo para copiar as bibliotecas de projeto em uma pasta dedicada, pois voc no prec
bibliotecas com outros usurios ou projetos).

5. Selecione o servidor GlassFish Server e defina a verso do Java EE como Java EE 6 Web ou Java EE 7 Web. Cliq

6. Selecione JavaServer Faces no painel Frameworks. Clique em Finalizar.

2 de 15

https://netbeans.org/kb/docs/javaee/javaee-gettingstarted_pt_BR.html

Se voc estiver desenvolvendo uma aplicao web Java EE e implantando-a no GlassFish Server, o IDE seleciona

2.x como default. A verso da biblioteca JSF default depende da verso encapsulada de seu servidor GlassFish. A
permite utilizar Facelets como a linguagem da pgina e tambm fornece o suporte para JSF 1.2 e JSP.

Quando voc clica em Finalizar, o IDE cria o projeto e o abre na janela Projetos. O IDE cria automaticamente a pgina
a pgina no editor.

Criando a Classe de Entidade e a Fachada de Sesso

Nesta sesso, voc criar uma classe de entidade e uma fachada de sesso para a classe de entidade. Uma classe de en
Java simples e antigo (POJO), uma classe Java simples que identificada como uma entidade pela anotao

especificao Java EE 5, voc pode utilizar classes de entidade como objetos persistentes para representar tabelas em um
Java Persistence API permite utilizar a persistncia em aplicaes web sem a necessidade de criar um mdulo EJB.

A fachada de sesso para a classe de entidade nesta aplicao um bean de sesso sem estado. A arquitetura Enterprise

3.1 introduzida como parte da especificao Java EE 6 permite criar beans de sesso sem as interfaces de negcios que e

EJB 3.0. A especificao Java EE 6 tambm permite encapsular componentes do EJB diretamente em um arquivo compac

simplifica o desenvolvimento de aplicaes web menores eliminando a necessidade de criar mdulos EJB separados, que
como um arquivo compactado JAR em um arquivo compactado EAR. No entanto, para aplicaes enterprise maiores que
entre diferentes mquinas, voc ainda precisar criar arquivos compactados EAR para separar sua lgica de negcios da
apresentao.

3 de 15

https://netbeans.org/kb/docs/javaee/javaee-gettingstarted_pt_BR.html

Para obter mais informaes sobre o uso do EJB 3.1 no IDE, consulte o tutorial Criando uma Aplicao Corporativa
Para saber mais sobre classes de entidade, consulte o captulo Introduo Java Persistence API no
Para obter mais informaes sobre beans de sesso, consulte o captulo O que um Bean de Sesso?

Criando a Classe de Entidade

Neste exerccio, voc utilizar o assistente Nova Classe de Entidade para criar uma classe de entidade persistente sim

utilizar o assistente para criar uma unidade de persistncia que define a origem dos dados e o gerenciador de entidad

aplicao. Voc adicionar um campo na classe para representar os dados em sua tabela e gerar um getter e um sette
campo.

Uma classe de entidade deve ter uma chave primria. Quando voc cria a classe de entidade utilizando o assistente, o

default, o campo id e anota o campo com a anotao @Id para declarar o campo como a chave primria. O IDE tamb
anotao @GeneratedValue e especifica a estratgia de gerao de chave para o campo de id primrio.

Utilizar a Java Persistence em seu projeto simplifica tremendamente o desenvolvimento da aplicao, removendo a ne
configurar os descritores de implantao para fornecer informaes de mapeamento relacional de objeto para campos

persistentes. Em vez disso, voc pode utilizar anotaes para definir essas propriedades diretamente em uma classe J

A persistncia de entidade gerenciada pela API EntityManager. A API EntityManager trata o contexto de persistncia

persistncia um grupo de instncias de entidade. Ao desenvolver a aplicao, voc pode utilizar anotaes em sua c

especificar a instncia do contexto de persistncia das suas instncias de entidade. O ciclo de vida das instncias de e
tratado pelo continer.
Para criar a classe de entidade, execute as seguintes etapas.
1. Clique com o boto direito do mouse no n do projeto e selecione Novo > Outro.
2. Selecione Classe de Entidade na categoria Persistncia. Clique em Prximo.
3. Digite Message como o nome da classe.
4. Digite entities para o Pacote.
5. Selecione Criar Unidade de Persistncia. Clique em Prximo.
6. Selecione uma fonte de dados (por exemplo, selecione jdbc/sample se desejar utilizar o JavaDB).
A fonte de dados para jdbc/sample includa com o IDE ao instalar o IDE e o GlassFish Server, mas voc
uma fonte de dados diferente se desejar utilizar um banco de dados diferente.

Voc pode manter as outras opes default (nome da unidade de persistncia, provedor da persistncia Eclipse

a unidade de persistncia est utilizando a Java Transaction API e se a Estratgia de Gerao de Tabela defi
para que as tabelas com base nas suas classes de entidade sejam criadas quando a aplicao implantada.
7. Clique em Finalizar no assistente Nova Classe de Entidade.
Quando voc clica em Finalizar, o IDE cria a classe de entidade e abre a classe no editor. Voc pode ver que o
de id private Long id; e anotou o campo com @Id e @GeneratedValue(strategy =

GenerationType.AUTO).
8. No editor, adicione o campo mensagem (em negrito) abaixo do campo id.

private Long id;


private String message;

4 de 15

https://netbeans.org/kb/docs/javaee/javaee-gettingstarted_pt_BR.html

9. Clique com o boto direito do mouse no editor e selecione Inserir Cdigo (Alt-Insert; Ctrl+I no Mac) e, em segui
e Setter.
10. Na caixa de dilogo Gerar Getters e Setters, selecione o campo mensagem e clique em Gerar.
O IDE gera os mtodos getter e setter para o campo mensagem.

11. Salve as alteraes.

A classe de entidade representa uma tabela no banco de dados. Quando voc executa esta aplicao, uma tabela do b
para Mensagem ser criada automaticamente. A tabela conter as colunas id e mensagem.
Se examinar a unidade de persistncia no editor XML, ver que a aplicao utilizar a API de Transao Java (JTA) (

type="JTA"). Isso especifica que a responsabilidade por gerenciar o ciclo de vida de entidades no contexto da pers

ao continer. Isso resulta em menos cdigo, porque o ciclo de vida da entidade gerenciado pelo continer e no pela

obter mais informaes sobre o uso de JTA para gerenciar transaes, consulte a documentao da API de Transao

Criando a Fachada da Sesso

Neste exerccio voc utilizar um assistente para criar uma fachada de sesso sem estado para a entidade Mensagem

EJB 3.1. declara que as interfaces de negcios para beans de sesso agora so opcionais. Nesta aplicao, onde o cli

bean um cliente local, voc tem a opo de utilizar uma interface local ou uma view sem interface para expor o bean.
Para criar o bean da sesso, execute as seguintes etapas.
1. Clique com o boto direito do mouse no n do projeto e selecione Novo > Outro.

2. Selecione Beans de Sesso para Classes de Entidade na categoria Enterprise JavaBeans. Clique em Prximo.
3. Selecione a entidade Mensagem e clique em Adicionar. Clique em Prximo.
4. Digite boundary para o pacote. Clique em Finalizar.

Observe que no foi necessrio criar uma interface de negcios para o bean de sesso. Em vez disso, nessa a
ser exposto a um bean gerenciado local utilizando uma view sem interface.

5 de 15

https://netbeans.org/kb/docs/javaee/javaee-gettingstarted_pt_BR.html

Quando voc clica em Finalizar, o IDE gera a classe de fachada da sesso MessageFacade.java e

abre os arquivos no editor. Como podemos ver no cdigo gerado, a anotao @Stateless usada para declarar a c

MessageFacade.java como um componente de bean de sesso sem estado. MessageFacade.java


AbstractFacade.java, que contm a lgica de negcio e gerencia a transao.

@Stateless
public class MessageFacade extends AbstractFacade<Message> {
@PersistenceContext(unitName = "SimpleEE6AppPU")
private EntityManager em;

Quando voc cria a fachada para a entidade utilizando o assistente, como default, o IDE adiciona a anotao

(@PersistenceContext(unitName = "SimpleEE6AppPU")) para injetar recurso de gerenciador de entida

do bean de sesso e para especificar o nome da unidade de persistncia. Neste exemplo, o nome da unidade de persi
explicitamente declarado, mas o nome opcional se a aplicao tiver somente uma unidade de persistncia.

O IDE tambm gera mtodos em AbstractFacade.java para criar, editar, remover e localizar entidades. A API E

os mtodos que so utilizados para interagir com o contexto da persistncia. Voc pode ver que o IDE gera alguns mt
default usados com frequncia que podem ser utilizados para localizar objetos de entidade. Os mtodos

count utilizam os mtodos definidos na API Critrios para criar consultas. A API Critrios faz parte da especificao J
includa na especificao Java EE 6.

Criando as Pginas Bean Gerenciado JSF e JSF

Nesta seo, voc criar a camada de apresentao para a aplicao utilizando o JavaServer Faces (JSF) 2.x e um backin

6 de 15

https://netbeans.org/kb/docs/javaee/javaee-gettingstarted_pt_BR.html

que utilizado pelas pginas JSF. A especificao JSF 2.x adiciona o suporte para Facelets, como a tecnologia de exibi
aplicaes com base em JSF. Comeando com o JSF 2.x, voc tambm poder utilizar a anotao @ManagedBean

para declarar uma classe como bean gerenciado. No mais necessrio adicionar entradas no arquivo faces-config.
beans gerenciados JSF. Voc pode utilizar nomes de beans em pginas JSF para acessar mtodos no bean gerenciado.
Para obter mais informaes sobre o suporte do IDE para a especificao JavaServer Faces 2.x, consulte
IDE.

Para obter mais informaes sobre a especificao JavaServer Faces 2.x, consulte o captulo Tecnologia do JavaSe
Tutorial Java EE 7.

Criando o Bean Gerenciado

Neste exerccio, ser criado um bean gerenciado JSF simples, que utilizado para acessar a fachada de sesso. A es

2.x permite utilizar anotaes em uma classe do bean para identific-la como um bean gerenciado pelo JSF e especific
nome para o bean.
Para criar o bean gerenciado, execute as seguintes etapas:
1. Clique com o boto direito do mouse no n do projeto e selecione Novo > Outro.
2. Selecione Bean Gerenciado pelo JSF na categoria JavaServer Faces. Clique em Prximo.
3. Digite MessageView para o Nome da Classe.

Voc utilizar o bean gerenciado de nome MessageView como o valor para inputText e commandButt

index.xhtml ao chamar mtodos no bean.


4. Digite my.presentation para o Pacote.
5. Digite MessageView para o Nome que ser utilizado para o bean gerenciado.

Observao. Quando voc cria um bean gerenciado utilizando o assistente, o IDE designar, por default

bean, com base no nome da classe bean com uma letra minscula. Para este tutorial e para fins de demo

designa explicitamente ao bean um nome que comea com uma letra maiscula. Ao referenciar o bean n

voc usar MessageView, em vez de messageView. Se voc no tiver designado o nome explicitam

messageView default na pgina JSF.


6. Defina Escopo como Requisio. Clique em Finalizar.

7 de 15

https://netbeans.org/kb/docs/javaee/javaee-gettingstarted_pt_BR.html

Quando voc clicar em Finalizar, o IDE gerar a classe bean e abrir a classe no editor. Na janela Projetos, voc ver o
arquivos.

8 de 15

https://netbeans.org/kb/docs/javaee/javaee-gettingstarted_pt_BR.html

No editor, voc pode ver que o IDE adicionou as anotaes @ManagedBean e @RequestScoped e o nome do bea

@ManagedBean(name="MessageView")
@RequestScoped
public class MessageView {
/** Creates a new instance of MessageView */
public MessageView() {
}
}

Agora, voc adicionar uma anotao @EJB ser adicionada para utilizar injeo de dependncia para obter uma refer

sesso MessageFacade. Voc tambm chamar os mtodos findAll e create que esto expostos na fachada. A
autocompletar cdigo do IDE pode ajud-lo enquanto voc digita os mtodos.

1. Clique com o boto direito do mouse no editor, selecione Inserir Cdigo (Alt-Insert; Ctrl-I no Mac) e Chamar Ent
menu pop-up.
2. Selecione MessagFacade na caixa de dilogo Chamar Enterprise Bean. Clique em OK.

9 de 15

https://netbeans.org/kb/docs/javaee/javaee-gettingstarted_pt_BR.html

Quando voc clica em OK, o IDE adiciona o seguinte cdigo (em negrito) para injetar o bean.

public class MessageView {


/** Creates a new instance of MessageView */
public MessageView() {
}
// Injects the MessageFacade session bean using the @EJB annotation
@EJB
private MessageFacade messageFacade;
}
3. Adicione o cdigo a seguir para criar uma nova instncia.

/** Creates a new instance of MessageView */


public MessageView() {
this.message = new Message();
}
4. Adicione o seguinte cdigo classe.

// Creates a new field


private Message message;

// Calls getMessage to retrieve the message


public Message getMessage() {
return message;
}

10 de 15

https://netbeans.org/kb/docs/javaee/javaee-gettingstarted_pt_BR.html

// Returns the total number of messages


public int getNumberOfMessages(){
return messageFacade.findAll().size();
}
// Saves the message and then returns the string "theend"
public String postMessage(){
this.messageFacade.create(message);
return "theend";
}

5. Clique com o boto direito do mouse no editor, selecione Corrigir Importaes (Alt-Shift-I; -Shift-I no Mac) e s
Voc pode utilizar a funcionalidade para autocompletar cdigo no editor para ajudar a digitar seu cdigo.

Observe que o mtodo postMessage retorna a string "theend". A especificao JSF 2.x permite a utilizao de regra

implcitas em aplicaes que utilizam a tecnologia Facelets. Nesta aplicao, no h regras de navegao configurada

config.xml. Em vez disso, o handler de navegao tentar localizar a pgina adequada na aplicao. Neste caso,
navegao tentar localizar uma pgina nomeada theend.xhtml quando o mtodo postMessage for chamado.

Modificando a Pgina de ndice

Neste exerccio, voc far algumas alteraes simples na pgina index.xhtml para adicionar alguns componentes
usurio. Voc adicionar um form com um campo de entrada de texto e um boto.
1. Abra o index.xhtml no editor.
2. Modifique o arquivo para adicionar o seguinte form simples entre as tags <h:body>.

<h:body>
<f:view>
<h:form>
<h:outputLabel value="Message:"/><h:inputText value="#

{MessageView.message.message}"/>
<h:commandButton action="#{MessageView.postMessage}" value="Po
Message"/>
</h:form>
</f:view>
</h:body>
A funcionalidade autocompletar cdigo JSF pode ajud-lo ao digitar o cdigo.

11 de 15

https://netbeans.org/kb/docs/javaee/javaee-gettingstarted_pt_BR.html

Observao. Se voc copiar e colar o cdigo no arquivo, receber uma advertncia na margem esquerd
que contm <f:view>. Voc pode colocar o cursor de insero na linha e digitar Alt-Espao para abrir
resolver o erro. A dica informa que necessrio adicionar a declarao de biblioteca

xmlns:f="http://xmlns.jcp.org/jsf/core".
3. Salve as alteraes.
Os componentes inputText e commandButton chamaro os mtodos no bean gerenciado JSF nomeado
mtodo postMessage retornar "theend" e o handler de navegao procurar por uma pgina nomeada

Criando a Pgina de Resultados

Neste exerccio, voc criar a pgina JSF theend.xhtml. A pgina ser exibida quando o usurio clicar no boto P

index.xhtml e chamar o mtodo postMessage no bean gerenciado JSF.


1. Clique com o boto direito do mouse no n do projeto e selecione Novo > Outro.
2. Selecione a Pgina JSF na categoria JavaServer Faces. Clique em Prximo.
3. Digite theend como o Nome do Arquivo.
4. Certifique-se de que a opo Facelets esteja selecionada. Clique em Finalizar.

12 de 15

https://netbeans.org/kb/docs/javaee/javaee-gettingstarted_pt_BR.html

5. Modifique o arquivo digitando o seguinte entre as tags <h:body>.

<h:body>
<h:outputLabel value="Thanks! There are "/>
<h:outputText value="#{MessageView.numberOfMessages}"/>
<h:outputLabel value=" messages!"/>
</h:body>
Quando voc comea a digitar, o IDE adiciona automaticamente a definio de biblioteca de tags

xmlns:h="http://xmlns.jcp.org/jsf/html" ao arquivo para os elementos JSF.

Executando a Aplicao
Voc agora finalizou a codificao da aplicao. Agora voc pode testar a aplicao no browser.
1. Clique com o boto direito do mouse no n na janela Projetos e selecione Executar.
Quando voc seleciona Executar, o IDE constri e implanta a aplicao e abre o index.xhtml no browser.
2. Digite uma mensagem no campo de texto. Clique em Postar Mensagem.

13 de 15

https://netbeans.org/kb/docs/javaee/javaee-gettingstarted_pt_BR.html

Quando voc clica em Postar Mensagem, a mensagem ser salva no banco de dados e o nmero de mensagens ser rec

Fazendo Download do Projeto da Soluo


Voc pode fazer o download dos projetos de amostra usados neste tutorial das seguintes formas:
Faa download de um arquivo compactado zip do projeto finalizado.
Faa o check-out do cdigo-fonte do projeto das Amostras do NetBeans ao executar as etapas a seguir:
Escolha Equipe > Subversion > Efetuar check-out no menu principal.
Na caixa de dilogo Efetuar Check-out, insira o Repositrio URL a seguir:

https://svn.netbeans.org/svn/samples~samples-source-code
Clique em Prximo.
Clique em Procurar para abrir a caixa de dilogo Procurar Pastas do Repositrio.
Expanda o n de raiz e selecione samples/javaee/SimpleEE6App. Clique em OK.
Especifique a Pasta Local para o cdigos-fonte (a pasta local precisa estar vazia).
Clique em Finalizar.

Quando voc clica em Finalizar, o IDE inicializa a pasta local como um repositrio Subversion e verifica os c
projeto.
Clique em Abrir Projeto na caixa de dilogo exibida quando o check-out for concludo.

14 de 15

https://netbeans.org/kb/docs/javaee/javaee-gettingstarted_pt_BR.html

Observaes.

necessrio um cliente Subversion para verificar os cdigos-fonte. Para saber mais sobre a instalao do S
a seo Configurando o Subversion no Guia do Subversion no NetBeans IDE.

Consulte Tambm

Para obter mais informaes sobre o uso do NetBeans IDE para desenvolver aplicaes Java EE, consulte os seguintes re
Introduo Tecnologia Java EE
Suporte a JSF 2.x no NetBeans IDE
Trilha de Aprendizado do Java EE e Java Web
Voc pode encontrar mais informaes sobre o uso das tecnologias Java EE 6 para desenvolver aplicaes no
Para enviar comentrios e sugestes, obter suporte e se manter informado sobre os mais recentes desenvolvimentos das
desenvolvimento do Java EE do NetBeans IDE, inscreva-se na lista de correspondncia de nbj2ee.

SiteMap

About Us

Contact

Legal & Licences


By use of this website, you agree to the NetBeans Policies and Terms of Use. 2016, Oracle Corporation and/or
its affiliates. Sponsored by

15 de 15