hibernate入门（一）

一 第一个应用实例

1．搭建环境：新建一个名为HibernateDemo的java工程，并导入Hibernate的jar包，特别要注意除了导入lib下的jar包还需导入hibernate3.jar核心jar包。 由于涉及数据库操作，还应导入mysql驱动包。

2．简述Hibernate的作用：ORM：Object Relational Mapping，对象关系映射。将java程序中的对象自动持久化到关系数据库中。而Hibernate的作用好比就是在java对象与关系数据库之间的一座桥梁，它主要负责两者之间的映射。在Hibernate内部封装了JDBC技术（但只是一个轻量级的封装，因而可以让程序设计人员更方便的以面向对象的思想操纵数据库），并向外提供API接口。

3．建新一个名为User.java的类，即是上面所说的java对象。我们以后称这种类为实体类（或是持久化类），它的对象为实体对象（或是持久化对象）。User.java内容如下：

package com.asm.hibernate.domain;
import java.util.Date;
public class User {
	private int id;
	private String name;
	private Date date;

	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 Date getDate() {
		return date;
	}
	public void setDate(Date date) {
		this.date = date;
	}
}

 

4．编写配置文件：User.hbm.xml。它和User.java放在同一个包下。内容如下：

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

	<class name="User">
		<id name="id">
			<generator class="native"/>
		</id>
		<property name="name"></property>
		<property name="date"></property>	
	</class>
</hibernate-mapping>

 

此配置文件，是用来为User.java进行配置的，我们以后称这种文件为实体配置文件（或是持久化类映射文件）  <class>用来关联一个java类，注意在前面的根元素下有一个package属性，这样结合这个package和class标签下所指定的类名，就共同关联映射了一个java类。 其实可以这样理解，每一个包下都有实体配置文件，而这个配置文件开始的根元素package指定了此文件所处的位置（或是说它所关联的包），根元素下可以有多个<class>标签（查阅dtd文件），它们可以分别来关联包下的java类文件。

<class>标签，一般建议至少有两个属性：name属性用来关联一个java类，比如这里关联了User类；table属性用来指定这个类所对应的表文件，如果不指定，系统会自动name指定的类文件进行关联（比如上面实际是：<class name="User" table="user">） 

<class>标签下的子标签：

l        <id>子标签实际就是用来映射主键，<id>下的name就是用来指java类中的id属性，而它可以有一个column属性用来指定表中的主键。同时注意在此标签下有一个<generator class="native"/>标签，它是用来指定主键的生成方式。

l        <property>子标签，就是用来指定java类的属性映射到表中的一个字段，默认下此标签没有指定column属性，即是说它会把name所关联的属性名作为字段名。 如果不想java类中的某些属性映射到表中，只要不用这个标签来关联这些属性即可。

l        总结：上面的<class><id><property>的name属性都分别指定了java类，java类的属性。而table，column是用来指定表，字段名

配置文件：hibernate.cfg.xml。它放在当前的项目的根目录下。内容如下：

<!DOCTYPE hibernate-configuration PUBLIC
	"-//Hibernate/Hibernate Configuration DTD 3.0//EN"
	"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">

<hibernate-configuration>
	<session-factory name="foo">
		<property name="hibernate.connection.driver_class">com.mysql.jdbc.Driver</property>
		<property name="hibernate.connection.url">jdbc:mysql://localhost:3306/test</property>
		<property name="hibernate.connection.username">root</property>
		<property name="hibernate.connection.password">123456</property>
		
		<property name="hibernate.dialect">org.hibernate.dialect.MySQLDialect</property>
		<property name="hibernate.hbm2ddl.auto">create</property>
		<mapping resource="com/asm/hibernate/domain/User.hbm.xml"/>		
	</session-factory>
</hibernate-configuration>

 

主配置文件，完成了驱动注册，数据库连接，并关联了相应的java对象配置文件。

说明：<mapping>具体指定了关联的所有实体配置文件，关于它的作用可以注释掉此属性看效果。另通过<property name="hibernate.hbm2ddl.auto">create</property>指定了根据实体配置文件来自动生成表，其中包括：create/create-drop/update/validate四种可选方式。

5．编写测试类：UserTest.java 内容如下：

package com.asm.hibernate.test;

import java.util.Date;
import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.Transaction;
import org.hibernate.cfg.Configuration;
import com.asm.hibernate.domain.User;

public class UserTest {
	public static void main(String []args){
		Configuration cf=new Configuration();
		cf.configure();		
		SessionFactory sf=cf.buildSessionFactory();
		
		Session s=sf.openSession();
		Transaction ts=s.beginTransaction(); //事务
		
		User user=new User();
		user.setName("jack");
		user.setDate(new Date());
		s.save(user);
		ts.commit(); //提交事务
		s.close();
		System.out.println("done");
	}
}

 

6．分析流程：首先抛开Transaction tx=s.beginTransaction()和tx.commit()，因为它们是提交事务得。支持提交事务意味着支持数据回滚。说明，通常情况下，很多数据库都默认支持提交事务，所以加这两句代码非常必要。下面具体谈流程：

第一步：获取SessionFactory对象，它会首先构建一个Configuration对象，此对象调用可以调用configure()和configure(String resource)这两种方法：这两种方法在Configuration中的源代码如下：

public Configuration configure() throws HibernateException {
		configure( "/hibernate.cfg.xml" );
		return this;
	}
public Configuration configure(String resource) throws HibernateException {
		log.info( "configuring from resource: " + resource );
		InputStream stream = getConfigurationInputStream( resource );
		return doConfigure( stream, resource );
	}

 

分析这两个源代码可以知道：无参调用最终也是调用这个有参数的方法，所以我们也可以直接传参数调用。现在的重点是读配置文件，这个配置文件我们一般放在eclipse的scr根目录下，而当eclipse编译时会自动把这个目录下的文件编译到bin目录下，而这个bin目录下是被配置成classpath环境变量，而configure方法就是在classpath环境变量下查找配置文件。 再来分析，无参调用configure方法时，默认的是传递的hibernate.cfg.xml配置文件，所以只有取名为这个的配置文件，才可以调用无参的configure方法，如果是其它名字的配置文件，则调用含参的配置文件，并且这个参数名应为这个配置文件的名字。 当读取配置文件后的Configuration对象，才是一个真正意义上可操控的实例对象。然后，再用这个对象来构建一个SessionFactory对象。 强调说明，这一步整个操作最好是放在类的静态代码块中，因为它只在该类被加载时执行一次。7.实体类定义规则：

第二步：得到一个Session实例，以进行数据库CRUD操作
第三步：实例化一个java类
第四步：持久化操作

第五步：后续操作：主要是关闭连接

Domain object（java对象）必须要有构造方法，同时建议有一个id属性，为了赖加载，这个java类的声明最好不用final。

8.开发流程：

官方推荐：先Domain object 再mapping，最后是DB。 常用开发方式：DB开始，由工具来生成mapping和Domain object。

9.总结基本步骤：

环境搭建(导入相关包等) —>实体类及配置文件—>主配置文件(完成了数据库的配置及通过设置属性创建了相应的表)—>得到Session测试应用。

评论

3 楼 cnyangqi 2010-04-29  

86asm 写道

回复cnyangqi

步骤一：确定数据库已创建，它只会自动建表，不包括建库。
步骤二：确定连库信息配置正确
步骤三：如果你是通过eclipse自动生成的hibernate.cfg.xml文件，注意查看此文件中是否有catalog="***"（*表示数据库名称） 这样的信息，如果有删除。
步骤四：实在不行可以到我博客hibernate入门最后一节下载源码对照下。

谢谢兄弟热心帮助，我后来找到原因了，还没来得及到你这里汇报工作。
问题出来我使用的数据库是Oracle10g2，User表是Oracle保留表，所以无法创建，我另外在Hibernate3.5.1+Proxool-0.9.1+Oracle10g2下调试通过。
当然修改了实体类^^

在我的Javaeye博客里有相关记录^^

2 楼 86asm 2010-04-29  

回复cnyangqi

步骤一：确定数据库已创建，它只会自动建表，不包括建库。
步骤二：确定连库信息配置正确
步骤三：如果你是通过eclipse自动生成的hibernate.cfg.xml文件，注意查看此文件中是否有catalog="***"（*表示数据库名称） 这样的信息，如果有删除。
步骤四：实在不行可以到我博客hibernate入门最后一节下载源码对照下。

1 楼 cnyangqi 2010-04-29  

我无法通过
<property name="hibernate.hbm2ddl.auto">create</property>
创建数据库表。
Exception in thread "main" org.hibernate.exception.SQLGrammarException: Could not execute JDBC batch update
at org.hibernate.exception.SQLStateConverter.convert(SQLStateConverter.java:92)
at org.hibernate.exception.JDBCExceptionHelper.convert(JDBCExceptionHelper.java:66)
at org.hibernate.jdbc.AbstractBatcher.executeBatch(AbstractBatcher.java:275)
at org.hibernate.engine.ActionQueue.executeActions(ActionQueue.java:263)
at org.hibernate.engine.ActionQueue.executeActions(ActionQueue.java:179)
at org.hibernate.event.def.AbstractFlushingEventListener.performExecutions(AbstractFlushingEventListener.java:321)
at org.hibernate.event.def.DefaultFlushEventListener.onFlush(DefaultFlushEventListener.java:51)
at org.hibernate.impl.SessionImpl.flush(SessionImpl.java:1206)
at org.hibernate.impl.SessionImpl.managedFlush(SessionImpl.java:375)
at org.hibernate.transaction.JDBCTransaction.commit(JDBCTransaction.java:137)
at test.UserTest.main(UserTest.java:24)