Hibernate注解大全和实战

于 2014-08-21 14:11:51 发布
阅读量1.7k 收藏 2
点赞数
分类专栏： Hibernate 文章标签： hibernate Hibernate注解
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/he90227/article/details/38728831
版权

1.官方例子

声明实体Bean

@Entity
public class Flight implements Serializable {
  Long id;
  @Id
  public Long getId() { return id; }
  public void setId(Long id) { this.id = id; }
}

@Entity 注解将一个类声明为实体 Bean, @Id 注解声明了该实体Bean的标识属性。

Hibernate 可以对类的属性或者方法进行注解。属性对应field类别，方法的 getXxx()对应property类别。

定义表

通过 @Table 为实体Bean指定对应数据库表，目录和schema的名字。

@Entity
@Table(name="tbl_sky")
public class Sky implements Serializable {

...

@Table 注解包含一个schema和一个catelog 属性，使用@UniqueConstraints 可以定义表的唯一约束。

@Table(name="tbl_sky",
  uniqueConstraints = {@UniqueConstraint(columnNames={"month", "day"})}
)

上述代码在  "month" 和 "day" 两个 field 上加上 unique constrainst.

@Version 注解用于支持乐观锁版本控制。

@Entity
public class Flight implements Serializable {
   ...
   @Version
   @Column(name="OPTLOCK")
   public Integer getVersion() { ... }
}

version属性映射到 "OPTLOCK" 列，entity manager 使用这个字段来检测冲突。 一般可以用 数字 或者 timestamp 类型来支持 version.

实体Bean中所有非static 非 transient 属性都可以被持久化，除非用@Transient注解。

默认情况下，所有属性都用 @Basic 注解。

public transient int counter; //transient property

private String firstname; //persistent property
@Transient
String getLengthInMeter() { ... } //transient property
String getName() {... } // persistent property
@Basic
int getLength() { ... } // persistent property
@Basic(fetch = FetchType.LAZY)
String getDetailedComment() { ... } // persistent property
@Temporal(TemporalType.TIME)
java.util.Date getDepartureTime() { ... } // persistent property
@Enumerated(EnumType.STRING)
Starred getNote() { ... } //enum persisted as String in database

上述代码中 counter, lengthInMeter 属性将忽略不被持久化，而 firstname, name, length 被定义为可持久化和可获取的。 

@TemporalType.(DATE,TIME,TIMESTAMP) 分别Map java.sql.(Date, Time, Timestamp).

@Lob 注解属性将被持久化为 Blog 或 Clob 类型。具体的java.sql.Clob, Character[], char[] 和 java.lang.String 将被持久化为 Clob 类型. java.sql.Blob, Byte[], byte[] 和 serializable type 将被持久化为 Blob 类型。

@Lob
public String getFullText() {
   return fullText;  // clob type
}


@Lob
public byte[] getFullCode() {
  return fullCode;  // blog type
}

@Column 注解将属性映射到列。

@Entity
public class Flight implements Serializable {
   ...
   @Column(updatable = false, name = "flight_name", nullable = false, length=50)
   public String getName() { ... }

定义 name 属性映射到 flight_name column, not null, can't update, length equal 50

@Column(
   name="columnName"; (1) 列名
   boolean unique() default false; (2)    是否在该列上设置唯一约束
   boolean nullable() default true; (3)   列可空？
   boolean insertable() default true; (4) 该列是否作为生成 insert语句的一个列
   boolean updatable() default true; (5)  该列是否作为生成 update语句的一个列
   String columnDefinition() default ""; (6)  默认值
   String table() default ""; (7)             定义对应的表（deault 是主表）
   int length() default 255; (8)              列长度
   int precision() default 0; // decimal precision (9)  decimal精度
   int scale() default 0; // decimal scale        (10)  decimal长度

嵌入式对象（又称组件）也就是别的对象定义的属性

组件类必须在类一级定义 @Embeddable 注解。在特定的实体关联属性上使用 @Embeddable 和 @AttributeOverride 注解可以覆盖该属性对应的嵌入式对象的列映射。

@Entity
public class Person implements Serializable {
   // Persistent component using defaults
   Address homeAddress;
   @Embedded
   @AttributeOverrides( {
      @AttributeOverride(name="iso2", column = @Column(name="bornIso2") ),
      @AttributeOverride(name="name", column = @Column(name="bornCountryName") )
   } )
   Country bornIn;
   ...
}

@Embeddable
public class Address implements Serializable {
   String city;
   Country nationality; //no overriding here
}

@Embeddable
public class Country implements Serializable {
   private String iso2;
   @Column(name="countryName") private String name;
   public String getIso2() { return iso2; }
   public void setIso2(String iso2) { this.iso2 = iso2; }
   public String getName() { return name; }
   public void setName(String name) { this.name = name; }
   ...
}

Person 类定义了 Address 和  Country 对象，具体两个类实现见上。

无注解属性默认值：

• 属性为简单类型，则映射为 @Basic

• 属性对应的类型定义了 @Embeddable 注解，则映射为 @Embedded

• 属性对应的类型实现了Serializable,则属性被映射为@Basic并在一个列中保存该对象的serialized版本。

• 属性的类型为 java.sql.Clob or java.sql.Blob, 则映射到 @Lob 对应的类型。

映射主键属性

@Id 注解可将实体Bean中某个属性定义为主键，使用@GenerateValue注解可以定义该标识符的生成策略。

• AUTO -  可以是 identity column, sequence 或者 table 类型，取决于不同底层的数据库
• TABLE - 使用table保存id值
• IDENTITY - identity column
• SEQUENCE - seque

nce 

@Id @GeneratedValue(strategy=GenerationType.SEQUENCE, generator="SEQ_STORE")
public Integer getId() { ... }

@Id @GeneratedValue(strategy=GenerationType.IDENTITY)
public Long getId() { ... }

AUTO 生成器，适用与可移值的应用，多个@Id可以共享同一个 identifier生成器，只要把generator属性设成相同的值就可以。通过@SequenceGenerator 和 @TableGenerator 可以配置不同的 identifier 生成器。 

<table-generator name="EMP_GEN"
     table="GENERATOR_TABLE"
     pk-column-name="key"
     value-column-name="hi"
     pk-column-value="EMP"
     allocation-size="20"/>
//and the annotation equivalent
@javax.persistence.TableGenerator(
     name="EMP_GEN",
     table="GENERATOR_TABLE",
     pkColumnName = "key",
     valueColumnName = "hi"
     pkColumnValue="EMP",
     allocationSize=20
)
<sequence-generator name="SEQ_GEN"
     sequence-name="my_sequence"
     allocation-size="20"/>
//and the annotation equivalent
@javax.persistence.SequenceGenerator(
     name="SEQ_GEN",
     sequenceName="my_sequence",
     allocationSize=20
)

The next example shows the definition of a sequence generator in a class scope:

@Entity
@javax.persistence.SequenceGenerator(
    name="SEQ_STORE",
    sequenceName="my_sequence"
)
public class Store implements Serializable {
   private Long id;
   @Id @GeneratedValue(strategy=GenerationType.SEQUENCE, generator="SEQ_STORE")
   public Long getId() { return id; }
}

Store类使用名为my_sequence的sequence，并且SEQ_STORE生成器对于其他类是不可见的。

通过下面语法，你可以定义组合键。

• 将组件类注解为 @Embeddable， 并将组件的属性注解为 @Id
• 将组件的属性注解为 @EmbeddedId
• 将类注解为 @IdClass，并将该实体中所有主键的属性都注解为 @Id

@Entity
@IdClass(FootballerPk.class)
public class Footballer {
  //part of the id key
  @Id public String getFirstname() {
    return firstname;
  }
  public void setFirstname(String firstname) {
     this.firstname = firstname;
  }
  //part of the id key
  @Id public String getLastname() {
    return lastname;
  }
  public void setLastname(String lastname) {
    this.lastname = lastname;
  }
  public String getClub() {
    return club;
  }
  public void setClub(String club) {
   this.club = club;
  }
  //appropriate equals() and hashCode() implementation
}

@Embeddable
public class FootballerPk implements Serializable {
  //same name and type as in Footballer
  public String getFirstname() {
    return firstname;
  }
  public void setFirstname(String firstname) {
    this.firstname = firstname;
  }
  //same name and type as in Footballer
  public String getLastname() {
    return lastname;
  }
  public void setLastname(String lastname) {
   this.lastname = lastname;
  }
  //appropriate equals() and hashCode() implementation
}

@Entity
@AssociationOverride( name="id.channel", joinColumns = @JoinColumn(name="chan_id") )
public class TvMagazin {
   @EmbeddedId public TvMagazinPk id;
   @Temporal(TemporalType.TIME) Date time;
}


@Embeddable
public class TvMagazinPk implements Serializable {
   @ManyToOne
   public Channel channel;
   public String name;
   @ManyToOne
   public Presenter presenter;
}

映射继承关系

EJB支持3种类型的继承。

• Table per Class Strategy: the <union-class> element in Hibernate 每个类一张表
• Single Table per Class Hierarchy Strategy: the <subclass> element in Hibernate 每个类层次结构一张表
• Joined Subclass Strategy: the <joined-subclass> element in Hibernate 连接的子类策略

@Inheritance 注解来定义所选的之类策略。

每个类一张表

@Entity
@Inheritance(strategy = InheritanceType.TABLE_PER_CLASS)
public class Flight implements Serializable {

有缺点，如多态查询或关联。Hibernate 使用 SQL Union 查询来实现这种策略。 这种策略支持双向的一对多关联，但不支持 IDENTIFY 生成器策略，因为ID必须在多个表间共享。一旦使用就不能使用AUTO和IDENTIFY生成器。

每个类层次结构一张表

@Entity
@Inheritance(strategy=InheritanceType.SINGLE_TABLE)
@DiscriminatorColumn(
    name="planetype",
    discriminatorType=DiscriminatorType.STRING
)
@DiscriminatorValue("Plane")
public class Plane { ... }

@Entity
@DiscriminatorValue("A320")
public class A320 extends Plane { ... }

整个层次结构中的所有父类和子类属性都映射到同一个表中，他们的实例通过一个辨别符列（discriminator）来区分。

Plane 是父类。@DiscriminatorColumn 注解定义了辨别符列。对于继承层次结构中的每个类, @DiscriminatorValue 注解指定了用来辨别该类的值。 辨别符列名字默认为 DTYPE，其默认值为实体名。其类型为DiscriminatorType.STRING。

连接的子类

@Entity
@Inheritance(strategy=InheritanceType.JOINED)
public class Boat implements Serializable { ... }


@Entity
public class Ferry extends Boat { ... }

@Entity
@PrimaryKeyJoinColumn(name="BOAT_ID")
public class AmericaCupClass extends Boat { ... }

以上所有实体使用 JOINED 策略 Ferry和Boat class使用同名的主键关联(eg: Boat.id = Ferry.id)， AmericaCupClass 和 Boat 关联的条件为 Boat.id = AmericaCupClass.BOAT_ID.

从父类继承的属性

@MappedSuperclass
public class BaseEntity {
  @Basic
  @Temporal(TemporalType.TIMESTAMP)
  public Date getLastUpdate() { ... }
  public String getLastUpdater() { ... }
  ...
}


@Entity class Order extends BaseEntity {
  @Id public Integer getId() { ... }
  ...
}

继承父类的一些属性，但不用父类作为映射实体，这时候需要 @MappedSuperclass 注解。 上述实体映射到数据库中的时候对应 Order 实体Bean, 其具有 id, lastUpdate, lastUpdater 三个属性。如果没有@MappedSuperclass 注解,则父类中属性忽略，这是 Order 实体 Bean 只有 id 一个属性。

映射实体Bean的关联关系

一对一

使用 @OneToOne 注解可以建立实体Bean之间的一对一关系。一对一关系有3种情况。

• 关联的实体都共享同样的主键。

@Entity
public class Body {
  @Id
  public Long getId() { return id; }
  @OneToOne(cascade = CascadeType.ALL)
  @PrimaryKeyJoinColumn
  public Heart getHeart() {
     return heart;
  }
  ...
}

@Entity
public class Heart {
  @Id
  public Long getId() { ...}
}

通过@PrimaryKeyJoinColumn 注解定义了一对一的关联关系。


多对一

使用 @ManyToOne 注解定义多对一关系。

@Entity()
public class Flight implements Serializable {
  @ManyToOne( cascade = {CascadeType.PERSIST, CascadeType.MERGE} )
  @JoinColumn(name="COMP_ID")
  public Company getCompany() {
    return company;
  }
  ...
}

其中@JoinColumn 注解是可选的，关键字段默认值和一对一关联的情况相似。列名为：主题的关联属性名 + 下划线 + 被关联端的主键列名。本例中为company_id,因为关联的属性是company, Company的主键为 id.

@ManyToOne 注解有个targetEntity属性，该参数定义了目标实体名。通常不需要定义，大部分情况为默认值。但下面这种情况则需要 targetEntity 定义（使用接口作为返回值，而不是常用的实体）。

@Entity()
public class Flight implements Serializable {
   @ManyToOne(cascade=   {CascadeType.PERSIST,CascadeType.MERGE},targetEntity= CompanyImpl.class)
   @JoinColumn(name="COMP_ID")
   public Company getCompany() {
     return company;
   }
   ...
}


public interface Company {
   ...

多对一也可以通过关联表的方式来映射，通过 @JoinTable 注解可定义关联表。该关联表包含指回实体的外键（通过@JoinTable.joinColumns）以及指向目标实体表的外键（通过@JoinTable.inverseJoinColumns）.

@Entity()
public class Flight implements Serializable {

   @ManyToOne( cascade = {CascadeType.PERSIST, CascadeType.MERGE} )
   @JoinTable(name="Flight_Company",
       joinColumns = @JoinColumn(name="FLIGHT_ID"),
       inverseJoinColumns = @JoinColumn(name="COMP_ID")
   )
   public Company getCompany() {
       return company;
   }
   ...
}

集合类型



 一对多

@OneToMany 注解可定义一对多关联。一对多关联可以是双向的。

双向

规范中多对一端几乎总是双向关联中的主体（owner）端，而一对多的关联注解为 @OneToMany(mappedBy=)

@Entity
public class Troop {
  @OneToMany(mappedBy="troop")
  public Set<Soldier> getSoldiers() {
  ...
}


@Entity
public class Soldier {
  @ManyToOne
  @JoinColumn(name="troop_fk")
  public Troop getTroop() {
  ...
  }

Troop 通过troop属性和Soldier建立了一对多的双向关联。在 mappedBy 端不必也不能定义任何物理映射。

单向

@Entity
public class Customer implements Serializable {
   @OneToMany(cascade=CascadeType.ALL, fetch=FetchType.EAGER)
   @JoinColumn(name="CUST_ID")
   public Set<Ticket> getTickets() {
      ...
   }

@Entity
public class Ticket implements Serializable {
   ... //no bidir
}

一般通过连接表来实现这种关联，可以通过@JoinColumn注解来描述这种单向关联关系。上例 Customer 通过 CUST_ID 列和 Ticket 建立了单向关联关系。

通过关联表来处理单向关联

@Entity
public class Trainer {
  @OneToMany
  @JoinTable(
     name="TrainedMonkeys",
     joinColumns = @JoinColumn( name="trainer_id"),
     inverseJoinColumns = @JoinColumn( name="monkey_id")
  )
  public Set<Monkey> getTrainedMonkeys() {
     ...
  }


@Entity
public class Monkey {
  ... //no bidir
}

通过关联表来处理单向一对多关系是首选，这种关联通过 @JoinTable 注解来进行描述。上例子中 Trainer 通过TrainedMonkeys表和Monkey建立了单向关联关系。其中外键trainer_id关联到Trainer(joinColumns)而外键monkey_id关联到Monkey(inverseJoinColumns).

默认处理机制

通过连接表来建立单向一对多关联不需要描述任何物理映射，表名由一下3个部分组成，主表(owner table)表名 + 下划线 + 从表(the other side table)表名。指向主表的外键名:主表表名+下划线+主表主键列名 指向从表的外键定义为唯一约束，用来表示一对多的关联关系。

@Entity
public class Trainer {
  @OneToMany
  public Set<Tiger> getTrainedTigers() {
  ...
}


@Entity
public class Tiger {
  ... //no bidir
}

上述例子中 Trainer 和 Tiger 通过 Trainer_Tiger 连接表建立单向关联关系。其中外键 trainer_id 关联到 Trainer表，而外键 trainedTigers_id 关联到 Tiger 表。

多对多

通过 @ManyToMany 注解定义多对多关系，同时通过 @JoinTable 注解描述关联表和关联条件。其中一端定义为 owner, 另一段定义为 inverse(对关联表进行更新操作，这段被忽略)。

@Entity
public class Employer implements Serializable {
  @ManyToMany(
    targetEntity=org.hibernate.test.metadata.manytomany.Employee.class,
    cascade={CascadeType.PERSIST, CascadeType.MERGE}
  )
  @JoinTable(
    name="EMPLOYER_EMPLOYEE",
    joinColumns=@JoinColumn(name="EMPER_ID"),
    inverseJoinColumns=@JoinColumn(name="EMPEE_ID")
  )
  public Collection getEmployees() {
    return employees;
  }
  ...
}

@Entity
public class Employee implements Serializable {
  @ManyToMany(
    cascade = {CascadeType.PERSIST, CascadeType.MERGE},
    mappedBy = "employees",
    targetEntity = Employer.class
  )
  public Collection getEmployers() {
    return employers;
  }
}

默认值：

关联表名：主表表名 + 下划线 + 从表表名；关联表到主表的外键：主表表名 + 下划线 + 主表中主键列名；关联表到从表的外键名：主表中用于关联的属性名 + 下划线 + 从表的主键列名。

用 cascading 实现传播持久化（Transitive persistence）

cascade 属性接受值为 CascadeType 数组，其类型如下：

• CascadeType.PERSIST: cascades the persist (create) operation to associated entities persist() is called or if the entity is managed 如果一个实体是受管状态，或者当 persist() 函数被调用时，触发级联创建(create)操作。


• CascadeType.MERGE: cascades the merge operation to associated entities if merge() is called or if the entity is managed 如果一个实体是受管状态，或者当 merge() 函数被调用时，触发级联合并(merge)操作。


• CascadeType.REMOVE: cascades the remove operation to associated entities if delete() is called 当 delete() 函数被调用时，触发级联删除(remove)操作。


• CascadeType.REFRESH: cascades the refresh operation to associated entities if refresh() is called  当 refresh() 函数被调用时，出发级联更新(refresh)操作。


• CascadeType.ALL: all of the above  以上全部

映射二级列表

使用类一级的 @SecondaryTable 和 @SecondaryTables 注解可以实现单个实体到多个表的映射。使用 @Column 或者 @JoinColumn 注解中的 table 参数可以指定某个列所属的特定表。

@Entity
@Table(name="MainCat")
@SecondaryTables({
    @SecondaryTable(name="Cat1", pkJoinColumns={
           @PrimaryKeyJoinColumn(name="cat_id", referencedColumnName="id")}),
    @SecondaryTable(name="Cat2", uniqueConstraints={
           @UniqueConstraint(columnNames={"storyPart2"})})
 })
public class Cat implements Serializable {
  private Integer id;
  private String name;

  private String storyPart1;
  private String storyPart2;
  @Id @GeneratedValue
  public Integer getId() {
    return id;
  }
  public String getName() {
    return name;
  }
  @Column(table="Cat1")
  public String getStoryPart1() {
    return storyPart1;
  }
  @Column(table="Cat2")
  public String getStoryPart2() {
    return storyPart2;
  }

上述例子中， name 保存在 MainCat 表中，storyPart1保存在 Cat1 表中，storyPart2 保存在 Cat2 表中。 Cat1 表通过外键 cat_id 和 MainCat 表关联， Cat2 表通过 id 列和 MainCat 表关联。对storyPart2 列还定义了唯一约束。

映射查询

使用注解可以映射 EJBQL/HQL 查询，@NamedQuery 和 @NamedQueries 是可以使用在类级别或者JPA的XML文件中的注解。

<entity-mappings>
 <named-query name="plane.getAll">
  <query>select p from Plane p</query>
 </named-query>
 ...
</entity-mappings>
...
@Entity
@NamedQuery(name="night.moreRecentThan", query="select n from Night n where n.date >= :date")
public class Night {
 ...
}
public class MyDao {
 doStuff() {
   Query q = s.getNamedQuery("night.moreRecentThan");
   q.setDate( "date", aMonthAgo );
   List results = q.list();
   ...
 }
 ...
}

可以通过定义 QueryHint 数组的 hints 属性为查询提供一些 hint 信息。下图是一些 Hibernate hints:



映射本地化查询

通过@SqlResultSetMapping 注解来描述 SQL 的 resultset 结构。如果定义多个结果集映射，则用 @SqlResultSetMappings。

@NamedNativeQuery(name="night&area", query="select night.id nid, night.night_duration, "
     + " night.night_date, area.id aid, night.area_id, area.name "
     + "from Night night, Area area where night.area_id = area.id", resultSetMapping="joinMapping")

@SqlResultSetMapping( name="joinMapping", entities={
  @EntityResult(entityClass=org.hibernate.test.annotations.query.Night.class, fields = {
   @FieldResult(name="id", column="nid"),
   @FieldResult(name="duration", column="night_duration"),
   @FieldResult(name="date", column="night_date"),
   @FieldResult(name="area", column="area_id"),
   discriminatorColumn="disc"
  }),
  
  @EntityResult(entityClass=org.hibernate.test.annotations.query.Area.class, fields = {
   @FieldResult(name="id", column="aid"),
   @FieldResult(name="name", column="name")
  })
 }
)

上面的例子，名为“night&area”的查询和 "joinMapping"结果集映射对应，该映射返回两个实体，分别为 Night 和 Area, 其中每个属性都和一个列关联，列名通过查询获取。

@Entity
@SqlResultSetMapping(name="implicit", 
  entities=@EntityResult(
    entityClass=org.hibernate.test.annotations.@NamedNativeQuery(
      name="implicitSample", query="select * from SpaceShip", 
      resultSetMapping="implicit")
public class SpaceShip {
 private String name;
 private String model;
 private double speed;
 @Id
 public String getName() {
  return name;
 }
 public void setName(String name) {
  this.name = name;
 }
 @Column(name="model_txt")
 public String getModel() {
  return model;
 }
 public void setModel(String model) {
  this.model = model;
 }
 public double getSpeed() {
  return speed;
 }
 public void setSpeed(double speed) {
  this.speed = speed;
 }
}

上例中 model1 属性绑定到 model_txt 列，如果和相关实体关联设计到组合主键，那么应该使用 @FieldResult 注解来定义每个外键列。@FieldResult的名字组成：定义这种关系的属性名字 + "." + 主键名或主键列或主键属性。

@Entity
@SqlResultSetMapping(name="compositekey",
 entities=@EntityResult(entityClass=org.hibernate.test.annotations.query.SpaceShip.class,
  fields = {
   @FieldResult(name="name", column = "name"),
   @FieldResult(name="model", column = "model"),
   @FieldResult(name="speed", column = "speed"),
   @FieldResult(name="captain.firstname", column = "firstn"),
   @FieldResult(name="captain.lastname", column = "lastn"),
   @FieldResult(name="dimensions.length", column = "length"),
   @FieldResult(name="dimensions.width", column = "width")
  }),
 columns = { @ColumnResult(name = "surface"),
 
@ColumnResult(name = "volume") } )
 @NamedNativeQuery(name="compositekey",
 query="select name, model, speed, lname as lastn, fname as firstn, length, width, length * width as resultSetMapping="compositekey")
})

如果查询返回的是单个实体，或者打算用系统默认的映射，这种情况下可以不使用 resultSetMapping，而使用resultClass属性，例如：

@NamedNativeQuery(name="implicitSample", query="select * from SpaceShip",
                                            resultClass=SpaceShip.class)
public class SpaceShip {

Hibernate 独有的注解扩展

Hibernate 提供了与其自身特性想吻合的注解，org.hibernate.annotations package包含了这些注解。

实体

org.hibernate.annotations.Entity 定义了  Hibernate 实体需要的信息。

• mutable: whether this entity is mutable or not  此实体是否可变


• dynamicInsert: allow dynamic SQL for inserts   用动态SQL新增


• dynamicUpdate: allow dynamic SQL for updates   用动态SQL更新


• selectBeforeUpdate: Specifies that Hibernate should never perform an SQL UPDATE unless it is certain that an object is actually modified.指明Hibernate从不运行SQL Update，除非能确定对象已经被修改


• polymorphism: whether the entity polymorphism is of PolymorphismType.IMPLICIT (default) or PolymorphismType.EXPLICIT 指出实体多态是 PolymorphismType.IMPLICIT(默认)还是PolymorphismType.EXPLICIT 


• optimisticLock: optimistic locking strategy (OptimisticLockType.VERSION, OptimisticLockType.NONE, OptimisticLockType.DIRTY or OptimisticLockType.ALL) 乐观锁策略

标识符

@org.hibernate.annotations.GenericGenerator和@org.hibernate.annotations.GenericGenerators允许你定义hibernate特有的标识符。

@Id @GeneratedValue(generator="system-uuid")
@GenericGenerator(name="system-uuid", strategy = "uuid")
public String getId() {
@Id @GeneratedValue(generator="hibseq")
@GenericGenerator(name="hibseq", strategy = "seqhilo",
   parameters = {
     @Parameter(name="max_lo", value = "5"),
     @Parameter(name="sequence", value="heybabyhey")
   }
)
public Integer getId() {

新例子

@GenericGenerators(
 {
  @GenericGenerator(
   name="hibseq",
   strategy = "seqhilo",
   parameters = {
    @Parameter(name="max_lo", value = "5"),
    @Parameter(name="sequence", value="heybabyhey")
   }
  ),
  @GenericGenerator(...)
 }
)

自然ID

用 @NaturalId 注解标识

公式

让数据库而不是JVM进行计算。

@Formula("obj_length * obj_height * obj_width")
public long getObjectVolume()

索引

通过在列属性(property)上使用@Index注解，可以指定特定列的索引，columnNames属性(attribute)将随之被忽略。

@Column(secondaryTable="Cat1")
@Index(name="story1index")
public String getStoryPart1() {
  return storyPart1;
}

辨别符

@Entity
@DiscriminatorFormula("case when forest_type is null then 0 else forest_type end")
public class Forest { ... }

过滤 查询 ...





• 其中一个实体通过外键关联到另一个实体的主键。注：一对一，则外键必须为唯一约束。

@Entity
public class Customer implements Serializable {
   @OneToOne(cascade = CascadeType.ALL)
   @JoinColumn(name="passport_fk")
   public Passport getPassport() {
   ...
}


@Entity
public class Passport implements Serializable {
   @OneToOne(mappedBy = "passport")
   public Customer getOwner() {
   ...
}

通过@JoinColumn注解定义一对一的关联关系。如果没有@JoinColumn注解，则系统自动处理，在主表中将创建连接列，列名为：主题的关联属性名 + 下划线 + 被关联端的主键列名。上例为 passport_id, 因为Customer 中关联属性为 passport, Passport 的主键为 id.


• 通过关联表来保存两个实体之间的关联关系。注：一对一，则关联表每个外键都必须是唯一约束。

@Entity
public class Customer implements Serializable {
   @OneToOne(cascade = CascadeType.ALL)
   @JoinTable(name = "CustomerPassports",
        joinColumns = @JoinColumn(name="customer_fk"),
        inverseJoinColumns = @JoinColumn(name="passport_fk")
   )
   public Passport getPassport() {
   ...
}


@Entity public class Passport implements Serializable {
   @OneToOne(mappedBy = "passport")
   public Customer getOwner() {
   ...
}

Customer 通过 CustomerPassports 关联表和 Passport 关联。该关联表通过 passport_fk 外键指向 Passport 表，该信心定义为 inverseJoinColumns 的属性值。 通过 customer_fk 外键指向 Customer 表，该信息定义为 joinColumns 属性值。



2、常用注解


1 、 @Entity(name="EntityName")

必须 ,name 为可选 , 对应数据库中一的个表

2 、 @Table(name="",catalog="",schema="")

可选 , 通常和 @Entity 配合使用 , 只能标注在实体的 class 定义处 , 表示实体对应的数据库表的信息

name: 可选 , 表示表的名称 . 默认地 , 表名和实体名称一致 , 只有在不一致的情况下才需要指定表名

catalog: 可选 , 表示 Catalog 名称 , 默认为 Catalog("").

schema: 可选 , 表示 Schema 名称 , 默认为 Schema("").

3 、 @id

必须

@id 定义了映射到数据库表的主键的属性 , 一个实体只能有一个属性被映射为主键 . 置于 getXxxx() 前 .

4 、 @GeneratedValue(strategy=GenerationType,generator="")

可选

strategy: 表示主键生成策略 , 有 AUTO,INDENTITY,SEQUENCE 和 TABLE 4 种 , 分别表示让 ORM 框架自动选择,

根据数据库的 Identity 字段生成 , 根据数据库表的 Sequence 字段生成 , 以有根据一个额外的表生成主键 , 默认为AUTO

generator: 表示主键生成器的名称 , 这个属性通常和 ORM 框架相关 , 例如 ,Hibernate 可以指定 uuid 等主键生成方式 .

示例 :

@Id

@GeneratedValues(strategy=StrategyType.SEQUENCE)

public int getPk() {

return pk;

}

5 、 @Basic(fetch=FetchType,optional=true)

可选

@Basic 表示一个简单的属性到数据库表的字段的映射 , 对于没有任何标注的 getXxxx() 方法 , 默认即为 @Basic

fetch: 表示该属性的读取策略 , 有 EAGER 和 LAZY 两种 , 分别表示主支抓取和延迟加载 , 默认为 EAGER.

optional: 表示该属性是否允许为 null, 默认为 true

示例 :

@Basic(optional=false)

public String getAddress() {

return address;

}

6 、 @Column

可选

@Column 描述了数据库表中该字段的详细定义 , 这对于根据 JPA 注解生成数据库表结构的工具非常有作用 .

name: 表示数据库表中该字段的名称 , 默认情形属性名称一致

nullable: 表示该字段是否允许为 null, 默认为 true

unique: 表示该字段是否是唯一标识 , 默认为 false

length: 表示该字段的大小 , 仅对 String 类型的字段有效

insertable: 表示在 ORM 框架执行插入操作时 , 该字段是否应出现 INSETRT 语句中 , 默认为 true

updateable: 表示在 ORM 框架执行更新操作时 , 该字段是否应该出现在 UPDATE 语句中 , 默认为 true. 对于一经创建就不可以更改的字段 , 该属性非常有用 , 如对于 birthday 字段 .

columnDefinition: 表示该字段在数据库中的实际类型 . 通常 ORM 框架可以根据属性类型自动判断数据库中字段的类型 , 但是对于 Date 类型仍无法确定数据库中字段类型究竟是 DATE,TIME 还是 TIMESTAMP. 此外 ,String 的默认映射类型为 VARCHAR, 如果要将 String 类型映射到特定数据库的 BLOB 或 TEXT 字段类型 , 该属性非常有用 .

示例 :

@Column(name="BIRTH",nullable="false",columnDefinition="DATE")

public String getBithday() {

return birthday;

}

7 、 @Transient

可选

@Transient 表示该属性并非一个到数据库表的字段的映射 ,ORM 框架将忽略该属性 .

如果一个属性并非数据库表的字段映射 , 就务必将其标示为 @Transient, 否则 ,ORM 框架默认其注解为 @Basic

示例 :

// 根据 birth 计算出 age 属性

@Transient

public int getAge() {

return getYear(new Date()) - getYear(birth);

}

8 、 @ManyToOne(fetch=FetchType,cascade=CascadeType )

可选

@ManyToOne 表示一个多对一的映射 , 该注解标注的属性通常是数据库表的外键

optional: 是否允许该字段为 null, 该属性应该根据数据库表的外键约束来确定 , 默认为 true

fetch: 表示抓取策略 , 默认为 FetchType.EAGER

cascade: 表示默认的级联操作策略 , 可以指定为 ALL,PERSIST,MERGE,REFRESH 和 REMOVE 中的若干组合 , 默认为无级联操作

targetEntity: 表示该属性关联的实体类型 . 该属性通常不必指定 ,ORM 框架根据属性类型自动判断targetEntity.

示例 :

// 订单 Order 和用户 User 是一个 ManyToOne 的关系

// 在 Order 类中定义

@ManyToOne()

@JoinColumn(name="USER")

public User getUser() {

return user;

}

9 、 @JoinColumn

可选

@JoinColumn 和 @Column 类似 , 介量描述的不是一个简单字段 , 而一一个关联字段 , 例如 . 描述一个@ManyToOne 的字段 .

name: 该字段的名称 . 由于 @JoinColumn 描述的是一个关联字段 , 如 ManyToOne, 则默认的名称由其关联的实体决定 .

例如 , 实体 Order 有一个 user 属性来关联实体 User, 则 Order 的 user 属性为一个外键 ,

其默认的名称为实体 User 的名称 + 下划线 + 实体 User 的主键名称

示例 :

见 @ManyToOne

10 、 @OneToMany(fetch=FetchType,cascade=CascadeType)

可选

@OneToMany 描述一个一对多的关联 , 该属性应该为集体类型 , 在数据库中并没有实际字段 .

fetch: 表示抓取策略 , 默认为 FetchType.LAZY, 因为关联的多个对象通常不必从数据库预先读取到内存

cascade: 表示级联操作策略 , 对于 OneToMany 类型的关联非常重要 , 通常该实体更新或删除时 , 其关联的实体也应当被更新或删除

例如 : 实体 User 和 Order 是 OneToMany 的关系 , 则实体 User 被删除时 , 其关联的实体 Order 也应该被全部删除

示例 :

@OneTyMany(cascade=ALL)

public List getOrders() {

return orders;

}

11 、 @OneToOne(fetch=FetchType,cascade=CascadeType)

可选

@OneToOne 描述一个一对一的关联

fetch: 表示抓取策略 , 默认为 FetchType.LAZY

cascade: 表示级联操作策略

示例 :

@OneToOne(fetch=FetchType.LAZY)

public Blog getBlog() {

return blog;

}

12 、 @ManyToMany

可选

@ManyToMany 描述一个多对多的关联 . 多对多关联上是两个一对多关联 , 但是在 ManyToMany 描述中 , 中间表是由ORM 框架自动处理

targetEntity: 表示多对多关联的另一个实体类的全名 , 例如 :package.Book.class

mappedBy: 表示多对多关联的另一个实体类的对应集合属性名称

示例 :

User 实体表示用户 ,Book 实体表示书籍 , 为了描述用户收藏的书籍 , 可以在 User 和 Book 之间建立ManyToMany 关联

@Entity

public class User {

private List books;

@ManyToMany(targetEntity=package.Book.class)

public List getBooks() {

return books;

}

public void setBooks(List books) {

this.books=books;

}

}

@Entity

public class Book {

private List users;

@ManyToMany(targetEntity=package.Users.class, mappedBy="books")

public List getUsers() {

return users;

}

public void setUsers(List users) {

this.users=users;

}

}

两个实体间相互关联的属性必须标记为 @ManyToMany, 并相互指定 targetEntity 属性 ,

需要注意的是 , 有且只有一个实体的 @ManyToMany 注解需要指定 mappedBy 属性

13、@TransactionAttribute

事务管理服务

最有用的容器服务可能就是事务管理服务，当应用出现失败或异常时，它保证了数据库的完整性。你可以简单地将为一个 POJO方法申明它的事务属性。这样容器就可以在合适的上下文中运行这个方法。最常见的事务是定义在 session bean 的方法上，方法中所有的数据库操作只有在方法正常退出时才会提交，如果方法抛出未捕获的异常，事务管理将回滚所有的变更。

@TransactionAttribute 注释用作定义一个需要事务的方法。例如：

@TransactionAttribute(TransactionAttributeType.REQUIRED)

public void insertProduct(String name, Float price, boolean error) {

…

…

}

它可以有以下参数：

a. REQUIRED : 方法在一个事务中执行，如果调用的方法已经在一个事务中，则使用该事务，否则将创建一个新的事务。

b. MANDATORY : 方法必须在一个事务中执行，也就是说调用的方法必须已经有一个事务，否则新抛出一个错误（ERROR ）。

c. REQUIRESNEW : 方法将在一个新的事务中执行，如果调用的方法已经在一个事务中，则暂停旧的事务。

d. SUPPORTS : 如果方法在一个事务中被调用，则使用该事务，否则不使用事务。

e. NOT_SUPPORTED ：如果方法在一个事务中被调用，将抛出一个错误（ ERROR ）

如果没有指定参数， @TransactionAttribute 注释使用 REQUIRED 作为默认参数。

14、@PersistenceContextType

PersistenceContextType.EXTENDED。在默认情况下，EntityManagers用TRANSACTION的 PersistenceContextType来创建。这样做也就表示，只有当有活动的事务处理在进行时，实体才是可托管的。事务处理一结束，实体就与实 体管理程序脱离，这样我们就可以丢弃它。EXTENDED上下文类型表示这种脱离不会发生，即使在事务处理结束后实体仍然是可托管的。这就意味着你不需要 担心集合是否被暂缓取回，因为实体管理程序可以用来完成所需要的取回操作。当我们想要保持和更新／合并实体，或者从数据库里删除实体的时候，我们仍然需要 获得EntityTransaction，例如我们想要保存一个新的Application实体：

public void saveApplication(Application a) { 
   EntityTransaction tx=em.getTransaction(); 
   tx.begin(); 
   em.persist(a); 
   tx.commit(); 
}


1、@Entity(name="EntityName") 
必须,name为可选,对应数据库中一的个表 

2、@Table(name="",catalog="",schema="") 
可选,通常和@Entity配合使用,只能标注在实体的class定义处,表示实体对应的数据库表的信息 
name:可选,表示表的名称.默认地,表名和实体名称一致,只有在不一致的情况下才需要指定表名 
catalog:可选,表示Catalog名称,默认为Catalog(""). 
schema:可选,表示Schema名称,默认为Schema(""). 

3、@id 
必须 
@id定义了映射到数据库表的主键的属性,一个实体只能有一个属性被映射为主键.置于getXxxx()前. 

4、@GeneratedValue(strategy=GenerationType,generator="") 
可选 
strategy:表示主键生成策略,有AUTO,INDENTITY,SEQUENCE 和 TABLE 4种,分别表示让ORM框架自动选择, 
根据数据库的Identity字段生成,根据数据库表的Sequence字段生成,以有根据一个额外的表生成主键,默认为AUTO 
generator:表示主键生成器的名称,这个属性通常和ORM框架相关,例如,Hibernate可以指定uuid等主键生成方式. 
示例: 
    @Id 
    @GeneratedValues(strategy=StrategyType.SEQUENCE) 
    public int getPk() { 
       return pk; 
    } 

5、@Basic(fetch=FetchType,optional=true) 
可选 
@Basic表示一个简单的属性到数据库表的字段的映射,对于没有任何标注的getXxxx()方法,默认即为@Basic 
fetch: 表示该属性的读取策略,有EAGER和LAZY两种,分别表示主支抓取和延迟加载,默认为EAGER. 
optional:表示该属性是否允许为null,默认为true 
示例: 
    @Basic(optional=false) 
    public String getAddress() { 
       return address; 
    } 

6、@Column 
可选 
@Column描述了数据库表中该字段的详细定义,这对于根据JPA注解生成数据库表结构的工具非常有作用. 
name:表示数据库表中该字段的名称,默认情形属性名称一致 
nullable:表示该字段是否允许为null,默认为true 
unique:表示该字段是否是唯一标识,默认为false 
length:表示该字段的大小,仅对String类型的字段有效 
insertable:表示在ORM框架执行插入操作时,该字段是否应出现INSETRT语句中,默认为true 
updateable:表示在ORM框架执行更新操作时,该字段是否应该出现在UPDATE语句中,默认为true.对于一经创建就不可以更改的字段,该属性非常有用,如对于birthday字段. 
columnDefinition:表示该字段在数据库中的实际类型.通常ORM框架可以根据属性类型自动判断数据库中字段的类型,但是对于Date类型仍无法确定数据库中字段类型究竟是DATE,TIME还是TIMESTAMP.此外,String的默认映射类型为VARCHAR,如果要将String类型映射到特定数据库的BLOB或TEXT字段类型,该属性非常有用. 
示例: 
    @Column(name="BIRTH",nullable="false",columnDefinition="DATE") 
    public String getBithday() { 
       return birthday; 
    } 

7、@Transient 
可选 
@Transient表示该属性并非一个到数据库表的字段的映射,ORM框架将忽略该属性. 
如果一个属性并非数据库表的字段映射,就务必将其标示为@Transient,否则,ORM框架默认其注解为@Basic 
示例: 
    //根据birth计算出age属性 
    @Transient 
    public int getAge() { 
       return getYear(new Date()) - getYear(birth); 
    } 

8、@ManyToOne(fetch=FetchType,cascade=CascadeType) 
可选 
@ManyToOne表示一个多对一的映射,该注解标注的属性通常是数据库表的外键 
optional:是否允许该字段为null,该属性应该根据数据库表的外键约束来确定,默认为true 
fetch:表示抓取策略,默认为FetchType.EAGER 
cascade:表示默认的级联操作策略,可以指定为ALL,PERSIST,MERGE,REFRESH和REMOVE中的若干组合,默认为无级联操作 
targetEntity:表示该属性关联的实体类型.该属性通常不必指定,ORM框架根据属性类型自动判断targetEntity. 
示例: 
    //订单Order和用户User是一个ManyToOne的关系 
    //在Order类中定义 
    @ManyToOne() 
    @JoinColumn(name="USER") 
    public User getUser() { 
       return user; 
    } 

9、@JoinColumn 
可选 
@JoinColumn和@Column类似,介量描述的不是一个简单字段,而一一个关联字段,例如.描述一个@ManyToOne的字段. 
name:该字段的名称.由于@JoinColumn描述的是一个关联字段,如ManyToOne,则默认的名称由其关联的实体决定. 
例如,实体Order有一个user属性来关联实体User,则Order的user属性为一个外键, 
其默认的名称为实体User的名称+下划线+实体User的主键名称 
示例: 
    见@ManyToOne 

10、@OneToMany(fetch=FetchType,cascade=CascadeType) 
可选 
@OneToMany描述一个一对多的关联,该属性应该为集体类型,在数据库中并没有实际字段. 
fetch:表示抓取策略,默认为FetchType.LAZY,因为关联的多个对象通常不必从数据库预先读取到内存 
cascade:表示级联操作策略,对于OneToMany类型的关联非常重要,通常该实体更新或删除时,其关联的实体也应当被更新或删除 
例如:实体User和Order是OneToMany的关系,则实体User被删除时,其关联的实体Order也应该被全部删除 
示例: 
    @OneTyMany(cascade=ALL) 
    public List getOrders() { 
       return orders; 
    } 

11、@OneToOne(fetch=FetchType,cascade=CascadeType) 
可选 
@OneToOne描述一个一对一的关联 
fetch:表示抓取策略,默认为FetchType.LAZY 
cascade:表示级联操作策略 
示例: 
    @OneToOne(fetch=FetchType.LAZY) 
    public Blog getBlog() { 
       return blog; 
    } 

12、@ManyToMany 
可选 
@ManyToMany 描述一个多对多的关联.多对多关联上是两个一对多关联,但是在ManyToMany描述中,中间表是由ORM框架自动处理 
targetEntity:表示多对多关联的另一个实体类的全名,例如:package.Book.class 
mappedBy:表示多对多关联的另一个实体类的对应集合属性名称 
示例: 
    User实体表示用户,Book实体表示书籍,为了描述用户收藏的书籍,可以在User和Book之间建立ManyToMany关联
    @Entity 
    public class User { 
       private List books; 
       @ManyToMany(targetEntity=package.Book.class) 
       public List getBooks() { 
           return books; 
       } 
       public void setBooks(List books) { 
           this.books=books; 
       } 
    } 
   
    @Entity 
    public class Book { 
       private List users; 
       @ManyToMany(targetEntity=package.Users.class, mappedBy="books") 
       public List getUsers() { 
           return users; 
       } 
       public void setUsers(List users) { 
           this.users=users; 
       } 
    } 
两个实体间相互关联的属性必须标记为@ManyToMany,并相互指定targetEntity属性, 
需要注意的是,有且只有一个实体的@ManyToMany注解需要指定mappedBy属性,指向targetEntity的集合属性名称 
利用ORM工具自动生成的表除了User和Book表外,还自动生成了一个User_Book表,用于实现多对多关联 

13、@MappedSuperclass 
可选 
@MappedSuperclass可以将超类的JPA注解传递给子类,使子类能够继承超类的JPA注解 
示例: 
    @MappedSuperclass 
    public class Employee() { 
       .... 
    } 
   
    @Entity 
    public class Engineer extends Employee { 
       ..... 
    } 
    @Entity 
    public class Manager extends Employee { 
       ..... 
    } 

14、@Embedded 
可选 
@Embedded将几个字段组合成一个类,并作为整个Entity的一个属性. 
例如User包括id,name,city,street,zip属性. 
我们希望city,street,zip属性映射为Address对象.这样,User对象将具有id,name和address这三个属性. 
Address对象必须定义为@Embededable 
示例: 
    @Embeddable 
    public class Address {city,street,zip} 
    @Entity 
    public class User { 
       @Embedded 
       public Address getAddress() { 
           .......... 
       } 
    } 


　 

　　现在，让我们来动手使用Hibernate Annotation。 

安装 Hibernate Annotation 
　　要使用 Hibernate Annotation，您至少需要具备 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）。如果您正在使用 Maven，只需要向 POM 文件添加相应的依赖项即可，如下所示： 

    ... 
<dependency> 
<groupId>org.hibernate</groupId> 
<artifactId>hibernate</artifactId> 
<version>3.2.1.ga</version> 
</dependency> 
<dependency> 
<groupId>org.hibernate</groupId> 
<artifactId>hibernate-annotations</artifactId> 
<version>3.2.0.ga</version> 
</dependency> 
<dependency> 
<groupId>javax.persistence</groupId> 
<artifactId>persistence-api</artifactId> 
<version>1.0</version> 
</dependency> 
... 
　　下一步就是获取 Hibernate 会话工厂。尽管无需惊天的修改，但这一工作与使用 Hibernate Annotations有所不同。您需要使用 AnnotationConfiguration 类来建立会话工厂： 

sessionFactory = new 
AnnotationConfiguration().buildSessionFactory(); 
　　尽管通常使用 <mapping> 元素来声明持久性类，您还是需要在 Hibernate 配置文件（通常是 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> 
<mapping class="com.onjava.modelplanes.domain.PlaneType"/> 
<mapping class="com.onjava.modelplanes.domain.ModelPlane"/> 
</session-factory> 
</hibernate-configuration> 
　　近期的许多 Java 项目都使用了轻量级的应用框架，例如 Spring。如果您正在使用 Spring 框架，可以使用 AnnotationSessionFactoryBean 类轻松建立一个基于注释的 Hibernate 会话工厂，如下所示： 

<!-- Hibernate session factory --> 
<bean id="sessionFactory" 
class="org.springframework.orm.hibernate3.annotation.AnnotationSessionFactoryBean"> 
<property name="dataSource"> 
<ref bean="dataSource"/> 
</property> 
<property name="hibernateProperties"> 
<props> 
<prop key="hibernate.dialect">org.hibernate.dialect.DerbyDialect</prop> 
<prop key="hibernate.hbm2ddl.auto">create</prop> 
... 
</props> 
</property> 
<property name="annotatedClasses"> 
<list> 
<value>com.onjava.modelplanes.domain.PlaneType</value> 
<value>com.onjava.modelplanes.domain.ModelPlane</value> 
... 
</list> 
</property> 
</bean> 
第一个持久性类 
　　既然已经知道了如何获得注释所支持的 Hibernate 会话，下面让我们来了解一下带注释的持久性类的情况： 

　　像在其他任何 Hibernate应用程序中一样，带注释的持久性类也是普通 POJO。差不多可以说是。您需要向 Java 持久性 API （javax.persistence.*）添加依赖项，如果您正在使用任何特定于 Hibernate的扩展，那很可能就是 Hibernate Annotation 程序包（org.hibernate.annotations.*），但除此之外，它们只是具备了持久性注释的普通 POJO 。下面是一个简单的例子： 

@Entity 
public class ModelPlane { 
private Long id; 
private String name; 
@Id 
public Long getId() { 
return id; 
} 
public void setId(Long id) { 
this.id = id; 
} 
public String getName() { 
return name; 
} 
public void setName(String name) { 
this.name = name; 
} 
} 
　　正像我们所提到的，这非常简单。@Entity 注释声明该类为持久类。@Id 注释可以表明哪种属性是该类中的独特标识符。事实上，您既可以保持字段（注释成员变量），也可以保持属性（注释getter方法）的持久性。后文中将使用基于属性的注释。基于注释的持久性的优点之一在于大量使用了默认值（最大的优点就是 “惯例优先原则（convention over configuration）”）。例如，您无需说明每个属性的持久性——任何属性都被假定为持久的，除非您使用 @Transient 注释来说明其他情况。这简化了代码，相对使用老的 XML 映射文件而言也大幅地减少了输入工作量。 

生成主键 
　　Hibernate 能够出色地自动生成主键。Hibernate/EBJ 3 注释也可以为主键的自动生成提供丰富的支持，允许实现各种策略。下面的示例说明了一种常用的方法，其中 Hibernate 将会根据底层数据库来确定一种恰当的键生成策略： 

@Id 
@GeneratedValue(strategy=GenerationType.AUTO) 
public Long getId() { 
return id; 
} 
定制表和字段映射 
　　默认情况下，Hibernate 会将持久类以匹配的名称映射到表和字段中。例如，前一个类可以与映射到以如下代码创建的表中： 

CREATE TABLE MODELPLANE 
( 
ID long, 
NAME varchar 
) 
　　如果您是自己生成并维护数据库，那么这种方法很有效，通过省略代码可以大大简化代码维护。然而，这并不能满足所有人的需求。有些应用程序需要访问外部数据库，而另一些可能需要遵从公司的数据库命名惯例。如果有必要，您可以使用 @Table 和 @Column 注释来定制您自己的持久性映射，如下所示： 

@Entity 
@Table(name="T_MODEL_PLANE") 
public class ModelPlane { 
private Long id; 
private String name; 
@Id 
@Column(name="PLANE_ID") 
public Long getId() { 
return id; 
} 
public void setId(Long id) { 
this.id = id; 
} 
@Column(name="PLANE_NAME") 
public String getName() { 
return name; 
} 
public void setName(String name) { 
this.name = name; 
} 
} 
　　该内容将映射到下表中： 

CREATE TABLE T_MODEL_PLANE 
( 
PLANE_ID long, 
PLANE_NAME varchar 
) 
　　也可以使用其他图和列的属性来定制映射。这使您可以指定诸如列长度、非空约束等详细内容。Hibernate支持大量针对这些注释的属性。下例中就包含了几种属性： 

    ... 
@Column(name="PLANE_ID", length=80, nullable=true) 
public String getName() { 
return name; 
} 
... 
映射关系 
　　Java 持久性映射过程中最重要和最复杂的一环就是确定如何映射表间的关系。像其他产品一样， Hibernate 在该领域中提供了高度的灵活性，但却是以复杂度的增加为代价。我们将通过研究几个常见案例来了解如何使用注释来处理这一问题。 

　　其中一种最常用的关系就是多对一的关系。假定在以上示例中每个 ModelPlane 通过多对一的关系（也就是说，每个飞机模型只与一种飞机类型建立联系，尽管指定的飞机类型可以与七种飞机模型建立联系）来与 PlaneType 建立联系。可如下进行映射： 

    @ManyToOne( cascade = {CascadeType.PERSIST, CascadeType.MERGE} ) 
public PlaneType getPlaneType() { 
return planeType; 
} 
　　CascadeType 值表明 Hibernate 应如何处理级联操作。 

　　另一种常用的关系与上述关系相反：一对多再对一关系，也称为集合。在老式的 Hibernate 版本中进行映射或使用注释时，集合令人头疼，这里我们将简要加以探讨，以使您了解如何处理集合，例如，在以上示例中每个 PlaneType 对象都可能会包含一个 ModelPlanes 集合。可映射如下： 

@OneToMany(mappedBy="planeType", 
cascade=CascadeType.ALL, 
fetch=FetchType.EAGER) 
@OrderBy("name") 
public List<ModelPlane> getModelPlanes() { 
return modelPlanes; 
} 
命名查询 
　　Hibernate 最优秀的功能之一就在于它能够在您的映射文件中声明命名查询。随后即可通过代码中的名称调用此类查询，这使您可以专注于查询，而避免了 SQL 或者 HQL 代码分散于整个应用程序中的情况。 

　　也可以使用注释来实现命名查询，可以使用 @NamedQueries 和 @NamedQuery 注释，如下所示： 

@NamedQueries( 
{ 
@NamedQuery( 
name="planeType.findById", 
query="select p from PlaneType p left join fetch p.modelPlanes where id=:id" 
), 
@NamedQuery( 
name="planeType.findAll", 
query="select p from PlaneType p" 
), 
@NamedQuery( 
name="planeType.delete", 
query="delete from PlaneType where id=:id" 
) 
} 
) 
　　一旦完成了定义，您就可以像调用其他任何其他命名查询一样来调用它们。


3、注解实战一  -- Hibernate4实战之Hibernate4注解零配置


@Entity，注册在类头上，将一个类声明为一个实体bean(即一个持久化POJO类) 。
@Table，注册在类头上，注解声明了该实体bean映射指定的表（table）。
@Id用来注册主属性，@GeneratedValue用来注册主属性的生成策略，@Column用来注册属性，@Version用来注册乐观锁，@Transient用来注册不是属性。
以上的@Id、@GeneratedValue、 @Column 、 @Version，可以用来注册属性，既可以写在Java类的属性上，也可以注册在属性对应的getter上。
@Transient注册在多余的属性或多余的getter上，但是必须与以上的@Column等对应。
@Column
标识属性对应的字段，示例：@Column(name=“userName")

java代码：
查看 复制到剪贴板 打印
  1. @Column(  
  2.     name="columnName";                                (1)  
  3.     boolean unique() default false;                   (2)  
  4.     boolean nullable() default true;                  (3)  
  5.     boolean insertable() default true;                (4)  
  6.     boolean updatable() default true;                 (5)  
  7.     String columnDefinition() default "";             (6)  
  8.     String table() default "";                        (7)  
  9.     int length() default 255;                         (8)  
  10.     int precision() default 0; // decimal precision   (9)  
  11.     int scale() default 0; // decimal scale           (10)  
(1) name 可选,列名(默认值是属性名)
(2) unique 可选,是否在该列上设置唯一约束(默认值false)
(3) nullable 可选,是否设置该列的值可以为空(默认值false)
(4) insertable 可选,该列是否作为生成的insert语句中的一个列(默认值true)
(5) updatable 可选,该列是否作为生成的update语句中的一个列(默认值true)
(6) columnDefinition 可选: 为这个特定列覆盖SQL DDL片段 (这可能导致无法在不同数据库间移植)
(7) table 可选,定义对应的表(默认为主表)
(8) length 可选,列长度(默认值255)
(8) precision 可选,列十进制精度(decimal precision)(默认值0)
(10) scale 可选,如果列十进制数值范围(decimal scale)可用,在此设置(默认值0)
@Id，标识这个属性是实体类的唯一识别的值。
注意：这个注解只能标注单一列构成的主键，如tbl_grade那种有两个字段组成的联合主键由其他注解标识。
回忆*.hbm.xml：
<id name=  "uuid">
<generator class=  "assigned"/>
        </id>
@Id，只是标识这个属性是主键，但是并没有指出其生成策略，如上例中的assigned就是由程序员指定的生成策略。
如果仅仅写出@Id，即是使用assigned生成略，如：

java代码：
查看 复制到剪贴板 打印
  1. @Id  
  2. @Column  
  3. private int uuid;  
  4. 如果想使用Oracle支持的sequence取主键，必须通过@GeneratedValue来指定生成策略，而由@SequenceGenerator指定如何使用sequence。  
  5. @Id  
  6. @Column  
  7. @GeneratedValue(  
  8. strategy = GenerationType.SEQUENCE,//使用sequence生成主键  
  9. generator =“generator“//引用下面名为gernator的生成策略  
  10. )  
  11. @SequenceGenerator(  
  12. name = “generator”,//定义名为generator的生成策略  
  13. allocationSize = 1，//每次sequence加1  
  14. name=“seq_a”//引用名为seq_a的sequence  
  15. )  
  16. private int uuid;  
  17. @Version  
标识这个属性用来映射乐观锁的version
@Transient
标识这个属性不用持久化
@Embeddable【小对象的头上】
标识实体中可以定义一个嵌入式组件(embedded component)。组件类必须在类一级定义@Embeddable注解。
@Embedded【大对象的属性头上】
引用定义的小对象。
@Embeddable【小对象的头上】
标识实体中可以定义一个嵌入式组件(embedded component)。组件类必须在类一级定义@Embeddable注解。
注意：如果这个小对象作为复合主键，一定要实现Serializable接口。这并不是注解决定的，而是Hibernate的主键都需要实现Serializable接口。
@EmbeddedId 【大对象的属性头上】
引用定义的小对象作为主键。
注意：不需要再使用@Id注解。
 
标准的1:1
    
XML的配置

java代码：
查看 复制到剪贴板 打印
  1. 主1【tbl_product】：  
  2. <one-to-one name="info" cascade="all"/>  
  3. 从1【tbl_product_info】：  
  4. <id name="uuid">  
  5. <generator class=“foreign【写死，使用外来生成策略】">  
  6. <param name=“property”>product【引用自己的Java属性名】 </param>  
  7. </generator>  
  8. </id>  
  9. <one-to-one name="product"/>  
注解的配置

java代码：
查看 复制到剪贴板 打印
  1. 主1【tbl_product】：  
  2. @OneToOne(cascade=CascadeType.ALL)  
  3. @PrimaryKeyJoinColumn  
  4. private ProductInfoModel info;  
  5. 从1【tbl_product_info】：  
  6. @Id  
  7. @Column  
  8. @GeneratedValue(generator=“copy【引用生成策略】")  
  9. @GenericGenerator(name=“copy【定义生成策略】”,strategy=“foreign【写死，使用外来策略】”,parameters=@Parameter(name=“property”,value=“product【引用自己的Java属性】"))  
  10. private int uuid;  
  11. @OneToOne(mappedBy=“info【引用对方的Java属性】")  
  12. private ProductModel product;  
  13.    
标准的1:M
  
XML的配置


java代码：
查看 复制到剪贴板 打印
  1. 1【tbl_parent】：  
  2.  <set name="children">  
  3.         <key column=“puuid【对方的数据库外键列名】"/>  
  4.         <one-to-many class=“cn.javass.model.c.ChildModel【对方的Java类名】"/>  
  5.   </set>  
  6. 多【tbl_child】：  
  7. <many-to-one name=“parent” column=“puuid【自己的数据库外键列名】"/>  
注解的配置


java代码：
查看 复制到剪贴板 打印
  1. 1【tbl_parent】：  
  2. @OneToMany  
  3. @JoinColumn(name="puuid【对方的数据库外键列名】")  
  4. private Set<ChildModel> children = new HashSet<ChildModel>();  
  5. 多【tbl_child】：  
  6. @ManyToOne  
  7. @JoinColumn(name="puuid【自己的数据库外键列名】")  
  8. private ParentModel parent;  
  9.    
标准的1:M

 
XML的配置

java代码：
查看 复制到剪贴板 打印
  1. <set name=“courses” table=“tbl_grade【联接表】">  
  2.         <key column=“suuid【联接表里代表自己的数据库字段名】"/>  
  3.         <many-to-many column=“cuuid【联接表里代表对方的数据库字段名】” class=“cn.javass.model.e.CourseMode【对方的类名】l"/>  
  4. </set>  
  5. 注解的配置  
  6. @ManyToMany  
  7. @JoinTable(  
  8. name=“tbl_grade【联接表】",  
  9. joinColumns=@JoinColumn(name="suuid【联接表里代表自己的数据库字段名】"),  
  10. inverseJoinColumns=@JoinColumn(name="cuuid 【联接表里代表对方的数据库字段名】” )  
  11. )  
  12. private Set<CourseModel> courses = new HashSet<CourseModel>();  
  13.    
标准的1:M

    
XML的配置


java代码：
查看 复制到剪贴板 打印
  1. 主1【tbl_product】：  
  2. <one-to-one name=“info” foreign-key=“puuid【对方的数据库外键列名】" cascade="all"/>  
  3. 从1【tbl_product_info】：  
  4. <many-to-one name=“product” column=“puuid【自己的数据库外键列名】” unique=“true【写死】"/>  
注解的配置


java代码：
查看 复制到剪贴板 打印
  1. 主1【tbl_product】：  
  2. @OneToOne(cascade=CascadeType.ALL,mappedBy=“product【对方的Java类属性名 】")  
  3. private ProductInfoModel info;  
  4. 从1【tbl_product_info】：  
  5. @OneToOne  
  6. @JoinColumn(name=“puuid【自己的数据库外键列名】")  
  7. private ProductModel product;  
标准的1:M
 
  
 
 
XML的配置

java代码：
查看 复制到剪贴板 打印
  1. 1【tbl_parent】：  
  2. <set name=“children” table=“tbl_parent_child【联接表】">  
  3.         <key column=“puuid【联接表里代表自己的数据库列名】"/>  
  4.         <many-to-many column=“cuuid【联接表里代表对方的数据库列名】” unique=“true【写死】”  
  5. class=“cn.javass.model.d.ChildModel【对方的Java类名】"/>  
  6.         </set>  
  7. <join table=“tbl_parent_child【联接表】">  
  8.         <key column="cuuid【联接表里代表自己的数据库列名】"/>  
  9.         <many-to-one name="parent" column="puuid【联接表里代表对方的数据库列名】" unique="true【写死】"/>  
  10. </join>  
注解的配置

java代码：
查看 复制到剪贴板 打印
  1. 1【tbl_parent】：  
  2. @OneToMany(mappedBy="parent【对方的Java类属性名 】")  
  3. private Set<ChildModel> children = new HashSet<ChildModel>();  
  4. 多【tbl_child】：  
  5. @ManyToOne  
  6. @JoinTable(  
  7. name=“tbl_parent_child【联接表】",  
  8. joinColumns=@JoinColumn(name="cuuid【联接表里代表自己的数据库字段名】"),  
  9. inverseJoinColumns=@JoinColumn(name="puuid【联接表里代表对方的数据库字段名】")  
  10. )  
  11. private ParentModel parent;  
 
标准的1:M
 
  
 
 
XML的配置

java代码：
查看 复制到剪贴板 打印
  1. 1【tbl_product】：  
  2. <join table=“tbl_product_relation【联接表】">  
  3.         <key column=“puuid【联接表里代表自己的列名】"/>  
  4.         <many-to-one name=“course【自己的Java属性名】” column=“cuuid【联接表里代表对方的列名】” unique=“true【写死】"/>  
  5.  </join>  
注解的配置

java代码：
查看 复制到剪贴板 打印
  1. 1【tbl_product】：  
  2. @ManyToOne  
  3. @JoinTable(  
  4. name=" tbl_product_relation 【联接表】",  
  5. joinColumns=@JoinColumn(name="suuid【联接表里代表自己的列名】"),  
  6. inverseJoinColumns=@JoinColumn(name="cuuid【联接表里代表对方的列名】",unique=true【写死】)  
  7. )  
  8. private CourseModel course;  



4、注解版实战二、


数据库：mysql

category表：id，name，description       <Pk>id

product表：id,name ,price, description ,category_id                  <pk>id  <fk>category_id

新建java project项目：

Add Hibernate Capabilities

hibernate.cfg.xml

复制代码 
 1 <?xml version='1.0' encoding='UTF-8'?>
 2 <!DOCTYPE hibernate-configuration PUBLIC
 3           "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
 4           "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
 5 
 6 <!-- Generated by MyEclipse Hibernate Tools.                   -->
 7 <hibernate-configuration>
 8 
 9  <session-factory>
10   <property name="dialect">
11    org.hibernate.dialect.MySQLDialect
12   </property>
13   <property name="connection.url">
14    jdbc:mysql://localhost:3307/users
15   </property>
16   <property name="connection.username">root</property>
17   <property name="connection.password">root</property>
18   <property name="connection.driver_class">
19    com.mysql.jdbc.Driver
20   </property>
21   <property name="myeclipse.connection.profile">
22    mysqlusers
23   </property>
24   <property name="format_sql">true</property>
25   <property name="show_sql">true</property>
26   <property name="current_session_context_class">thread</property>
27   <mapping class="com.b510.examples.Product" />
28   <mapping class="com.b510.examples.Category" />
29 
30  </session-factory>
31 
32 </hibernate-configuration>
复制代码

利用Hibernate的逆向工程生成：

Category.java      and           Product.java   

Category.java

复制代码 
 1 package com.b510.examples;
 2 
 3 import java.util.HashSet;
 4 import java.util.Set;
 5 
 6 // 标准注解
 7 
 8 import javax.persistence.CascadeType;
 9 import javax.persistence.Column;
10 import javax.persistence.Entity;
11 import javax.persistence.FetchType;
12 import javax.persistence.GeneratedValue;
13 import javax.persistence.Id;
14 import javax.persistence.OneToMany;
15 import javax.persistence.Table;
16 
17 //增加的注解
18 
19 import org.hibernate.annotations.GenericGenerator;
20 
21 //当前的类是一个持久化类，是Category这个类。他映射了一个表category。所对应的 数据库是users
22 //这句：@Table(name = "category", catalog = "users")  可以省略
23 @Entity
24 @Table(name = "category", catalog = "users")
25 
26 public class Category implements java.io.Serializable {
27 
28  private static final long serialVersionUID = 3240281547213597385L;
29  private Integer id;
30  private String name;
31  private String description;
32  private Set<Product> products = new HashSet<Product>(0);
33 
34  
35  public Category() {
36  }
37 
38  public Category(String name, String description, Set<Product> products) {
39   this.name = name;
40   this.description = description;
41   this.products = products;
42  }
43 
44  // 主键 ：@Id    主键生成方式：strategy = "increment"
45  //映射表中id这个字段，不能为空，并且是唯一的
46  @GenericGenerator(name = "generator", strategy = "increment")
47  @Id
48  @GeneratedValue(generator = "generator")
49  @Column(name = "id", unique = true, nullable = false)
50  public Integer getId() {
51   return this.id;
52  }
53 
54  public void setId(Integer id) {
55   this.id = id;
56  }
57 
58  //映射表中name这个字段 ，长度是500
59  @Column(name = "name", length = 500)
60  public String getName() {
61   return this.name;
62  }
63 
64  public void setName(String name) {
65   this.name = name;
66  }
67  
68  //映射表中description这个字段 ，长度是500
69  @Column(name = "description", length = 500)
70  public String getDescription() {
71   return this.description;
72  }
73 
74  public void setDescription(String description) {
75   this.description = description;
76  }
77 
78  //级联操作：cascade = CascadeType.ALL
79  //延迟加载：fetch = FetchType.LAZY
80  //映射：mappedBy = "category"
81  //一对多方式
82  @OneToMany(cascade = CascadeType.ALL, fetch = FetchType.LAZY, mappedBy = "category")
83  public Set<Product> getProducts() {
84   return this.products;
85  }
86 
87  public void setProducts(Set<Product> products) {
88   this.products = products;
89  }
90 
91 }
复制代码

Product.java

复制代码 
 1 package com.b510.examples;
 2 
 3 import javax.persistence.Column;
 4 import javax.persistence.Entity;
 5 import javax.persistence.FetchType;
 6 import javax.persistence.GeneratedValue;
 7 import javax.persistence.Id;
 8 import javax.persistence.JoinColumn;
 9 import javax.persistence.ManyToOne;
10 import javax.persistence.Table;
11 import org.hibernate.annotations.GenericGenerator;
12 
13 
14 @Entity
15 @Table(name = "product", catalog = "users")
16 public class Product implements java.io.Serializable {
17 
18  private static final long serialVersionUID = -1546206493725028472L;
19  private Integer id;
20  private Category category;
21  private String name;
22  private String price;
23  private String descripton;
24 
25  
26  public Product() {
27  }
28 
29  public Product(Category category, String name, String price,
30    String descripton) {
31   this.category = category;
32   this.name = name;
33   this.price = price;
34   this.descripton = descripton;
35  }
36  
37  @GenericGenerator(name = "generator", strategy = "increment")
38  @Id
39  @GeneratedValue(generator = "generator")
40  @Column(name = "id", unique = true, nullable = false)
41  public Integer getId() {
42   return this.id;
43  }
44 
45  public void setId(Integer id) {
46   this.id = id;
47  }
48 
49  //延迟加载：多对一方式
50  //关联信息：外键name = "category_id"
51  @ManyToOne(fetch = FetchType.LAZY)
52  @JoinColumn(name = "category_id")
53  public Category getCategory() {
54   return this.category;
55  }
56 
57  public void setCategory(Category category) {
58   this.category = category;
59  }
60 
61  @Column(name = "name", length = 500)
62  public String getName() {
63   return this.name;
64  }
65 
66  public void setName(String name) {
67   this.name = name;
68  }
69 
70  @Column(name = "price", length = 10)
71  public String getPrice() {
72   return this.price;
73  }
74 
75  public void setPrice(String price) {
76   this.price = price;
77  }
78 
79  @Column(name = "descripton", length = 500)
80  public String getDescripton() {
81   return this.descripton;
82  }
83 
84  public void setDescripton(String descripton) {
85   this.descripton = descripton;
86  }
87 
88 }
复制代码

测试代码：

HibernateTest.java

复制代码 
 1 /**
 2  * 
 3  */
 4 package com.b510.examples;
 5 
 6 import java.util.Set;
 7 
 8 import org.hibernate.Session;
 9 import org.hibernate.SessionFactory;
10 import org.hibernate.cfg.AnnotationConfiguration;
11 import org.hibernate.cfg.Configuration;
12 
13 /**
14  *
15  * @author XHW
16  *
17  * @date 2011-7-20
18  *
19  */
20 public class HibernateTest {
21 
22  public static void main(String[] args) {
23   HibernateTest test=new HibernateTest();
24   test.add();
25   test.find();
26  }
27  public void add(){
28  Configuration config=new AnnotationConfiguration();
29  config.configure();
30  SessionFactory sessionFactory=config.buildSessionFactory();
31  Session session=sessionFactory.getCurrentSession();
32  session.beginTransaction();
33  Category c=(Category)session.get(Category.class, 5);
34  
35  Product p=new Product();
36  p.setName("计算机科学与技术");
37  p.setPrice("123");
38  p.setDescripton("计算机科学与技术,好啊，真是红啊");
39  
40  p.setCategory(c);
41  c.getProducts().add(p);
42  
43  session.save(p);
44  session.getTransaction().commit();
45  }
46  
47  
48  public void find(){
49   Configuration config=new AnnotationConfiguration();
50   config.configure();
51   SessionFactory sessionFactory=config.buildSessionFactory();
52   Session session=sessionFactory.getCurrentSession();
53   session.beginTransaction();
54   Category c=(Category)session.get(Category.class, 5);
55    System.out.println("id: "+c.getId()+"  name:"+c.getName());
56    Set<Product> p=c.getProducts();
57    for(Product product:p){
58     System.out.println("id:"+product.getId()+"  name:"+product.getName()+"  description:"+product.getDescripton());
59    }
60    session.getTransaction().commit();
61  }
62 }
复制代码

运行效果：

复制代码 
 1 log4j:WARN No appenders could be found for logger (org.hibernate.cfg.annotations.Version).
 2 log4j:WARN Please initialize the log4j system properly.
 3 Hibernate: 
 4     select
 5         category0_.id as id1_0_,
 6         category0_.description as descript2_1_0_,
 7         category0_.name as name1_0_ 
 8     from
 9         users.category category0_ 
10     where
11         category0_.id=?
12 Hibernate: 
13     select
14         products0_.category_id as category5_1_,
15         products0_.id as id1_,
16         products0_.id as id0_0_,
17         products0_.category_id as category5_0_0_,
18         products0_.descripton as descripton0_0_,
19         products0_.name as name0_0_,
20         products0_.price as price0_0_ 
21     from
22         users.product products0_ 
23     where
24         products0_.category_id=?
25 Hibernate: 
26     select
27         max(id) 
28     from
29         product
30 Hibernate: 
31     insert 
32     into
33         users.product
34         (category_id, descripton, name, price, id) 
35     values
36         (?, ?, ?, ?, ?)
37 Hibernate: 
38     select
39         category0_.id as id5_0_,
40         category0_.description as descript2_5_0_,
41         category0_.name as name5_0_ 
42     from
43         users.category category0_ 
44     where
45         category0_.id=?
46 id: 5  name:xml33
47 Hibernate: 
48     select
49         products0_.category_id as category5_1_,
50         products0_.id as id1_,
51         products0_.id as id4_0_,
52         products0_.category_id as category5_4_0_,
53         products0_.descripton as descripton4_0_,
54         products0_.name as name4_0_,
55         products0_.price as price4_0_ 
56     from
57         users.product products0_ 
58     where
59         products0_.category_id=?





6、Hibernate中集中状态的关系转换


花了一些时间理解hibernate中的java对象的几种状态，很容易就懂了，这里记录一下，分享给大家！！

在Hibernate中，对象有三种状态：临时状态、持久状态和游离状态。

下面分别来说说这些状态：

临时状态：当new一个实体对象后，这个对象处于临时状态，即这个对象只是一个保存临时数据的内存区域，如果没有变量引用这个对象，则会被jre垃圾回收机制回收。这个对象所保存的数据域数据库没有任何关系，除非通过Session的save或者saveOrUpdate把临时对象于数据库关联，并把数据插入或者更新到数据库，这个对 象才转换为持久对象。
持久状态：持久化对象的实例在数据库中有对应的记录，并拥有一个持久化表示ID。对持久化对象进行 delete操作后，数据库中对应的记录被删除，那么持久化对象与数据库记录不再存在对应关系，持久化对象变成临时状态。持久化对象被修改变更后，不会马上同步到数据库，直到数据库事务提交。在同步之前，持久化对象是脏数据。
游离状态：当Session进行了close，clear或者evict后，持久化对象拥有持久化标示符与数据库对应记录一致的值，但是因为回话已经消失，对象不在持久化管理之内，所以处理游离状态(托管状态)游离状态的对象与临时状态对象是十分相似的，只是它还含有持久化标识。

找了一些资料，我想这个图可以清楚的说明这三种状态：



hibernate Annotation标签的使用:

[1]
1.带注释的持久性类也是普通 POJO,它们只是具备了持久性注释的普通 POJO 。
2.事实上，您既可以保持字段的持久性（注释写在成员变量之上），也可以保持属性（注释写在getter方法之上）的持久性。
3.常用的hibernate annotation标签如下:
@Entity              --注释声明该类为持久类。将一个Javabean类声明为一 个实体的数据库表映射类,最好实现序列化.此时,默认情况下,所有的类属性都为映射到数据表的持久性字段.若在类中,添加另外属性,而非映射来数据库的, 要用下面的Transient来注解.

@Table(name= "promotion_info")      --持久性映射的表(表名="promotion_info).@Table是类一级的注解,定义在@Entity下,为实体bean映射表,目录和schema的名字, 默认为实体bean的类名,不带包名.

@Id--注释可以表明哪种属性是该类中的独特标识符(即相当于数据表的主键)。 
@GeneratedValue   --定义自动增长的主键的生成策略. 
@Transient             --将忽略这些字段和属性,不用持久化到数据库.适用于,在当前的持久类中,某些属性不是用于映射到数据表,而是用于其它的业务逻辑需要,这时,须将这些属性进行transient的注解.否则系统会因映射不到数据表相应字段而出错. 
@Temporal(TemporalType.TIMESTAMP)--声明时间格式 
@Enumerated         --声明枚举 
@Version                --声明添加对乐观锁定的支持 
@OneToOne            --可以建立实体bean之间的一对一的关联 
@OneToMany          --可以建立实体bean之间的一对多的关联 
@ManyToOne          --可以建立实体bean之间的多对一的关联 
@ManyToMany        --可以建立实体bean之间的多对多的关联 
@Formula               --一个SQL表达式，这种属性是只读的,不在数据库生成属性(可以使用sum、average、max等) 
@OrderBy               --Many端某个字段排序(List)
 
1.2
Hibernate 能够出色地自动生成主键。Hibernate/EBJ 3 注释也可以为主键的自动生成提供丰富的支持，允许实现各种策略。
其生成规则由@GeneratedValue设定的.这里的@id和@GeneratedValue都是JPA的标准用法, JPA提供四种标准用法,由@GeneratedValue的源代码可以明显看出. 
JPA提供的四种标准用法为TABLE,SEQUENCE,IDENTITY,AUTO. 
TABLE：使用一个特定的数据库表格来保存主键。 
SEQUENCE：根据底层数据库的序列来生成主键，条件是数据库支持序列。 
IDENTITY：主键由数据库自动生成（主要是自动增长型） 
AUTO：主键由程序控制。
在指定主键时，如果不指定主键生成策略，默认为AUTO。 
@Id
相当于
@Id
@GeneratedValue(strategy = GenerationType.AUTO)
 
identity:
使用SQL Server 和 MySQL 的自增字段，这个方法不能放到 Oracle 中，Oracle 不支持自增字段，要设定sequence（MySQL 和 SQL Server 中很常用）。
Oracle就要采用sequence了.
 
同时,也可采用uuid,native等其它策略.(相关用法,上网查询)
[2]
第一个持久性类 
@Entity 
@Table(name= "T_MODEL_PLANE") 
public  class ModelPlane     implements Serializable { 
        @Id 
        @Column(name= "PLANE_ID")    
        @GeneratedValue(strategy=GenerationType.AUTO)  //注解于属性中 
/* 
对于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.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语句中的字段和表名都应该和数据库相应,而不是类中的字段,        
      //若带有参数如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_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) REFERENCES classes(id)
则:
@JoinColumn(name= "classid") 
2.
在双向关联中，有且仅有一端作为主体（owner）端存在：主体端负责维护联接列（即更新），对于不需要维护这种关系的从表则通过mappedNy属性进行声明。mappedBy的值指向另一主体的关联属性。例子中，mappedBy的值为classes。
附加说明:
mappedBy相当于过去的inverse="true".
inverse=false的side（side其实是指inverse＝false所位于的class元素）端有责任维护关系，而inverse＝true端无须维护这些关系。
3.
cascade与fetch使用说明:
Cascade
CascadeType.PERSIST （级联新建） 
CascadeType.REMOVE  （级联删除） 
CascadeType.REFRESH （级联刷新） 
CascadeType.MERGE   （级联更新）中选择一个或多个。 
CascadeType.ALL
 fetch属性：
关联关系获取方式,即是否采用延时加载。
 LAZY（默认值）采用延时加载，查询数据时，不一起查询关联对象的数据。而是当访问关联对象时(如：getStudnets()时)才触发相应的查询操作，获取关联对象数据。
EAGER：是在查询数据时，也直接一起获取关联对象的数据。
package oneToMany; 
import 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 String name; 
    
  @OneToMany(cascade=CascadeType.ALL,mappedBy= "classes")    
   private Set<Student> 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 sname; 
    
   //若有多个cascade，可以是：{CascadeType.PERSIST,CascadeType.MERGE} 
  @ManyToOne(cascade={CascadeType.ALL})         
  @JoinColumn(name= "classid")      //student类中对应外键的属性：classid 
   private Classes classes; 
//getter,setter省略 
} 


public  class TestOneToMany { 
/* 
CREATE TABLE    student (    --要定义外键!!!!!!! 
    `sid` double NOT NULL auto_increment, 
    `classid` double NULL, 
    `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().buildSessionFactory(); 
      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 Classes(); 
      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); 
      tx.commit();
/* 
输出如下:
Hibernate: insert into classes (name) values (?)
Hibernate: insert into student (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<Student> students=new HashSet<Student>(); 
//      students.add(st1); 
//      students.add(st2); 
//        
//      Classes classes=new Classes(); 
//      classes.setName("access"); 
//      classes.setStudents(students); 
//      session.save(classes); 
/*
输出如下:
Hibernate: insert into student (classid, sname) values (?, ?)
Hibernate: insert into student (classid, sname) values (?, ?)
Hibernate: insert into classes (name) values (?)
*/
    } 
     catch(HibernateException e) 
    { 
      e.printStackTrace();        
    } 
  } 
}
 
 
[4]
多对多注解: 
在多对多注解中,双方都采用@ManyToMany.
其中被控方,像一对多注解中设置一样,也要设置mappedBy.
其中主控方,不像一对多注解那样,采用@joinColumn,而是采用@joinTable.如下:
@JoinTable(name="j_student_course" ,joinColumns={@JoinColumn(name="sid")},inverseJoinColumns={@JoinColumn(name="cid")})
其中,
如上所说,mappedBy,相当于inverse="true".所以,在@joinTable中的inverseJoinColumns中定义的字段为mappedBy所在类的主键.
joinColumns定义的字段,就是当前类的主键.
@Entity 
@Table(name= "jcourse") 
public  class Jcourse { 
  @Id 
  @GeneratedValue(strategy=GenerationType.AUTO) 
   private  int cid; 
   private String cname; 
    
  @ManyToMany(cascade={CascadeType.PERSIST,CascadeType.MERGE},fetch=FetchType.LAZY ,mappedBy= "courses") 
   private Set<Jstudent> students; 
//setter,getter省略....    
} 


@Entity 
@Table(name= "jstudent") 
public  class Jstudent { 
  @Id 
  @GeneratedValue(strategy=GenerationType.AUTO) 
   private  int sid; 
    
   private String sname; 
    
  @ManyToMany(cascade={CascadeType.PERSIST,CascadeType.MERGE},fetch=FetchType.EAGER) 
   //inverseJoinColumns中对应的id为以下属性course的对应id. 
  @JoinTable(name= "j_student_course" ,joinColumns={@JoinColumn(name= "sid")},inverseJoinColumns={@JoinColumn(name= "cid")}) 
   private Set<Jcourse> courses; 
//setter,getter省略....    
} 


public  class Test { 
   public  static  void main(String[] args) { 
     try 
    { 
      SessionFactory sf =  new AnnotationConfiguration().configure().buildSessionFactory(); 
      Session session=sf.openSession(); 
      Transaction tx=session.beginTransaction(); 
        
      Jcourse course= new Jcourse(); 
      course.setCname( "jason-english"); 
      session.save(course);  //先各自保存. 
        
      Jcourse course2= new Jcourse(); 
      course2.setCname( "herry-english"); 
      session.save(course2); 
        
      Set<Jcourse> courses= new HashSet<Jcourse>(); 
      courses.add(course); 
      courses.add(course2); 
        
      Jstudent student= new Jstudent(); 
      student.setSname( "jason"); 
      student.setCourses(courses); 
        
      session.save(student); // 要用非mapby定义的类(studet)来作为主者(会控制级联关系),一对多,多对一也一样道理. 
       //可以尝试反过来. 
      tx.commit(); 
    } 
     catch(HibernateException e) 
    { 
      e.printStackTrace();        
    } 
  } 
}

小飞鹤
关注
  • 0
    点赞
  • 踩
  • 2
    收藏
    觉得还不错? 一键收藏
  • 2
    评论
专栏目录
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值