在用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>
<class name="com.iplateau.test.hibernate.persistence.Animal" table="ANIMAL">
<!-- A 32 hex character is our surrogate key. It's automatically
generated by Hibernate with the UUID pattern. -->
<id name="id" type="string" unsaved-value="null" >
<column name="ANIMAL_ID" sql-type="char(32)" not-null="true"/>
<generator class="uuid.hex"/>
</id>
<!-- A cat has to have a name, but it shouldn' be too long. -->
<property name="name">
<column name="NAME" sql-type="varchar(16)" not-null="true"/>
</property>
<set name="cats" cascade="all" inverse="true" lazy="true">
<key column="ANIMAL_ID"/>
<one-to-many class="com.iplateau.test.hibernate.persistence.Cat"/>
</set>
</class>
</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">
<!-- A 32 hex character is our surrogate key. It's automatically
generated by Hibernate with the UUID pattern. -->
<id name="id" type="string" unsaved-value="null" >
<column name="CAT_ID" sql-type="char(32)" not-null="true"/>
<generator class="uuid.hex"/>
</id>
<!-- A cat has to have a name, but it shouldn' be too long. -->
<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">
<!-- Hibernate Properties -->
<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 files -->
<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的讨论。
本文地址:http://com.8s8s.com/it/it17523.htm