Jpa 实体类常用注解_joincolumn_早睡，身体好的博客

1. @Entity

被Entity标注的实体类将会被JPA管理控制，在程序运行时，JPA会识别并映射到指定的数据库表
唯一参数name:指定实体类名称，默认为当前实体类的非限定名称。
若给了name属性值即@Entity(name="XXX")，则jpa在仓储层(数据层)进行自定义查询时，所查的表名应是XXX。
如：select s from XXX s
2. @Table
 
当你想生成的数据库表名与实体类名称不同时，使用 @Table(name="数据库表名"),与@Entity标注并列使用，置于实体
类声明语句之前
@Entity
@Table(name="t_student")
public class student{
@Table中的参数(不常用) 
catalog: 用于设置表所映射到的数据库的目录
schema: 用于设置表所映射到的数据库的模式
uniqueConstraints: 设置约束条件 
3. @Id
 
@Id 用于实体类的一个属性或者属性对应的getter方法的标注，被标注的的属性将映射为数据库主键
4. @GeneratedValue
 
与@Id一同使用，用于标注主键的生成策略，通过 strategy 属性指定。默认是JPA自动选择合适的策略
在 javax.persistence.GenerationType 中定义了以下几种可供选择的策略：
 - IDENTITY：采用数据库ID自增长的方式产生主键，Oracle 不支持这种方式。
 - AUTO： JPA 自动选择合适的策略，是默认选项。
 - SEQUENCE：通过序列产生主键，通过@SequenceGenerator标注指定序列名，MySQL 不支持这种方式。
 - TABLE：通过表产生主键，框架借由表模拟序列产生主键，使用该策略更易于做数据库移植。
5. @Basic
 
@Basic表示一个简单的属性到数据库表的字段的映射,对于没有任何标注的 getXxxx() 方法,默认即为@Basic(fetch=FetechType.EAGER)
@Basic参数：
  1. fetch 表示该属性的加载读取策略
    1.1 EAGER 主动抓取 （默认为EAGER）
    1.2 LAZY 延迟加载,只有用到该属性时才会去加载
  2. optional (默认为 true)
    表示该属性是否允许为null
6. @Column
 
通常置于实体的属性声明之前，可与 @Id 标注一起使用
@Column参数：
  1. name: 指定映射到数据库中的字段名
  2. unique: 是否唯一，默认为false
  3. nullable: 是否允许为null，默认为true
  4. insertable: 是否允许插入，默认为true
  5. updatetable: 是否允许更新，默认为true
  6. columnDefinition: 指定该属性映射到数据库中的实际类型，通常是自动判断。
7. @Transient
 
JPA会忽略该属性，不会映射到数据库中，即程序运行后数据库中将不会有该字段
8. @Temporal
 
Java中没有定义 Date 类型的精度，而数据库中，表示时间类型的数据有 DATE,TIME,TIMESTAMP三种精度
  - @Temporal(TemporalType.DATE) 表示映射到数据库中的时间类型为 DATE，只有日期
  - @Temporal(TemporalType.TIME) 表示映射到数据库中的时间类型为 TIME，只有时间
  - @Temporal(TemporalType.TIMESTAMP) 表示映射到数据库中的时间类型为 TIMESTAMP,日期和时间都有
9. @Embedded 和 @Embeddable
 
用于一个实体类要在多个不同的实体类中进行使用，而本身又不需要独立生成一个数据库表
网上有一份比较详细说明，可参考链接 
10. @JoinColumn
 
定义表关联的外键字段名
常用参数有：
  1. name: 指定映射到数据库中的外键的字段名
  2. unique: 是否唯一，默认为false
  3. nullable: 是否允许为null，默认为true
  4. insertable: 是否允许插入，默认为true
  5. updatetable: 是否允许更新，默认为true
  6. columnDefinition: 指定该属性映射到数据库中的实际类型，通常是自动判断。
  7. foreignKey = @ForeignKey(name = "none",value = ConstraintMode.NO_CONSTRAINT)：指定外键相关信息，这里用法是指定外联关系但是不建立数据库外键
11. @OneToOne
 
targetEntity： 指定关联实体类型，默认为被注解的属性或方法所属的类
cascade： 级联操作策略 
  CascadeType.ALL 级联所有操作
CascadeType.PERSIST 级联新增
CascadeType.MERGE 级联归并更新
CascadeType.REMOVE 级联删除
CascadeType.REFRESH 级联刷新
CascadeType.DETACH 级联分离
 
fetch： fetch 表示该属性的加载读取策略 (默认值为 EAGER) 
  EAGER 主动抓取
LAZY 延迟加载,只有用到该属性时才会去加载
 
optional： 默认为true，关联字段是否为空
 如果为false，则常与@JoinColumn一起使用
mappedBy： 指定关联关系，该参数只用于关联关系被拥有方
 只用于双向关联@OneToOne,@OneToMany,@ManyToMany。而@ManyToOne中没有
 @OneToOne(mappedBy = “xxx”)
 表示xxx所对应的类为关系被拥有方，而关联的另一方为关系拥有方 
  关系拥有方：对应拥有外键的数据库表
关系被拥有方：对应主键被子表引用为外键的数据库表
 
orphanRemoval:默认值为false
 判断是否自动删除与关系拥有方不存在联系的关系被拥有方(关系被拥有方的一个主键在关系拥有方中未被引用，
 当jpa执行更新操作时，是否删除数据库中此主键所对应的一条记录，若为true则删除) 
//单向 一对一
@Entity  
public class Emp{//员工
  @GeneratedValue
  privte Integer eId;
  @Column(length = 40)
  private String empName;
  @OneToOne(cascade = CascadeType.ALL)
  private Identity identity;
  //get,set方法省略
@Entity
public class Identity{//身份证
  //...
//双向 一对一
@Entity  
public class Emp{
  @GeneratedValue
  privte Integer eId;
  @Column(length = 40)
  private String empName;
  @OneToOne(cascade = CascadeType.ALL)
  private Identity identity;
  //get,set方法省略
@Entity
public class Identity{
  @GeneratedValue
  privte Integer iId;
  @OneToOne(cascade = CascadeType.ALL, mappedBy = "identity")
  private Emp emp;
  //...
以上例子，双向一对一，Emp 为关系拥有方，Identity 为关系被拥有方。
 执行spring-data-jpa新增操作时，如果通过Identity的数据访问层进行新增操作(IdentityRepository.save())
 ，Emp表和Identity表都有数据，但是不会设置这两条数据的关系，Emp表中的外键为null。
 反之，以关系拥有方Emp的数据访问层进行新增操作(EmpRepository.save()),Emp表和Identity表都有数据，并且
 设置了两条数据的关系，即Emp表中的外键也得到正确新增 
12. @ManyToOne、@OneToMany
 
多对一(也可叫一对多，只是前后表颠倒一下而已)，只有双向多对一时才用得到@OneToMany。多对一中多的一方必定是对应数据库中拥有外键的表，即是关系拥有方，@ManyToOne只用在多对一中代表多的一类中，因为mappedBy只用于关系被拥有方，所以@ManyToOne参数中不包含mappedBy。 
@ManyToOne参数: 
targetEntity： 指定关联实体类型，默认为被注解的属性或方法所属的类
cascade： 级联操作策略 
  CascadeType.ALL 级联所有操作
CascadeType.PERSIST 级联新增
CascadeType.MERGE 级联归并更新
CascadeType.REMOVE 级联删除
CascadeType.REFRESH 级联刷新
CascadeType.DETACH 级联分离
 
fetch： fetch 表示该属性的加载读取策略(@ManyToOne 的默认值是 EAGER，@OneToMany 的默认值是 LAZY) 
  EAGER 主动抓取
LAZY 延迟加载,只有用到该属性时才会去加载
 
optional： 默认为true，关联字段是否为空
 如果为false，则常与@JoinColumn一起使用 
@OneToMany 参数除上述以外还有： 
 mappedBy: 指定关联关系，该参数只用于关联关系被拥有方
 只用于双向关联@OneToOne,@OneToMany,@ManyToMany。而@ManyToOne中没有
 @OneToMany(mappedBy = “xxx”)
 表示xxx所对应的类为关系被拥有方，而关联的另一方为关系拥有方 
  关系拥有方：对应拥有外键的数据库表
关系被拥有方：对应主键被子表引用为外键的数据库表
 
 orphanRemoval:默认值为false
 判断是否自动删除与关系拥有方不存在联系的关系被拥有方(关系被拥有方的一个主键在关系拥有方中未被引用，
 当jpa执行更新操作时，是否删除数据库中此主键所对应的一条记录，若为true则删除)
  
//单向 多对一
@Entity
public class Emp{
  @GeneratedValue
  privte Integer eId;
  @Column(length = 40)
  private String empName;
  @ManyToOne(cascade = CascadeType.ALL)
  private Dept dept;
  //...
@Entity
public class Dept{
  @GeneratedValue
  privte Integer dId;
  @Column(length = 40)
  private String deptName;
  //...
//双向 多对一
@Entity
public class Emp{
  @GeneratedValue
  privte Integer eId;
  @Column(length = 40)
  private String empName;
  @ManyToOne(cascade = CascadeType.ALL)
  private Emp emp;
  //...
@Entity
public class Dept{
  @GeneratedValue
  privte Integer dId;
  @Column(length = 40)
  private String deptName;
  @OneToMany(cascade = CascadeType.ALL, mappedBy = "emp")
  private List<Emp> emps;
  //...
无论双向关联还是单向关联，数据库中均会在Emp表中自动生成一个外键（dept_d_id） 
13. @ManyToMany
 
targetEntity： 指定关联实体类型，默认为被注解的属性或方法所属的类
cascade： 级联操作策略 
  CascadeType.ALL 级联所有操作
CascadeType.PERSIST 级联新增
CascadeType.MERGE 级联归并更新
CascadeType.REMOVE 级联删除
CascadeType.REFRESH 级联刷新
CascadeType.DETACH 级联分离
 
fetch： fetch 表示该属性的加载读取策略 (默认值为 LAZY) 
  EAGER 主动抓取
LAZY 延迟加载,只有用到该属性时才会去加载 
  mappedBy: 指定关联关系，该参数只用于关联关系被拥有方
 只用于双向关联@OneToOne,@OneToMany,@ManyToMany。而@ManyToOne中没有。
 @ManyToMany(mappedBy = “xxx”)
 表示xxx所对应的类为关系被拥有方，而关联的另一方为关系拥有方： 
    关系拥有方：对应拥有外键的数据库表
关系被拥有方：对应主键被子表引用为外键的数据库表
 
  
//单向 多对多
@Entity
public class Student{
  @ManyToMany(cascade = CascadeType.ALL)
  private List<Course> courses;
  //...
@Entity
public class Course{
  //...
//双向 多对多
@Entity
public class Student{
  @ManyToMany(cascade = CascadeType.ALL)
  private List<Course> courses;
  //...
@Entity
public class Course{
  @ManyToMany(cascade = CascadeType.ALL, mappedBy = "courses")
  private List<Student> students;
  //...
 所有双向关联使用时需谨慎，查询时容易引起栈内存溢出，尽量使用单向关联 
14. @Enumerated
 
当实体类中有枚举类型的属性时，默认情况下自动生成的数据库表中对应的字段类型是枚举的索引值，是数字类型的，若希望数据库中存储的是枚举对应的String类型，在属性上加入@Enumerated(EnumType.STRING)注解即可。 
@Enumerated(EnumType.STRING)
@Column(nullable = true)
private RoleEnum role;
有错误欢迎指出^_
注解属性的定义格式：
格式1：数据类型 属性名();  没有默认值的，使用时必须赋值。
格式2：数据类型 属性名() default 默认值; 有默认值的，使用时如果不赋值就会使用默认值，如果赋值就会覆盖掉默认值。
注解中能够定
                                    @Basic 字段是个隐藏字段，一般都不用加他。因为@Entity里面的字段默认都相当于加上@Basic了，就是要在数据库生成。
但是如果有个字段不需要在数据库生成。那么加上@Transient即可.
（比如实体People和实体IDCard，一个人对应一个身份证号）
@OneToOne（cascade=CAscadeType.ALL）全级联关系
@JoinColumn（name=“pid”,unique=true）被控类的外键写到主控类中，且唯一
注意：保存时应该先保存主表对象，再保存外键对象，这是因为数据库外键约束的原因。删除时则相反，应该先删除该人的身份证号，再删除该人，或者将该人和身份证号一起删除。
2、一对一双向外键
主控方配置不变
被控方添加
@OneToOne（map
     * (Optional) Defines whether the value of the field or property should
     * be lazily loaded or must be...
                                    JoinTable是中间表表名 joinColumns指定中间表中关联自己ID的字段，inverseJoinColumns表示中间表中关联对方ID的字段，joinColumns是列名
 @JoinTable(name = "employee_role",joinColumns = @JoinColumn(name = "employee_id"),
            inverseJoinC...
import javax.persistence.Entity;
@SelectBeforeUpdate(value = true) //指明Hibernate从不运行SQL U
The <code>Basic</code> annotation can be applied to a persistent
 * property or instance variable of any of the follo...
@JoinColumn与@Column相区别的是：
		@JoinColumn注释的是保存表与表之间关系的字段，它要标注在实体属性上。
		@Column标注的是表中不包含表关系的字段。 
相同点: @Column标记一样，name属性是用来标识表中所对应的字段的名称。例如customer表中存在字段addr_id，标识的代码如下所示。 
@OneToOne 
@JoinColumn(name = "addr_id")
                                    import com.luxsun.platform.lux.kernel.common.domain.basic.BasePage;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.experimental.SuperBuilder;
import java.util.List;
 * @a.
    @PostMapping("post_test2")
    public Message postTest(@RequestBody QueryConditionsDTO qc) {
        return MessageBox.ok(qc);
                                    一、@JoinColumn
@JoinColumn 的作用就是声明关联关系的，什么是关联关系？
就是我们在数据库设计时常说的一对多、多对一、多对多关系。因此，@JoinColumn 必须和这些关系注解一起使用，否则是没有意义的。
二、name 和 referencedColumnName
刚开始接触这两个属性会觉得很难理解，特别是看书的时候总是分不清，看下面的例子：
// Address表对应的Entity
Class Address{
    @GeneratedValue(strategy =
@JoinColumn 注解的作用：用来指定与所操作实体或实体集合相关联的数据库表中的列字段。
由于 @OneToOne（一对一）、@OneToMany（一对多）、@ManyToOne（多对一）、@ManyToMany（多对多） 等注解只能确定实体之间几...
在Person中对应到数据库里面就有一个指向Address的外键.
我们也可以增加注释指定外键的列的名字,如下:@OneToOne(cascade=CascadeType.ALL,optional=true)@JoinColumn(name="addressID")//注释本表中指向另一个表的外键。public Address getAddres...
                                    @Column(nullable = false)是用于生成模式的指令。生成的类的数据库列将在实际数据库中标记为不可为空。
@Basic(optional = false)是运行时指令。会在SQL被发送到数据库之前引发一个异常。它所做的主要功能是与延迟加载有关。你不能延迟加载非集合映射的实体，除非你记得设置optional = false(因为Hibernate不知道是否应该有一个代理或null，...