Resolvi fazer um pequeno teste (tambem chamado testículo) com JEE5 e ver como ele se comporta na prática, já tinha ouvido e lido sobre o aumento da produtividade, que é mais facil, etc... Até agora eu só tinha visto exemplos de JPA, EJB 3.0, JSF 1.2, etc... mas não tinha visto um com tudo junto, então resolvi fazer o meu. É uma aplicação simples, apenas uma agenda de telefone/e-mail funcionando tudo numa tela, inclusão, alteração, exclusão e consulta, um CRUDizinho sem vergonha.
Como IDE resolvi usar o NetBeans 5.5 beta 2, que tem suporte completo e ja vem com o Sun Java System Application Server que implementa a JEE5, e se eu não estiver enganado é a base do GlassFish. Cheguei até ver na net como fazer para o usar o GlassFish, mas acabei perdendo o link e não achei mais, e como eu tambem não tava com muita esperança de que tudo fosse funcionar, nem liguei, mas depois vou correr atraz ;-) (bem como vou ver se tem como fazer isso tudo no Eclipse tambem).
Bom então vamos lá, pra começar temos que baixar o NetBeans 5.5 beta 2 e instalá-lo. Depois de instalado, basta executá-lo (dããã) :)
A primeira coisa que vamos fazer é criar a base de dados e a tabela da nossa agenda. O NetBeans 5.5 beta 2 vem com Java DB, que é baseado no Derby que é baseado no Cloudscape (ufa), acredito que você possa usar quaquer banco de dados, eu usei este porque ja vinha com ele e como o foco era fazer o JEE5 funcionar ficou ele mesmo.
Para criar a base de dados, vá no menu Tools>Java DB Database>Create Java DB Database, na janela de diálogo basta preencher todos os campos com "agenda": database name, user e password. Assim a vida fica mais facil :P
Na "abinha" de runtime, em databases nossa base irá aparecer (se você for abrindo os nodes, claro). Clique com o botão direito sobre ela e selecione connect para abrir a conexão.
Agora vamos criar a nossa tabelinha, com a conexão aberta, clique com o botão direito novamente sobre a base e selecione Execute command, isto irá abrir uma janela para executarmos comandos SQL, entre com a instrução abaixo para criarmos nossa tabelinha:
create table tb_agenda (
id integer generated always as identity constraint id_pk primary key,
nome varchar(50) not null,
telefone varchar(30),
email varchar(30),
dtnascimento date
);
Agora ja temos que temos nossa base com nossa tabelinha, vamos criar o nosso projeto. Então vamos lá, menu File>New Project selecione Enterprise e Enterprise Application, para criarmos nosso EAR. Na janela basta entrar com o nome do Projeto Agenda, deve estar marcada como default a opção para JEE5, mas não custa nada confirmar, o restante deixe como default. Devem ter sido criadas 3 entradas na lista de projetos do NetBeans, Agenda (ear), Agenda-ejb e Agenda-war.
Precisamos agorar criar a configuração da persistencia do EJB 3.0, o persistence.xml. Para isso o NetBeans tem um wizard que quebra um galho, clique com o botão direito sobre o Agenda-ejb selecione New>Persistence Unit. Deixe as opções default (ate mesmo o nome), verifique se está apontando para o datasource correto, no meu teste eu deixei como Persistence Provider o Toplink, mas acredito que possa ser usado o Hibernate ou o Kodo, em todo caso isto pode ser alterado mais tarde sem maiores dificuldades, basta editar o persistence.xml.
Depois de terminarmos será criado o seguinte conteúdo para o arquivo:
<?xml version="1.0" encoding="UTF-8"?>
<persistence version="1.0" xmlns="http://java.sun.com/xml/ns/persistence"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/persistence
http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd">
<persistence-unit name="Agenda-ejbPU" transaction-type="JTA">
<jta-data-source>jdbc/agenda</jta-data-source>
<properties></properties>
</persistence-unit>
</persistence>
Chegou a hora de criarmos nosso objeto para representar os dados da agenda, que deve se chamar Agenda (oh!). Vamos colocar nossa classe no pacote agenda, do projeto Agenda-ejb, segue abaixo o código:
package agenda;
import java.util.Date;
import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.Table;
import javax.persistence.Temporal;
import javax.persistence.TemporalType;
@Entity
@Table(name="tb_agenda")
public class Agenda implements java.io.Serializable {
@Id
@GeneratedValue(strategy=GenerationType.IDENTITY)
@Column(name="id")
private int id;
@Column(name="nome",length=50)
private String nome;
@Column(name="telefone",length=40)
private String telefone;
@Column(name="email",length=30)
private String email;
@Column(name="dtnascimento")
@Temporal(TemporalType.DATE)
private Date dtnascimento;
public int getId(){ return id; }
public void setId(int id) { this.id = id; }
public String getNome() { return nome; }
public void setNome(String nome) { this.nome =nome;}
public String getTelefone() { return telefone; }
public void setTelefone(String telefone) {this.telefone = telefone;}
public String getEmail() { return email; }
public void setEmail(String email) { this.email = email;}
public Date getDtnascimento() { return dtnascimento; }
public void setDtnascimento(Date dtnascimento){
this.dtnascimento = dtnascimento;
}
}
Não vou perder tempo explicando as annotations, porque isto já esta ficando grande e porque já tem um monte de site explicando isto :P (sem contar que na javamagazine deste mes tem uma materia sobre JPA).
Agora temos que criar nosso EJB de negócio, um stateless simples que sera acessado pela aplicação web e persistira o nosso Entity agenda usando JPA. Novamente clique com o botão direito sobre o Agenda-ejb selecione New>Session Bean, na janela de diálogo preencha o nome do EJB com Agenda, o pacote tambem pode ser agenda. Serão criados dois arquivos, a classe AgendaBean que é nosso ejb e a interface local AgendaLocal.
Agora vem o exercicio preferido: ctrl+c ctrl+v :) primeiro para o AgendaBean:
package agenda;
import java.util.List;
import javax.annotation.Resource;
import javax.ejb.Stateless;
import javax.ejb.TransactionManagement;
import javax.ejb.TransactionManagementType;
import javax.persistence.EntityManager;
import javax.persistence.EntityManagerFactory;
import javax.persistence.PersistenceContext;
import javax.persistence.Query;
import javax.transaction.HeuristicMixedException;
import javax.transaction.HeuristicRollbackException;
import javax.transaction.NotSupportedException;
import javax.transaction.RollbackException;
import javax.transaction.SystemException;
import javax.transaction.UserTransaction;
@Stateless
@TransactionManagement(value=TransactionManagementType.CONTAINER)
public class AgendaBean implements agenda.AgendaLocal {
@PersistenceContext
private EntityManager manager;
public void salvar(Agenda agenda) {
if (agenda.getId()>0)
manager.merge(agenda);
else
manager.persist(agenda);
}
public void excluir(Agenda agenda) {
Agenda ag =manager.merge(agenda);
manager.remove(ag);
}
public List consultar() {
Query q =manager.createQuery("select a from Agenda a");
return q.getResultList();
}
}
Agora é a vez da interface:
package agenda;
import java.util.List;
import javax.ejb.Local;
@Local
public interface AgendaLocal {
public void salvar(Agenda agenda);
public void excluir(Agenda agenda);
public List consultar();
}
Nossa camada de negócios está pronta agora temos que fazer a nossa camada web (e dalhe MVC).
A primeira coisa a ser feita é configurar a servlet do JSF no web.xml, para isso vá la no projeto Agenda-war e abra o web.xml e faça com que fique assim (e tome ctrl+c ctrl+v)
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
version="2.5">
<session-config>
<session-timeout>30</session-timeout>
</session-config>
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
<servlet>
<servlet-name>Faces Servlet</servlet-name>
<servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>Faces Servlet</servlet-name>
<url-pattern>*.jsf</url-pattern>
</servlet-mapping>
</web-app>
Agora vamos criar o arquivo faces-config.xml, na pasta WEB-INF clique com o botão direito selecione New>XML Document nome do arquivo faces-config e deixe as opções default, o resto você ja sabe (mais ctrl+c ctr+v, afinal se chegou ate aqui você já deve estar craque nisso).
<faces-config xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-facesconfig_1_2.xsd"
version="1.2">
<managed-bean>
<managed-bean-name>agendaMB</managed-bean-name>
<managed-bean-class>agenda.AgendaMB</managed-bean-class>
<managed-bean-scope>session</managed-bean-scope>
</managed-bean>
</faces-config>
E já que declaramos o agenda.AgendaMB, vamos então criá-lo, seguindo o mesmo ritual, botão direito, New>Java Class ........ ctrl+v.
package agenda;
import java.util.Date;
import javax.ejb.EJB;
import javax.faces.context.FacesContext;
import javax.faces.model.DataModel;
import javax.faces.model.ListDataModel;
public class AgendaMB {
private Agenda agenda;
private DataModel lista;
@EJB
private AgendaLocal agendaBean;
public void salvar(){
agendaBean.salvar(agenda);
this.agenda = null;
this.lista = null;
}
public void excluir(){
agendaBean.excluir(agenda);
this.agenda = null;
this.lista = null;
}
public DataModel getLista(){
if (lista==null) {
lista = new ListDataModel(agendaService.consultar());
}
return lista;
}
public void selecionar(){
agenda = (Agenda) lista.getRowData();
}
public Agenda getAgenda(){
if (agenda ==null)
agenda =new Agenda();
return agenda;
}
}
Agora vamos a parte chata, criar a pagina jsp para nossa agenda, afinal vamos ter que fazer mais ctrl+c ctrl+v. Mais uma vez botão direito..... O nome da página será agenda (dã!).
<%@page contentType="text/html"%>
<%@page pageEncoding="UTF-8"%>
<%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %>
<%@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<f:view>
<head>
<title>Agenda</title>
</head>
<body>
<h1>Agenda</h1>
<h:form>
<h:panelGrid columns="2">
<h:outputLabel id="labelID" value="ID" />
<h:panelGroup>
<h:inputText id="id" value="#{agendaMB.agenda.id}"
disabled="true" label="labelID">
<f:convertNumber integerOnly="true"/>
</h:inputText>
<h:message for="id"
errorStyle="color:red"/>
</h:panelGroup>
<h:outputLabel id="labelNome" value="Nome"/>
<h:panelGroup>
<h:inputText id="nome" value="#{agendaMB.agenda.nome}"
label="labelNome" size="40" maxlength="50"
required="true"/>
<h:message for="nome"
errorStyle="color:red"/>
</h:panelGroup>
<h:outputLabel id="labelTelefone" value="Telefone"/>
<h:panelGroup>
<h:inputText id="telefone"
value="#{agendaMB.agenda.telefone}"
label="labelTelefone" size="20"
maxlength="30"/>
<h:message for="telefone"
errorStyle="color:red"/>
</h:panelGroup>
<h:outputLabel id="labelEmail" value="E-Mail"/>
<h:panelGroup>
<h:inputText id="email"
value="#{agendaMB.agenda.email}"
label="labelEmail" size="30" maxlength="30"/>
<h:message for="email"
errorStyle="color:red"/>
</h:panelGroup>
<h:outputLabel id="labelNascimento"
value="Data de Nascimento"/>
<h:panelGroup>
<h:inputText id="dtnascimento"
value="#{agendaMB.agenda.dtnascimento}"
label="labelNascimento" size="12" maxlength="10">
<f:convertDateTime pattern="dd/MM/yyyy" />
</h:inputText>
<h:message for="dtnascimento"
errorStyle="color:red"/>
</h:panelGroup>
<f:facet name="footer">
<h:panelGroup>
<h:commandButton value="Salvar"
action="#{agendaMB.salvar}" />
<h:commandButton value="Excluir"
action="#{agendaMB.excluir}"
rendered="#{agendaMB.agenda.id>0}" />
</h:panelGroup>
</f:facet>
</h:panelGrid>
</h:form>
<hr/>
<h:form>
<h:dataTable value="#{agendaMB.lista}" var="linha">
<h:column>
<f:facet name="header">
<h:outputText value="ID"/>
</f:facet>
<h:commandLink action="#{agendaMB.selecionar}" >
<h:outputText value="#{linha.id}" />
</h:commandLink>
</h:column>
<h:column>
<f:facet name="header">
<h:outputText value="Nome"/>
</f:facet>
<h:outputText value="#{linha.nome}" />
</h:column>
</h:dataTable>
</h:form>
</body>
</f:view>
</html>
E por último vamos alterar a pagina index.jsp que é criada por default para que ela redirecione para nossa página, é só apagar tudo que tem la e incluir este bloco imenso de código (o maior ate agora):
<jsp:forward page="agenda.jsf" />
(pelo menos a fonte é a maior :)
Agora é só executar a aplicação e começar a cadastrar os contatos. Num próximo post vou comentar alguns passos (afinal isto aqui ja ta grande pacas).
E por favor comentem pra eu saber que não foi só a minha esposa que viu :P
