[LG U+ 유레카 3기]순수JPA 실습 — JPQL (Java Persistence Query Language)

🧩 JPA 실습 ⑤ — JPQL (Java Persistence Query Language)

이번 실습에서는 JPQL의 기본 개념과 Typed Query, 파라미터 바인딩을 학습했다.
JPQL은 SQL처럼 보이지만, 실제로는 엔티티 객체를 기준으로 질의하는 객체지향 쿼리 언어다.
즉, “테이블명”이 아닌 “엔티티 클래스명(Book)”과 “컬럼명”이 아닌 “필드명(bookname, price)”으로 작성된다.

---

❶ 프로젝트 폴더 구조

JPABasic_JPQL
 ├─ src/main/java/
 │   ├─ entity/
 │   │   └─ Book.java
 │   └─ Test.java
 │
 ├─ src/main/resources/
 │   └─ META-INF/
 │       └─ persistence.xml
 │
 └─ pom.xml

➡️ 순수 JPA + Hibernate 환경에서 작성되었으며, 별도의 Spring 설정 없이 EntityManagerFactory를 직접 생성했다.

---

❷ persistence.xml 설정

<?xml version="1.0" encoding="UTF-8"?>
<persistence xmlns="https://jakarta.ee/xml/ns/persistence"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             version="3.0"
             xsi:schemaLocation="https://jakarta.ee/xml/ns/persistence
             https://jakarta.ee/xml/ns/persistence/persistence_3_0.xsd">

  <persistence-unit name="my-pu">
      <class>entity.Book</class>
      <properties>
          <property name="jakarta.persistence.jdbc.driver" value="com.mysql.cj.jdbc.Driver"/>
          <property name="jakarta.persistence.jdbc.url" value="jdbc:mysql://localhost:3306/jpql_basic"/>
          <property name="jakarta.persistence.jdbc.user" value="root"/>
          <property name="jakarta.persistence.jdbc.password" value="1234"/>
          <property name="hibernate.dialect" value="org.hibernate.dialect.MySQL8Dialect"/>
          <property name="hibernate.hbm2ddl.auto" value="update"/>
          <property name="hibernate.show_sql" value="true"/>
      </properties>
  </persistence-unit>
</persistence>

📌 hbm2ddl.auto = update → 테이블이 없으면 자동 생성, 필드 변경 시 alter
📌 show_sql = true → 실행되는 JPQL → SQL 변환 로그 출력

---

❸ 엔티티 클래스 — Book.java

package entity;

import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.Table;

@Entity
@Table(name="book")
public class Book {

    @Id
    private int bookid;
    private String bookname;
    private String publisher;
    private int price;

    public int getBookid() { return bookid; }
    public void setBookid(int bookid) { this.bookid = bookid; }

    public String getBookname() { return bookname; }
    public void setBookname(String bookname) { this.bookname = bookname; }

    public String getPublisher() { return publisher; }
    public void setPublisher(String publisher) { this.publisher = publisher; }

    public int getPrice() { return price; }
    public void setPrice(int price) { this.price = price; }

    @Override
    public String toString() {
        return "Book [bookid=" + bookid + ", bookname=" + bookname +
                ", publisher=" + publisher + ", price=" + price + "]";
    }
}

✅ Book 엔티티는 테이블 “book”과 매핑되며, 각 필드는 컬럼(bookid, bookname, publisher, price)에 매핑된다.
이제 JPQL은 이 Book 객체를 대상으로 조회를 수행한다.

---

❹ JPQL 기본 쿼리 — 전체 조회

import jakarta.persistence.*;
import java.util.List;

public class Test {
    public static void main(String[] args) {
        EntityManagerFactory emf =
                Persistence.createEntityManagerFactory("my-pu");
        EntityManager em = emf.createEntityManager();

        // Typed Query
        String jpql = "select b from Book b"; // 테이블이 아닌 Book 엔티티 기준
        TypedQuery<Book> query = em.createQuery(jpql, Book.class);
        List<Book> bookList = query.getResultList();

        for (Book book : bookList) {
            System.out.println(book);
        }

        em.close();
    }
}

✅ 실행 결과 (콘솔)

Book [bookid=1, bookname=축구의 역사, publisher=굿스포츠, price=7000]
Book [bookid=2, bookname=축구를 아는 여자, publisher=나무수, price=13000]
Book [bookid=3, bookname=축구의 이해, publisher=대한미디어, price=22000]
Book [bookid=4, bookname=골프 바이블, publisher=대한미디어, price=35000]
Book [bookid=5, bookname=피겨 교본, publisher=굿스포츠, price=8000]
...

- JPQL의 select b from Book b는 SQL로 변환 시 select * from book 형태로 실행된다.
- Book은 클래스명이며, b는 엔티티의 별칭(alias)이다.

---

❺ JPQL + 위치 파라미터 (Positional Parameter)

String jpql = "select b from Book b where b.price > ?1";
TypedQuery<Book> query = em.createQuery(jpql, Book.class);
query.setParameter(1, 15000); // ?1 → 15000으로 치환
List<Book> bookList = query.getResultList();

for (Book book : bookList) {
    System.out.println(book);
}

✅ 실행 SQL

Hibernate: select b1_0.bookid,b1_0.bookname,b1_0.price,b1_0.publisher
from Book b1_0 where b1_0.price>?

✅ 결과 (price > 15000)

Book [bookid=3, bookname=축구의 이해, publisher=대한미디어, price=22000]
Book [bookid=4, bookname=골프 바이블, publisher=대한미디어, price=35000]
Book [bookid=7, bookname=야구의 추억, publisher=이상미디어, price=20000]

- ?1은 첫 번째 파라미터를 의미한다.
- setParameter(1, 15000) 형태로 값을 바인딩한다.
- SQL Injection 위험 없이 안전하게 조건 처리 가능하다.

---

❻ JPQL + 이름 파라미터 (Named Parameter)

String jpql = "select b from Book b where b.price > :price";
TypedQuery<Book> query = em.createQuery(jpql, Book.class);
query.setParameter("price", 15000);
List<Book> bookList = query.getResultList();

for (Book book : bookList) {
    System.out.println(book);
}

✅ 실행 결과

Hibernate: select b1_0.bookid,b1_0.bookname,b1_0.price,b1_0.publisher
from Book b1_0 where b1_0.price>?
Book [bookid=3, bookname=축구의 이해, publisher=대한미디어, price=22000]
Book [bookid=4, bookname=골프 바이블, publisher=대한미디어, price=35000]
Book [bookid=7, bookname=야구의 추억, publisher=이상미디어, price=20000]

- :price 형태로 선언 후, setParameter("price", 15000)로 값 전달.
- 위치 파라미터보다 가독성이 좋고 유지보수가 용이하다.

---

❼ JPQL vs SQL 비교

구분	JPQL	SQL
대상	엔티티 클래스	테이블
필드 참조	엔티티의 필드명	컬럼명
예시	select b from Book b where b.price > 10000	select * from book where price > 10000
결과	Book 객체 리스트	ResultSet (row 기반)

---

❽ 핵심 요약

• JPQL은 SQL이 아니라 엔티티 객체 중심의 쿼리 언어이다.
• TypedQuery<T>를 사용해 타입 안전한 결과를 받을 수 있다.
• setParameter()로 파라미터 바인딩을 통해 조건을 동적으로 처리한다.
• 결과는 엔티티 객체(Book)로 반환되어, 자바 컬렉션(List)으로 다룰 수 있다.

---

❾ 실습 정리

종류	예시	특징
기본 조회	select b from Book b	엔티티 전체 조회
위치 파라미터	?1, ?2	순서 기반 바인딩
이름 파라미터	:price	이름 기반 바인딩 (가독성↑)
결과	List<Book>	엔티티 객체 리스트 반환

---

❿ 한 줄 요약

JPQL은 “테이블 중심 SQL”이 아니라 “엔티티 중심 쿼리 언어”이다.
SQL이 데이터를 가져온다면, JPQL은 객체를 가져온다.