細(xì)心!用心!耐心!

吾非文人，乃市井一俗人也，讀百卷書，跨江河千里，故申城一游；一兩滴辛酸，三四年學(xué)業(yè)，五六點(diǎn)粗墨，七八筆買賣，九十道人情。

BlogJava 聯(lián)系聚合

管理

1 Posts :: 196 Stories :: 10 Comments :: 0 Trackbacks

常用鏈接

留言簿(5)

隨筆分類

文章分類

文章檔案

收藏夾

Doug Lea關(guān)于util.concurrent并發(fā)工具包的講座(3)

搜索

環(huán)境準(zhǔn)備

　　由于Kodo是基于注釋機(jī)制的框架，我們必須使用JDK5.0完成開發(fā)工作。所以下載、安裝Kodo之前，請(qǐng)確保您已經(jīng)下載和安裝了JDK5.0。

　　為了演示的需要，我們選擇MySQL數(shù)據(jù)庫作為持久化的目標(biāo)數(shù)據(jù)庫，請(qǐng)大家自己到www.mysql.com下載最新的MySQL數(shù)據(jù)庫后安裝。

安裝Kodo

　　Kodo的最新版本是Kodo 4.0.0 Early Access 4，目前大家可以到http://www.solarmetric.com/去下載試用版本，下載時(shí)需要注冊(cè)，你會(huì)得到30天的License。
將下載的壓縮文件解壓到c:/kodo4目錄下(后面將使用%KODO_HOME%來引用這個(gè)目錄)，打開%KODO_HOME%/bin/kodocmd.cmd文件，將其中的KODODIR設(shè)置為您的Kodo的安裝目錄，將JDKHOME設(shè)置為Java的安裝目錄。

安裝Weblogic9

　　Kodo EJB在JAVA EE環(huán)境下運(yùn)行時(shí)需要EJB容器支持EJB3標(biāo)準(zhǔn)，BEA最新發(fā)布的Weblogic9服務(wù)器就支持EJB3標(biāo)準(zhǔn)，因此我們選擇Weblogic9作為演示時(shí)使用的目標(biāo)服務(wù)器。大家可以到http://www.bea.com下載Weblogic9，然后將Weblogic9安裝到自己的機(jī)器上。

　　[注]本文中的實(shí)例是實(shí)現(xiàn)可遠(yuǎn)程訪問的EJB實(shí)例，因此你可以將Weblogic9安裝到其他機(jī)器上，不過客戶端調(diào)用的時(shí)候需要增加一些環(huán)境變量，請(qǐng)參考后面的說明。

開發(fā)Kodo EJB應(yīng)用

　　由于篇幅的關(guān)系，我們直接使用《Kodo EJB：符合EJB3規(guī)范的持久層框架》一文中已經(jīng)創(chuàng)建好的例子，包括環(huán)境準(zhǔn)備、持久化類創(chuàng)建、數(shù)據(jù)庫創(chuàng)建等工作，下面的章節(jié)中將盡量不再重復(fù)《Kodo EJB：符合EJB3規(guī)范的持久層框架》一文中已經(jīng)提到的步驟，而是重點(diǎn)描述需要額外完成的工作。

　　在EJB開發(fā)中，我們通常都采用Session Façade設(shè)計(jì)模式，因此下面的例子也使用了這種設(shè)計(jì)模式來封裝Kodo EJB應(yīng)用。

　　我們使用一個(gè)無狀態(tài)的Session Bean來封裝對(duì)Book類的所有操作，由于Kodo EJB應(yīng)用中需要開發(fā)者完成kodo.persistence.EntityManagerFactoryImpl的實(shí)例到JNDI的綁定，我們把這部分工作訪在Session Bean中完成，下面是Session Bean的接口和實(shí)現(xiàn)的全部代碼，請(qǐng)注意代碼中增加的注釋，他們有助于您了解Kodo EJB如何工作的。

BookBean類

　　下面是BookBean類的源代碼，請(qǐng)大家特別注意BookBean類中的setSessionContext方法，其中的代碼將
kodo.persistence.EntityManagerFactoryImpl的實(shí)例綁定到JNDI上。

package org.vivianj.kodo.examples.ejb.stateless;
import java.rmi.RemoteException;
import java.util.Collection;
import javax.ejb.EJBException;
import javax.ejb.SessionBean;
import javax.ejb.SessionContext;
import javax.naming.InitialContext;
import javax.naming.NamingException;
import javax.persistence.EntityManager;
import javax.persistence.EntityManagerFactory;
import javax.persistence.PersistenceContextType;
import javax.persistence.Query;
import kodo.persistence.KodoPersistence;
import org.vivianj.kodo.examples.beans.Book;
/**
* BookBean 提供Session Bean的實(shí)現(xiàn)類
*/
public class BookBean implements SessionBean {
protected SessionContext ctx;
private EntityManagerFactory emf;
/**
* getBookById 根據(jù)Book對(duì)象的id屬性查找、返回符合條件的Book對(duì)象
*
* @param id
*      Book對(duì)象的編號(hào)
* @return 編號(hào)為id的Book對(duì)象
* @throws RemoteException
*/
public Book getBookById(int id) throws RemoteException {
/* 獲得EJB的實(shí)體管理器 */
EntityManager em = emf
.createEntityManager(PersistenceContextType.EXTENDED);
try {
/* 開始事務(wù) */
em.getTransaction().begin();
/* 處理業(yè)務(wù) */
Book book = em.find(Book.class, id);
/* 結(jié)束事務(wù) */
em.getTransaction().commit();
return book;
} finally {
/* 關(guān)閉EJB實(shí)體管理器 */
em.close();
}
}
/**
* updateBook 更新Book對(duì)象的信息
*
* @param book
*      需要更新的Book對(duì)象
* @throws RemoteException
*/
public void updateBook(Book book) throws RemoteException {
/* 獲得EJB的實(shí)體管理器 */
EntityManager em = emf.getEntityManager();
try {
/* 開始事務(wù) */
em.getTransaction().begin();
/* 處理業(yè)務(wù) */
em.merge(book);
/* 結(jié)束事務(wù) */
em.getTransaction().commit();
} finally {
/* 關(guān)閉EJB實(shí)體管理器 */
em.close();
}
}
/**
* createBook 方法用于持久化新的Book對(duì)象
*
* @param book
*      被持久化的Book對(duì)象
* @throws RemoteException
*/
public void createBook(Book book) throws RemoteException {
/* 獲得EJB的實(shí)體管理器 */
EntityManager em = emf.getEntityManager();
try {
/* 開始事務(wù) */
em.getTransaction().begin();
/* 處理業(yè)務(wù) */
em.persist(book);
/* 結(jié)束事務(wù) */
em.getTransaction().commit();
} finally {
/* 關(guān)閉EJB實(shí)體管理器 */
em.close();
}
}
public void deleteBook(Book book) throws RemoteException {
/* 獲得EJB的實(shí)體管理器 */
EntityManager em = emf.getEntityManager();
try {
/* 開始事務(wù) */
em.getTransaction().begin();
/* 處理業(yè)務(wù) */
Query q = em.createQuery("delete from Book c where c.id = :id");
q.setParameter("id", book.id);
q.executeUpdate();
/* 結(jié)束事務(wù) */
em.getTransaction().commit();
} finally {
/* 關(guān)閉EJB實(shí)體管理器 */
em.close();
}
}
public Collection getBooks(String queryString) throws RemoteException {
/* 獲得EJB的實(shí)體管理器 */
EntityManager em = emf.getEntityManager();
try {
/* 開始事務(wù) */
em.getTransaction().begin();
/* 處理業(yè)務(wù) */
List allBooks = em.createQuery(queryString).getResultList();
/* 結(jié)束事務(wù) */
em.getTransaction().commit();
return allBooks;
} finally {
/* 關(guān)閉EJB實(shí)體管理器 */
em.close();
}
}
public void setSessionContext(SessionContext ctx) {
this.ctx = ctx;
try {
/* 獲取JAVA EE容器上下文環(huán)境 */
Context ejbContext = new InitialContext ();
Object o = null;
try{
/* 根據(jù)JNDI查找kodo.persistence.EntityManagerFactoryImpl的實(shí)例 */
o = ejbContext.lookup("ejb/kodo/emf");
}catch(Exception e){
/* 如果沒有找到，嘗試將kodo.persistence.EntityManagerFactoryIm
pl的實(shí)例綁定到JNDI上 */
EntityManagerFactory emfForEjb =
Persistence.createEntityManagerFactory(null);
ejbContext.bind("ejb/kodo/emf",emfForEjb);
}
if (o == null)
{
/* 如果沒有找到，嘗試再次查找 */
emf = (EntityManagerFactory)ejbContext.lookup("ejb/kodo/emf");
}
else {
emf = (EntityManagerFactory)o;
}
} catch (NamingException e) {
throw new RuntimeException(e);
}
}
public void ejbCreate() throws RemoteException {
}
public void ejbActivate() throws EJBException, RemoteException {
}
public void ejbPassivate() throws EJBException, RemoteException {
}
public void ejbRemove() throws EJBException, RemoteException {
}
public void unsetSessionContext() {
ctx = null;
}
}

BookHome接口

package org.vivianj.kodo.examples.ejb.stateless;
import java.rmi.RemoteException;
import javax.ejb.CreateException;
import javax.ejb.EJBHome;
/**
* BookHome 類提供Session Bean的home接口
*/
public interface BookHome extends EJBHome {
public BookRemote create() throws CreateException, RemoteException;
}

BookRemote接口

package org.vivianj.kodo.examples.ejb.stateless;
import java.rmi.RemoteException;
import java.util.Collection;
import javax.ejb.EJBObject;
import org.vivianj.kodo.examples.beans.Book;
/**
* BookRemote 類提供Session Bean的remote接口
*/
public interface BookRemote extends EJBObject {
public Book getBookById(int id) throws RemoteException;
public void updateBook(Book book) throws RemoteException;
public void createBook(Book book) throws RemoteException;
public void deleteBook(Book book) throws RemoteException;
public Collection getBooks(String queryString) throws RemoteException;
}

編寫EJB描述符文件

　　為了將該Session Bean發(fā)布到Weblogic9中，我們還需要提供兩個(gè)配置文件：ejb-jar.xml和weblogic-ejb-jar.xml，作者提供的演示實(shí)例中，這兩個(gè)文件的內(nèi)容如下，開發(fā)者可以根據(jù)自己的實(shí)際環(huán)境進(jìn)行調(diào)整。

ejb-jar.xml

<?xml version="1.0" encoding="UTF-8"?>
<ejb-jar
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
 http://java.sun.com/xml/ns/j2ee/ejb-jar_2_1.xsd"
version="2.1">
<display-name>Sample Kodo EJB</display-name>
<enterprise-beans>
<session>
<ejb-name>BookEJB</ejb-name>
<home>org.vivianj.kodo.examples.ejb.stateless.BookHome</home>
<remote>org.vivianj.kodo.examples.ejb.stateless.BookRemote</remote>
<ejb-class>org.vivianj.kodo.examples.ejb.stateless.BookBean</ejb-class>
<session-type>Stateless</session-type>
<transaction-type>Container</transaction-type>
</session>
</enterprise-beans>
<assembly-descriptor>
<container-transaction>
<method>
<ejb-name>BookEJB</ejb-name>
<method-name>*</method-name>
</method>
<trans-attribute>Required</trans-attribute>
</container-transaction>
</assembly-descriptor>
</ejb-jar>

weblogic-ejb-jar.xml

<?xml version="1.0"?>
<weblogic-ejb-jar
xmlns="http://www.bea.com/ns/weblogic/90"
xmlns:j2ee="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.bea.com/ns/weblogic/90
http://www.bea.com/ns/weblogic/90/weblogic-ejb-jar.xsd">
<weblogic-enterprise-bean>
<ejb-name>BookEJB</ejb-name>
<jndi-name>ejb/kodo/book</jndi-name>
</weblogic-enterprise-bean>
</weblogic-ejb-jar>

打包部署

　　基于Kodo EJB開發(fā)的EJB打包和通常的EJB打包沒有什么特別，部署過程也沒有什么特別，比較簡單的方式是使用配置工具創(chuàng)建新的域后，將打包好的EJB jar文件直接拷貝到域目錄下的autodeploy目錄下。

　　完整地打包部署過程這里不再贅述，如果大家還不是十分熟悉，請(qǐng)大家參考Weblogic Server的在線幫助文檔http://edocs.bea.com/wls/docs91/index.html。

　　在這里要給大家介紹的是創(chuàng)建Weblogic9域后如何配置Kodo的兩部分內(nèi)容：

安裝Kodo
Windows平臺(tái)下創(chuàng)建Weblogic9域后，可以在該域所在目錄下找到bin目錄下的setDomainEnv.cmd文件。打開該文件，在其中找到set PRE_CLASSPATH=這一行，這里假如地jar文件將被加入Weblogic9服務(wù)器的啟動(dòng)CLASSPATH中，因此我們把%KODO_HOME%/lib目錄下所有jar文件增加到PRE_CLASSPATH中。下面是作者的設(shè)置情況（沒有全部填寫完整，請(qǐng)開發(fā)者根據(jù)實(shí)際情況填寫完整）。

set PRE_CLASSPATH= F:/OpenSource/kodo-4.0.0EA4/lib/kodo.jar; F:/OpenSource/kodo-4.0.0EA4/lib/jta-spec1_0_1.jar;F:/OpenSource/kodo-4.0.0EA4/lib/jca1.0.jar;F:/OpenSource/kodo-4.0.0EA4/lib/jdo-2.0.jar;

可選擇的，你可以將數(shù)據(jù)庫服務(wù)器的驅(qū)動(dòng)jar和其他應(yīng)用中需要的jar文件放在這個(gè)變量下。

提供Kodo的license

Kodo使用時(shí)需要提供License文件，在《Kodo EJB：符合EJB3規(guī)范的持久層框架》一文中，我們知道Kodo的License信息保存在應(yīng)用的META-INF目錄中的kodo.xml文件中，和應(yīng)用一起使用，可是在JAVA EE環(huán)境下，我們是將kodo.persistence.EntityManagerFactoryImpl的實(shí)例綁定到JNDI服務(wù)上，這個(gè)過程是服務(wù)器完成的，將License放在EJB包中并不能讓服務(wù)器獲取License的信息，查看Kodo的幫助文檔，也沒有看到相應(yīng)的實(shí)施指南，不過作者經(jīng)過測(cè)試后發(fā)現(xiàn)下面的方法可以完成這部分工作。

準(zhǔn)備一個(gè)license.jar文件
license.jar中包含META-INF目錄，該目錄下包含有提供Kodo License的kodo.xml文件。license.jar文件的結(jié)構(gòu)如下：
將該jar文件加入到Weblogic域的CLASSPATH中

請(qǐng)參考前面一步“安裝Kodo”的步驟將license.jar文件加入Weblogic域的CLASSPATH中。

測(cè)試

　　現(xiàn)在，啟動(dòng)服務(wù)器，編寫段簡單的測(cè)試代碼，看看EJB是否能夠正常開始工作，下面這段代碼可以用于測(cè)試從EJB中查找符合要求的Book對(duì)象并打印它的name屬性。

/* 提供Weblogic服務(wù)器的信息 */
Hashtable<String,String> h = new Hashtable<String,String>();
h.put(Context.INITIAL_CONTEXT_FACTORY,
"weblogic.jndi.WLInitialContextFactory");
h.put(Context.PROVIDER_URL, "t3://localhost:7001");
/* 獲取指定服務(wù)器的上下文路徑 */
Context ctx = new InitialContext(h);
/* 從JNDI中獲取Session Bean的home接口 */
Object o = ctx.lookup("ejb/kodo/book");
BookHome home = (BookHome) PortableRemoteObject.narrow(o,BookHome.class);
/* 獲得Session Bean的remote接口 */
BookRemote remote = home.create();
/* 調(diào)用業(yè)務(wù)方法 */
System.out.println(remote.getBookById(1).name);

　　執(zhí)行客戶端的時(shí)候，請(qǐng)將%KODO_HOME%/lib目錄下的jar文件和Weblogic服務(wù)器安裝目錄下的server/lib/weblogic.jar文件都放在CLASSPATH中。

總結(jié)

　　在EJB3的標(biāo)準(zhǔn)中，EJB3應(yīng)用既可以用于Java SE環(huán)境中，同時(shí)還可以用于Java EE環(huán)境下使用。Kodo EJB中提供了兩種不同的方式支持在Java EE環(huán)境下使用：JCA和JNDI，其中JCA方式比較簡單，而JNDI方式則能夠提供更好的靈活性。

　　在本文中，作者以一個(gè)簡單的例子說明了在Weblogic9中如何將Kodo EJB中kodo.persistence.EntityManagerFactoryImpl的實(shí)例綁定到JNDI上，通過JNDI訪問Kodo EJB應(yīng)用中的持久化類。

參考資源:

　　EJB3規(guī)范：http://jcp.org/aboutJava/communityprocess/pfd/jsr220/index.html
JDO2規(guī)范：http://jcp.org/aboutJava/communityprocess/pfd/jsr243/index.html
Kodo在線文檔：http://solarmetric.com/kodo/Documentation/4.0.0EA4/docs/full/html/index.html
Weblogic9在線文檔:http://edocs.bea.com/wls/docs91/index.html

　　下載資源：kodoejb-JavaEE.jar

posted on 2007-04-17 11:43 張金鵬閱讀(137) 評(píng)論(0) 編輯收藏

新用戶注冊(cè) 刷新評(píng)論列表


只有注冊(cè)用戶登錄后才能發(fā)表評(píng)論。




網(wǎng)站導(dǎo)航: 博客園 IT新聞 Chat2DB C++博客博問管理