@MappedSuperclass
标注的实体类不会映射到数据库 也无需实现序列化接口 属性都会映射到子类中
@Entity(name=“UserEntity”)
对实体注释。任何Hibernate映射对象都要有这个注释,只能标注在实体的class定义处,表示实体对应的数据库表的信息。
不用name和@Table结合的话 默认类名的 SnakeCaseStrategy(命名策略 )为表名
使用name不用@Table 默认name的 SnakeCaseStrategy(命名策略 )为表名
@Table(name = “UserEntity”,catalog="",schema="")
name 可选,表示表的名称。默认,表名和实体名称一致,只有在不一致的情况下才需要指定表名。
catalog:可选,表示Catalogs名称,默认为Catalog(“”)。属性表示实体指定的目录名
schema:可选,表示Schema名称,默认为Schema(“”)。属性表示实体指定数据库名所用的数据库模式
uniqueConstraints 用来批量命名唯一键 “mobile”, “email” 列加上注解 @Column(unique=true)
@Table(name=”an_user_table”, uniqueConstraints = {@UniqueConstraint(columnNames={“mobile”, “email”})})
@Inheritance(strategy = InheritanceType.JOINED)
在JPA中,实体继承关系的映射策略共有三种:单表继承策略(table per class)、Joined策略(table per subclass)和Table_PER_Class策略。
1.单表继承策略
单表继承策略,父类实体和子类实体共用一张数据库表,在表中通过一列辨别字段来区别不同类别的实体。具体做法如下:
a.在父类实体的@Entity注解下添加如下的注解:
@Inheritance(Strategy=InheritanceType.SINGLE_TABLE)
@DiscriminatorColumn(name=”辨别字段列名”)
@DiscriminatorValue(父类实体辨别字段列值)
b.在子类实体的@Entity注解下添加如下的注解:
@DiscriminatorValue(子类实体辨别字段列值)
定义了一个父类
@Entity
@Inheritance(strategy = InheritanceType.SINGLE_TABLE)
@Table(name = "WINDOW_FILE")
@DiscriminatorColumn(name = "DISCRIMINATOR", discriminatorType = DiscriminatorType.STRING, length = 30)
@DiscriminatorValue("WindowFile")
public class WindowFile {
@Id
@GeneratedValue(strategy = GenerationType.AUTO)
private Integer id;
@Basic
@Column(name = "NAME")
private String name;
@Basic
@Column(name = "TYPE")
private String type;
@Basic
@Column(name = "DATE")
private Date date;
//省略get set
}
后定义2个子类
@Entity
@DiscriminatorValue(“Folder”)
public class Folder extends WindowFile {
@Basic
@Column(name = “FILE_COUNT”)
private Integer fileCount;
//省略get set
}
@Entity
@DiscriminatorValue("Document")
public class Document extends WindowFile {
@Basic
@Column(name = "SIZE")
private String size;
//省略get set
}
以上通过列DISCRIMINATOR的不同,区分具体父子实体。
实际表结构如下:
WINDOW_FILE DISCRIMINATOR,ID,NAME,DATE,TYPE,SIZE,FILE_COUNT
当你使用WindowFile实体时,实际表的字段为DISCRIMINATOR=‘WindowFile’,SIZE与FILE_COUNT永远是空
当使用Folder实体时,DISCRIMINATOR=‘Folder’,SIZE永远是空,FILE_COUNT为实际值。
Document同理,与Folder类似。
2.Joined策略
父类实体和子类实体分别对应数据库中不同的表,子类实体的表中只存在其扩展的特殊属性,父类的公共属性保存在父类实体映射表中。具体做法:
@Inheritance(Strategy=InheritanceType.JOINED)
子类实体不需要特殊说明
@Entity
@Table(name = "T_ANIMAL")
@Inheritance(strategy = InheritanceType.JOINED)
public class Animal {
@Id
@Column(name = "ID")
@GeneratedValue(strategy = GenerationType.AUTO)
private Integer id;
@Column(name = "NAME")
private String name;
@Column(name = "COLOR")
private String color;
//省略get set
}
@Entity
@Table(name = "T_BIRD")
@PrimaryKeyJoinColumn(name = "BIRD_ID")
public class Bird extends Animal {
@Column(name = "SPEED")
private String speed;
//省略get set
}
@Entity
@Table(name = "T_DOG")
@PrimaryKeyJoinColumn(name = "DOG_ID")
public class Dog extends Animal {
@Column(name = "LEGS")
private Integer legs;
//省略get set
}
实际表结构如下:
T_ANIMAL ID,COLOR,NAME
T_BIRD SPEED,BIRD(既是外键,也是主键)
T_DOG LEGS,DOG_ID(既是外键,也是主键)
3.Table_PER_Class策略:
Table_PER_Class策略,父类实体和子类实体每个类分别对应一张数据库中的表,子类表中保存所有属性,包括从父类实体中继承的属性。具体做法:
只需在父类实体的@Entity注解下添加如下注解:
@Inheritance(Strategy=InheritanceType.TABLE_PER_CLASS)
@Entity
@Inheritance(strategy = InheritanceType.TABLE_PER_CLASS)
@Table(name = "T_VEHICLE")
public class Vehicle { // 基类
@Id
// @GeneratedValue
@Column(name = "ID")
private Integer id;
@Column(name = "SPEED")
private Integer speed;// 速度
//省略get set
}
@Entity
@Table(name = "T_CAR")
public class Car extends Vehicle {
@Column(name = "ENGINE")
private String engine;// 发动机
//省略get set
}
一旦使用这种策略就意味着你不能使用AUTO generator 和IDENTITY generator,即主键值不能采用数据库自动生成。
实际表结构如下:
T_VEHICLE ID,SPEED
T_CAR ID,SPEED,ENGINE
@SequenceGenerator(name = “ID_SEQ”, sequenceName = “SEQ_BDF2_USER”,allocationSize=1,initialValue=1, )
SEQ_BDF2_USER 这个序列数据库中要存在
标注在类上,要和@GeneratedValue 一起使用,
@GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "ID_SEQ")
标注在属性 @SequenceGenerator(name = "ID_SEQ", sequenceName = "SEQ_BDF2_USER",allocationSize=1,initialValue=1)
注意事项
类上面声明序列可以在各个字段使用
字段上声明的序列只能在当前字段使用
@SequenceGenerator中allocationSize属性用来定义递增值
如果主键为随机生成的,请检查是否定义allocationSize属性
如果是其它数据库请修改主键策略GenerationType
strategy:表示主键生成策略,有AUTO,INDENTITY,SEQUENCE 和 TABLE 4种,分别表示让ORM框架自动选择,根据数据库的 Identity 字段生成,根据数据库表的 Sequence 字段生成,以有根据一个额外的表生成主键,默认为 AUTO。
generator:表示主键生成器的名称,这个属性通常和ORM框架相关,例如,Hibernate可以指定uuid等主键生成方式.
@id
@id定义了映射到数据库表的主键的属性,一个实体只能有一个属性被映射为主键。
@Basic(fetch=FetchType,optional=true)
@Basic表示一个简单的属性到数据库表的字段的映射,对于没有任何标注的getXxxx()方法,默认即为@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字段类型,该属性非常有用。
@Transient
可选
@Transient表示该属性并非一个到数据库表的字段的映射,ORM框架将忽略该属性。
如果一个属性并非数据库表的字段映射。就务必将其标示为@Transient。否则。ORM框架默认其注解为@Basic
@OneToOne(fetch=FetchType,cascade=CascadeType)
可选
@OneToOne描述一个一对一的关联
fetch:表示抓取策略,默认为FetchType.LAZY
cascade:表示级联操作策略
@ManyToOne(fetch=FetchType,cascade=CascadeType)
可选
@ManyToOne表示一个多对一的映射,该注解标注的属性通常是数据库表的外键
optional:是否允许该字段为null,该属性应该根据数据库表的外键约束来确定,默认为true
fetch:表示抓取策略,默认为FetchType.EAGER
cascade:表示默认的级联操作策略,可以指定为ALL,PERSIST,MERGE,REFRESH和REMOVE中的若干组合,默认为无级联操作
targetEntity:表示该属性关联的实体类型。该属性通常不必指定,ORM框架根据属性类型自动判断targetEntity。
@OneToMany(fetch=FetchType,cascade=CascadeType)
可选
@OneToMany描述一个一对多的关联,该属性应该为集体类型,在数据库中并没有实际字段。
fetch:表示抓取策略,默认为FetchType.LAZY,因为关联的多个对象通常不必从数据库预先读取到内存
cascade:表示级联操作策略,对于OneToMany类型的关联非常重要,通常该实体更新或删除时,其关联的实体也应当被更新或删除
例如:实体User和Order是OneToMany的关系,则实体User被删除时,其关联的实体Order也应该被全部删除
@ManyToMany 描述一个多对多的关联.多对多关联上是两个一对多关联,但是在ManyToMany描述中,中间表是由ORM框架自动处理
targetEntity:表示多对多关联的另一个实体类的全名,例如:package.Book.class
mappedBy:表示多对多关联的另一个实体类的对应集合属性名称
两个实体间相互关联的属性必须标记为@ManyToMany,并相互指定targetEntity属性,
需要注意的是,有且只有一个实体的@ManyToMany注解需要指定mappedBy属性,指向targetEntity的集合属性名称
利用ORM工具自动生成的表除了User和Book表外,还自动生成了一个User_Book表,用于实现多对多关联
@JoinColumn
可选
@JoinColumn和@Column类似,介量描述的不是一个简单字段,而一一个关联字段,例如.描述一个@ManyToOne的字段.
name:该字段的名称.由于@JoinColumn描述的是一个关联字段,如ManyToOne,则默认的名称由其关联的实体决定.
例如,实体Order有一个user属性来关联实体User,则Order的user属性为一个外键,
其默认的名称为实体User的名称+下划线+实体User的主键名称
@JoinTable(name = “student_teacher”, inverseJoinColumns = @JoinColumn(name = “tid”), joinColumns = @JoinColumn(name = “sid”))
可选
由第三张表来维护两张表的关系
name:是关系表的名字
joinColumns:自己这一端的主键
inverseJoinColumns:对方的主键
@Embedded @Embededable
在使用实体类生成对应的数据库表时,很多的时候都会遇到这种情况:
在一个实体类中引用另外的实体类,一般遇上这种情况,我们使用@OneToOne、@OneToMany、@ManyToOne、@ManyToMany这4个注解比较多,但是好奇害死猫,
除了这四个有没有别的使用情况,尤其是一个实体类要在多个不同的实体类中进行使用,而本身又不需要独立生成一个数据库表,这就是需要@Embedded、@Embeddable的时候了,下面分成4类来说明在一个实体类中引用另外的实体类的情况,具体的数据库环境是MySQL 5.7。
@Embedded将几个字段组合成一个类,并作为整个Entity的一个属性.
例如User包括id,name,city,street,zip属性.
我们希望city,street,zip属性映射为Address对象.这样,User对象将具有id,name和address这三个属性.
Address对象必须定义为@Embededable
案例:
Address类
public class Address implements Serializable{
private static final long serialVersionUID = 8849870114128959929L;
private String country;
private String province;
private String city;
private String detail;
//setter、getter
}
Person类:
@Entity
public class Person implements Serializable{
private static final long serialVersionUID = 8849870114127659929L;
@Id
@GeneratedValue
private Long id;
@Column(nullable = false)
private String name;
@Column(nullable = false)
private Integer age;
private Address address;
//setter、getter
}
1、 两个注解全不使用 表中有id,age,name,address
Address属性字段会映射成tinyblob类型的字段,这是用来存储不超过255字符的二进制字符串的数据类型,显然我们通常不会这么使用
2、 只使用@Embeddable 和单独使用 @Embedded 效果是一样的。
覆盖@Embeddable类中字段的列属性
这里就要使用另外的两个注解@AttributeOverrides和@AttributeOverride,这两个注解是用来覆盖@Embeddable类中字段的属性的。
@AttributeOverrides:里面只包含了@AttributeOverride类型数组;
@AttributeOverride:包含要覆盖的@Embeddable类中字段名name和新增的@Column字段的属性;
@Entity
public class Person implements Serializable{
private static final long serialVersionUID = 8849870114127659929L;
@Id
@GeneratedValue
private Long id;
@Column(nullable = false)
private String name;
@Column(nullable = false)
private Integer age;
@Embedded
@AttributeOverrides({@AttributeOverride(name="country", column=@Column(name = "person_country", length = 25, nullable = false)), @AttributeOverride(name="city", column = @Column(name = "person_city", length = 15))})
private Address address; //setter、getter }
Address类如下:
@Embeddable
public class Address implements Serializable{
private static final long serialVersionUID = 8849870114128959929L;
@Column(nullable = false)
private String country;
@Column(length = 30)
private String province;
@Column(unique = true)
private String city;
@Column(length = 50)
private String detail;
//setter、getter
}
多层嵌入实体类属性
上面所有的例子都是使用两层实体类嵌入,其实这种实体类的嵌入映射是可以使用多层的,具体的例子如下。
我们新建立一个类Direction表示方位如下
@Embeddable public class Direction implements Serializable{
@Column(nullable = false)
private Integer longitude;
private Integer latitude;
}
Address如下:
@Embeddable public class Address implements Serializable{
private static final long serialVersionUID = 8849870114128959929L;
@Column(nullable = false)
private String country;
@Column(length = 30)
private String province;
@Column(unique = true)
private String city;
@Column(length = 50)
private String detail;
@Embedded
private Direction direction;
}
Person类如下:
@Entity public class Person implements Serializable{
private static final long serialVersionUID = 8849870114127659929L;
@Id
@GeneratedValue
private Long id;
@Column(nullable = false)
private String name;
@Column(nullable = false)
private Integer age;
@Embedded
@AttributeOverrides({@AttributeOverride(name="direction.latitude", column=@Column(name = "person_latitude")), @AttributeOverride(name="direction.longitude", column = @Column(name = "person_longitude"))})
private Address address;
}
在上面需要注意如下几点:
在Person中定义Direction中的属性时,需要用”.”将所有相关的属性连接起来;
在Direction中longitude属性定义为not null,但是由于使用了@AttributeOverride注解,其中虽然没有定义null属性,但是这时使用的是默认的nullable属性,默认为true;
@Table(indexes = {
@Index(name="studentAnswerQueIdIndex", columnList="studentAnswerQueId DESC"),
@Index(name="questionConIdIndex", columnList="questionConId")
})
@Index(name = "questionConIdIndex")
标注在属性上
@Enumerated:
EnumType.STRING 指定数据库中存储的值为枚举值(MAN,WOMEN)
EnumType.ORDINAL 指定数据库中存储的值为索引值(MAN的索引值0,WOMEN索引值1)
@Enumerated(EnumType.STRING) @Column(length = 5,nullable = false)
Gender枚举类
public enum Gender {
MAN,WOMEN
}
/设置默认值
private Gender gender = Gender.MAN;
public User() {
}
//枚举类型不能为空,所以非空约束一定要加上
@Enumerated(EnumType.STRING) @Column(length = 5,nullable = false)
public Gender getGender() {
return gender;
}
https://www.yiibai.com/jpa/jpa-object-relational-mapping.html
https://blog.csdn.net/qq_32827261/article/details/74690867
@Type(type = DbEnumType.CLAZE, parameters = { @Parameter(name = “enumClass”, value = oStatus.CLAZE) })
@Column(name = "source")
@Type(type = DbEnumType.CLAZE, parameters = { @Parameter(name = "enumClass", value = Source.CLAZE) })
public Source getSource() {
return source;
}
@JSONField(serialize = false)
@JsonIgnore
@Transient
public String getMobile() {
return Mobile;
}
@Entity
@Inheritance(strategy = InheritanceType.SINGLE_TABLE)
@DiscriminatorColumn(name = "type", discriminatorType = DiscriminatorType.INTEGER)
@Table(name = "location")
@SequenceGenerator(name = "seq_location", sequenceName = "seq_location")
@Index(name = "c_nos_idx")
@Basic(fetch = FetchType.LAZY)
@Type(type="text")
@Column(name = "pall_nos")
@Basic(fetch = FetchType.LAZY)
@Type(type="text")
@Column(name = "summary")
public String getSummary() {
return summary;
}
@Entity
@DiscriminatorValue(house.LOCATION_TYPE)
//@NamedQueries({
// @NamedQuery(name = house.QUERY_WAREHOUSE_DTO, query = "SELECT NEW houseDto(e.id, e.externalId, e.name) from ahouse e") })