JPA(二) JPA 注解

JPA(二) JPA 注解

标签： JPA注解

---

[TOC]

JPA经常使用的注解有 @Entity、@Table、@Id、@GeneratedValue、@Column、@Basic、@Transient、@Temporal等等。下面这几个简单介绍下这几个注解。

@Entity

@Entity 标注用于实体类声明语句以前，指出该Java 类为实体类，将映射到指定的数据库表。如声明一个实体类 Customer，它将映射到数据库中的 customer 表上。例如:

@Entity
public class Customer {

@Table

当实体类与其映射的数据库表名不一样名时须要使用 @Table 标注说明，该标注与 @Entity 标注并
列使用，置于实体类声明语句以前，可写于单独语句行，也可与声明语句同行。@Table 标注的经常使用选项是 name，用于指明数据库的表名@Table标注还有一个两个选项 catalog 和 schema 用于设置表所属的数据库目录或模式，一般为数据库名。uniqueConstraints 选项用于设置约束条件，一般不须设置

@Table(name="JPA_CUSTOMER")
@Entity
public class Customer {

@Id

@Id 标注用于声明一个实体类的属性映射为数据库的主键列。该属性一般置于属性声明语句以前，可与声明语句同行，也可写在单独行上。@Id标注也可置于属性的getter方法以前。

@Id
  public Integer getId() {
    return Id;
  }
  public void setId(Integer id) {
    Id = id;
  }

@GeneratedValue

@GeneratedValue 用于标注主键的生成策略，经过 strategy 属性指定。默认状况下，JPA 自动选择一个最适合底层数据库的主键生成策略：SqlServer 对应 identity，MySQL 对应 auto increment。
在 javax.persistence.GenerationType 中定义了如下几种可供选择的策略：

• IDENTITY：采用数据库 ID自增加的方式来自增主键字段，Oracle 不支持这种方式；
• AUTO： JPA自动选择合适的策略，是默认选项；
• SEQUENCE：经过序列产生主键，经过 @SequenceGenerator 注解指定序列名，MySql 不支持这种方式
• TABLE：经过表产生主键，框架借由表模拟序列产生主键，使用该策略可使应用更易于数据库移植。

@GeneratedValue(strategy=GenerationType.AUTO)
  @Id
  public Integer getId() {
    return Id;
  }
  public void setId(Integer id) {
    Id = id;
  }

@Column

当实体的属性与其映射的数据库表的列不一样名时须要使用@Column 标注说明，该属性一般置于实体的属性声明语句以前，还可与 @Id 标注一块儿使用。

• @Column 标注的经常使用属性是 name，用于设置映射数据库表的列名。此外，该标注还包含其它多个属性，如：unique 、nullable、length 等。
• @Column 标注的 columnDefinition 属性: 表示该字段在数据库中的实际类型.一般 ORM 框架能够根据属性类型自动判断数据库中字段的类型,可是对于Date类型仍没法肯定数据库中字段类型到底是DATE,TIME仍是TIMESTAMP.此外,String的默认映射类型为VARCHAR, 若是要将 String 类型映射到特定数据库的 BLOB 或TEXT 字段类型.
• @Column标注也可置于属性的getter方法以前

@Column(name="LAST_NAME")
  public String getLastName() {
    return lastName;
  }
  public void setLastName(String lastName) {
    this.lastName = lastName;
  }

@Basic

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

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

@Transient

表示该属性并不是一个到数据库表的字段的映射,ORM框架将忽略该属性.
若是一个属性并不是数据库表的字段映射,就务必将其标示为@Transient,不然,ORM框架默认其注解为@Basic

@Transient
    public String customerInfo() {
        return "Customer [Id=" + Id + ", lastName=" + lastName + ", email="
                + email + ", age=" + age + "]";
    }

@Temporal

在核心的 Java API 中并无定义 Date 类型的精度(temporal precision). 而在数据库中,表示 Date 类型的数据有 DATE, TIME, 和 TIMESTAMP 三种精度(即单纯的日期,时间,或者二者 兼备). 在进行属性映射时可以使用@Temporal注解来调整精度。

@Temporal(TemporalType.TIMESTAMP)
    public Date getCreateDate() {
        return createDate;
    }
    public void setCreateDate(Date createDate) {
        this.createDate = createDate;
    }

    @Temporal(TemporalType.DATE)
    public Date getBirthday() {
        return birthday;
    }
    public void setBirthday(Date birthday) {
        this.birthday = birthday;
    }