[Spring] 동적쿼리(JPQL)

Yuri·2025년 2월 14일

목록 보기

15/21

🔫 페이징을 구현하며 겪은 문제점과 해결방법, 새로 알게된 점을 기록합니다.

JPQL

Java Persistence Query Language
JPA(Java Persistence API) 에서 사용하는 객체 지향 쿼리 언어
객체 모델을 대상으로 쿼리를 작성한다.
즉, 데이터베이스의 테이블이 아닌 JPA 엔티티를 기반으로 쿼리를 작성하는 방식

특징

객체 지향적
SQL이 테이블과 컬럼을 대상으로 하는 것과 달리, JPQL은 엔티티 클래스와 필드를 대상으로 쿼리를 작성
엔티티 클래스 기준
쿼리에서 사용하는 FROM 절이나 WHERE 절에 등장하는 것은 데이터베이스 테이블이 아니라, JPA 엔티티이다.
실행 시 자동 매핑
JPQL은 SQL 처럼 데이터베이스와 상호작용하지만, 결과는 엔티티 객체로 반환된다
동적 쿼리 작성
문자열로 쿼리를 작성하는 방식이므로, 동적 쿼리를 쉽게 작성할 수 있다. 사용자가 입력한 검색 조건에 맞게 WHERE 절을 동적으로 추가하는 방식으로 쿼리를 변경

기본문법

SELECT

SELECT e FROM Employee e

WHERE

SELECT e FROM Employee e WHERE e.name = :name

AND, OR 조건

SELECT e FROM Employee e WHERE e.name = :name AND e.age = :age

LIKE 연산자

SELECT e FROM Employee e WHERE e.name LIKE %:name%

ORDER BY 절

SELECT e FROM Employee e ORDER BY e.age DESC

JOIN

SELECT e FROM Employee e JOIN e.department d WHERE d.name = :departmentName

@Query

Spring Data JPA에서는 @Query 어노테이션을 사용해 JPQL 쿼리를 직접 작성

public interface EmployeeRepository extends JpaRepository<Employee, Long> {

    @Query("SELECT e FROM Employee e WHERE e.name = :name")
    List<Employee> findByName(@Param("name") String name);
}