Hibernate注解说明.docx

1、Hibernate注解说明Hibernate 注解笔记(1)简介：Hibernate是一个开放源代码的对象关系映射框架，它对JDBC进行了非常轻量级的对象封装，使得Java程序员可以随心所欲的使用对象编程思维来操纵数据库。 Hibernate可以应用在任何使用JDBC的场合，既可以在Java的客户端程序使用，也可以在Servlet/JSP的Web应用中使用，最具革命意义的是，Hibernate可以在应用EJB的J2EE架构中取代CMP，完成数据持久化的重任。(2)安装 Hibernate Annotation第一步，环境与jar包：要使用 Hibernate Annotation，您至少需要具

2、备 Hibernate 3.2和Java 5。可以从 Hibernate 站点下载 Hibernate 3.2 和 Hibernate Annotation库。除了标准的 Hibernate JAR 和依赖项之外，您还需要 Hibernate Annotations .jar 文件（hibernate-annotations.jar）、Java 持久性 API （lib/ejb3-persistence.jar）。添加hibernate3.2.jar,hibernate-annotations- 3.3.0.jar，hibernate-commons-annotations.jar和ejb3-

3、persistence.jar 。这样就可以使用hibernate的annotation了。如果您正在使用 Maven，只需要向 POM 文件添加相应的依赖项即可，如下所示： . org.hibernate hibernate 3.2.1.ga org.hibernate hibernate-annotations 3.2.0.ga javax.persistence persistence-api 1.0 第二步，获取 Hibernate 会话工厂。尽管无需惊天的修改，但这一工作与使用 Hibernate Annotations有所不同。您需要使用 AnnotationConfigurati

4、on 类来建立会话工厂：sessionFactory = new AnnotationConfiguration().buildSessionFactory(); 第三步，尽管通常使用 元素来声明持久性类，您还是需要在 Hibernate 配置文件（通常是 hibernate.cfg.xml）中声明持久性类：!DOCTYPE hibernate-configuration PUBLIC -/Hibernate/Hibernate Configuration DTD 3.0/EN 近期的许多 Java 项目都使用了轻量级的应用框架，例如 Spring。如果您正在使用 Spring 框架，可以使用

5、 AnnotationSessionFactoryBean 类轻松建立一个基于注释的 Hibernate 会话工厂，如下所示： org.hibernate.dialect.DerbyDialect create . com.onjava.modelplanes.domain.PlaneType com.onjava.modelplanes.domain.ModelPlane . (3)hibernate Annotation标签的使用:11.带注释的持久性类也是普通 POJO,它们只是具备了持久性注释的普通 POJO 。2.事实上，您既可以保持字段的持久性（注释写在成员变量之上），也可以保持属

6、性（注释写在getter方法之上）的持久性。3.常用的hibernate annotation标签如下:Entity-注释声明该类为持久类。将一个Javabean类声明为一 个实体的数据库表映射类,最好实现序列化.此时,默认情况下,所有的类属性都为映射到数据表的持久性字段.若在类中,添加另外属性,而非映射来数据库的, 要用下面的Transient来注解.Table(name=promotion_info) -持久性映射的表(表名=promotion_info).Table是类一级的注解,定义在Entity下,为实体bean映射表,目录和schema的名字,默认为实体bean的类名,不带包名.

7、Id-注释可以表明哪种属性是该类中的独特标识符(即相当于数据表的主键)。 GeneratedValue -定义自动增长的主键的生成策略. Transient -将忽略这些字段和属性,不用持久化到数据库.适用于,在当前的持久类中,某些属性不是用于映射到数据表,而是用于其它的业务逻辑需要,这时,须将这些属性进行transient的注解.否则系统会因映射不到数据表相应字段而出错. Temporal(TemporalType.TIMESTAMP)-声明时间格式 Enumerated-声明枚举 Version -声明添加对乐观锁定的支持 OneToOne-可以建立实体bean之间的一对一的关联 OneT

8、oMany-可以建立实体bean之间的一对多的关联 ManyToOne-可以建立实体bean之间的多对一的关联 ManyToMany-可以建立实体bean之间的多对多的关联 Formula-一个SQL表达式，这种属性是只读的,不在数据库生成属性(可以使用sum、average、max等) OrderBy-Many端某个字段排序(List)1.2Hibernate 能够出色地自动生成主键。Hibernate/EBJ 3 注释也可以为主键的自动生成提供丰富的支持，允许实现各种策略。其生成规则由GeneratedValue设定的.这里的id和GeneratedValue都是JPA的标准用法, JPA

9、提供四种标准用法,由GeneratedValue的源代码可以明显看出. JPA提供的四种标准用法为TABLE,SEQUENCE,IDENTITY,AUTO. TABLE：使用一个特定的数据库表格来保存主键。 SEQUENCE：根据底层数据库的序列来生成主键，条件是数据库支持序列。 IDENTITY：主键由数据库自动生成（主要是自动增长型） AUTO：主键由程序控制。 在指定主键时，如果不指定主键生成策略，默认为AUTO。 Id相当于IdGeneratedValue(strategy = GenerationType.AUTO)identity: 使用SQL Server 和 MySQL 的自增

10、字段，这个方法不能放到 Oracle 中，Oracle 不支持自增字段，要设定sequence（MySQL 和 SQL Server 中很常用）。 Oracle就要采用sequence了.同时,也可采用uuid,native等其它策略.(相关用法,上网查询)2第一个持久性类 Entity Table(name=T_MODEL_PLANE) public class ModelPlaneimplements Serializable Id Column(name=PLANE_ID)GeneratedValue(strategy=GenerationType.AUTO) /注解于属性中 /* 对于

11、oracle想使用各自的Sequence,设置如下:GeneratedValue(strategy = GenerationType.AUTO,generator=PROMOTION_SEQ)SequenceGenerator(name=PROMOTION_SEQ,sequenceName=PROMOTION_SEQ)另外:对于自动增长后,在数据表中的相应字段,要设置字段为auto_increment.*/ private Long id; private String name;/注解写于getter方法之上.请见下. /DATE- java.sql.Date /TIME- java.sql

12、.Time /TIMESTAMP - java.sql.Timestamp Temporal(TemporalType.TIMESTAMP) Column(name=start_time) private Date startTime; /显示0 隐藏1 public static enum DisplayType 显示,隐藏 Enumerated(value = EnumType.ORDINAL)/ORDINAL序数 private DisplayType displayType = DisplayType.显示;/1.sql语句中的字段和表名都应该和数据库相应,而不是类中的字段, /若带有

13、参数如la.id= id,这个=id才是类中属性 /2.操作字段一定要用别名 Formula(select COUNT(la.id) from largess la) private int count;/注解于方法中 Column(name=PLANE_ID, length=80, nullable=true) /较详细定义 public String getName() return name; public void setName(String name) this.name = name; 其它的setter,getter省略. 该内容将映射到下表中： CREATE TABLE T_

14、MODEL_PLANE ( PLANE_ID long, PLANE_NAME varchar 其它字段省略. )默认情况下，Hibernate 会将持久类以匹配的名称映射到表和字段中。例如，下例中，若不用注解，则会映射到如下一表中：CREATE TABLE MODELPLANE( ID long, NAME varchar 其它字段省略.) 3一对多注解:1.在一对多注解中,会用到:一方：OneToMany - mappedBy:多方的关联属性(被控方)多方：ManyToOne - JoinColumn，多方定义的外键字段.如数据表定义外键如下:FOREIGN KEY (classid) R

15、EFERENCES classes(id)则:JoinColumn(name=classid)2.在双向关联中，有且仅有一端作为主体（owner）端存在：主体端负责维护联接列（即更新），对于不需要维护这种关系的从表则通过mappedNy属性进行声明。mappedBy的值指向另一主体的关联属性。例子中，mappedBy的值为classes。附加说明:mappedBy相当于过去的inverse=true.inverse=false的side（side其实是指inversefalse所位于的class元素）端有责任维护关系，而inversetrue端无须维护这些关系。3.cascade与fetch使

16、用说明:CascadeCascadeType.PERSIST （级联新建） CascadeType.REMOVE （级联删除） CascadeType.REFRESH （级联刷新） CascadeType.MERGE （级联更新）中选择一个或多个。 CascadeType.ALLfetch属性：关联关系获取方式,即是否采用延时加载。LAZY（默认值）采用延时加载，查询数据时，不一起查询关联对象的数据。而是当访问关联对象时(如：getStudnets()时)才触发相应的查询操作，获取关联对象数据。EAGER：是在查询数据时，也直接一起获取关联对象的数据。package oneToMany; im

17、port java.util.Set; import javax.persistence.*; /* 注意导入时，是导入：import javax.persistence.*;非导入org.hibernate的相关类：import org.hibernate.annotations.Entity; */ Entity Table(name=classes) public class Classes implements Serializable Id GeneratedValue(strategy=GenerationType.AUTO) private int id; private Str

18、ing name; OneToMany(cascade=CascadeType.ALL,mappedBy=classes)private Set students; /getter,setter省略 package oneToMany; import javax.persistence.*; Entity Table(name=student) public class Student implements Serializable Id GeneratedValue(strategy=GenerationType.AUTO) private int sid; private String s

19、name; /若有多个cascade，可以是：CascadeType.PERSIST,CascadeType.MERGE ManyToOne(cascade=CascadeType.ALL) JoinColumn(name=classid) /student类中对应外键的属性：classid private Classes classes; /getter,setter省略 public class TestOneToMany /* CREATE TABLEstudent (-要定义外键! sid double NOT NULL auto_increment, classid double N

20、ULL, sname varchar(255) NOT NULL, PRIMARY KEY(sid), INDEX par_ind (classid), FOREIGN KEY (classid) REFERENCES classes(id) ON DELETE CASCADE ON UPDATE CASCADE ) ENGINE=InnoDB */public static void main(String args) throws SQLException try SessionFactory sf = new AnnotationConfiguration().configure().b

21、uildSessionFactory(); Session session=sf.openSession(); Transaction tx=session.beginTransaction();/*因为mappedBy是定义在classes中,即classes类不负责维护级联关系.即维护者是student.所以,1.要将clsses的数据,赋给student,即用student的setClasses()方法去捆定class数据;2.在进行数据插入/更新session.save()/session.update()时,最后操作的是student.*/Classes classes=new Cl

22、asses(); classes.setName(access); Student st1=new Student(); st1.setSname(jason); st1.setClasses(classes); session.save(st1); Student st2=new Student(); st2.setSname(hwj); st2.setClasses(classes); session.save(st2);mit();/*输出如下:Hibernate: insert into classes (name) values (?)Hibernate: insert into s

23、tudent (classid, sname) values (?, ?)Hibernate: insert into student (classid, sname) values (?, ?)*/*因为一端维护关系另一端不维护关系的原因，我们必须注意避免在应用中用不维护关系的类(class)建立关系，因为这样建立的关系是不会在数据库中存储的。如上的代码倒过来,则插入时,student的外键值为空.如下:*/Student st1=new Student(); /st1.setSname(jason); /session.save(st1); /Student st2=new Student(); /st2.setSname(hwj); /session.save(st2); /Set students=new HashSet(); /students.add(st1); /students.add(st2); /Classes classes=new Classes(); /classes.setName(access); /classes.