Hibernate注解

声明实体Bean   

1@Entity 

2public class Flight implements Serializable { 

3  Long id; 

4  @Id 

5  public Long getId() { return id; } 

6  public void setId(Long id) { this.id = id; } 

7}

@Entity 注解将一个类声明为实体 Bean, @Id 注解声明了该实体Bean的标识属性。   
   
Hibernate 可以对类的属性或者方法进行注解。属性对应field类别，方法的 getXxx()对应property类别。   

  

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

1@Entity 

2@Table(name="tbl_sky") 

3public class Sky implements Serializable { 

4   

5｝  

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

1@Table(name="tbl_sky", 

2  uniqueConstraints = {@UniqueConstraint(columnNames={"month", "day"})} 

3)

上述代码在  "month" 和 "day" 两个 field 上加上 unique constrainst.   
   
@Version 注解用于支持乐观锁版本控制。    

1@Entity 

2public class Flight implements Serializable { 

3   ... 

4   @Version 

5   @Column(name="OPTLOCK") 

6   public Integer getVersion() { ... } 

7}   

version属性映射到 "OPTLOCK" 列，entity manager 使用这个字段来检测冲突。 一般可以用 数字 或者 timestamp 类型来支持 version.   
   
实体Bean中所有非static 非 transient 属性都可以被持久化，除非用@Transient注解。   
   
默认情况下，所有属性都用 @Basic 注解。   

01public transient int counter; //transient property 

02   

03private String firstname; //persistent property 

04@Transient 

05String getLengthInMeter() { ... } //transient property 

06String getName() {... } // persistent property 

07@Basic 

08int getLength() { ... } // persistent property 

09@Basic(fetch = FetchType.LAZY) 

10String getDetailedComment() { ... } // persistent property 

11@Temporal(TemporalType.TIME) 

12java.util.Date getDepartureTime() { ... } // persistent property 

13@Enumerated(EnumType.STRING) 

14Starred 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 属性值

 

 

 

 

 

CascadeType属性：

   cascade表示级联操作 
  
   CascadeType.MERGE级联更新：若items属性修改了那么order对象保存时同时修改items里的对象。对应EntityManager的merge方法 

  
   CascadeType.PERSIST级联刷新：获取order对象里也同时也重新获取最新的items时的对象。对应EntityManager的refresh(object)方法有效。即会重新查询数据库里的最新数据   
   

  CascadeType.REFRESH级联保存：对order对象保存时也对items里的对象也会保存。对应EntityManager的presist方法   
   

  CascadeType.REMOVE级联删除：对order对象删除也对items里的对象也会删除。对应EntityManager的remove方法   

CascadeType.PERSIST只有A类新增时，会级联B对象新增。若B对象在数据库存（跟新）在则抛异常（让B变为持久态）

CascadeType.MERGE指A类新增或者变化，会级联B对象（新增或者变化）

CascadeType.REMOVE只有A类删除时，会级联删除B类；

CascadeType.ALL包含所有；

CascadeType.REFRESH没用过。

综上：大多数情况用CascadeType.MERGE就能达到级联跟新又不报错，用CascadeType.ALL时要斟酌下CascadeType.REMOVE

@Fetch:

定义了加载关联关系的获取策略. FetchMode 可以是

SELECT (在需要加载关联的时候触发select操作), SUBSELECT(只对集合有效,使用了子查询策略,详情参考Hibernate参考文档)

JOIN (在加载主实体(owner entity)的时候使用SQL JOIN来加载关联关系).

JOIN 将覆写任何延迟属性 (通过 JOIN策略加载的关联将不再具有延迟性).