深入理解JPA注解：从基础到高级

最新推荐文章于 2025-06-13 17:46:38 发布
最新推荐文章于 2025-06-13 17:46:38 发布
阅读量1.2k 收藏 8
点赞数 24
CC 4.0 BY-SA版权
文章标签： oracle 数据库
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/xycxycooo/article/details/141068270

深入理解JPA注解：从基础到高级

Java Persistence API（JPA）是Java EE标准的一部分，用于对象关系映射（ORM），使得开发者可以用面向对象的方式操作数据库。JPA通过注解（Annotation）简化了数据库表和Java对象之间的映射，提高了开发效率。本文将详细介绍JPA注解的使用，从基础注解到高级应用，帮助读者全面掌握JPA的强大功能。

1. JPA简介

JPA是Java EE 5规范中引入的一种ORM技术，旨在简化Java应用程序与关系型数据库之间的交互。JPA提供了一套标准的API和注解，使得开发者可以专注于业务逻辑，而不必过多关注底层数据库操作。

2. 基础注解

2.1 @Entity

@Entity注解用于标记一个类为JPA实体，表示该类对应数据库中的一张表。

import javax.persistence.Entity;
import javax.persistence.Id;

@Entity
public class User {
    @Id
    private Long id;
    private String username;
    private String email;

    // Getters and Setters
}

2.2 @Table

@Table注解用于指定实体类对应的数据库表名，以及其他表相关的属性。

import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.Table;

@Entity
@Table(name = "users")
public class User {
    @Id
    private Long id;
    private String username;
    private String email;

    // Getters and Setters
}

2.3 @Id

@Id注解用于标记实体类的主键字段。

import javax.persistence.Entity;
import javax.persistence.Id;

@Entity
public class User {
    @Id
    private Long id;
    private String username;
    private String email;

    // Getters and Setters
}

2.4 @GeneratedValue

@GeneratedValue注解用于指定主键的生成策略，常见的有IDENTITY、SEQUENCE和TABLE。

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String username;
    private String email;

    // Getters and Setters
}

2.5 @Column

@Column注解用于指定字段与数据库列的映射关系，包括列名、长度、是否允许为空等属性。

import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.Column;

@Entity
public class User {
    @Id
    private Long id;

    @Column(name = "user_name", length = 50, nullable = false)
    private String username;

    @Column(name = "user_email", length = 100, nullable = false)
    private String email;

    // Getters and Setters
}

2.6 @Transient

@Transient注解用于标记一个字段不被持久化，即不映射到数据库表中的任何列。

import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.Transient;

@Entity
public class User {
    @Id
    private Long id;
    private String username;
    private String email;

    @Transient
    private String tempField;

    // Getters and Setters
}

3. 高级注解

3.1 @OneToOne

@OneToOne注解用于定义一对一关系，表示一个实体与另一个实体之间的一对一关联。

import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.OneToOne;

@Entity
public class User {
    @Id
    private Long id;
    private String username;
    private String email;

    @OneToOne
    private Address address;

    // Getters and Setters
}

@Entity
public class Address {
    @Id
    private Long id;
    private String street;
    private String city;

    // Getters and Setters
}

3.2 @OneToMany

@OneToMany注解用于定义一对多关系，表示一个实体与多个其他实体之间的关联。

import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.OneToMany;
import java.util.List;

@Entity
public class User {
    @Id
    private Long id;
    private String username;
    private String email;

    @OneToMany(mappedBy = "user")
    private List<Order> orders;

    // Getters and Setters
}

@Entity
public class Order {
    @Id
    private Long id;
    private String orderNumber;

    @ManyToOne
    private User user;

    // Getters and Setters
}

3.3 @ManyToOne

@ManyToOne注解用于定义多对一关系，表示多个实体与一个实体之间的关联。

import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.ManyToOne;

@Entity
public class Order {
    @Id
    private Long id;
    private String orderNumber;

    @ManyToOne
    private User user;

    // Getters and Setters
}

@Entity
public class User {
    @Id
    private Long id;
    private String username;
    private String email;

    // Getters and Setters
}

3.4 @ManyToMany

@ManyToMany注解用于定义多对多关系，表示多个实体与多个其他实体之间的关联。

import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.ManyToMany;
import java.util.Set;

@Entity
public class User {
    @Id
    private Long id;
    private String username;
    private String email;

    @ManyToMany
    private Set<Role> roles;

    // Getters and Setters
}

@Entity
public class Role {
    @Id
    private Long id;
    private String name;

    @ManyToMany(mappedBy = "roles")
    private Set<User> users;

    // Getters and Setters
}

3.5 @JoinColumn

@JoinColumn注解用于指定外键列的名称和其他属性。

import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.JoinColumn;
import javax.persistence.ManyToOne;

@Entity
public class Order {
    @Id
    private Long id;
    private String orderNumber;

    @ManyToOne
    @JoinColumn(name = "user_id")
    private User user;

    // Getters and Setters
}

3.6 @JoinTable

@JoinTable注解用于定义多对多关系中的连接表，包括连接表的名称、外键列等属性。

import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.JoinTable;
import javax.persistence.ManyToMany;
import javax.persistence.JoinColumn;
import java.util.Set;

@Entity
public class User {
    @Id
    private Long id;
    private String username;
    private String email;

    @ManyToMany
    @JoinTable(
        name = "user_role",
        joinColumns = @JoinColumn(name = "user_id"),
        inverseJoinColumns = @JoinColumn(name = "role_id")
    )
    private Set<Role> roles;

    // Getters and Setters
}

@Entity
public class Role {
    @Id
    private Long id;
    private String name;

    @ManyToMany(mappedBy = "roles")
    private Set<User> users;

    // Getters and Setters
}

4. 继承和复合主键

4.1 继承

JPA支持实体类的继承，可以通过@Inheritance注解指定继承策略。

import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.Inheritance;
import javax.persistence.InheritanceType;

@Entity
@Inheritance(strategy = InheritanceType.SINGLE_TABLE)
public class Person {
    @Id
    private Long id;
    private String name;

    // Getters and Setters
}

@Entity
public class Employee extends Person {
    private String employeeId;

    // Getters and Setters
}

4.2 复合主键

JPA支持复合主键，可以通过@Embeddable和@EmbeddedId注解实现。

import javax.persistence.Entity;
import javax.persistence.EmbeddedId;
import javax.persistence.Embeddable;
import java.io.Serializable;

@Entity
public class Employee {
    @EmbeddedId
    private EmployeeId id;
    private String name;

    // Getters and Setters
}

@Embeddable
public class EmployeeId implements Serializable {
    private String departmentCode;
    private String employeeCode;

    // Getters and Setters
}

5. 高级特性

5.1 生命周期回调

JPA提供了生命周期回调注解，如@PrePersist、@PostPersist、@PreUpdate、@PostUpdate、@PreRemove和@PostRemove，用于在实体生命周期的特定阶段执行自定义逻辑。

import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.PrePersist;
import javax.persistence.PreUpdate;
import java.util.Date;

@Entity
public class User {
    @Id
    private Long id;
    private String username;
    private String email;
    private Date createdAt;
    private Date updatedAt;

    @PrePersist
    public void prePersist() {
        createdAt = new Date();
    }

    @PreUpdate
    public void preUpdate() {
        updatedAt = new Date();
    }

    // Getters and Setters
}

5.2 自定义类型映射

JPA支持自定义类型映射，可以通过@Converter注解实现。

import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.Convert;
import javax.persistence.AttributeConverter;
import javax.persistence.Converter;

@Entity
public class User {
    @Id
    private Long id;
    private String username;
    private String email;

    @Convert(converter = BooleanToStringConverter.class)
    private boolean active;

    // Getters and Setters
}

@Converter
public class BooleanToStringConverter implements AttributeConverter<Boolean, String> {
    @Override
    public String convertToDatabaseColumn(Boolean attribute) {
        return attribute ? "Y" : "N";
    }

    @Override
    public Boolean convertToEntityAttribute(String dbData) {
        return "Y".equals(dbData);
    }
}

5.3 二级缓存

JPA支持二级缓存，可以通过@Cacheable注解启用实体的二级缓存。

import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.Cacheable;

@Entity
@Cacheable
public class User {
    @Id
    private Long id;
    private String username;
    private String email;

    // Getters and Setters
}

6. 总结

JPA注解是Java开发者进行ORM的重要工具，通过本文的介绍，读者可以全面了解JPA注解的使用，从基础的实体映射到高级的关系映射、继承、复合主键、生命周期回调、自定义类型映射和二级缓存等特性。掌握这些注解，将大大提高开发效率，使开发者能够更加专注于业务逻辑的实现。希望本文能帮助读者更好地理解和应用JPA注解，提升Java开发技能。

jpa注解详解
10-09
java开发的JPA 批注总结参考资料，内容非常详细，非常丰富。
JPA深入浅出
09-10
该文档描述了JPA的来世今生，由浅入深地讲述了JPA概要、实体定义和基本注解、开发流程、JPA API和JPQL语言。将每个涉及到的细节讲得清晰、全面，可以作为学习JPA的指导文档！
Hibernate 注解
Narnia08的专栏
04-09 468
1、@Entity(name="EntityName") 必须,name为可选,对应数据库中一的个表 2、@Table(name="",catalog="",schema="") 可选,通常和@Entity配合使用,只能标注在实体的class定义处,表示实体对应的数据库表的信息 name:可选,表示表的名称.默认地,表名和实体名称一致,只有在不一致的情况下才需要指...
JPA全面指南：使用步骤、语法详解与实战案例
最新发布
m0_66884848的博客
06-13 1155
Java Persistence API（JPA）是Java EE和Java SE平台上的ORM（对象关系映射）标准规范，它简化了Java应用程序与数据库的交互过程。JPA不是具体的实现，而是一套接口规范，常见的实现框架有Hibernate、EclipseLink等。
JPA常用注解
热门推荐
在你最感兴趣的事物上，隐藏着你人生的秘密
03-20 4万+
JPA全称Java Persistence API.JPA通过JDK 5.0注解或XML描述对象－关系表的映射关系，并将运行期的实体对象持久化到数据库中。         JPA由EJB 3.0软件专家组开发，作为JSR-220实现的一部分。但它不囿于EJB 3.0，你可以在Web应用、甚至桌面应用中使用。JPA的宗旨是为POJO提供持久化标准规范.         JPA的总体思想和现有Hi
JPA注解
log_cd的专栏
12-08 297
1、@Entity(name="EntityName")      必须,name为可选,对应数据库中一的个表 2、@Table(name="",catalog="",schema="")      可选,通常和@Entity配合使用,只能标注在实体的class定义处,表示实体对应的数据库表的信息 name:可选,表示表的名称.默认地,表名和实体名称一致,只有在不一致的情况下才需要指定表名 cat...
JPA详解
系统运维
09-23 494
1.1 01、全面阐释和精彩总结JPA 1.2 02、JPA开发环境和思想介绍 1.3 03、搭建JPA开发环境和全局事务介绍 1.4 04、第一个JPA实例与JPA主键生成策略 1.5 05、日期_枚举等字段类型的JPA映射 1.6 06、大数据字段映射与字段延迟加载 1.7 07、使用JPA加载_更新_删除对象 1.8 08、分析JPA与持久化实现产品对接的源代码 1.9 ...
深入理解JPA：从基础到高级实战
笔记深入浅出地介绍了JPA在Java应用中的作用和使用方式，对于理解JPA如何进行对象关系映射以及执行数据库查询非常有帮助。" 一、JPA基础 JPA（Java Persistence API）是Java平台上的ORM（对象关系映射）规范，允许...
深入理解JPA：从基础到实践
JPA 还支持继承（单表继承、联合继承和多表继承）、嵌入式对象（使用`@Embeddable`和`@Embedded`注解）以及其他高级特性，如转换、事件监听等。 JPA 为Java开发者提供了统一、便捷的ORM解决方案，使得数据库操作变...
深入理解Spring Boot：从基础到高级特性
在本教程中，我们将通过构建一个简单的RESTful API开始，逐步深入了解Spring Boot的各项高级特性和最佳实践。 **快速入门** 快速入门部分介绍了如何使用IntelliJ的Spring Initializr工具来构建基于Spring Boot的...
深入理解JPA教程：TOPLink、Hibernate与Open JPA
### JPA概述 ...这些内容对于希望深入理解并应用JPA进行数据库操作的Java开发者而言，是非常宝贵的资源。掌握JPA，能够有效地提高开发效率，使得开发团队能够更快速地对数据库进行操作，并优化应用性能。
深入理解JPA源码：EJB实体Bean解析
从文件名称列表中，我们可以推断出这些源码文件是按照一定的顺序或者项目结构进行组织的，可能是从一个基础的JPA设置和配置开始，逐步深入到实体Bean的定义、生命周期管理、事务处理、查询优化等高级话题。...
深入了解 JPA
xqhrs232的专栏
11-08 403
原文地址::https://blog.youkuaiyun.com/xiang__liu/article/details/80805967 相关文章 1、JPA百度百科----https://baike.baidu.com/item/JPA/5660672?fr=aladdin 2、JPA 语法和demo----https://blog.youkuaiyun.com/yang0597/article/details...
JPA 注解的几个要点
向北航行
01-27 597
1.设置Pojo为实体@Entity //标识这个pojo是一个jpa实体     public class Users implements Serializable {     }    2.设置表名@Entity     @Table
JPA基本注解
huzelong0的博客
10-08 983
JPA之常用 基本注解 1、常用基本注解 @Entity @Table @Basic @Column @GeneratedValue @Id 2、特殊注解 @Transient @Temporal 用 table 来生成主键 3、常用注解的使用 1、@Entity 标注用于实体类声明语句之前，指出该Java 类为实体类，将映射到指定的数据库表。如声明一个实体类 Customer，它将映射到数据库中...
SpringData JPA详解
shensuqiao的专栏
08-17 416
Spring Data JPA 1.    概述 Spring JPA通过为用户统一创建和销毁EntityManager，进行事务管理，简化JPA的配置等使用户的开发更加简便。 Spring Data JPA是在Spring JPA的基础上，对持久层做了简化。用户只需声明持久层的接口，不需要实现该接口。Spring Data JPA内部会根据不同的策略、通过不同的方法创建Query操...
JPA 注解详解
h624536203的博客
03-12 576
废话不多说，直接上干货 @Entity 所在包 javax.persistence.Entity 用法：标注于实体类声明类名前 指出该类为实体类 @Table 所在包 同上 用法：1.当实体类与映射的数据库名不一致时，使用其进行标注说明 @Table(name=”alias_name”) 2.可选项catalog和schema用于设置所属数据库的目录和模式，通常为数据库名 3.u...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

需要重新演唱

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值