JPQL

🔎 JPQL

JPQL(Java Persistence Query Language)은 JPA(Java Persistence API)에서 제공하는 객체 지향 쿼리 언어입니다. SQL과 유사하지만, 데이터베이스 테이블이 아닌 Java 엔티티 객체를 대상으로 쿼리를 작성합니다.

🏷️ 주요 특징

엔티티 객체를 대상으로 쿼리 작성
데이터베이스에 독립적인 쿼리 언어
JPA 구현체가 JPQL을 SQL로 변환하여 실행

🔎 EntityManager를 사용한 JPQL 쿼리

EntityManager는 JPA의 핵심 인터페이스로, JPQL 쿼리를 실행하는 데 사용됩니다.

@Test
public void testEmCreateQuery() {
    String qlString = "SELECT u FROM User u WHERE u.username = :username";

    User findUser = em.createQuery(qlString, User.class)
            .setParameter("username", "teasun")
            .getSingleResult();

    assertThat(findUser.getUsername()).isEqualTo("teasun");
}

🏷️ 특징

문자열로 쿼리를 직접 작성
setParameter()를 통한 파라미터 바인딩
타입 안정성이 부족하고 오타의 위험이 있음

🔎 @Query 어노테이션을 활용한 JPQL

Spring Data JPA에서는 @Query 어노테이션을 사용하여 리포지토리 메서드에 직접 JPQL을 정의할 수 있습니다.

public interface UserRepository extends JpaRepository<User, Long> {

    @Query("SELECT u FROM User u WHERE u.username = :username")
    List<User> findByUsername(@Param("username") String username);

    @Query("SELECT u FROM User u WHERE u.username = ?1")
    List<User> findByUsernamePositional(String username);
}

🏷️ 특징:

메서드 시그니처와 쿼리를 함께 정의
이름 기반 또는 위치 기반 파라미터 바인딩 지원
컴파일 시점에 기본적인 문법 오류 검출 가능

🔎 JPQL의 장단점

🏷️ 장점

객체 지향적인 쿼리 작성 가능
데이터베이스에 독립적인 쿼리 작성
복잡한 조인, 서브쿼리 등 고급 쿼리 기능 지원

🏷️ 단점

문자열 기반 쿼리로 인한 타입 안정성 부족
런타임 시점에 오류 발견
IDE의 자동 완성 지원이 제한적

🔎 주의사항

상수 사용: 반복되는 JPQL 문자열은 상수로 정의하여 관리

public class JPQLConstants {
    public static final String FIND_BY_USERNAME = "SELECT u FROM User u WHERE u.username = :username";
}

네임드 쿼리 활용: 자주 사용되는 쿼리는 엔티티 클래스에 @NamedQuery로 정의

@Entity
@NamedQuery(name = "User.findByUsername", query = "SELECT u FROM User u WHERE u.username = :username")
public class User { ... }

파라미터 바인딩 사용: SQL 인젝션 방지를 위해 항상 파라미터 바인딩 사용

테스트 작성: JPQL 쿼리에 대한 단위 테스트를 작성하여 오류 조기 발견

QueryDSL 고려: 대규모 프로젝트에서는 타입 안전한 QueryDSL 사용 검토