📌 JPQL이란?

📅 날짜

2025년 5월 7일

📝 학습 내용

1️⃣ JPQL(Java Persistence Query Language) 개념

• JPA에서 객체 지향적으로 데이터를 조회하기 위한 쿼리 언어
• SQL과 유사하지만, 테이블이 아닌 엔티티 객체(Entity) 를 대상으로 함
• ex) SELECT u FROM User u ← User는 실제 테이블이 아니라 엔티티 클래스 이름
• DB에 종속되지 않고, JPA 구현체(Hibernate 등) 가 SQL로 변환해 실행

---

2️⃣ UserRepository에서 JPQL 사용 예제

@Repository
public interface UserRepository extends JpaRepository<User, String> {

    /**
     * 역할(role)에 해당하는 사용자 목록 조회
     */
    @Query("SELECT u FROM User AS u WHERE u.role=?1")
    List<User> selectByRole(String role);

    /**
     * 역할과 비밀번호가 모두 일치하는 사용자 조회
     * ⚠️ 보안상 비밀번호는 일반 텍스트로 비교하지 않도록 주의!
     */
    @Query("SELECT u FROM User AS u WHERE u.role=?1 and u.password=?2")
    List<User> selectByRoleAndPassword(String role, String password);

    /**
     * 비밀번호가 일치하는 사용자 조회
     * ⚠️ 실제 서비스에서는 사용하지 않도록 주의
     */
    @Query("SELECT u FROM User AS u WHERE u.password=:password")
    List<User> selectByPassword(@Param("password") String pw);

    /**
     * 사용자 이름에 특정 키워드가 포함된 사용자 목록 조회
     * ⚠️ LIKE 사용 시 와일드카드 처리 주의
     */
    @Query("SELECT u FROM User u WHERE u.username LIKE CONCAT('%',:username,'%')")
    List<User> selectAllLikeUsername(@Param("username") String username);
}

---

3️⃣ 테스트 코드 예시

@Test
public void t2() throws Exception {
    // 사용자 이름에 '1'이 포함된 사용자 검색
    List<User> list = userRepository.selectAllLikeUsername("1");
    list.stream().forEach(System.out::println);
}

🔹 출력 예시 (데이터 예시 기준)

User(username=user1, role=ROLE_USER)
User(username=admin1, role=ROLE_ADMIN)

---

🔥 정리

• JPQL은 객체(Entity)를 대상으로 작성하는 쿼리 언어
• @Query 를 사용해 커스텀 JPQL 쿼리를 작성할 수 있음
• ?1, ?2: 위치 기반 파라미터 / :param: 네임드 파라미터
• LIKE, CONCAT 등을 통해 부분 검색 구현 가능
• 민감한 필드(비밀번호 등)는 직접 조회 지양, 암호화된 비교 필요

---

🔗 참고 자료

• 📘 Spring Data JPA Reference
• 📘 Baeldung - JPQL Queries

---

느낀 점

• JPQL은 객체 중심의 쿼리를 작성할 수 있어 코드와 DB 간의 추상화가 자연스러움
• 네임드 파라미터가 가독성이 좋아 실무에 적합하다고 느낌
• 실제 서비스에서는 보안 이슈(비밀번호, LIKE 등)에 각별한 주의 필요

---