在企业级Java开发中，JPA作为持久层标准规范，解决了不同ORM框架实现差异带来的兼容性问题，而SQL语言作为关系型数据库的标准查询语言，二者结合可以让数据操作兼顾灵活性与规范性。下面我们就详细讲解SQL语言通过JPA规范操作的具体实践。
JPA规范与SQL的基础关联
JPA全称Java Persistence API，是Java EE提供的持久层标准规范，本身不提供具体实现，常见的Hibernate、EclipseLink都是JPA规范的实现框架。JPA定义了实体映射、持久化操作、查询等标准接口，而SQL语言是操作关系型数据库的基础，JPA规范中天然支持通过标准接口执行SQL语句，不需要依赖特定框架的私有API。
在使用JPA操作SQL之前，我们需要先完成基础的实体映射配置，比如下面这个用户实体的示例：
import javax.persistence.*;
@Entity
@Table(name = "t_user") // 对应数据库中的t_user表
public class User {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
@Column(name = "user_name")
private String userName;
@Column(name = "age")
private Integer age;
// 省略getter和setter方法
}通过JPA执行原生SQL的两种方式
使用EntityManager执行原生SQL
EntityManager是JPA规范中的核心接口，提供了直接执行原生SQL的方法，适合需要编写复杂SQL或者不便于用JPQL实现的场景。
执行原生查询的示例代码如下：
import javax.persistence.EntityManager;
import javax.persistence.PersistenceContext;
import javax.persistence.Query;
import java.util.List;
public class UserDao {
@PersistenceContext
private EntityManager entityManager;
// 执行原生SQL查询，返回对象数组列表
public List<Object[]> queryUserByAge(int age) {
String sql = "SELECT id, user_name, age FROM t_user WHERE age > ?";
Query query = entityManager.createNativeQuery(sql);
// 设置第一个参数，索引从1开始
query.setParameter(1, age);
return query.getResultList();
}
// 执行原生SQL更新操作
public int updateUserAge(Long userId, int newAge) {
String sql = "UPDATE t_user SET age = ? WHERE id = ?";
Query query = entityManager.createNativeQuery(sql);
query.setParameter(1, newAge);
query.setParameter(2, userId);
return query.executeUpdate();
}
}使用@NamedNativeQuery注解定义原生SQL
如果某些SQL语句需要重复使用，可以通过@NamedNativeQuery注解在实体类上预定义，后续直接通过名称调用，符合JPA的规范化使用习惯。
import javax.persistence.*;
@Entity
@Table(name = "t_user")
@NamedNativeQueries({
@NamedNativeQuery(
name = "User.queryByAgeRange",
query = "SELECT id, user_name, age FROM t_user WHERE age BETWEEN ?1 AND ?2",
resultSetMapping = "userAgeRangeMapping"
),
@NamedNativeQuery(
name = "User.updateUserStatus",
query = "UPDATE t_user SET status = ?1 WHERE id = ?2"
)
})
@SqlResultSetMappings({
@SqlResultSetMapping(
name = "userAgeRangeMapping",
columns = {
@ColumnResult(name = "id"),
@ColumnResult(name = "user_name"),
@ColumnResult(name = "age")
}
)
})
public class User {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
@Column(name = "user_name")
private String userName;
@Column(name = "age")
private Integer age;
@Column(name = "status")
private Integer status;
// 省略getter和setter方法
}调用预定义的原生SQL查询的代码如下：
import javax.persistence.EntityManager;
import javax.persistence.PersistenceContext;
import javax.persistence.Query;
import java.util.List;
public class UserDao {
@PersistenceContext
private EntityManager entityManager;
public List<Object[]> queryByAgeRange(int minAge, int maxAge) {
Query query = entityManager.createNamedQuery("User.queryByAgeRange");
query.setParameter(1, minAge);
query.setParameter(2, maxAge);
return query.getResultList();
}
public int updateStatus(Long userId, int status) {
Query query = entityManager.createNamedQuery("User.updateUserStatus");
query.setParameter(1, status);
query.setParameter(2, userId);
return query.executeUpdate();
}
}JPA规范下SQL操作的注意事项
- 参数索引从1开始，和JDBC的PreparedStatement的参数索引规则一致，不要使用0作为起始索引。
- 原生SQL查询结果默认返回
Object[]数组或者数值列表，如果需要映射到实体类，可以在createNativeQuery方法中传入实体类class，例如entityManager.createNativeQuery(sql, User.class)。 - 执行更新、删除类的SQL时，需要确保在事务上下文中运行，否则会抛出事务相关的异常。
- 如果需要拼接动态SQL，要注意避免SQL注入问题，尽量使用参数绑定的方式而不是字符串拼接。
不同场景下SQL与JPQL的选择
JPA规范也支持JPQL（Java Persistence Query Language），它是面向对象的查询语言，不需要直接写数据库表名和字段名，而是操作实体和实体属性。我们可以通过下面这个表格对比两者的适用场景：
| 对比项 | 原生SQL | JPQL |
|---|---|---|
| 适用场景 | 复杂多表关联、数据库特有函数调用、性能优化场景 | 简单的CRUD操作、面向实体的查询场景 |
| 数据库兼容性 | 依赖特定数据库语法，移植性差 | 符合JPA规范，不依赖数据库，移植性好 |
| 面向对象特性 | 面向关系型表结构，无面向对象特性 | 面向实体对象，支持面向对象查询语法 |
在实际开发中，建议优先使用JPQL满足常规查询需求，当遇到JPQL无法实现或者性能达不到要求的场景时，再使用JPA规范提供的原生SQL接口，这样既保证了代码的规范性，又能满足复杂场景的需求。