EJB3 – JPA – JSF trong 1 ví dụ

EJB3 – JPA – JSF với Eclipse

Created-by: Võ Văn Hải
Blog: https://vovanhai.wordpress.com

Trong bài này, chúng ta dùng lại bài đã nói về JSF trong Eclipse. Ta sẽ hoàn thành các công việc sau:

Tạo Database trong MySQL

Bạn có thể dùng MySQL command-line, hoặc tool MySQLQueryBrowser, hoặc tool MySQLAdministrator để tạo 1 database có tên là test1.

Tạo database project với Eclipse

Trong Eclipse, vào menu Window->Open Perspective, chọn Other

Chọn Database Development. Nhấn OK. Layout của eclipse sẽ đổi và phía bên trái của ta có cửa sổ Data Source Explorer thay vì Project Explorer.

Nhấn phải chuột lên mục Databases, chọn New. Cửa sổ sau xuất hiện

Chọn mục MySQL, gõ tên của Connection Profile là « CustomersDB_profiles ». nhấn Next, gõ vào các thông tin cần thiết như hình.

Bạn có thể nhấn nút Test Connection để đảm bảo rằng kết nối của bạn thành công trước khi tiếp tục làm việc tiếp. Nhấn Finish để kết thúc việc tạo database project. Kết quả trong Data Source Explorer như sau

Bạn tạo bảng mới trong database vừa tạo bằng cách nhấn phải chuột lên mục Tables trong Data Souce Explorer của database vửa tạo rồi chọn “New Table”. Theo wizard bạn tạo bảng để có kết quả như câu query sau:

CREATE TABLE customers ( id INT NOT NULL, name VARCHAR(255), PRIMARY KEY (id) );

Kết quả hoàn tất:

OK. Bây giờ phần Database đã hoàn tất, bạn có thể tạo 1 EJB project được rồi đấy.

Tạo EJB Project (làm Business Logic)

Bạn quay lại JavaEE Perspective bằng cách vào menu Window->Open Perspective->Others, chọn Java EE.

Vào menu File->New->Others, chọn mục EJB->EJB Project.

Đặt tên Project là FirstJPAProject.

Mục Target runtime chọn Jboss4.2.2 (nếu chưa có bạn phải cấu hình 1 cái bằng cách nhấn nút New bên cạnh). EJB Module version chọn 3.0.

Trong mục Configuration, nhấn nút Modify. Chọn “Java Persistence 1.0” như hình

Nhấn OK.

Nhấn Next 2 lần, cửa sổ sau xuất hiện

Đảm bảo bạn chọn đúng như hình. Nhấn Finish để hoàn tất bước này.

Tạo Entity

Bây giờ chúng ta sẽ dùng wizard “Generate Entities” để sinh ra JPA entity từ bảng cơ sở dữ liệu của chúng ta.

Nhấn phải chuột lên project JPA của chúng ta, chọn đến mục “JPA Tools->Generate Entities…”. Cấu hình như hình sau:

Nhấn Next. Trong package gõ vovanhai.wordpress.jpa và trong Tables nhớ check vào bảng customers như hình.

Nhấn Finish. Chúng ta sẽ có lớp Customers trong gói vovanhai.wordpress.jpa. Nhưng mọi thứ dường như có lỗi. Hãy an tâm! Chúng ta cần phải chuyển perspective cho nó và fix lỗi này bằng cách:

Vào menu Window->Open Perspective, chọn Other sau đó chọn JPA. Eclipse sẽ chuyển layout sang JPA. Ở góc dưới của màn hình bên phải ta thấy bảng sau xuất hiện và bạn sẽ cấu hình như hình sau

Good! Lưu file Customers.java, mọi lỗi sẽ được giải quyết!.

Có lẽ chúng ta nên đổi tên lớp từ Customers lại thành Customer bởi theo chuẩn thì tên lớp không thể ở dạng số nhiều bằng cách chọn tên lớp Customers, nhấn tổ hợp phím Alt-Shift-R sau đó bỏ chữ s rồi nhấn Enter. Sau đó ta phải đổi annotation của lớp lại như sau:

@Entity @Table(schema=“test1”, name=“customers”) public class Customer implements Serializable { //… }

Bạn có thể hiệu chỉnh lớp này lại theo ý mình, chẳng hạn tôi thêm vào annotation cho phép id tự động tăng khi thêm 1 mẫu tin. Code hoàn chỉnh như sau:

package vovanhai.wordpress.jpa; import java.io.Serializable; import javax.persistence.Entity; import javax.persistence.GeneratedValue; import javax.persistence.GenerationType; import javax.persistence.Id; import javax.persistence.Table; @Entity @Table(schema=“test1”, name=“customers”) public class Customer implements Serializable { @Id @GeneratedValue(strategy=GenerationType.IDENTITY) private int id; private String name; private static final long serialVersionUID = 1L; public Customer() { super(); } public Customer(String name) { this.name=name; } public int getId() { return this.id; } public void setId(int id) { this.id = id; } public String getName() { return this.name; } public void setName(String name) { this.name = name; } }

Tạo Enterprise Java Bean

1. Tạo Remote Interface: Vào Menu File->New->Interface, đặt tên Interface là CustomerDAO. Tất nhiên nó nằm cùng gói với Customer class. Nội dung như sau

package vovanhai.wordpress.jpa; import java.util.Collection; import javax.ejb.Remote; @Remote public interface CustomerDAO { public void addCustomer(Customer customer); public Customer findCustomerByID(int id); public Collection<Customer>getAllCustomers(); }

2. Tạo stateless session bean: tạo 1 lớp mới có tên CustomerDAOBean với nội dung sau:

package vovanhai.wordpress.jpa; import java.util.Collection; import javax.ejb.Stateless; import javax.persistence.EntityManager; import javax.persistence.PersistenceContext; @Stateless public class CustomerDAOBean implements CustomerDAO { @PersistenceContext (name=“FirstJPAProject”) private EntityManager entityManager; @Override public void addCustomer(Customer customer) { entityManager.persist(customer); } @Override public Customer findCustomerByID(int id) { return entityManager.find(Customer.class, id); } @SuppressWarnings(“all”) @Override public Collection<Customer> getAllCustomers() { return (Collection<Customer>) (entityManager.createQuery(“from Customer c”) .getResultList()); } }

3. Cấu hình đặc tả triển khai (deployment descriptor):

Mở file Persistence.xml và cấu hình như sau

<?xml version=“1.0” encoding=“UTF-8”?> <persistence version=“1.0” xmlns=“http://java.sun.com/xml/ns/persistence&#8221; xmlns:xsi=“http://www.w3.org/2001/XMLSchema-instance&#8221; xsi:schemaLocation=“http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd&#8221;> <persistence-unit name=“demoJPA”> <jta-data-source>java:/MySQLDS</jta-data-source> <properties> <property name=“hibernate.dialect” value=“org.hibernate.dialect.MySQLDialect” /> <property name=“hibernate.hbm2ddl.auto” value=“create-drop” /> </properties> </persistence-unit> </persistence>

Lưu ý :

<jta-data-source>java:/MySQLDS</jta-data-source> là data source mà bạn phải cấu hình trong Jboss bằng cách thêm hoặc sửa file mysql-ds.xml sao cho có dạng sau

<datasources> <local-tx-datasource> <jndi-name>MySQLDS</jndi-name> <connection-url>jdbc:mysql://localhost:3306/test1</connection-url> <driver-class>com.mysql.jdbc.Driver</driver-class> <user-name>root</user-name> <password></password> <exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.MySQLExceptionSorter</exception-sorter-class-name> <metadata> <type-mapping>mySQL</type-mapping> </metadata> </local-tx-datasource> <!–các data source khác ở phần tiếp theo–> <!–…–> </datasources>

<property name=“hibernate.hbm2ddl.auto” value=“create-drop” /> chỉ cho hibernate tạo mới bảng khi triển khai cũng như xóa bảng khi kết thúc. Nếu ban muốn giữ các mẫu tin sau khi kết thúc thì bạn đổi value lại thành update (Chỗ này đọc thêm trong tài liệu hibernate sẽ hiểu thêm).

4. Triển khai

Bạn có thể nhấn phải chuột lên project và chọn Run As-> Run on server. Nhớ chọn server là Jboss nhé.

Bạn sẽ thấy kết quả khi triển khai dạng như sau

………… 15:23:46,356 INFO [NamingHelper] JNDI InitialContext properties:{java.naming.factory.initial=org.jnp.interfaces.NamingContextFactory, java.naming.factory.url.pkgs=org.jboss.naming:org.jnp.interfaces} 15:23:46,527 INFO [JmxKernelAbstraction] creating wrapper delegate for: org.jboss.ejb3.stateless.StatelessContainer 15:23:46,531 INFO [JmxKernelAbstraction] installing MBean: jboss.j2ee:jar=FirstJPAProject.jar,name=CustomerDAOBean,service=EJB3 with dependencies: 15:23:46,531 INFO [JmxKernelAbstraction] persistence.units:jar=FirstJPAProject.jar,unitName=FirstJPAProject 15:23:46,570 INFO [EJBContainer] STARTED EJB: vovanhai.wordpress.jpa.CustomerDAOBean ejbName: CustomerDAOBean 15:23:46,619 INFO [EJB3Deployer] Deployed: file:/E:/javaSoft/jboss-4.2.3.GA/server/default/deploy/FirstJPAProject.jar 15:23:46,745 INFO [TomcatDeployer] deploy, ctxPath=/jmx-console, warUrl=…/deploy/jmx-console.war/ 15:23:47,010 INFO [Http11Protocol] Starting Coyote HTTP/1.1 on http-127.0.0.1-8080 15:23:47,028 INFO [AjpProtocol] Starting Coyote AJP/1.3 on ajp-127.0.0.1-8009 15:23:47,037 INFO [Server] JBoss (MX MicroKernel) [4.2.3.GA (build: SVNTag=JBoss_4_2_3_GA date=200807181439)] Started in 25s:806ms

Chúc mừng bạn đã thành công!

5. Tạo Client để thử

Tạo lớp có tên Client với nội dung code như sau:

package vovanhai.wordpress.jpa; import javax.naming.InitialContext; public class Client { public static void main(String[] args) { try { System.setProperty(“java.naming.factory.initial”, “org.jnp.interfaces.NamingContextFactory”); System.setProperty( “java.naming.provider.url”, “localhost:1099” ); System.setProperty( “java.naming.factory.url.pkgs”, “org.jboss.naming” ); InitialContext context=new InitialContext(); CustomerDAO dao=(CustomerDAO)context.lookup(“CustomerDAOBean/remote”); Customer firstCust=new Customer(); firstCust.setId(1); firstCust.setName(“Nguyen Van Teo”); dao.addCustomer(firstCust); Customer found=dao.findCustomerByID(1); System.out.println(found.getName()); } catch (Exception e) { e.printStackTrace(); } } }

Mọi thứ tuyệt vời quá phải không? Mở database MySQL, bạn sẽ thấy mẫu tin của bạn đã có ở đấy.

Tạo JSF project (làm Presentation Logic)

Ở đây thay vì tạo mới 1 JSF project, ta sử dụng lại bài tạo JSF project đã nói ở phần trước. Ta chỉ hiệu chỉnh lại vài chỗ:

1. Tham chiếu cho project đến JPA project của chúng ta

Nhấn phải chuột lên FirstJSFProject chọn Properties. Chọn mục “java EE Module Dependencies” sau đó check vào FirstJPAProject. Nhấn OK.

2. Thay đổi nội dung bean và các trang jsp

Nội dung của lớp CustomerBean bây giờ như sau

package vovanhai.com.web; import java.util.Collection; import javax.naming.InitialContext; import vovanhai.wordpress.jpa.Customer; import vovanhai.wordpress.jpa.CustomerDAO; public class CustomerBean { private int id; private String name; public CustomerBean() { this.id = 0; this.name = “no-name”; } public CustomerBean(int id, String name) { this.id = id; this.name = name; } public int getId() { return id; } public void setId(int id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public String add(){ CustomerDAO dao=getCustomerDAO(); Customer cust=new Customer(); cust.setId(id); cust.setName(name); dao.addCustomer(cust); return “success”; } public Collection<Customer>getAll(){ return getCustomerDAO().getAllCustomers(); } private CustomerDAO getCustomerDAO(){ CustomerDAO dao=null; try { System.setProperty(“java.naming.factory.initial”, “org.jnp.interfaces.NamingContextFactory”); System.setProperty( “java.naming.provider.url”, “localhost:1099” ); System.setProperty( “java.naming.factory.url.pkgs”, “org.jboss.naming” ); InitialContext context=new InitialContext(); dao=(CustomerDAO)context.lookup(“CustomerDAOBean/remote”); } catch (Exception e) { e.printStackTrace(); } return dao; } }

Nội dung file addCustomer,jsp không đổi.

Nội dung của trang listCustomers.jsp bây giờ như sau

<%@taglib uri=“http://java.sun.com/jsf/core&#8221; prefix=“f”%><%@taglib uri=“http://java.sun.com/jsf/html&#8221; prefix=“h”%><%@ page language=“java” contentType=“text/html; charset=UTF-8” pageEncoding=“ISO-8859-1”%> <!DOCTYPE html PUBLIC “-//W3C//DTD HTML 4.01 Transitional//EN” “http://www.w3.org/TR/html4/loose.dtd&#8221;> <html> <head> <meta http-equiv=“Content-Type” content=“text/html; charset=ISO-8859-1”> <title>List Customers</title> </head> <body> <f:view> <h:form> <h:dataTable border=“1” value=“#{customerBean.all}” var=“currentCustomer”> <h:column id=“column1”> <h:outputText value=“#{currentCustomer.id}”></h:outputText> <f:facet name=“header”> <h:outputText value=“id”></h:outputText> </f:facet> </h:column> <h:column id=“column2”> <h:outputText value=“#{currentCustomer.name}”></h:outputText> <f:facet name=“header”> <h:outputText value=“name”></h:outputText> </f:facet> </h:column> </h:dataTable> </h:form> </f:view> </body> </html>

Chạy file addCustomer.jsp. Bạn thử thêm vài mẫu tin. Mở database lên xem thử kết quả thế nào!

Chúc các bạn thành công!