JPA 注解
Entity 常用注解
参考:JPA & Spring Data JPA学习与使用小记
指定对象与数据库字段映射时注解的位置:如@Id、@Column等注解指定Entity的字段与数据库字段对应关系时,注解的位置可以在Field(属性)或Property(属性的get方法上),两者统一用其中一种,不能两者均有。推荐用前者。
@Entity、@Table
映射实体类。指出该 Java 类为实体类,将映射到指定的关系数据库表。
应用了此注解后,将会自动将类名映射作为数据库表名、将类内的字段名映射为数据库表的列名。映射策略默认是按驼峰命名法拆分将类名或字段名拆分成多部分,然后以下划线连接,如StudentEntity -> student_entity、studentName -> student_name。若不按默认映射,则可通过@Table、@Column 指定,见下面。
映射数据库表名。当实体类与其映射的数据库表名不同名时需要使用 @Table 标注说明,该标注与 @Entity 标注并列使用
@DynamicInsert、@DynamicUpdate
设置为 true,表示 insert 对象的时候,生成动态的 insert 语句,如果这个字段的值是 null 就不会加入到 insert 语句中,默认 false
标注在实体类上。
-
设置为 true,表示执行 update 对象时,在生成动态的 update 语句前,会先查询该表在数据库中的字段值,并对比更新使用的对象中的字段值与数据库中的字段值是否相同,若相同(即该值没有修改),则该字段就不会被加入到 update 语句中。
-
默认 false,表示无论更新使用实体类中的字段值与数据库中的字段值是否一致,都加入到 update 语句中,即都使用对象中所有字段的值覆盖数据库中的字段值。
比如只想更新某个属性,但是却把整个属性都更改了,这并不是希望的结果,希望的结果是:更改了哪写字段,只要更新修改的字段就够了。
所以 jpa 更新数据库字段值,无论是否有 @DynamicUpdate 注解,均需要手动先 select 对象,然后通过 set 更新对象的属性值,然后再 save 对象,实现更新操作
注意:
-
@DynamicUpdate 的动态更新的含义是,比较更新要使用的实体类中的所有字段值与从数据库中查询出来的所有字段值,判断其是否有修改,不同则加入到update语句中更新字段值。
例如:数据库中 id=1 的记录所有字段都是非空的,但是实体类中只有 name 有值,也就是所有字段都变了,只是其他字段被更新为了新的空值。
@Id、@GeneratedValue
@Id(必需)
映射生成主键。用于声明一个实体类的属性映射为数据库的一个主键列。
若同时指定了下面的 @GeneratedValue 则存储时会自动生成主键值,否则在存入前用户需要手动为实体赋一个主键值。
-
java.util.Date, java.sql.Date, java.sql.Time, java.sql.Timestamp
指定联合主键,有 @IdClass、@EmbeddedId 两种方法。
@GeneratedValue
@GeneratedValue 用于标注主键的生成策略,通过 strategy 属性指定。
默认情况下,JPA 自动选择一个最适合底层数据库的主键生成策略:SqlServer 对应 identity,MySQL 对应 auto increment
@Column、@Basic、@Transient
@Column(可选)
映射表格列。当实体的属性与其映射的数据库表的列不同名时需要使用 @Column 标注说明。
类的字段名在数据库中对应的字段名可以通过此注解的name属性指定,不指定则默认为将属性名按驼峰命名法拆分并以下划线连接,如 createTime
对应 create_time
。
**注意:**即使name的值中包含大写字母,对应到db后也会转成小写,如@ Column(name="create_Time")
在数据库中字段名仍为create_time
。可通过SpringBoot配置参数【spring.jpa.hibernate.naming.physical-strategy】配置对应策略,如指定name值是什么,数据库中就对应什么名字的列名。默认值为:【org.springframework.boot.orm.jpa.hibernate.SpringPhysicalNamingStrategy】
@Column注解一共有10个属性,这10个属性均为可选属性,各属性含义分别如下:
-
unique:该字段是否为唯一标识,默认为false。也可以使用@Table标记中的@UniqueConstraint。
-
updatable:在使用“UPDATE”脚本插入数据时,是否更新该字段的值。默认为true。
insertable = false 和updatable = false 一般多用于只读的属性,例如主键和外键等。这些字段的值通常是自动生成的。
-
columnDefinition:建表时创建该字段的DDL语句,一般用于通过Entity生成表定义时使用。
(如果DB中表已经建好,该属性没有必要使用)
-
precision和scale:表示精度,当字段类型为double时,precision表示数值的总长度,scale表示小数点所占的位数。
@Basic(可选)
表示一个简单的属性到数据表的字段的映射,对于没有任何标注的属性或getter方法,默认标注为 @Basic
定义暂态属性。表示该属性并非一个到数据库表的字段的映射,ORM 框架将忽略该属性。
如果一个属性并非数据库表的字段映射,就必须将其标识为 @Transient,否则ORM 框架默认为其注解 @Basic,例如工具方法不需要映射。
@Temporal:时间日期精度
在 JavaAPI 中没有定义 Date 类型的精度,而在数据库中表示 Date 类型的数据类型有 Date(年月日),Time(时分秒),TimeStamp(年月日时分秒) 三种精度,进行属性映射的时候可以使用 @Temporal 注解调整精度。
目前此注解只能用于修饰JavaAPI中的【java.util.Date】、【java.util.Calendar】类型的变量,TemporalType 取 DATE、TIME、TIMESTAMP 时在MySQL中分别对应的 DATE、TIME、DATETIME 类型。
示例:
@Temporal(TemporalType.TIMESTAMP)
@CreationTimestamp //org.hibernate.annotations.CreationTimestamp,用于在JPA执行insert操作时自动更新该字段值
@Column(name = "create_time", updatable=false ) //为防止手动set,可设false以免该字段被更新
private Date createTime;
@Temporal(TemporalType.TIMESTAMP)
@UpdateTimestamp //org.hibernate.annotations.UpdateTimestamp,用于在JPA执行update操作时自动更新该字段值
private Date updateTime;
1、Hibernate 的注解:
@CreationTimestamp(创建时间)、@UpdateTimestamp(更新时间)
2、SpringDataJPA 的注解:(可参阅https://blog.csdn.net/tianyaleixiaowu/article/details/77931903)
@CreatedDate(创建时间)、@LastModifiedDate(更新时间)、@CreatedBy、@LastModifiedBy
用法:
- 在实体类加上注解 @EntityListeners(AuditingEntityListener.class)
- 在启动类上加上注解 @EnableJpaAuditing
- 在实体类中属性中加上面四种注解
示例:
@Data
@MappedSuperclass
@EntityListeners(AuditingEntityListener.class)
public abstract class BaseEntity {
@Id
@GeneratedValue(strategy = GenerationType.AUTO)
protected Integer id;
// 创建时间
@CreatedDate
@Column(name = "create_time", updatable=false ) //为防止手动set,可设false以免该字段被更新
private Long createTime;
// 更新时间
@LastModifiedDate
@Column(name = "update_time")
private Long updateTime;
}
其他注解
@MappedSuperClass:共有字段超类
标注在实体类上。
共有字段超类中声明了各 Entity 共有的字段,即数据库中多表中共有的字段,如 create_time、update_time、id 等。
标注为 @MappedSuperclass 的类将不是一个完整的实体类,将不会映射到数据库表,但是其属性都将映射到其子类的数据库字段中。
标注为 @MappedSuperclass 的类不能再标注 @Entity 或 @Table 注解,也无需实现序列化接口。
注解的类继承另一个实体类或标注 @MappedSuperclass 类,可以使用 @AttributeOverride 或 @AttributeOverrides 注解重定义其父类属性映射到数据库表中字段。
@IdClass:指定联合主键类
标注在实体类上。
指定联合主键类。如:@IdClass(StudentExperimentEntityPK.class)
主键类 StudentExperimentEntityPK 需要满足:
- 实现 Serializable 接口
- 有默认的 public 无参数的构造方法
- 重写 equals 和 hashCode 方法。equal s方法用于判断两个对象是否相同,EntityManger 通过 find 方法来查找 Entity 时,是根据 equals 的返回值来判断的。hashCode 方法返回当前对象的哈希码
- 它的类型和名称必须与使用 @Id 进行标注的实体主键字段的类型和名称一致。
示例:
/**
* 实体类
*/
@Data
@Entity
@Table(name = "customer_course")
@IdClass(CustomerCourseEntityPK.class) // 指定联合主键类
public class CustomerCourseEntity {
@Id
@Column(name = "customer_id", length = ColumnLengthConstrain.LEN_ID_MAX)
private String customerId;
@Id
@Column(name = "course_id", length = ColumnLengthConstrain.LEN_ID_MAX)
private String courseId;
@Column(name = "max_number")
private Integer maxNumber;
@ManyToOne
@JoinColumn(name = "course_id", referencedColumnName = "id", nullable = false, insertable = false, updatable = false)
private CourseEntity courseByCourseId;
}
/**
* 联合主键类
*/
@Data
public class CustomerCourseEntityPK implements Serializable {
private static final long serialVersionUID = 1L;
private String customerId;
private String courseId;
}
@EmbeddedId:联合主键
功能与 @IdClass 一样用于指定联合主键。不同的是其标注在实体内的主键类变量上,且主键类应该标注 @Embeddable 注解。
此外在主键类内指定的字段在实体类内可以不再指定,若再指定则需为 @Column 加上 insertable = false, updatable = false 属性
示例:
@Data
@Entity
@Table(name = "customer_course")
@IdClass(CustomerCourseEntityPK.class) // 指定联合主键类
public class CustomerCourseEntity {
@EmbeddedId
private CustomerCourseEntityPK id;
@Column(name = "max_number")
private Integer maxNumber;
}
/**
* 联合主键类
*/
@Data
@Embeddable
public class CustomerCourseEntityPK implements Serializable {
private static final long serialVersionUID = 1L;
@Column(name = "customer_id", length = ColumnLengthConstrain.LEN_ID_MAX)
private String customerId;
@Column(name = "course_id", length = ColumnLengthConstrain.LEN_ID_MAX)
private String courseId;
}
@Inheritance:表结构复用
标注在实体类上。
用于表结构复用。指定被该注解修饰的类被子类继承后子类和父类的表结构的关系。
-
SINGLE_TABLE:适用于共同字段多独有字段少的关联关系定义。
子类和父类对应同一个表且所有字段在一个表中,还会自动生成(也可通过 @DiscriminatorColumn 指定)一个字段
varchar 'dtype'
用来表示一条数据是属于哪个实体的。为默认值。 -
JOINED:子类和父类对应不同表,父类属性对应的列(除了主键)不会且无法再出现在子表中。子表自动产生与父表主键对应的外键与父表关联。同样地也可通过 @DiscriminatorColumn 为父类指定一个字段用于标识一条记录属于哪个子类。
-
TABLE_PER_CLASS:子类和父类对应不同表且各类自己的所有字段(包括继承的)分别都出现在各自的表中;表间没有任何外键关联。此策略最终效果与 @MappedSuperClass 等同。
@Inheritance 与 @MappedSuperclass 的区别:
@Inheritance、@MappedSuperClass 可用于定义 Inheritance 关系。这些方式的一个缺点是子类中无法覆盖从父类继承的字段的定义(如父类中 name 是 not null,但子类中允许为 null)。
除了 @Inheritance、@MappedSuperClass 外,还有一种 Inheritance 方法(此法可解决上述不足):先定义一个 Java POJO(干净的 POJO,没有任何对该类使用任何的 ORM 注解),然后不同子类继承该父类,并分别在不同子类中进行 ORM 定义即可。此法下不同子类拥有父类的公共字段且该字段在不同子类中对应的数据库列定义可不同。
@Embedded、@Embeddable
当一个实体类要在多个不同的实体类中进行使用,而其不需要生成数据库表
@Enumerated:映射枚举
注入数据库的类型有两种:EnumType.ORDINAL(Interger)、EnumType.STRING(String)
@TableGenerator:主键值生成器
TableGenerator定义一个主键值生成器,在 @GeneratedValue的属性strategy = GenerationType.TABLE时,generator属性中可以使用生成器的名字。生成器可以在类、方法或者属性上定义。
生成器是为多个实体类提供连续的ID值的表,每一行为一个类提供ID值,ID值通常是整数。
属性说明:
- name:生成器的唯一名字,可以被Id元数据使用。
- table:生成器用来存储id值的Table定义。
- pkColumnName:生成器表里用来保存主键名字的字段
- valueColumnName:生成器表里用来保存主键值的字段
- pkColumnValue:生成器表里用来保存主键名字的字段的值
- initialValue:id值的初始值。
- allocationSize:id值的增量
示例:
@Entity
public class Employee {
@Id
@Column(name = "id")
@TableGenerator(name = "hf_opert_id_gen", // 此处的名字要和下面generator属性值一致
table = "mcs_hibernate_seq", // 主键保存到数据库的表名
pkColumnName = "sequence_name", // 表里用来保存主键名字的字段
valueColumnName = "sequence_next_hi_value", // 表里用来保存主键值的字段
pkColumnValue = "user_id", // 表里名字字段对应的值
allocationSize = 1) // 自动增长,设置为1
@GeneratedValue(strategy = GenerationType.TABLE, generator = "hf_opert_id_gen")
private Integer id;
}
@JoinColumn、@JoinColumns
@JoinColumn:指定外键
如果在实体类的某个属性上定义了联表关系(OneToOne或OneTOMany等),则使用@JoinColumn注解来定义关系的属性。JoinColumn的大部分属性和Column类似。
属性说明:
- name:主表的列名。若不指定,默认为 关联表的名称 + “_” + 关联表主键的字段名,例如 address_id
- referencedColumnName:关联表作为外键的列名。若不指定,默认为关联表的主键作为外键。
- unique:是否唯一 ,默认false
- nullable:是否允许为空,默认true
- insertable:是否允许插入,默认true
- updatable:是否允许更新,默认true
- columnDefinition:定义建表时创建此列的DDL
- secondaryTable:从表名。如果此列不建在主表上(默认建在主表),该属性定义该列所在从表的名字。
- foreignKey():外键。默认@ForeignKey(ConstraintMode.PROVIDER_DEFAULT);
@Data
@Entity
public class Person {
...
// Person和Address是一对一关系。Address表中名为id_address的列作为外键指向Person表中名为address_id的列
@OneToOne
@JoinColumn(name="address_id", referencedColumnName="id_address", unique=true)
private Address address;
}
@Data
@Entity
public class Address {
@Id
@column(name ="id_address")
private Integer idAddress;
}
@JoinColumns
如果在实体类的某个属性上定义了联表关系(OneToOne或OneTOMany等),并且关系存在多个JoinColumn,则使用@JoinColumns注解定义多个JoinColumn的属性。
属性说明:
@Data
@Entity
public class Custom {
// Custom和Order是一对一关系。Order表中一个名为CUST_ID的列作为外键指向Custom对应表中名为ID_CUST的列,另一名为CUST_NAME的列作为外键指向Custom对应表中名为NAME_CUST的列
@OneToOne
@JoinColumns({
@JoinColumn(name="CUST_ID", referencedColumnName="ID_CUST"),
@JoinColumn(name="CUST_NAME", referencedColumnName="NAME_CUST")
})
private Order order;
}
@OneToOne、@OneToMany
@OneToOne
属性说明:
@Data
@Entity
public class Person {
...
// Person和Address是一对一关系。Address表中名为id_address的列作为外键指向Person表中名为address_id的列
@OneToOne
@JoinColumn(name="address_id", referencedColumnName="id_address", unique=true)
private Address address;
}
@OneToMany
描述一个 一对多的关联,该属性应该为集体类型,在数据库中并没有实际字段。
属性说明:
- fetch:表示抓取策略,默认为FetchType.LAZY,因为关联的多个对象通常不必从数据库预先读取到内存
- cascade:表示级联操作策略,对于OneToMany类型的关联非常重要,通常该实体更新或删除时,其关联的实体也应当被更新或删除
例如:实体User和Order是OneToMany的关系,则实体User被删除时,其关联的实体Order也应该被全部删除
@ManyToOne、@ManyToMany
@ManyToOne
表示一个多对一的映射,该注解标注的属性通常是数据库表的外键
属性说明:
- optional:是否允许该字段为null,该属性应该根据数据库表的外键约束来确定,默认为true
- fetch:表示抓取策略,默认为FetchType.EAGER
- cascade:表示默认的级联操作策略,可以指定为ALL,PERSIST,MERGE,REFRESH和REMOVE中的若干组合,默认为无级联操作
- targetEntity:表示该属性关联的实体类型。该属性通常不必指定,ORM框架根据属性类型自动判断 targetEntity
@ManyToMany
描述一个多对多的关联。多对多关联上是两个一对多关联,但是在ManyToMany描述中,中间表是由ORM框架自动处理
属性说明:
两个实体间相互关联的属性必须标记为@ManyToMany,并相互指定targetEntity属性, 需要注意的是,有且只有一个实体的@ManyToMany注解需要指定mappedBy属性,指向targetEntity的集合属性名称,利用ORM工具自动生成的表除了User和Book表外,还自动生成了一个User_Book表,用于实现多对多关联
@NamedStoredProcedureQuery
定义在一个实体上面声明存储过程。有多个存储过程,可以用@NamedStoredProcedureQueries。
@JsonFormat、@DateTimeFormat
后端到前端的时间格式的转换。注意:该注解并非 JPA 注解。
// 出参时间格式化
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date createTime;
spring.jackson.date-format=yyyy-MM-dd HH:mm:ss
spring.jackson.time-zone=GMT+8
@DateTimeFormat
前端到后端的时间格式的转换。注意:该注解并非 JPA 注解。
// 入参出参时间格式化。请求报文只需要传入"yyyy-MM-dd HH:mm:ss"格式字符串进来,则自动转换为Date类型数据
@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm")
private Date createTime;
主键生成策略
通用策略
@GeneratedValue 注解介绍
-
通过 annotation 来映射 hibernate 实体,基于 annotation 的 hibernate 主键标识 @Id,由 @GeneratedValue 设定其生成规则。
-
@GeneratedValue 注解用于标注主键的生成策略,通过 strategy 属性指定。
默认情况下,JPA 自动选择一个最适合底层数据库的主键生成策略:
源码定义:
@Target({METHOD,FIELD})
@Retention(RUNTIME)
public @interface GeneratedValue{
GenerationType strategy() default AUTO;
String generator() default "";
}
其中GenerationType:
public enum GenerationType{
TABLE,
SEQUENCE,
IDENTITY,
AUTO
}
-
AUTO:JPA 自动选择合适的策略,是默认选项
AUTO、IDENTITY、SEQUENCE 策略
-
AUTO 策略
用法:
// 指定主键 @Id // 指定主键生成策略,默认为 AUTO @GeneratedValue(strategy = GenerationType.AUTO)
-
IDENTITY 策略
用法:
@Id @GeneratedValue(strategy = GenerationType.IDENTITY)
-
SEQUENCE 策略
用法:
// 使用示例 @Id @GeneratedValue(strategy = GenerationType.SEQUENCE, generator="aaa") @SequenceGenerator(name="aaa", sequenceName="seq_payment")
@SequenceGenerator 源码定义:
@Target({TYPE, METHOD, FIELD}) @Retention(RUNTIME) public @interface SequenceGenerator { String name(); String sequenceName() default ""; int initialValue() default 0; int allocationSize() default 50; }
-
initialValue 表示主键初识值,默认为0
TABLE 策略
-
用法示例:
@Id @GeneratedValue(strategy = GenerationType.TABLE, generator="pk_gen") @TableGenerator( name = "pk_gen", table="tb_generator", pkColumnName="gen_name", valueColumnName="gen_value", pkColumnValue="PAYABLEMOENY_PK", allocationSize=1 )
-
@TableGenerator 的源码定义
@Target({TYPE, METHOD, FIELD}) @Retention(RUNTIME) public @interface TableGenerator { String name(); String table() default ""; String catalog() default ""; String schema() default ""; String pkColumnName() default ""; String valueColumnName() default ""; String pkColumnValue() default ""; int initialValue() default 0; int allocationSize() default 50; UniqueConstraint[] uniqueConstraints() default {}; }
以上属性说明如下:
hibernate 策略
hibernate 提供多种主键生成策略,有点是类似于 JPA,基于 Annotation 的方式通过 @GenericGenerator 注解实现。
@GenericGenerator 注解介绍
源码定义:
@Target({PACKAGE, TYPE, METHOD, FIELD})
@Retention(RUNTIME)
public @interface GenericGenerator {
String name();
String strategy();
Parameter[] parameters() default {};
}
以上属性说明如下:
hibernate 特有策略
-
native:将主键的生成工作交由数据库完成,hibernate 不管(常用)
对于 oracle 采用 Sequence 方式,对于 MySQL 和 SQL Server 采用 identity(自增主键生成机制)
-
uuid:采用 128 位的 uuid 算法生成主键,uuid 被编码为一个 32 位 16 进制数字的字符串,占用空间大(字符串类型)
-
hilo:使用 hilo 生成策略,要在数据库中建立一张额外的表,默认表名为 hibernate_unique_key,默认字段为 integer 类型,名称是 next_hi(比较少用)
-
assigned:在插入数据的时候主键由程序处理(很常用),这是
<generator>
元素没有指定时的默认生成策略。等同于 JPA 中的 AUTO
-
identity:使用 SQL Server 和 MySQL 的自增字段
注意:这个方法不能放到 Oracle 中,Oracle 不支持自增字段,要设定sequence(MySQL 和 SQL Server 中很常用)
等同于 JPA 中的 INDENTITY
-
increment:插入数据的时候 hibernate 会给主键添加一个自增的主键,但是一个 hibernate 实例就维护一个计数器,所以在多个实例运行的时候不能使用这个方法
-
对应 MYSQL 的 uuid() 函数,SQL Server 的 newid() 函数,ORACLE 的rawtohex(sys_guid()) 函数等
-
sequence-identity:sequence 策略的扩展,采用立即检索策略来获取 sequence 值
注意:需要 JDBC3.0 和 JDK4 以上(含1.4)版本
使用示例:
// uuid
@GeneratedValue(generator = "paymentableGenerator")
@GenericGenerator(name = "paymentableGenerator", strategy = "uuid")
// 除以下所列特殊适配格式外,其他策略均采用上面第一种格式
// select
@GeneratedValue(generator = "paymentableGenerator")
@GenericGenerator(name="select", strategy="select",
parameters = { @Parameter(name = "key", value = "idstoerung") })
// sequence
@GeneratedValue(generator = "paymentableGenerator")
@GenericGenerator(name = "paymentableGenerator", strategy = "sequence",
parameters = { @Parameter(name = "sequence", value = "seq_payablemoney") })
// seqhilo
@GeneratedValue(generator = "paymentableGenerator")
@GenericGenerator(name = "paymentableGenerator", strategy = "seqhilo",
parameters = { @Parameter(name = "max_lo", value = "5") })
// foreign
@GeneratedValue(generator = "idGenerator")
@GenericGenerator(name = "idGenerator", strategy = "foreign",
parameters = { @Parameter(name = "property", value = "employee") })
// sequence-identity
@GeneratedValue(generator = "paymentableGenerator")
@GenericGenerator(name = "paymentableGenerator", strategy = "sequence-identity",
parameters = { @Parameter(name = "sequence", value = "seq_payablemoney") })
对于这些 hibernate 主键生成策略和各自的具体生成器之间的关系,在 org.hibernate.id.IdentifierGeneratorFactory 中指定了:
static {
GENERATORS.put("uuid", UUIDHexGenerator.class);
GENERATORS.put("hilo", TableHiLoGenerator.class);
GENERATORS.put("assigned", Assigned.class);
GENERATORS.put("identity", IdentityGenerator.class);
GENERATORS.put("select", SelectGenerator.class);
GENERATORS.put("sequence", SequenceGenerator.class);
GENERATORS.put("seqhilo", SequenceHiLoGenerator.class);
GENERATORS.put("increment", IncrementGenerator.class);
GENERATORS.put("foreign", ForeignGenerator.class);
GENERATORS.put("guid", GUIDGenerator.class);
GENERATORS.put("uuid.hex", UUIDHexGenerator.class); //uuid.hex is deprecated
GENERATORS.put("sequence-identity", SequenceIdentityGenerator.class);
}
// 上面十二种策略,加上native,hibernate一共默认支持十三种生成策略。
自定义策略
hibernate 每种主键生成策略提供接口 org.hibernate.id.IdentifierGenerator 的实现类,如果要实现自定义的主键生成策略也必须实现此接口。
IdentifierGenerator 提供一个 generate 方法,generate 方法返回产生的主键。
// 源码展示
public interface IdentifierGenerator {
public static final String ENTITY_NAME = "entity_name";
public Serializable generate(SessionImplementor session, Object object)
throws HibernateException;
}
自定义主键生成策略
-
方式2:自定义类继承 hibernate 的主键生成器类(间接实现了 IdentifierGenerator 接口)
示例:
import org.hibernate.HibernateException; import org.hibernate.MappingException; import org.hibernate.engine.spi.SharedSessionContractImplementor; import org.hibernate.id.UUIDHexGenerator; import org.hibernate.service.ServiceRegistry; import org.hibernate.type.Type; import java.io.Serializable; import java.util.Properties; /** * 自定义主键生成策略。实现自己设置ID,同时保留原来的主键生成策略(32位UUID)不变。 * 调用的保存方法需为Repository.save()或EntityManager.merge() * 若调用的保存方法为EntityManager.persist(),且传入对象有id值时,仍会报错! */ public class CustomUUIDGenerator extends UUIDHexGenerator { private String entityName; @Override public void configure(Type type, Properties params, ServiceRegistry serviceRegistry) throws MappingException { entityName = params.getProperty(ENTITY_NAME); if (entityName == null) { throw new MappingException("no entity name"); } super.configure(type, params, serviceRegistry); } @Override public Serializable generate(SharedSessionContractImplementor session, Object object) throws HibernateException { Serializable id = session.getEntityPersister(entityName, object).getIdentifier(object, session); if (id != null) { return id; } return super.generate(session, object); } }
Entity 实体类中使用
@GeneratedValue(generator = "paymentableGenerator") @GenericGenerator(name = "paymentableGenerator", strategy = "{自定义主键生成策略的全限定类名}") private String id;
Repository 相关注解
Repository 相关注解主要在 SpringDataJpa 的 Repository 中使用。
-
@Query:自定义 JPQL 或原生 Sql 查询,摆脱命名查询的约束
@Query("select u from User u where u.firstname = :firstname") // JPQL User findByLastnameOrFirstname(@Param("lastname") String lastname); @Query(value = "SELECT * FROM USERS WHERE X = ?1", nativeQuery = true) // 原生sql User findByEmailAddress(String X);
关于 @**Query **中参数的占位符:
-
@Modifying:DELETE 和 UPDATE 操作必须加上 @modifying 注解,以通知 Spring Data 这是一个 DELETE 或 UPDATE 操作
-
@NoRepositoryBean:避免 Spring 容器为此接口创建实例。
不被Service层直接用到的Repository(如base repository)均应加此声明
可用于定义公共 Repository,并将业务中用到的公共方法抽离到公共Repository中
@NoRepositoryBean public interface BaseRepository<T, ID> { @Modifying @Query("update #{#entityName} set isDelete='N' where id in ?1 ") Integer myUpdateAsNotDeleted(Collection<String> ids); }
原文地址:https://blog.csdn.net/footless_bird/article/details/129242569
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如若转载,请注明出处:http://www.7code.cn/show_43240.html
如若内容造成侵权/违法违规/事实不符,请联系代码007邮箱:suwngjj01@126.com进行投诉反馈,一经查实,立即删除!