Hibernate注解详细介绍
阅读原文时间:2023年07月16日阅读:1

引自http://blog.csdn.net/lin_yongrui/article/details/6855394

声明实体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_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-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 element in Hibernate 每个类一张表
 

• Single Table per Class Hierarchy Strategy: the element in
Hibernate 每个类层次结构一张表  

• Joined Subclass Strategy: the 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 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 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 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 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文件中的注解。  

  select p from Plane p
 

 …  

…  

@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 属性值。

版权声明:本文为博主原创文章,未经博主允许不得转载。