Seam Hello World
เกริ่นนำ
Seam คือ application framework สำหรับ JavaEE5 เป็นโปรเจคหนึ่งของ JBoss พัฒนาขึ้นโดย Gavin King (ผู้เริ่มคิดค้น Hibernate ORM framework) โดย framework พัฒนาขึ้นโดยนำแนวคิดในกาัรพัฒนา web application framework หลายๆ ตัวมาใช้โดยเป้าหมายของ framework ตัวนี้คือ
"One of the (several) goals of Seam is to bring Ruby On Rails style productivity to the Java EE platform" (^^)
ความสามารถพื้นฐานของ seam คือมันเป็นกาวที่ทำให้ EJB3 กับ JSF มันเชื่อมต่อกันได้อย่างสวยงาม ถ้ามองกันการพัฒนา web application ตามมาตรฐานของ Sun ที่มีอยู่อาจต้องใช้ JNDI lookup, ประกาศ JSF backing bean, facade business method หรือความพยายามในการส่ง object ข้ามไปยัง tier ต่างๆ ที่เรารู้จักกันใน pattern ที่ชื่อ DTO (Data Transfer Object) แต่ seam มันบอกว่าสิ่งเหล่านี้เป็นความฟุ่มเฟื่อยแล้วมันจะ integerate JSF กับ EJB3 ให้เองโดยเราไม่ต้องไปเขียน xml config อะไรให้ฟุ้มเฟือย ในตัวอย่างนี้จะมาดูว่ามันเชื่อมต่อกันยังไง (คร่าวสุดๆ นะเพราะอยากให้เห็น code โดยรวมก่อน)
ลงมือ
1. สร้างโปรเจค
ก่อนอื่นติดตั้ง Eclipse + JBoss Tool ให้เรียบร้อย (หรืออาจใช้ seam gen สร้างโปรเจคขึ้นมาแล้วจับยัด (import) ลง Eclipse) เมื่อติดตั้งเรียบร้อยแล้วก็สร้าง seam web project ขึ้นมา config ให้เรียบร้อยเลือก deploy เป็น ear นะ (สมมุติ project นี้ชื่อ hello)
2. สร้าง Data Model
เกริ่นนำ
Seam คือ application framework สำหรับ JavaEE5 เป็นโปรเจคหนึ่งของ JBoss พัฒนาขึ้นโดย Gavin King (ผู้เริ่มคิดค้น Hibernate ORM framework) โดย framework พัฒนาขึ้นโดยนำแนวคิดในกาัรพัฒนา web application framework หลายๆ ตัวมาใช้โดยเป้าหมายของ framework ตัวนี้คือ
"One of the (several) goals of Seam is to bring Ruby On Rails style productivity to the Java EE platform" (^^)
ความสามารถพื้นฐานของ seam คือมันเป็นกาวที่ทำให้ EJB3 กับ JSF มันเชื่อมต่อกันได้อย่างสวยงาม ถ้ามองกันการพัฒนา web application ตามมาตรฐานของ Sun ที่มีอยู่อาจต้องใช้ JNDI lookup, ประกาศ JSF backing bean, facade business method หรือความพยายามในการส่ง object ข้ามไปยัง tier ต่างๆ ที่เรารู้จักกันใน pattern ที่ชื่อ DTO (Data Transfer Object) แต่ seam มันบอกว่าสิ่งเหล่านี้เป็นความฟุ่มเฟื่อยแล้วมันจะ integerate JSF กับ EJB3 ให้เองโดยเราไม่ต้องไปเขียน xml config อะไรให้ฟุ้มเฟือย ในตัวอย่างนี้จะมาดูว่ามันเชื่อมต่อกันยังไง (คร่าวสุดๆ นะเพราะอยากให้เห็น code โดยรวมก่อน)
ลงมือ
1. สร้างโปรเจค
ก่อนอื่นติดตั้ง Eclipse + JBoss Tool ให้เรียบร้อย (หรืออาจใช้ seam gen สร้างโปรเจคขึ้นมาแล้วจับยัด (import) ลง Eclipse) เมื่อติดตั้งเรียบร้อยแล้วก็สร้าง seam web project ขึ้นมา config ให้เรียบร้อยเลือก deploy เป็น ear นะ (สมมุติ project นี้ชื่อ hello)
2. สร้าง Data Model
package org.domain.hello.entity;
import java.io.Serializable;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;
import org.jboss.seam.annotations.Name;
@Entity
@Name("person")
public class Person implements Serializable{
private static final long serialVersionUID = 1L;
private long id;
private String name;
@Id @GeneratedValue
public long getId() {
return id;
}
public void setId(long id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
import java.io.Serializable;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;
import org.jboss.seam.annotations.Name;
@Entity
@Name("person")
public class Person implements Serializable{
private static final long serialVersionUID = 1L;
private long id;
private String name;
@Id @GeneratedValue
public long getId() {
return id;
}
public void setId(long id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
ด้วยความง่ายของ EJB3 เราสร้าง POJO + Annotation ก็จะกลายเป็น component หนึ่งของ EJB3 ในตัวอย่างนี้เป็น entity bean
โดยเราใช้ @Entity annotation เพื่อจะบอกว่าเราจะ map class นี้กับ relational database table ไหน และ attribute ที่เราอยู่ใน class ก็จะ map เข้ากับ column ใน table นั้น ดังนั้น 1 row ก็จะเท่ากับ 1 person instance (เพราะว่า seam บอกว่าการ configuration เป็นสิ่งทีมันพยายามหลีกเลี่ยงจึงใช้ annotation ในการช่วย config และเราไม่ต้องไปเขียน config xml ให้ฟุ่มเฟือย) และมี @Id เพื่อบอกถึง attribute ที่มันเป็น primary key และใช้ @GeneratedValue เพื่อบอกให้ application server สร้างค่าให้อัตโนมัติกับ Person instance เมื่อ save ลง database (ในตัวอย่างจะเห็นว่าเราไม่ต้องระบุชื่อ column เพราะใน table กับ class เราตั้งชื่อตรงกัน แต่ถ้าคนละชื่อต้องใช้ annotation เพื่อระบุชื่อลงด้วย)
ส่วนสำคัญที่สุดของ class นี้คือ @Name มันเป็นการ register กับ seam เพื่อให้เราสามารถเข้าจัดการ Person bean ตัวนี้ได้โดยการอ้างชื่อ person
3. Map ตัว Data Model กับ Web Formโดยเราใช้ @Entity annotation เพื่อจะบอกว่าเราจะ map class นี้กับ relational database table ไหน และ attribute ที่เราอยู่ใน class ก็จะ map เข้ากับ column ใน table นั้น ดังนั้น 1 row ก็จะเท่ากับ 1 person instance (เพราะว่า seam บอกว่าการ configuration เป็นสิ่งทีมันพยายามหลีกเลี่ยงจึงใช้ annotation ในการช่วย config และเราไม่ต้องไปเขียน config xml ให้ฟุ่มเฟือย) และมี @Id เพื่อบอกถึง attribute ที่มันเป็น primary key และใช้ @GeneratedValue เพื่อบอกให้ application server สร้างค่าให้อัตโนมัติกับ Person instance เมื่อ save ลง database (ในตัวอย่างจะเห็นว่าเราไม่ต้องระบุชื่อ column เพราะใน table กับ class เราตั้งชื่อตรงกัน แต่ถ้าคนละชื่อต้องใช้ annotation เพื่อระบุชื่อลงด้วย)
ส่วนสำคัญที่สุดของ class นี้คือ @Name มันเป็นการ register กับ seam เพื่อให้เราสามารถเข้าจัดการ Person bean ตัวนี้ได้โดยการอ้างชื่อ person
ให้เราสร้างไฟล์ hello.xhtml ไว้ใน WebContent ก่อน
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"
xmlns:h="http://java.sun.com/jsf/html"
xmlns:f="http://java.sun.com/jsf/core"
xmlns:ui="http://java.sun.com/jsf/facelets">
<head>
<title>Hello Page</title>
</head>
<body>
<h:form>
Please enter your name: <br/>
<h:inputText value="#{person.name}" size="15" /> <br/>
<h:commandButton action="#{manager.sayHello}" value="Say Hello" />
</h:form>
<h:dataTable value="#{fans}" var="fan">
<h:column>
<h:outputText value=#{fan.id}" />
</h:column>
<h:column>
<h:outputText value="#{fan.name}" />
</h:column>
</h:dataTable>
</body>
</html>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"
xmlns:h="http://java.sun.com/jsf/html"
xmlns:f="http://java.sun.com/jsf/core"
xmlns:ui="http://java.sun.com/jsf/facelets">
<head>
<title>Hello Page</title>
</head>
<body>
<h:form>
Please enter your name: <br/>
<h:inputText value="#{person.name}" size="15" /> <br/>
<h:commandButton action="#{manager.sayHello}" value="Say Hello" />
</h:form>
<h:dataTable value="#{fans}" var="fan">
<h:column>
<h:outputText value=#{fan.id}" />
</h:column>
<h:column>
<h:outputText value="#{fan.name}" />
</h:column>
</h:dataTable>
</body>
</html>
ใน JSF page นี้เราจะใช้ Person bean เป็นตัวเก็บข้อมูลเวลา input field เข้ามาโดยใช้ Expression Language (EL) #{person.name} (สังเกตุเราอ้างถึง person bean และกำหนดว่าให้เก็บลงใน attribute ที่ชื่อ name)
มีการเรียกตัว session bean ชื่อ sayHello ใน manager bean
และส่วนสุดท้ายเป็นการแสดงผลค่า fans ออกมาโดยใช้ dataTable มันจะเป็น iterater แล้ว list รายการ fans ออกมาจาก list ทั้งหมด
เมื่อผู้ใช้คลิกปุ่ม Say Hello ตัว Seam จะสร้าง person bean เพื่อรับ input data และเรียกไปที่ sayHello method ของ class ManagerAction ที่เป็น session bean
มีการเรียกตัว session bean ชื่อ sayHello ใน manager bean
และส่วนสุดท้ายเป็นการแสดงผลค่า fans ออกมาโดยใช้ dataTable มันจะเป็น iterater แล้ว list รายการ fans ออกมาจาก list ทั้งหมด
เมื่อผู้ใช้คลิกปุ่ม Say Hello ตัว Seam จะสร้าง person bean เพื่อรับ input data และเรียกไปที่ sayHello method ของ class ManagerAction ที่เป็น session bean
package org.domain.hello.session;
import java.util.List;
import javax.ejb.Stateless;
import javax.persistence.EntityManager;
import javax.persistence.PersistenceContext;
import org.domain.hello.entity.Person;
import org.jboss.seam.annotations.In;
import org.jboss.seam.annotations.Logger;
import org.jboss.seam.annotations.Name;
import org.jboss.seam.annotations.Out;
import org.jboss.seam.log.Log;
@Stateless
@Name("manager")
public class ManagerAction implements Manager{
@In @Out
private Person person;
@Out
private List<Person> fans;
@Logger
private Log log;
@PersistenceContext
private EntityManager em;
public String sayHello(){
log.info("start sayHello");
em.persist(person);
fans = em.createQuery("select p from Person p").getResultList();
log.info("end sayHello");
return null;
}
}
manager component ใน Seam คือ ManagerAction ที่เป็น session bean โดยเราใช้ @Name ในการประกาศชื่อ
@In (dependency injection) เป็นการบอกให้ Seam assign ตัว person component เข้ามาให้ โดยมันจะมาจากหน้า JSF form data ซึ่ง Seam จะส่งค่าให้ person ก่อนที่จะเข้ามาทำงานใน method ของ session bean
@Out (dependency outjection) เป็นการบอกให้ Seam assign ค่าของ fans ที่เก็บเป็น list of person หลังจากที่ execution method เสร็จแล้ว เช่นใน sayHello() method เรา update ค่า fans และ person field เมื่อทำงานใน method นี้เสร็จค่า fans จะถูก update ใหม่และส่งให้ที่หน้าเวบเพจ
บางครั้ง Seam อาจเรียกว่า bijection ซึ่งมันเป็นการอ้างถึง injection และ oiutjection ระหว่าง seam component กับ seam managed context
ใน sayHello() method จะทำการเก็บข้อมูลที่กรอบเข้ามาลงใน database ผ่าน EntityManager (JPA) ซึ่งตัว EntityManager ได้มาจากการ inject ผ่าน @PersistenceContext และเมื่อทำงานเสร็จแล้วก็ return null นั่นหมายถึงไม่มีการเปลี่ยนไปหน้า JSF page อื่นต่อ
แน่นอนสุดท้ายตามข้อกำหนด session bean อย่าลืม local ด้วยละ (เมื่อเราต้องการเรียกแบบ local)
package org.domain.hello.session;
import javax.ejb.Local;
@Local
public interface Manager {
public abstract String sayHello();
}
No comments:
Post a Comment