JPA学习 —— 第四课、JPA注解

喜欢ヅ旅行 2022-05-25 02:21 252阅读 0赞

# 常用基础注解 #

## @Entity ##

必须

@Entity(name=”“) 标注用于实体类声明语句之前，指出该Java 类为实体类，将映射到指定的数据库表。

name为可选,对应数据库表名

## @Table ##

可选  
当实体类与其映射的数据库表名不同名时需要使用 @Table 标注说明，该标注与 @Entity 标注并列使用，置于实体类声明语句之前，可写于单独语句行，也可与声明语句同行。

@Table 标注的常用选项是 name，用于指明数据库的表名,如果和@Entity同时设置了表名,则这个会覆盖@Entity的设置。

@Table标注还有一个两个选项 catalog 和 schema 用于设置表所属的数据库目录或模式，通常为数据库名。

@Entity
    @Table(name="employee")
    public class Employee { 
    }

## @Id ##

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

@Id
        private Integer Id;

@Id标注也可置于属性的getter方法之前。

## @GeneratedValue ##

可选

@GeneratedValue 用于标注主键的生成策略，通过 strategy 属性指定。默认情况下，JPA 自动选择一个最适合底层数据库的主键生成策略：SqlServer 对应 identity，MySQL 对应 auto increment。

在 javax.persistence.GenerationType 中定义了以下几种可供选择的策略：

IDENTITY：采用数据库 ID自增长的方式来自增主键字段，Oracle 不支持这种方式；

AUTO： JPA自动选择合适的策略，是默认选项；

SEQUENCE：通过序列产生主键，通过 @SequenceGenerator 注解指定序列名，MySql 不支持这种方式

@Id
    @SequenceGenerator(name = "ID_SEQUENCE_GENERATOR", sequenceName = "ID_SEQUENCE", allocationSize = 1)
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "ID_SEQUENCE_GENERATOR")
    @Column(name = "ID")
    private Long id;

TABLE：通过表产生主键，框架借由表模拟序列产生主键，使用该策略可以使应用更易于数据库移植。

## @Basic ##

可选

@Basic 表示一个简单的属性到数据库表的字段的映射,对于没有使用@Column指定生成表字段名称的属性,即默认为@Basic,而映射数据库表的列名会根据配置的命名策略进行映射。

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

optional:表示该属性是否允许为null, 默认为true

## @Column ##

可选

@Column描述了数据库表中该字段的详细定义,这对于根据JPA注解生成数据库表结构的工具非常有作用.  
属性说明:  
name:表示数据库表中该字段的名称,默认情形属性名称一致  
nullable:表示该字段是否允许为null,默认为true  
unique:表示该字段是否是唯一标识,默认为false  
length:表示该字段的大小,仅对String类型的字段有效  
insertable:表示在ORM框架执行插入操作时,该字段是否应出现INSETRT语句中,默认为true  
updateable:表示在ORM框架执行更新操作时,该字段是否应该出现在UPDATE语句中,默认为true.对于一经创建就不可以更改的字段,该属性非常有用,如对于birthday字段.  
columnDefinition: 表示该字段在数据库中的实际类型.通常ORM框架可以根据属性类型自动判断数据库中字段的类型,但是对于Date类型仍无法确定数据库中字段类型究竟是 DATE,TIME还是TIMESTAMP.此外,String的默认映射类型为VARCHAR,如果要将String类型映射到特定数据库的BLOB或 TEXT字段类型,该属性非常有用.

@Column(name="BIRTH", nullable="false", columnDefinition="DATE")
    public String getBithday() {
          return birthday;
     }

## @Transient ##

可选

表示该属性并非一个到数据库表的字段的映射,ORM框架将忽略该属性.

如果一个属性并非数据库表的字段映射,就务必将其标示为@Transient,否则,ORM框架默认其注解为@Basic

## @Temporal ##

可选

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

@Temporal(TemporalType.DATE)
    private Date empBirth;