整合struts和hibernate開發嚮導

在用struts進行項目開發的時候，你是用什麼來持久化你的數據的呢？（OJB、Castor還是hibernate?）如果沒有，我建議你看看我這篇文章，Hibernate是目前開發員普遍都很推崇的ORM，而且自帶的文檔極其豐富（我爲什麼沒有選擇OJB，恐怕這是主要的原因。）
Struts在今年的下半年初推出了它的1.1正式版，標誌其在成熟和穩定方面有了更一步的提高。本文正是基於此版本，本來想把struts1.1中的好的特性都用到做一個比較好的例子，由於時間的原因，譬如：tiles,exception hadling,validator,多模塊、國際化等等在例子中沒有涉及，相關內容請看我在csdn的專欄文章。
（一）前期準備：
a． struts1.1
http://jakarta.apache.org/struts
b． hibernate 2.0
http://hibernate.bluemars.net/
c． eclipse2.1(呵呵，我比較喜歡的一個IDE，此爲可選)
http://www.eclipse.org/
d． ant1.5.1
http://ant.apache.org/
e． jdk1.4
f． tomcat4.1

(相關網站都可以得到其最新版本)
（二）用例說明
很簡單的一個例子，關係也不復雜：貓科(Animal.java)和貓(Cat.java)。前者對後者是一對多的關係，後者對前者是多對一的關係。
第一部分，和hibernate 相關
1. Animal類

package com.iplateau.test.hibernate.persistence;
import java.util.Set;
/**
* Class or Interface Discription
* @author $Author:jack$
* @version $ReVision:1.0 $ <br/>
* $Id:Animal.java 2003-8-4 16:44:02 jack Exp.
*/
public class Animal {
private String id;
private String name;
private Set cats;

public Animal() {
}

/**
* @return
*/
public Set getCats() {
  return cats;
}
/**
* @return
*/
public String getId() {
  return id;
}
/**
* @return
*/
public String getName() {
  return name;
}
/**
* @param set
*/
public void setCats(Set set) {
  cats = set;
}
/**
* @param string
*/
public void setId(String string) {
  id = string;
}
/**
* @param string
*/
public void setName(String string) {
  name = string;
}
}

Cat類：

package com.iplateau.test.hibernate.persistence;
/**
* Class or Interface Discription
* @author $Author:jack$
* @version $ReVision:1.0 $ <br/>
* $Id:Cat.java 2003-8-3 14:33:11 jack Exp.
*/
public class Cat {

private String id;
private String name;
private String sex;
private float weight;
//select name form Cat as cat where cat.name=
private Animal animal;

public Cat() {
}
/**
* @return
*/
public String getId() {
  return id;
}
/**
* @return
*/
public String getName() {
  return name;
}
/**
* @return
*/
public String getSex() {
  return sex;
}
/**
* @return
*/
public float getWeight() {
  return weight;
}
/**
* @param string
*/
public void setId(String string) {
  id = string;
}
/**
* @param string
*/
public void setName(String string) {
  name = string;
}
/**
* @param c
*/
public void setSex(String c) {
  sex = c;
}
/**
* @param f
*/
public void setWeight(float f) {
  weight = f;
}
/**
* @return
*/
public Animal getAnimal() {
  return animal;
}
/**
* @param animal
*/
public void setAnimal(Animal animal) {
  this.animal = animal;
}
}
   這兩個類的代碼可以在本文後邊的代碼包中找到，我之所以在此列出來的原因，想讓大家知道，可持久化的類和平常你熟悉的java類對象沒有什麼不同：屬性、get、set方法。
"透明"就"透明"在這裏了吧。

Hibernate爲每一個可持久的類配備一個xml格式的mapping文件，他們可以通過hibernate自帶的或其他的工具生成（反過來也一樣：先有mapping文件，然後生成java代碼）,剛開始學習的時候最好用手寫來熟悉。

Animal.hbm.xml

<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD//EN" "http://hibernate.sourceforge.net/hibernate-mapping-2.0.dtd">
<hibernate-mapping>

Cat.hbm.xml

<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD//EN"                                   "http://hibernate.sourceforge.net/hibernate-mapping-2.0.dtd">
<hibernate-mapping>
    <class name="com.iplateau.test.hibernate.persistence.Cat" table="CAT">
        
        <id name="id" type="string" unsaved-value="null" >
            <column name="CAT_ID" sql-type="char(32)" not-null="true"/>
            <generator class="uuid.hex"/>
        </id>
        
        <property name="name">
            <column name="NAME" sql-type="varchar(16)" not-null="true"/>
        </property>
        <property name="sex"/>
        <property name="weight"/>
        <many-to-one name="animal" class="com.iplateau.test.hibernate.persistence.Animal" column="ANIMAL_ID"/>
    </class>
</hibernate-mapping>

具體mapping文件的格式以及詞法（仔細看還是滿簡單的），請參照hibernate自帶的文檔，絕對詳細！

好了，通常在完成mapping文件以後，就可以利用hibernate自帶的工具生成建表語句，這時要用到ant來幫助你完成。{見附代碼包中build.xml}，以下爲建表片斷：
……
……
    <target name="initdb.postgres"
            description="Generates the database schema for Mssql server."
            depends="compile">
        <pathconvert refid="hibernate.mapping.files"
      property="hibernate.mappings" pathsep=" "/>
        <java classname="net.sf.hibernate.tool.hbm2ddl.SchemaExport" fork="true">

            
            <jvmarg value="-Dhibernate.dialect=${db.dialect}"/>
            <jvmarg value="-Dhibernate.connection.driver_class=${db.driver}"/>
            <jvmarg value="-Dhibernate.connection.url=${db.url}"/>
            <jvmarg value="-Dhibernate.connection.username=${db.user}"/>
            <jvmarg value="-Dhibernate.connection.password=${db.password}"/>

            <classpath refid="project.class.path" />
            <arg line="${hibernate.args}"/>
            <arg line="${hibernate.mappings}"/>
        </java>
    </target>
……
……

第二部分，整合struts，運行實例
在第一部分，我們用hibernate對我們的數據對象進行持久化，那麼hibernate如何操縱我們的數據的呢？，粗略的說就是創建系統SessionFactory(通常只創建一次),然後實例一個Session，通常我們直接對數據進行操作都是通過Session來完成，它就象jdo中的persistenceManager，而SessionFactory呢，就象jdo的persistenceManagerFactory。兩者之間的關係不管是jdo還是hibernate都是相同的。

下面說一下SessionFactory的創建方法，大概有三種方法（詳細請看hibernate的手冊）：通過*.class;通過*.hbm.xml；通過hibernate.cfg.xml；我比較傾向於用最後一種方法，本例就是採用hibernate.cfg.xml來創建SessionFactory以及數據庫連接的。

Hibernate.cfg.xml

<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE hibernate-configuration PUBLIC "-//Hibernate/Hibernate Configuration DTD//EN"
"http://hibernate.sourceforge.net/hibernate-configuration-2.0.dtd">

<hibernate-configuration>

<session-factory>

<property name="hibernate.connection.driver_class">com.microsoft.jdbc.sqlserver.SQLServerDriver</property>
        <property name="hibernate.connection.url">jdbc:microsoft:sqlserver://yourserver;DatabaseName=yourdatabase;SelectMethod=Cursor</property>
        <property name="hibernate.connection.username">your account</property>
        <property name="hibernate.connection.password">your password</property>
        <property name="hibernate.connection.pool.size">20</property>
        <property name="hibernate.dialect">net.sf.hibernate.dialect.SybaseDialect</property>
        
        <mapping resource="com/iplateau/test/hibernate/persistence/Cat.hbm.xml"/>
  <mapping resource="com/iplateau/test/hibernate/persistence/Animal.hbm.xml"/>
    </session-factory>

</hibernate-configuration>

OK,確定了創建方法以後我們就可以應用了，應爲SessionFactory通常只創建一次，所以推薦在系統初始化的建立，那麼可以利用struts的plugin機制來完成這一任務，見：

Com.iplateau.test.hibernate.InitHibernateDataStore.java
(hibernate手冊也推薦在struts中用這種方法創建)

關於struts的擴展機制請參見我的另一篇文章《擴展你的struts》

package com.iplateau.test.hibernate;

import java.io.File;
import java.util.List;
import java.net.URL;
import javax.naming.Context;
import javax.naming.InitialContext;
import javax.naming.NamingException;

import net.sf.hibernate.SessionFactory;
import net.sf.hibernate.cfg.Configuration;

import javax.servlet.ServletException;

import org.apache.struts.action.ActionServlet;
import org.apache.struts.action.PlugIn;
import org.apache.struts.config.ModuleConfig;

/**
* Class or Interface Discription
* @author $Author:jack$
* @version $ReVision:1.0 $ <br/>
* $Id:InitHibernateDataStore.java 2003-8-3 14:08:50 jack Exp.
*/
public class InitHibernateDataStore implements PlugIn {

private String _configFilePath = "/hibernate.cfg.xml";
private SessionFactory _factory = null;
static String contextFactory =
  "com.sun.jndi.rmi.registry.RegistryContextFactory";

private Context ctx = null;
/* (non-Javadoc)
* @see org.apache.struts.action.PlugIn#destroy()
*/
public void destroy() {
  // TODO Auto-generated method stub
  try {
   if (ctx != null) {
    ctx.close();
    ctx = null;
   }
  } catch (NamingException ex) {
   ex.printStackTrace();
  }
}

/* (non-Javadoc)
* @see org.apache.struts.action.PlugIn#init(org.apache.struts.action.ActionServlet, org.apache.struts.config.ModuleConfig)
*/
public void init(ActionServlet arg0, ModuleConfig arg1)
  throws ServletException {
  // TODO Auto-generated method stub
  Configuration configuration = null;
  URL configFileURL = null;
  System.out.println("4385738758237482173841847382374823742");
  try {
   configFileURL =
    InitHibernateDataStore.class.getResource(_configFilePath);
   configuration = (new Configuration()).configure(configFileURL);
   _factory = configuration.buildSessionFactory();

   Context ctx = new InitialContext();
   ctx.addToEnvironment(
    javax.naming.Context.INITIAL_CONTEXT_FACTORY,
    contextFactory);

ctx.bind("hibernate_connection_factory", _factory);

} catch (Exception e) {

}
}
}

在創建sessionFactory以後，採用jndi來取得：
SessionFactory sf =
(SessionFactory) inttex.lookup("hibernate_connection_factory");
{見com.iplateau.test.hibernate.DBManager.java}

數據庫的中文問題，我採用filter來解決，效果還不錯，具體參看web.xml以及com.iplateau.test.hibernate.SetEncodingFilter.java

小節：
總的來說，把struts和hibernate這兩種在業內比較推崇的開源技術相結合，在項目開發中不管是從效率上還是易維護上都是完美的結合。
希望從這個簡單的例子中給你更多的提示，同時也希望你提出好的建議，通過[email protected]和我聯繫。
附上代碼包：
http://www.ifreeway.com.cn/download/strutsInHibernate.rar
（兩星期內有效，過後可能會刪除）

參考資源：
hibernate參考手冊（hibernate發佈包中自帶）
hibernate example
http://sourceforge.net/project/showfiles.php?group_id=40712
Introduction to hibernate
http://www.theserverside.com/resources/article.jsp?l=Hibernate

同時http://www.chinaxp.org和http://www.jdon.com都有很多關於hibernate的討論。

整合struts和hibernate開發嚮導

JDO:查詢你的數據

Hibernate綜合查詢解決方案

使用Hibernate進行對象的關係映射

整合struts和hibernate開發嚮導

Flex 記錄點滴（一）關於Flex

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結