简介
Spring Data JPA是一个常用的ORM框架，本文介绍它的注解及其用法。
注解概述
| 注解 | 说明 |
| @Entity | 声明类为实体。 |
| @Table | 声明表名。 @Entity和@Table一般一起使用，如果表名和实体类名相同，那么@Table可以省略。 |
| @Basic | 指定非约束明确的各个字段。 |
| @Embedded | 用于注释属性，表示该属性的类是嵌入类。 （ @Embeddable 用于注释Java类的，表示类是嵌入类）。 |
| @ld | 指定的类的属性，一个表中的主键。 |
| @GeneratedValue | 指定如何标识属性可以被初始化。 如@GeneratedValue(strategy = GenerationType.SEQUENCE,generator = “repair_seq”)：表示主键生成策略是sequence。还有Auto、ldentity、 Native 等。 |
| @Transient | 表示该属性并非一个数据库表的字段的映射，ORM框架将忽略该属性。 如果一个属性并非数据库表的字段映射，就务必将其标示为@Transient，即它是不持久的，为虚拟字段。 |
| @Column | 指定持久属性，即字段名。 若字段名与列名相同，则可以省略。 如：@Column(length=11,name=”phone”,nullable=false,columnDefinition = “varchar(11) unique comment’电话号码'”) |
| @SequenceGenerator | 指定在 @SequenceGenerator 注解中指定的属性的值。 它创建一个序列。 |
| @TableGenerator | 在数据库生成一张表来管理主键生成策略。 |
| @AccessType | 这种类型的注释用于设置访问类型。 如果设置@AccessType(FIELD)，则可以直接访问变量，并且不需要使用Gtter和Stter方法，但必须为public属性。 如果设置@AccessType(PROPERTY)，则通过Getter和Setter方法访问Entity的变量。 |
| @UniqueConstraint | 指定的字段和用于主要或辅助表的唯一约束。 |
| @ColumnResult | 可以参考使用select子句的SQL查询中的列名。 |
| @NamedQueries | 指定命名查询的列表。 |
| @NamedQuery | 指定使用静态名称的查询。 |
| @Basic | 指定实体属性的加载方式。 如@Basic(fetch=FetchType.LAZY)。 |
@Entity
被@Entity标注的实体类将会被JPA管理控制，在程序运行时，JPA会识别并映射到指定的数据库表。
| 属性 | 含义 | 示例 |
| name | 指定实体类名称，默认为当前实体类的非限定名称。 | @Entity(name=”XXX”) 对应的JQPL的实体类名是XXX。 |
例如：
Entity
import lombok.Data;
import lombok.NoArgsConstructor;
import javax.persistence.Entity;
@Data
@NoArgsConstructor
@Entity(name = "XXX")
public class User {
}
package com.example.demo.user.repository;
import com.example.demo.user.entity.User;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;
import org.springframework.stereotype.Repository;
@Repository
public interface UserRepository extends JpaRepository<User, Long> {
@Query("SELECT u FROM XXX u WHERE u.userName = :userName")
List<User> getByUserName(@Param("userName") String userName);
}
@Table
若表名与实体类名称不同时，使用 @Table(name=”表名”)，与@Entity标注并列使用，置于实体类声明语句之前。
有两个@Table，我们应该使用javax.persistence.table。两个@Table如下
- javax.persistence.Table
- org.hibernate.annotations.Table;
| 属性 | 含义 | 示例 |
| name | 表名 | @Entity @Table(name=”t_user”) 对应的表名是t_user。 |
| catalog | 表所属的数据库目录。 通常为数据库名 | |
| schema | 表所属的数据库模式。 通常为数据库名 | |
| uniqueConstraints | 设置约束条件。 通常不须设置 |
@Id
@Id 用于实体类的一个属性或者属性对应的getter方法上，被标注的的属性将映射为数据库主键。
@GeneratedValue
与@Id一同使用，用于标注主键的生成策略，通过 strategy 属性指定。
在 javax.persistence.GenerationType 中定义了以下几种可供选择的策略：
- AUTO： JPA 自动选择合适的策略，是默认选项。MySQL不支持这种方式。
- @GeneratedValue等价于@GeneratedValue(strategy=GenerationType.AUTO)
- IDENTITY：采用数据库ID自增长的方式产生主键。Oracle 不支持这种方式。
- SEQUENCE：通过序列产生主键，通过@SequenceGenerator标注指定序列名。MySQL 不支持这种方式。
- TABLE：通过表产生主键，框架借由表模拟序列产生主键，使用该策略更易于做数据库移植。
@Column
通常置于实体的属性声明之前，可与 @Id 标注一起使用
| 属性 | 含义 |
| name | 映射到数据库中的字段名。 可以在属性或者getter上面或加入； |
| unique | 是否唯一，默认为false |
| nullable | 是否允许为null，默认为true |
| insertable | 是否允许插入，默认为true |
| updatetable | 是否允许更新，默认为true |
| length | 指定列的最大字符长度。仅对String类型的字段有效。 |
| columnDefinition | 该属性映射到数据库中的实际类型，通常是自动判断 |
| secondaryTable | 从表名。 如果此列不建在主表上（默认是主表），该属性定义该列所在从表的名字。 |
@Transient
JPA会忽略该属性，不会映射到数据库中，即程序运行后数据库中将不会有该字段。
@Basic
@Basic表示一个简单的属性到数据库表的字段的映射。对于没有任何标注的 getXxxx() 方法,默认即为@Basic(fetch=FetechType.EAGER)
| 属性 | 含义 | 示例 |
| fetch | 加载读取策略。 有如下值： EAGER：主动抓取 （默认为EAGER） LAZY：延迟加载，只有用到该属性时才会去加载。 | @Entity @Table(name=”t_user”) 本实体类对应的的表名是t_user。 |
| optional | 该属性是否允许为null。 默认为 true |
@Temporal
Java中没有定义 Date 类型的精度，而数据库中，表示时间类型的数据有DATE,TIME,TIMESTAMP三种精度。
@Temporal(TemporalType.DATE) ：映射到数据库中的时间类型为 DATE，只有日期
@Temporal(TemporalType.TIME) ：映射到数据库中的时间类型为 TIME，只有时间
@Temporal(TemporalType.TIMESTAMP)：映射到数据库中的时间类型为 TIMESTAMP,日期和时间都有
@Embedded 和 @Embeddable
用于一个实体类要在多个不同的实体类中进行使用，而本身又不需要独立生成一个数据库表。
@Embedded将几个字段组合成一个类,并作为整个Entity的一个属性。
例如：User包括id,name,city,street,zip属性，我们希望city,street,zip属性映射为Address对象，这样，User对象将具有id,name和address这三个属性，Address对象要定义为@Embededable。
@JoinColumn
定义表关联的外键字段名。
| 属性 | 含义 | 示例 |
| name | 映射到数据库中的外键的字段名 | |
| unique | 是否唯一，默认为false | |
| nullable | 是否允许为null，默认为true | |
| insertable | 是否允许插入，默认为true | |
| updatetable | 是否允许更新，默认为true | |
| columnDefinition | 该属性映射到数据库中的实际类型，通常是自动判断 | |
| foreignKey | 指定外键相关信息。 | 指定外联关系但是不建立数据库外键：foreignKey = @ForeignKey(name = “none”,value = ConstraintMode.NO_CONSTRAINT) |
例：
实体Order有一个user属性来关联实体User，则Order的user属性为一个外键，其默认的名称为实体User的名称+下划线+实体User的主键名称。
@JoinTable
@JoinTable(name = “student_teacher”, inverseJoinColumns = @JoinColumn(name = “tid”), joinColumns = @JoinColumn(name = “sid”))
由第三张表来维护两张表的关系
name：是关系表的名字
joinColumns：自己这一端的主键
inverseJoinColumns：对方的主键
请先 ！