Hibernate 3.2.5 annotation介绍及其简单例子

在Hibernate3.2中，引进了Java5的新特性，就是注释配置，替代了我们以前用的*.hbm.xml配置文件，只需在实体类中进行相应的配置来完成 Hibernate的映射。

正如其他的ORM工具,Hibernate同样需要元数据来控制在不同数据表达形式之间的转化. 在Hibernate 2.x里,多数情况下表示映射关系的元数据保存在XML文本文件中. 还有一种方式就是Xdoclet,它可以在编译时利用Javadoc中的源码注释信息来进行预处理. 现在新的JDK标准（JDK1.5以上）也支持类似的注解功能,但相比之下很多工具对此提供了更强大更好用的支持.
以IntelliJ IDEA和Eclipse为例,这些IDE工具为JDK 5.0注解功能提供了自动完成和语法高亮功能. 注解被直接编译到字节码里,并 在运行时（对于Hibernate来讲就是启动的时候）通过反射读取这些注解, 因此外部XML文件就不再需要了.

EJB3规范最终认可了透明化ORM的成功范例以及市场对于这种技术的兴趣. EJB3规范标准化了ORM的基础API而且在任何ORM持久化机制中使用元数据. Hibernate EntityManager实现了EJB3持久化规范中定义的编程接口和生命周期规则. 在Hibernate Core的基础上再结合 Hibernate Annotations就实现了一套完整(并且独立)的EJB3持久化解决方案. 你可以结合三者来使用,也可以抛开EJB3编程接口和生命周期规则而独立使用注解,
甚至只单独使用Hibernate Core. 这些都取决于项目的商业和技术上的实际需求. Hibernate允许你直接使用native APIs,如果有需要, 甚至可以直接操作JDBC和SQL.

做一个简单的例子！

简历好环境

hibernate核心包以及使用注解需要的包，  hibernate-annotations.jar 、 ejb3-persistence.jar、hibernate-commons-annotation。

【（最小必要包为antlr.jar,cglib.jar,asm.jar,
asm-attrs.jar,  commons-collections.jar, commons-loggins.jar ,encache.jar, dom4j.jar,log4j.jar,jta.jar）】



附带hibernate的一些jar包表：

包	作用	说明
jta.jar	JTA(Java任务API)规范，当Hibernate使用JTA的时候需要，不过App Server都会带上，所以也是多余的。	必要
commons-logging.jar	Apache Commons包中的一个，包含了日志功能，必须使用的jar包。这个包本身包含了一个Simple Logger，但是功能很弱。在运行的时候它会先在CLASSPATH找log4j，如果有，就使用log4j，如果没有，就找JDK1.4带的 java.util.logging，如果也找不到就用Simple Logger。commons-logging.jar的出现是一个历史的的遗留的遗憾，当初Apache极力游说Sun把log4j加入JDK1.4， 然而JDK1.4项目小组已经接近发布JDK1.4产品的时间了，因此拒绝了Apache的要求，使用自己的java.util.logging，这个包 的功能比log4j差的很远，性能也一般。	必要
commons-collections.jar	Apache Commons包中的一个，包含了一些Apache开发的集合类，功能比java.util.*强大。	必要
antlr.jar	开源语法分析器（ANTLR—Another Tool for Language Recognition）其前身是PCCTS，它为包括Java，C++，C#在内的语言提供了一个通过语法描述来自动构造自定义语言的识别器（recognizer），编译器（parser）和解释器（translator）的框架。ANTLR可以通过断言（Predicate）解决识别冲突；支持动作（Action）和返回值（Return Value）	必要
dom4j.jar	dom4j是一个Java的XML API，类似于jdom，用来读写XML文件的。dom4j是一个非常非常优秀的Java XML API，具有性能优异、功能强大和极端易用使用的特点，同时它也是一个开放源代码的软件，可以在SourceForge上找到它。在IBM developerWorks上面可以找到一篇文章，对主流的Java XML API进行的性能、功能和易用性的评测，dom4j无论在那个方面都是非常出色的。我早在将近两年之前就开始使用dom4j，直到现在。如今你可以看到越 来越多的Java软件都在使用dom4j来读写XML，特别值得一提的是连Sun的JAXM也在用dom4j。这是必须使用的jar 包，Hibernate用它来读写配置文件。	必要
Hibernate3.jar	核心库	必要
asm.jar	ASM(汇编)字节码库	如果使用“cglib”则必要
asm-attrs.jar	ASM字节码库	如果使用“cglib”则必要
ehcache.jar	EHCache缓存	如果没有其它的缓存，则它是必要的
cglib.jar	CGLIB库，Hibernate用它来实现PO（persisent object 持久对象,持久对象实际上必须对应数据库中的entity，所以和POJO有所区别。比如说POJO是由new创建，由GC回收。但是持久对象是insert数据库创建，由数据库delete删除的。基本上持久对象生命周期和数据库密切相关。另外持久对象往往只能存在一个数据库Connection之中，Connnection关闭以后，持久对象就不存在了，而POJO只要不被GC回收，总是存在的。）字节码的动态生成，非常核心的库	如果使用“cglib”则必要
以下包可选
versioncheck.jar	版本检查
swarmcache.jar
jboss-cache.jar	TreeCache
jgroups.jar
xml-apis.jar	JAXP API
c3p0-0.9.1.jar	C3PO是一个数据库连接池，Hibernate可以配置为使用C3PO连接池。如果你准备用这个连接池，就需要这个jar包。
connector.jar	JCA API
jboss-system.jar		使用TreeCache时必要
jacc-1_0-fr.jar	JACC 库
checkstyle-all.jar
junit.jar
javassist.jar	Javassist 字节码解释器
ant-lanuncher.jar
jaas.jar	JAAS API
jdbc2_0-stdext.jar	JDBC扩展API
ant-antlr.jar	Ant antlr支持
jboss-jmx.jar
cleanimports.jar	cleanimports
xerces.jar	SAX parser	JDK版本低于1.4时必要
jaxen-1.1-beta-7.jar	Jaxen	如果想提高启动性能则去使用
ant-junit.jar	Ant junit support
ant-swing.jar	ant swing support
ant.jar	Ant编译工具的jar包，用来编译Hibernate源代码的。如果你不准备修改和编译Hibernate源代码，那么就没有什么用，可选的jar包
proxool.jar	Proxool JDBC连接池
concurrent.jar		使用TreeCache需要
syndiag2.jar

mysql数据库，hiber001数据库，表：product，使用注解保存一条数据

create database hiber001;

create table(id int primary key, name varchar(20), qq varchar(20));

@Entity 表示一个实体类 ，如果不用@table指明，则默认与数据库中的表名相同（不区分大小写）。这里我们的类名以及属性和数据库的表名以及字段相同！

如果使用注解，则需要在hibernate.cfg.xml中定义经过注解的类：

<mapping class="包名+类名" />

在测试的时候需要用专门的注解管理类，AnnotationConfiguration。

-------------------------------------------------------------------------------------------------------------------------------------

hibernate.cfg.xml

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE hibernate-configuration PUBLIC
"-//Hibernate/Hibernate Configuration DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
<!-- Generated by MyEclipse Hibernate Tools.                   -->
<hibernate-configuration>
<session-factory>
<property name="dialect">
org.hibernate.dialect.MySQLDialect
</property>
<property name="connection.url">
jdbc:mysql://localhost:3306/hiber001
</property>
<property name="connection.username">root</property>
<property name="connection.password">123456</property>
<property name="connection.driver_class">
com.mysql.jdbc.Driver
</property>
<property name="myeclipse.connection.profile">mysql5</property>
<property name="show_sql">true</property>
<!-- annotation part -->
<mapping class="com.bubble.entity.Product" />

</session-factory>

</hibernate-configuration>

-----------------------------------------------------------------------------------------------------------

hibernate管理类

package com.bubble.util;

import org.hibernate.HibernateException;
import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.cfg.AnnotationConfiguration;

/**
* @author bubble
*
*/
public class HibernateUtil {

// single
private static final SessionFactory sessionFactory;

static{
try{
//class AnnotationConfiguration:读取关于Annotation的配置
sessionFactory=new AnnotationConfiguration().configure().buildSessionFactory();
}catch (Throwable e) {
// TODO: handle exception
throw new ExceptionInInitializerError(e);
}
}

// static method to get session
public static Session getSession() throws HibernateException{

return sessionFactory.openSession();

}

// close session factory
public static void closeSessionFactory(){

sessionFactory.close();

}

}

PS：还可以通过编程方式来定义注解的类

sessionFactory = new AnnotationConfiguration()
.addPackage("com.bubble.entity") //the fully qualified package name
.addAnnotatedClass(Product.class)
.buildSessionFactory();

-------------------------------------------------------------------------------------------------------------------------

POJO：product

package com.bubble.entity;

import javax.persistence.Entity;
import javax.persistence.Id;

/**
* @author bubble
*
*/
@Entity
public class Product {

private int id;

private String name;

private String qq;

public void setName(String name) {
this.name = name;
}

public String getName() {
return name;
}

public void setQq(String qq) {
this.qq = qq;
}

public String getQq() {
return qq;
}

public void setId(int id) {
this.id = id;
}
@Id
public int getId() {
return id;
}

}

----------------------------------------------------------------------------

测试类：

package com.bubble.test;

import org.hibernate.Session;

import com.bubble.entity.Product;
import com.bubble.util.HibernateUtil;

public class AnnoTest {

/**
* @author bubble 11 / 12 / 05
*/
public static void main(String[] args) {
// TODO Auto-generated method stub
Product p= new Product();

p.setId(1);

p.setName("笔记本");

p.setQq("20111205");

Session session=HibernateUtil.getSession();// get session

session.beginTransaction();

session.save(p);

session.beginTransaction().commit();

session.close();

HibernateUtil.closeSessionFactory();

}

}

---------------------------------------------------------------------------------------------------------

Console Result:

2011-12-5 22:41:07 org.hibernate.cfg.annotations.Version <clinit>
信息: Hibernate Annotations 3.3.0.GA
2011-12-5 22:41:07 org.hibernate.cfg.Environment <clinit>
信息: Hibernate 3.2.5
2011-12-5 22:41:07 org.hibernate.cfg.Environment <clinit>
信息: hibernate.properties not found
2011-12-5 22:41:07 org.hibernate.cfg.Environment buildBytecodeProvider
信息: Bytecode provider name : cglib
2011-12-5 22:41:08 org.hibernate.cfg.Environment <clinit>
信息: using JDK 1.4 java.sql.Timestamp handling
2011-12-5 22:41:08 org.hibernate.cfg.Configuration configure
信息: configuring from resource: /hibernate.cfg.xml
2011-12-5 22:41:08 org.hibernate.cfg.Configuration getConfigurationInputStream
信息: Configuration resource: /hibernate.cfg.xml
2011-12-5 22:41:08 org.hibernate.cfg.Configuration doConfigure
信息: Configured SessionFactory: null
2011-12-5 22:41:08 org.hibernate.cfg.AnnotationBinder bindClass
信息: Binding entity from annotated class: com.bubble.entity.Product
2011-12-5 22:41:08 org.hibernate.cfg.annotations.EntityBinder bindTable
信息: Bind entity com.bubble.entity.Product on table Product
2011-12-5 22:41:09 org.hibernate.validator.Version <clinit>
信息: Hibernate Validator 3.0.0.GA
2011-12-5 22:41:09 org.hibernate.connection.DriverManagerConnectionProvider configure
信息: Using Hibernate built-in connection pool (not for production use!)
2011-12-5 22:41:09 org.hibernate.connection.DriverManagerConnectionProvider configure
信息: Hibernate connection pool size: 20
2011-12-5 22:41:09 org.hibernate.connection.DriverManagerConnectionProvider configure
信息: autocommit mode: false
2011-12-5 22:41:09 org.hibernate.connection.DriverManagerConnectionProvider configure
信息: using driver: com.mysql.jdbc.Driver at URL: jdbc:mysql://localhost:3306/hiber001
2011-12-5 22:41:09 org.hibernate.connection.DriverManagerConnectionProvider configure
信息: connection properties: {user=root, password=****}
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: RDBMS: MySQL, version: 5.1.45-community-log
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: JDBC driver: MySQL-AB JDBC Driver, version: mysql-connector-java-5.1.13 ( Revision: ${bzr.revision-id} )
2011-12-5 22:41:10 org.hibernate.dialect.Dialect <init>
信息: Using dialect: org.hibernate.dialect.MySQLDialect
2011-12-5 22:41:10 org.hibernate.transaction.TransactionFactoryFactory buildTransactionFactory
信息: Using default transaction strategy (direct JDBC transactions)
2011-12-5 22:41:10 org.hibernate.transaction.TransactionManagerLookupFactory getTransactionManagerLookup
信息: No TransactionManagerLookup configured (in JTA environment, use of read-write or transactional second-level cache is not recommended)
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: Automatic flush during beforeCompletion(): disabled
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: Automatic session close at end of transaction: disabled
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: JDBC batch size: 15
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: JDBC batch updates for versioned data: disabled
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: Scrollable result sets: enabled
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: JDBC3 getGeneratedKeys(): enabled
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: Connection release mode: auto
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: Maximum outer join fetch depth: 2
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: Default batch fetch size: 1
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: Generate SQL with comments: disabled
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: Order SQL updates by primary key: disabled
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: Order SQL inserts for batching: disabled
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory createQueryTranslatorFactory
信息: Query translator: org.hibernate.hql.ast.ASTQueryTranslatorFactory
2011-12-5 22:41:10 org.hibernate.hql.ast.ASTQueryTranslatorFactory <init>
信息: Using ASTQueryTranslatorFactory
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: Query language substitutions: {}
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: JPA-QL strict compliance: disabled
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: Second-level cache: enabled
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: Query cache: disabled
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory createCacheProvider
信息: Cache provider: org.hibernate.cache.NoCacheProvider
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: Optimize cache for minimal puts: disabled
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: Structured second-level cache entries: disabled
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: Echoing all SQL to stdout
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: Statistics: disabled
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: Deleted entity synthetic identifier rollback: disabled
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: Default entity-mode: pojo
2011-12-5 22:41:10 org.hibernate.cfg.SettingsFactory buildSettings
信息: Named query checking : enabled
2011-12-5 22:41:10 org.hibernate.impl.SessionFactoryImpl <init>
信息: building session factory
2011-12-5 22:41:10 org.hibernate.impl.SessionFactoryObjectFactory addInstance
信息: Not binding factory to JNDI, no JNDI name configured
Hibernate: insert into Product (name, qq, id) values (?, ?, ?)
2011-12-5 22:41:11 org.hibernate.impl.SessionFactoryImpl close
信息: closing
2011-12-5 22:41:11 org.hibernate.connection.DriverManagerConnectionProvider close
信息: cleaning up connection pool: jdbc:mysql://localhost:3306/hiber001

查询数据库中表数据：

mysql> select * from product;
+----+------+----------+
| id | name | qq       |
+----+------+----------+
|  1 | 笔记本  | 20111205 |
+----+------+----------+
1 row in set (0.00 sec)

mysql> delete from product;
Query OK, 1 row affected (0.00 sec)

mysql>

成功插入一条数据！