JPA-2 基本注解

　　JPA的基本注解主要包括@Entity、@Table、@Id、@GeneratedValue、@Basic、@Column、@Transient、@Temporal和@TableGenerator等。
　　其中，JPA基本注解的具体实现代码下载地址：http://download.csdn.net/download/bingbeichen/9805737。

---

1. @Entity

　　标注位置：实体类声明语句之前；
　　主要作用：标注该Java类为实体类，且将其映射到指定的数据库表。

// 例：默认将实体类Customer映射到数据库的CUSTOMER表上@Entitypublic class Customer { //... }

---

2. @Table

　　标注位置：实体类声明语句之前，与@Entity注释并列使用；
　　主要作用：标注当前实体类映射到数据库中的数据表名，当实体类与数据表名不同时使用。

// 例：将实体类Customer映射到数据库的CUSTOMERS表上@Table(name="CUSTOMERS")@Entitypublic class Customer { //... }

---

3. @Id

　　标注位置：实体类的属性声明语句之前，或属性的getter()方法之前；
　　主要作用：指定该实体类的当前属性映射到数据表的主键列。

// 例：将该实体类id属性映射到数据表的主键列@Idpublic Integer getId() {    return id;}

---

4. @GeneratedValue

　　标注位置：与@Id注释配合使用；
　　主要作用：通过其strategy属性指定数据表主键的生成策略。默认情况下，JPA自动选择最适合底层数据库的主键生成策略，即SqlServer对应identity，而MySQL对应auto increment。
　　其中，在javax.persistence.GenerationType中定义了如下几种可供选择的主键生成策略：

主键生成策略 具体描述 IDENTITY 采用数据库ID自增长的方式来生成主键，但Oracle数据库不支持该方式 AUTO 默认选项，JPA自动选择合适的主键生成策略 SEQUENCE 采用序列生成主键，通过@SequenceGenerator注解指定序列名，但MySQL数据库不支持该方式 TABLE 采用外部表生成主键，框架借由表模拟序列产生主键，该策略可使应用程序更易于数据库移植

// 例：采用外部表的方式来生成主键@TableGenerator(name="ID_GENERATOR",        table="jpa_id_generators",        pkColumnName="PK_NAME",        pkColumnValue="ORDER_ID",        valueColumnName="PK_VALUE",        allocationSize=1)@GeneratedValue(strategy=GenerationType.TABLE, generator="ID_GENERATOR")//  @GeneratedValue(strategy=GenerationType.AUTO)@Idpublic Integer getId() {    return id;}

---

5. @Basic

　　标注位置：实体类的属性声明语句之前，或属性的getter()方法之前；
　　主要作用：标注将实体类的当前属性映射到数据库表的字段，对于没有任何标注的getter()方法，默认即为@Basic，其具有如下属性：

属性 说明 fetch 表示该属性的读取策略，取值为EAGER（主支抓取，默认值）和LAZY（延迟加载） optional 表示该属性是否允许为null，默认为true

// 例：将该实体类email属性映射到数据库表的email字段public String getEmail() {    return email;}

---

6. @Column

　　标注位置：实体类的属性声明语句之前，或属性的getter()方法之前；
　　主要作用：标注实体类的当前属性映射到数据库表的字段名，当属性名与数据表字段名不一致时使用。
　　标注将实体类的当前属性映射到数据库表的字段，对于没有任何标注的getter()方法，默认即为@Basic，其具有如下属性：

属性 说明 name 设置映射到数据库表的字段名 unique 设置映射到数据库表的字段具有唯一约束 nullable 设置映射到数据库表的字段是否为空 length 设置映射到数据库表的字段长度 columnDefinition 设置映射到数据库表的字段的实际类型，如将String类型属性映射为BLOB或TEXT类型字段

// 例：将该实体类name属性映射到数据库表的LAST_NAME字段@Column(name="LAST_NAME")public String getName() {    return name;}

---

7. @Transient

　　标注位置：实体类的属性声明语句之前，或属性的getter()方法之前；
　　主要作用：标注实体类的当前属性不进行数据表字段的映射，ORM框架将忽略此映射，如实体类的getInfo()方法通常不需要映射到数据表的字段上。

---

8. @Temporal

　　标注位置：实体类的属性声明语句之前，或属性的getter()方法之前；
　　主要作用：标注实体类中Date类型（Java核心API中未定义Date类型的精度）的属性映射到数据表字段的具体精度（数据库中Date类型的数据有DATE、TIME和TIMESTAMP三种精度）。

// 例：将该实体类Date类型的createTime属性映射到数据库表TIMESTAMP精度的CREATE_TIME字段@Temporal(TemporalType.TIMESTAMP)@Column(name="CREATE_TIME")public Date getCreateTime() {    return createTime;}// 例：将该实体类Date类型的birth属性映射到数据库表DATE精度的BIRTH字段@Temporal(TemporalType.DATE)public Date getBirth() {    return birth;}

---

9. @TableGenerator：使用外部表生成主键

　　标注位置：实体类的属性声明语句之前，或属性的getter()方法之前；
　　主要作用：将当前主键的值单独保存到外部数据表中，每次从该外部表中查询获取其当前数据表的主键值；
　　对比优势：该主键生成策略可以适用于任何数据库，故更加易于数据库的移植。
　　@TableGenerator主要具有如下属性：

属性 说明 name 表示该主键生成策略的名称，其被引用在@GeneratedValue中设置的generator值中 table 表示表生成策略所持久化的表名 pkColumnName 表示在持久化表中，该主键生成策略所对应键值的名称 valueColumnName 表示在持久化表中，该主键当前所生成的值，其会随着每次创建而累加 pkColumnValue 表示在持久化表中，该生成策略所对应的主键 allocationSize 表示每次主键值增加的大小，默认值为50

// 例：采用外部表的方式来生成主键@TableGenerator(name="ID_GENERATOR",        table="jpa_id_generators",        pkColumnName="PK_NAME",        pkColumnValue="CUSTOMER_ID",        valueColumnName="PK_VALUE",        allocationSize=1)@GeneratedValue(strategy=GenerationType.TABLE, generator="ID_GENERATOR")//  @GeneratedValue(strategy=GenerationType.AUTO)@Idpublic Integer getId() {    return id;}