Java代码  
  1. 声明实体Bean  

  2. @Entity

  3. publicclass Flight implements Serializable {  

  4.  Long id;  

  5. @Id

  6. public Long getId() { return id; }  

  7. publicvoid setId(Long id) { this.id = id; }  

  8. }  

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

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

  11. 定义表  

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

  13. @Entity

  14. @Table(name="tbl_sky")  

  15. publicclass Sky implements Serializable {  

  16. ...  

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

  18. @Table(name="tbl_sky",  

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

  20. )  

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

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

  23. @Entity

  24. publicclass Flight implements Serializable {  

  25.   ...  

  26. @Version

  27. @Column(name="OPTLOCK")  

  28. public Integer getVersion() { ... }  

  29. }  

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

  31. 实体Bean中所有非statictransient 属性都可以被持久化,除非用@Transient注解。  

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

  33. publictransientint counter; //transient property

  34. private String firstname; //persistent property

  35. @Transient

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

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

  38. @Basic

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

  40. @Basic(fetch = FetchType.LAZY)  

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

  42. @Temporal(TemporalType.TIME)  

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

  44. @Enumerated(EnumType.STRING)  

  45. Starred getNote() { ... } //enum persisted as String in database

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

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

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

  49. @Lob

  50. public String getFullText() {  

  51. return fullText;  // clob type

  52. }  

  53. @Lob

  54. publicbyte[] getFullCode() {  

  55. return fullCode;  // blog type

  56. }  

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

  58. @Entity

  59. publicclass Flight implements Serializable {  

  60.   ...  

  61. @Column(updatable = false, name = "flight_name", nullable = false, length=50)  

  62. public String getName() { ... }  

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

  64. @Column(  

  65.   name="columnName"; (1) 列名  

  66. boolean unique() defaultfalse; (2)    是否在该列上设置唯一约束  

  67. boolean nullable() defaulttrue; (3)   列可空?  

  68. boolean insertable() defaulttrue; (4) 该列是否作为生成 insert语句的一个列  

  69. boolean updatable() defaulttrue; (5)  该列是否作为生成 update语句的一个列  

  70.   String columnDefinition() default""; (6)  默认值  

  71.   String table() default""; (7)             定义对应的表(deault 是主表)  

  72. int length() default255; (8)              列长度  

  73. int precision() default0; // decimal precision (9)  decimal精度

  74. int scale() default0; // decimal scale        (10)  decimal长度

  75. 嵌入式对象(又称组件)也就是别的对象定义的属性  

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

  77. @Entity

  78. publicclass Person implements Serializable {  

  79. // Persistent component using defaults

  80.   Address homeAddress;  

  81. @Embedded

  82. @AttributeOverrides( {  

  83. @AttributeOverride(name="iso2", column = @Column(name="bornIso2") ),  

  84. @AttributeOverride(name="name", column = @Column(name="bornCountryName") )  

  85.   } )  

  86.   Country bornIn;  

  87.   ...  

  88. }  

  89. @Embeddable

  90. publicclass Address implements Serializable {  

  91.   String city;  

  92.   Country nationality; //no overriding here

  93. }  

  94. @Embeddable

  95. publicclass Country implements Serializable {  

  96. private String iso2;  

  97. @Column(name="countryName") private String name;  

  98. public String getIso2() { return iso2; }  

  99. publicvoid setIso2(String iso2) { this.iso2 = iso2; }  

  100. public String getName() { return name; }  

  101. publicvoid setName(String name) { this.name = name; }  

  102.   ...  

  103. }  

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

  105. 无注解属性默认值:  

  106. 属性为简单类型,则映射为 @Basic

  107. 属性对应的类型定义了 @Embeddable 注解,则映射为 @Embedded

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

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

  110. 映射主键属性  

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

  112. AUTO -  可以是 identity column, sequence 或者 table 类型,取决于不同底层的数据库  

  113. TABLE - 使用table保存id值  

  114. IDENTITY - identity column  

  115. SEQUENCE - seque  

  116. nce  

  117. @Id@GeneratedValue(strategy=GenerationType.SEQUENCE, generator="SEQ_STORE")  

  118. public Integer getId() { ... }  

  119. @Id@GeneratedValue(strategy=GenerationType.IDENTITY)  

  120. public Long getId() { ... }  

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

  122. <table-generator name="EMP_GEN"

  123.     table="GENERATOR_TABLE"

  124.     pk-column-name="key"

  125.     value-column-name="hi"

  126.     pk-column-value="EMP"

  127.     allocation-size="20"/>  

  128. //and the annotation equivalent

  129. @javax.persistence.TableGenerator(  

  130.     name="EMP_GEN",  

  131.     table="GENERATOR_TABLE",  

  132.     pkColumnName = "key",  

  133.     valueColumnName = "hi"

  134.     pkColumnValue="EMP",  

  135.     allocationSize=20

  136. )  

  137. <sequence-generator name="SEQ_GEN"

  138.     sequence-name="my_sequence"

  139.     allocation-size="20"/>  

  140. //and the annotation equivalent

  141. @javax.persistence.SequenceGenerator(  

  142.     name="SEQ_GEN",  

  143.     sequenceName="my_sequence",  

  144.     allocationSize=20

  145. )  

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

  147. @Entity

  148. @javax.persistence.SequenceGenerator(  

  149.    name="SEQ_STORE",  

  150.    sequenceName="my_sequence"

  151. )  

  152. publicclass Store implements Serializable {  

  153. private Long id;  

  154. @Id@GeneratedValue(strategy=GenerationType.SEQUENCE, generator="SEQ_STORE")  

  155. public Long getId() { return id; }  

  156. }  

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

  158. 通过下面语法,你可以定义组合键。  

  159. 将组件类注解为 @Embeddable, 并将组件的属性注解为 @Id

  160. 将组件的属性注解为 @EmbeddedId

  161. 将类注解为 @IdClass,并将该实体中所有主键的属性都注解为 @Id

  162. @Entity

  163. @IdClass(FootballerPk.class)  

  164. publicclass Footballer {  

  165. //part of the id key

  166. @Idpublic String getFirstname() {  

  167. return firstname;  

  168.  }  

  169. publicvoid setFirstname(String firstname) {  

  170. this.firstname = firstname;  

  171.  }  

  172. //part of the id key

  173. @Idpublic String getLastname() {  

  174. return lastname;  

  175.  }  

  176. publicvoid setLastname(String lastname) {  

  177. this.lastname = lastname;  

  178.  }  

  179. public String getClub() {  

  180. return club;  

  181.  }  

  182. publicvoid setClub(String club) {  

  183. this.club = club;  

  184.  }  

  185. //appropriate equals() and hashCode() implementation

  186. }  

  187. @Embeddable

  188. publicclass FootballerPk implements Serializable {  

  189. //same name and type as in Footballer

  190. public String getFirstname() {  

  191. return firstname;  

  192.  }  

  193. publicvoid setFirstname(String firstname) {  

  194. this.firstname = firstname;  

  195.  }  

  196. //same name and type as in Footballer

  197. public String getLastname() {  

  198. return lastname;  

  199.  }  

  200. publicvoid setLastname(String lastname) {  

  201. this.lastname = lastname;  

  202.  }  

  203. //appropriate equals() and hashCode() implementation

  204. }  

  205. @Entity

  206. @AssociationOverride( name="id.channel", joinColumns = @JoinColumn(name="chan_id") )  

  207. publicclass TvMagazin {  

  208. @EmbeddedIdpublic TvMagazinPk id;  

  209. @Temporal(TemporalType.TIME) Date time;  

  210. }  

  211. @Embeddable

  212. publicclass TvMagazinPk implements Serializable {  

  213. @ManyToOne

  214. public Channel channel;  

  215. public String name;  

  216. @ManyToOne

  217. public Presenter presenter;  

  218. }  

  219. 映射继承关系  

  220. EJB支持3种类型的继承。  

  221. Table per Class Strategy: the <union-class> element in Hibernate 每个类一张表  

  222. Single Table per Class Hierarchy Strategy: the <subclass> element in Hibernate 每个类层次结构一张表  

  223. Joined Subclass Strategy: the <joined-subclass> element in Hibernate 连接的子类策略  

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

  225. 每个类一张表  

  226. @Entity

  227. @Inheritance(strategy = InheritanceType.TABLE_PER_CLASS)  

  228. publicclass Flight implements Serializable {  

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

  230. 每个类层次结构一张表  

  231. @Entity

  232. @Inheritance(strategy=InheritanceType.SINGLE_TABLE)  

  233. @DiscriminatorColumn(  

  234.    name="planetype",  

  235.    discriminatorType=DiscriminatorType.STRING  

  236. )  

  237. @DiscriminatorValue("Plane")  

  238. publicclass Plane { ... }  

  239. @Entity

  240. @DiscriminatorValue("A320")  

  241. publicclass A320 extends Plane { ... }  

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

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

  244. 连接的子类  

  245. @Entity

  246. @Inheritance(strategy=InheritanceType.JOINED)  

  247. publicclass Boat implements Serializable { ... }  

  248. @Entity

  249. publicclass Ferry extends Boat { ... }  

  250. @Entity

  251. @PrimaryKeyJoinColumn(name="BOAT_ID")  

  252. publicclass AmericaCupClass extends Boat { ... }  

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

  254. 从父类继承的属性  

  255. @MappedSuperclass

  256. publicclass BaseEntity {  

  257. @Basic

  258. @Temporal(TemporalType.TIMESTAMP)  

  259. public Date getLastUpdate() { ... }  

  260. public String getLastUpdater() { ... }  

  261.  ...  

  262. }  

  263. @Entityclass Order extends BaseEntity {  

  264. @Idpublic Integer getId() { ... }  

  265.  ...  

  266. }  

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

  268. 映射实体Bean的关联关系  

  269. 一对一  

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

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

  272. @Entity

  273. publicclass Body {  

  274. @Id

  275. public Long getId() { return id; }  

  276. @OneToOne(cascade = CascadeType.ALL)  

  277. @PrimaryKeyJoinColumn

  278. public Heart getHeart() {  

  279. return heart;  

  280.  }  

  281.  ...  

  282. }  

  283. @Entity

  284. publicclass Heart {  

  285. @Id

  286. public Long getId() { ...}  

  287. }  

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

  289. 多对一  

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

  291. @Entity()  

  292. publicclass Flight implements Serializable {  

  293. @ManyToOne( cascade = {CascadeType.PERSIST, CascadeType.MERGE} )  

  294. @JoinColumn(name="COMP_ID")  

  295. public Company getCompany() {  

  296. return company;  

  297.  }  

  298.  ...  

  299. }  

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

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

  302. @Entity()  

  303. publicclass Flight implements Serializable {  

  304. @ManyToOne(cascade=   {CascadeType.PERSIST,CascadeType.MERGE},targetEntity= CompanyImpl.class)  

  305. @JoinColumn(name="COMP_ID")  

  306. public Company getCompany() {  

  307. return company;  

  308.   }  

  309.   ...  

  310. }  

  311. publicinterface Company {  

  312.   ...  

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

  314. @Entity()  

  315. publicclass Flight implements Serializable {  

  316. @ManyToOne( cascade = {CascadeType.PERSIST, CascadeType.MERGE} )  

  317. @JoinTable(name="Flight_Company",  

  318.       joinColumns = @JoinColumn(name="FLIGHT_ID"),  

  319.       inverseJoinColumns = @JoinColumn(name="COMP_ID")  

  320.   )  

  321. public Company getCompany() {  

  322. return company;  

  323.   }  

  324.   ...  

  325. }  

  326. 集合类型  

  327. 一对多  

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

  329. 双向  

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

  331. @Entity

  332. publicclass Troop {  

  333. @OneToMany(mappedBy="troop")  

  334. public Set<Soldier> getSoldiers() {  

  335.  ...  

  336. }  

  337. @Entity

  338. publicclass Soldier {  

  339. @ManyToOne

  340. @JoinColumn(name="troop_fk")  

  341. public Troop getTroop() {  

  342.  ...  

  343.  }  

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

  345. 单向  

  346. @Entity

  347. publicclass Customer implements Serializable {  

  348. @OneToMany(cascade=CascadeType.ALL, fetch=FetchType.EAGER)  

  349. @JoinColumn(name="CUST_ID")  

  350. public Set<Ticket> getTickets() {  

  351.      ...  

  352.   }  

  353. @Entity

  354. publicclass Ticket implements Serializable {  

  355.   ... //no bidir

  356. }  

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

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

  359. @Entity

  360. publicclass Trainer {  

  361. @OneToMany

  362. @JoinTable(  

  363.     name="TrainedMonkeys",  

  364.     joinColumns = @JoinColumn( name="trainer_id"),  

  365.     inverseJoinColumns = @JoinColumn( name="monkey_id")  

  366.  )  

  367. public Set<Monkey> getTrainedMonkeys() {  

  368.     ...  

  369.  }  

  370. @Entity

  371. publicclass Monkey {  

  372.  ... //no bidir

  373. }  

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

  375. 默认处理机制  

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

  377. @Entity

  378. publicclass Trainer {  

  379. @OneToMany

  380. public Set<Tiger> getTrainedTigers() {  

  381.  ...  

  382. }  

  383. @Entity

  384. publicclass Tiger {  

  385.  ... //no bidir

  386. }  

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

  388. 多对多  

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

  390. @Entity

  391. publicclass Employer implements Serializable {  

  392. @ManyToMany(  

  393.    targetEntity=org.hibernate.test.metadata.manytomany.Employee.class,  

  394.    cascade={CascadeType.PERSIST, CascadeType.MERGE}  

  395.  )  

  396. @JoinTable(  

  397.    name="EMPLOYER_EMPLOYEE",  

  398.    joinColumns=@JoinColumn(name="EMPER_ID"),  

  399.    inverseJoinColumns=@JoinColumn(name="EMPEE_ID")  

  400.  )  

  401. public Collection getEmployees() {  

  402. return employees;  

  403.  }  

  404.  ...  

  405. }  

  406. @Entity

  407. publicclass Employee implements Serializable {  

  408. @ManyToMany(  

  409.    cascade = {CascadeType.PERSIST, CascadeType.MERGE},  

  410.    mappedBy = "employees",  

  411.    targetEntity = Employer.class

  412.  )  

  413. public Collection getEmployers() {  

  414. return employers;  

  415.  }  

  416. }  

  417. 默认值:  

  418. 关联表名:主表表名 + 下划线 + 从表表名;关联表到主表的外键:主表表名 + 下划线 + 主表中主键列名;关联表到从表的外键名:主表中用于关联的属性名 + 下划线 + 从表的主键列名。  

  419. 用 cascading 实现传播持久化(Transitive persistence)  

  420. cascade 属性接受值为 CascadeType 数组,其类型如下:  

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

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

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

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

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

  426. 映射二级列表  

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

  428. @Entity

  429. @Table(name="MainCat")  

  430. @SecondaryTables({  

  431. @SecondaryTable(name="Cat1", pkJoinColumns={  

  432. @PrimaryKeyJoinColumn(name="cat_id", referencedColumnName="id")}),  

  433. @SecondaryTable(name="Cat2", uniqueConstraints={  

  434. @UniqueConstraint(columnNames={"storyPart2"})})  

  435. })  

  436. publicclass Cat implements Serializable {  

  437. private Integer id;  

  438. private String name;  

  439. private String storyPart1;  

  440. private String storyPart2;  

  441. @Id@GeneratedValue

  442. public Integer getId() {  

  443. return id;  

  444.  }  

  445. public String getName() {  

  446. return name;  

  447.  }  

  448. @Column(table="Cat1")  

  449. public String getStoryPart1() {  

  450. return storyPart1;  

  451.  }  

  452. @Column(table="Cat2")  

  453. public String getStoryPart2() {  

  454. return storyPart2;  

  455.  }  

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

  457. 映射查询  

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

  459. <entity-mappings>  

  460. <named-query name="plane.getAll">  

  461.  <query>select p from Plane p</query>  

  462. </named-query>  

  463. ...  

  464. </entity-mappings>  

  465. ...  

  466. @Entity

  467. @NamedQuery(name="night.moreRecentThan", query="select n from Night n where n.date >= :date")  

  468. publicclass Night {  

  469. ...  

  470. }  

  471. publicclass MyDao {  

  472. doStuff() {  

  473.   Query q = s.getNamedQuery("night.moreRecentThan");  

  474.   q.setDate( "date", aMonthAgo );  

  475.   List results = q.list();  

  476.   ...  

  477. }  

  478. ...  

  479. }  

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

  481. 映射本地化查询  

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

  483. @NamedNativeQuery(name="night&area", query="select night.id nid, night.night_duration, "

  484.     + " night.night_date, area.id aid, night.area_id, area.name "

  485.     + "from Night night, Area area where night.area_id = area.id", resultSetMapping="joinMapping")  

  486. @SqlResultSetMapping( name="joinMapping", entities={  

  487. @EntityResult(entityClass=org.hibernate.test.annotations.query.Night.class, fields = {

  488. @FieldResult(name="id", column="nid"),  

  489. @FieldResult(name="duration", column="night_duration"),  

  490. @FieldResult(name="date", column="night_date"),  

  491. @FieldResult(name="area", column="area_id"),  

  492.   discriminatorColumn="disc"

  493.  }),  

  494. @EntityResult(entityClass=org.hibernate.test.annotations.query.Area.class, fields = {  

  495. @FieldResult(name="id", column="aid"),  

  496. @FieldResult(name="name", column="name")  

  497.  })  

  498. }  

  499. )  

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

  501. @Entity

  502. @SqlResultSetMapping(name="implicit",  

  503.  entities=@EntityResult(  

  504.    entityClass=org.hibernate.test.annotations.@NamedNativeQuery(  

  505.      name="implicitSample", query="select * from SpaceShip",  

  506.      resultSetMapping="implicit")  

  507. publicclass SpaceShip {  

  508. private String name;  

  509. private String model;  

  510. privatedouble speed;  

  511. @Id

  512. public String getName() {  

  513. return name;  

  514. }  

  515. publicvoid setName(String name) {  

  516. this.name = name;  

  517. }  

  518. @Column(name="model_txt")  

  519. public String getModel() {  

  520. return model;  

  521. }  

  522. publicvoid setModel(String model) {  

  523. this.model = model;  

  524. }  

  525. publicdouble getSpeed() {  

  526. return speed;  

  527. }  

  528. publicvoid setSpeed(double speed) {  

  529. this.speed = speed;  

  530. }  

  531. }  

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

  533. @Entity

  534. @SqlResultSetMapping(name="compositekey",  

  535. entities=@EntityResult(entityClass=org.hibernate.test.annotations.query.SpaceShip.class,

  536.  fields = {  

  537. @FieldResult(name="name", column = "name"),  

  538. @FieldResult(name="model", column = "model"),  

  539. @FieldResult(name="speed", column = "speed"),  

  540. @FieldResult(name="captain.firstname", column = "firstn"),  

  541. @FieldResult(name="captain.lastname", column = "lastn"),  

  542. @FieldResult(name="dimensions.length", column = "length"),  

  543. @FieldResult(name="dimensions.width", column = "width")  

  544.  }),  

  545. columns = { @ColumnResult(name = "surface"),  

  546. @ColumnResult(name = "volume") } )  

  547. @NamedNativeQuery(name="compositekey",  

  548. query="select name, model, speed, lname as lastn, fname as firstn, length, width, length * width as resultSetMapping="compositekey")  

  549. })  

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

  551. @NamedNativeQuery(name="implicitSample", query="select * from SpaceShip",  

  552.                                            resultClass=SpaceShip.class)  

  553. publicclass SpaceShip {  

  554. Hibernate 独有的注解扩展  

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

  556. 实体  

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

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

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

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

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

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

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

  564. 标识符  

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

  566. @Id@GeneratedValue(generator="system-uuid")  

  567. @GenericGenerator(name="system-uuid", strategy = "uuid")  

  568. public String getId() {  

  569. @Id@GeneratedValue(generator="hibseq")  

  570. @GenericGenerator(name="hibseq", strategy = "seqhilo",  

  571.   parameters = {  

  572. @Parameter(name="max_lo", value = "5"),  

  573. @Parameter(name="sequence", value="heybabyhey")  

  574.   }  

  575. )  

  576. public Integer getId() {  

  577. 新例子  

  578. @GenericGenerators(  

  579. {  

  580. @GenericGenerator(  

  581.   name="hibseq",  

  582.   strategy = "seqhilo",  

  583.   parameters = {  

  584. @Parameter(name="max_lo", value = "5"),  

  585. @Parameter(name="sequence", value="heybabyhey")  

  586.   }  

  587.  ),  

  588. @GenericGenerator(...)  

  589. }  

  590. )  

  591. 自然ID  

  592. @NaturalId 注解标识  

  593. 公式  

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

  595. @Formula("obj_length * obj_height * obj_width")  

  596. publiclong getObjectVolume()  

  597. 索引  

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

  599. @Column(secondaryTable="Cat1")  

  600. @Index(name="story1index")  

  601. public String getStoryPart1() {  

  602. return storyPart1;  

  603. }  

  604. 辨别符  

  605. @Entity

  606. @DiscriminatorFormula("case when forest_type is null then 0 else forest_type end")  

  607. publicclass Forest { ... }  

  608. 过滤 查询 ...  

  609. 其中一个实体通过外键关联到另一个实体的主键。注:一对一,则外键必须为唯一约束。  

  610. @Entity

  611. publicclass Customer implements Serializable {  

  612. @OneToOne(cascade = CascadeType.ALL)  

  613. @JoinColumn(name="passport_fk")  

  614. public Passport getPassport() {  

  615.   ...  

  616. }  

  617. @Entity

  618. publicclass Passport implements Serializable {  

  619. @OneToOne(mappedBy = "passport")  

  620. public Customer getOwner() {  

  621.   ...  

  622. }  

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

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

  625. @Entity

  626. publicclass Customer implements Serializable {  

  627. @OneToOne(cascade = CascadeType.ALL)  

  628. @JoinTable(name = "CustomerPassports",  

  629.        joinColumns = @JoinColumn(name="customer_fk"),  

  630.        inverseJoinColumns = @JoinColumn(name="passport_fk")  

  631.   )  

  632. public Passport getPassport() {  

  633.   ...  

  634. }  

  635. @Entitypublicclass Passport implements Serializable {  

  636. @OneToOne(mappedBy = "passport")  

  637. public Customer getOwner() {  

  638.   ...  

  639. }  

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