JPA 쿼리 작성 방법에는 어떤 것들이 있나요?

[daumi125]

✅ JPA 쿼리 작성 방법 정리

---

📘 1. JPQL (Java Persistence Query Language)

String jpql = "SELECT m FROM Member m WHERE m.age > :age";
List<Member> result = em.createQuery(jpql, Member.class)
                        .setParameter("age", 20)
                        .getResultList();

• Member는 엔티티 이름 기준 (테이블 아님)
• SQL 유사하지만 객체(Entity) 기준임

---

📘 2. Criteria API (JPA 표준, 자바 코드 기반)

CriteriaBuilder cb = em.getCriteriaBuilder();
CriteriaQuery<Member> cq = cb.createQuery(Member.class);
Root<Member> m = cq.from(Member.class);
cq.select(m).where(cb.equal(m.get("name"), "다음"));
List<Member> result = em.createQuery(cq).getResultList();

• 복잡하지만 동적 쿼리 가능
• 코드가 너무 길고 읽기 어려움 → 거의 안 씀

---

📘 3. Native SQL (순수 SQL)

List<Member> result = em.createNativeQuery("SELECT * FROM member", Member.class)
                        .getResultList();

• DB 종속성 있음
• 성능 튜닝, 복잡한 조인, DB 함수 등 필요할 때 사용

---

📘 4. Spring Data JPA + @query

@Query("SELECT m FROM Member m WHERE m.name = :name")
List<Member> findByName(@Param("name") String name);

• 간단한 쿼리 빠르게 작성 가능
• nativeQuery = true로 SQL도 작성 가능

---

📘 5. QueryDSL (가장 선호되는 방식)

JPAQueryFactory query = new JPAQueryFactory(em);
QMember m = QMember.member;
List<Member> result = query

.selectFrom(m)

.where(m.age.gt(20))

.fetch();

• 자바 코드 기반 DSL, 자동완성 & 컴파일 오류 탐지 가능
• 복잡한 조건이나 동적 쿼리에 매우 강력

[daumi125]

✅ 왜 JPA 자동 쿼리만으로는 부족한가?

1. 복잡한 조건 처리 불가

• 자동 쿼리는 AND, OR 정도까지만 표현 가능
• 복잡한 쿼리 조건 (ex. 다중 조건, 서브쿼리, 동적 조건)은 메서드 이름으로 표현 불가

java
복사편집
// 안 되는 예시
List<Member> findByTeamNameAndAgeBetweenAndStatusAndCreatedDateBefore(...);

너무 길어지고, 조합이 많아지면 폭발적으로 메서드가 늘어남

---

2. 동적 쿼리 작성 불가

• 조건이 있을 수도, 없을 수도 있을 때 → 메서드 이름으로 불가능

java
복사편집
// name, age가 있을 수도 없을 수도 있는 경우 → QueryDSL 필요

---

3. JOIN, GROUP BY, 서브쿼리 등 복잡한 SQL

• 자동 쿼리는 단순 WHERE 조건까지만 커버 가능
• JOIN, GROUP BY, HAVING, ORDER BY, IN 등은 직접 작성 필요

java
복사편집
@Query("SELECT m FROM Member m JOIN m.team t WHERE t.name = :teamName")
List<Member> findByTeamName(@Param("teamName") String teamName);

---

4. 성능 최적화가 필요한 경우

• JPA는 추상화된 쿼리를 사용하므로 DB 튜닝이 어려움
• Native SQL로 인덱스, 힌트, 페이징 최적화 등을 직접 지정해야 할 수 있음

---

5. 복잡한 응답 DTO 매핑

• 엔티티가 아니라 DTO로 바로 조회하려면 @Query, JPQL, QueryDSL 필요

java
복사편집
@Query("SELECT new com.example.MemberDto(m.id, m.name) FROM Member m")
List<MemberDto> findMemberDto();

---

6. 비즈니스 로직이 유연해야 할 때

• 조건을 모듈화하거나, 공통 조건을 재사용해야 할 때 → 코드 기반 쿼리 필수
• 대표적으로 QueryDSL + 동적 BooleanExpression

[daumi125]

🔹 Q1. JPA에서 자동 쿼리 메서드란 무엇인가요?

✅ 답변 예시

JPA에서는 메서드 이름만으로 쿼리를 생성할 수 있는 기능을 제공합니다.

예를 들어, findByNameAndAgeGreaterThan(String name, int age) 같은 메서드를 정의하면, JPA가 자동으로 "WHERE name = ? AND age > ?" 쿼리를 생성해줍니다.

이는 간단한 조건에서 매우 빠르게 개발할 수 있는 장점이 있습니다.

---

🔹 Q2. 자동 쿼리는 편리한데, 왜 굳이 직접 쿼리를 작성하나요?

✅ 답변 예시

자동 쿼리는 단순 조건에서는 효율적이지만, 실무에서는 복잡한 요구사항이 많습니다.

예를 들어:

• 동적으로 조건이 달라지거나

• JOIN, GROUP BY, ORDER BY, 서브쿼리 등이 필요한 경우

  이런 경우에는 자동 쿼리로는 표현이 어렵고, 유지보수도 힘듭니다.

  그래서 저는 복잡한 로직에서는 QueryDSL이나 @Query를 사용하여 직접 쿼리를 작성합니다.

---

🔹 Q3. 직접 쿼리를 작성하는 방식에는 어떤 것들이 있나요?

✅ 답변 예시

JPA에서는 다음과 같은 방식으로 직접 쿼리를 작성할 수 있습니다.

1. JPQL – 객체를 대상으로 하는 JPA 표준 쿼리 언어
2. @query – Spring Data JPA에서 메서드에 직접 JPQL/SQL 작성
3. QueryDSL – 타입 안전한 자바 코드 기반 DSL
4. Native SQL – 데이터베이스 고유 기능이나 성능 튜닝이 필요할 때 사용합니다.

---

🔹 Q4. QueryDSL을 실무에서 왜 사용하시나요?

✅ 답변 예시

실무에서는 다양한 조건을 조합해야 하는 경우가 많고, 조건마다 다르게 쿼리를 생성해야 할 때가 많습니다.

QueryDSL은 자바 코드 기반이라 자동완성, 컴파일 시점 오류 체크, 조건 재사용, 동적 쿼리 조합이 가능해서 유지보수성과 확장성이 뛰어납니다.

그래서 복잡한 조회 쿼리는 QueryDSL로 작성하고, 단순한 쿼리는 @query나 메서드 이름 기반을 적절히 섞어 사용합니다.

---

🔹 Q5. 동적 쿼리란 무엇이고, 왜 필요한가요?

✅ 답변 예시

동적 쿼리는 검색 조건이 있을 수도, 없을 수도 있는 경우에 사용하는 쿼리입니다.

예를 들어, 사용자 검색 시 이름, 나이, 주소 조건이 선택적으로 입력될 수 있다면, 그 조건들에 따라 쿼리를 유동적으로 조립해야 합니다.

이런 경우 QueryDSL의 BooleanExpression을 활용하면 간결하고 안전하게 쿼리를 구성할 수 있습니다.

---