[Spring] 쿼리 메서드! — JPA에서 SQL 없이 조회하기

 

🧙‍♂️ 마법처럼 작동하는 쿼리 메서드! — JPA에서 SQL 없이 조회하기

안녕하세요! 오늘은 SQL 한 줄도 안 쓰고도 데이터를 찾아주는, 정말 신기한 기능
**Spring Data JPA의 쿼리 메서드(Query Method)**에 대해 알아보겠습니다 😊

---

🧠 먼저, JPA가 지원하는 여러 쿼리 방식!

JPA에서는 데이터를 가져오기 위해 여러 가지 방법이 있어요. 아래처럼요:

방식설명

JPQL	JPA 전용 SQL (Entity 기준으로 작성, SQL과 유사)
Query Method	메서드 이름만 잘 지으면 자동으로 쿼리를 만들어주는 마법 같은 기능
Criteria	코드 조합으로 쿼리를 만드는 JPA 표준 방식 (하지만 불편해요!)
Querydsl	Criteria보다 쉽고 강력한 쿼리 작성 도구 (오픈소스)
Native SQL	우리가 직접 SQL을 작성하는 방식 (복잡한 쿼리에 사용)

 

🧙‍♀️ 그중에서도 오늘의 주인공! — 쿼리 메서드(Query Method)

Spring Data JPA에서는 메서드 이름만 잘 지으면,
자동으로 SELECT, DELETE, COUNT 같은 SQL을 만들어줘요!

 

예시:

List<Board> list = boardRepository.findByTitleAndWriter("제목", "글쓴이");

이 한 줄이 사실은 SQL을 대신하고 있어요!

SELECT * FROM board WHERE title = '제목' AND writer = '글쓴이';

 

 

쿼리 메서드가 왜 좋을까? 

• 생산성 향상: 복잡한 SQL/JPQL을 직접 작성할 필요 없이 메서드 이름만으로 기본적인 조회가 가능해 개발 속도가 빨라집니다.
• 코드의 가독성: 메서드 이름 자체가 어떤 데이터를 어떤 조건으로 찾는지 명확하게 보여주므로, 코드를 읽는 사람이 쉽게 이해할 수 있습니다.
• 유지보수 용이: 조회 조건이 변경될 때, 메서드 이름만 규칙에 맞게 수정하거나 새로운 메서드를 추가하면 되므로 유지보수가 편리합니다.
• 타입 안정성: 컴파일 시점에 메서드 이름과 매개변수의 타입 오류를 잡을 수 있어 런타임 오류 가능성을 줄여줍니다.
• 프레임워크 활용: Spring Data JPA와 같은 프레임워크의 강력한 기능을 별도의 설정 없이 활용할 수 있습니다.

 

 

 

🧱 BoardRepository 클래스 살펴보기

아래 코드는 쿼리 메서드가 어떻게 Repository에 정의되는지 보여줍니다!

public interface BoardRepository extends CrudRepository<Board, Long> {

    // 1. "작성자 이름이 [writer]인 글이 총 몇 개인지 세어주세요!"
    int countAllByWriter(String writer);

    // 2. "작성자 이름이 [writer]인 글들을 모두 찾아주세요!"
    List<Board> findByWriter(String writer);

    // 3. "제목이 [title]이고, 작성자 이름이 [writer]인 글들을 모두 찾아주세요!"
    List<Board> findByTitleAndWriter(String title, String writer);

    // 4. "작성자 이름이 [writer]인 글들은 이제 모두 지워주세요!"
    @Transactional // 여러 개를 지울 땐 안전하게! 특별한 처리가 필요해요.
    int deleteByWriter(String writer);
}

📌 규칙은 아주 간단해요:

동작 + By + 필드명 (그리고 필요하면 And, Or로 조합)

• countAllByWriter: '전부 세어줘' (countAll) + '작성자 기준으로' (ByWriter)
• findByWriter: '찾아줘' (find) + '작성자 기준으로' (ByWriter)
• findByTitleAndWriter: '찾아줘' (find) + '제목 기준으로' (ByTitle) + '그리고' (And) + '작성자 기준으로' (Writer)
• deleteByWriter: '지워줘' (delete) + '작성자 기준으로' (ByWriter)

이렇게 우리가 원하는 '요청'을 이름으로 잘 지어서 적어 놓으면, 컴퓨터(정확히는 스프링 데이터 JPA라는 똑똑한 친구)는 저 이름만 보고도 알아서 복잡한 데이터베이스 암호(JPQL)를 만들어서 데이터를 찾아오거나, 세거나, 지워주는 거예요.

@Transactional 같은 건 "여러 개의 글을 한 번에 지우는 것처럼 중요한 작업은 중간에 문제가 생기면 안 되니까, 컴퓨터가 특별히 더 신경 써서 안전하게 처리해줘!" 라고 알려주는 거라고 생각하면 쉬워요.

 

 

🧪 테스트 코드로 하나씩 이해해보기

🎯 1. 테스트용 데이터 만들기 (@BeforeEach)

for (int i = 0; i < 100; i++) {
    Board board = new Board();
    board.setBno((long)i);
    board.setTitle("title" + i);
    board.setContent("content" + i);
    board.setWriter("writer" + (i % 5)); // writer0 ~ writer4 (5명)
    ...
    boardRepository.save(board);
}

👉 총 100개의 게시물 생성!
👉 글쓴이는 writer0부터 writer4까지, 각 20개씩 있어요.

 

🔍 2. findByWriter() 테스트

List<Board> list = boardRepository.findByWriter("writer1");
assertTrue(list.size() == 20);

 

writer1이 작성한 글만 20개 찾기!
SQL로 쓰면 SELECT * FROM board WHERE writer = 'writer1'

 

 

📊 3. countAllByWriter() 테스트

int count = boardRepository.countAllByWriter("writer1");
assertTrue(count == 20);

writer1의 게시글 개수 세기!
SQL: SELECT COUNT(*) FROM board WHERE writer = 'writer1'

 

🧨 4. deleteByWriter() 테스트

int deletedCount = boardRepository.deleteByWriter("writer1");
assertTrue(deletedCount == 20);

List<Board> list = boardRepository.findByWriter("writer1");
assertTrue(list.size() == 0);

writer1이 쓴 글을 몽땅 삭제!
SQL: DELETE FROM board WHERE writer = 'writer1'

 

🧠 쿼리 메서드 키워드 요약표

키워드설명예시 메서드

findBy	조건에 맞는 데이터를 조회	findByTitle(String title)
countBy	개수 세기	countByWriter(String writer)
deleteBy	조건에 맞는 데이터 삭제	deleteByWriter(String writer)
And, Or	조건 여러 개 조합	findByTitleAndWriter(String t, String w)

 

---

✅ 정리하면!

개념설명

JPQL	Entity 기반 SQL 문법 (조금 복잡하지만 유연함)
쿼리 메서드	메서드 이름만으로 SQL을 자동 생성해주는 기능
사용 예시	findBy, countBy, deleteBy 등등
장점	SQL 몰라도 쉽게 데이터 조회/삭제 가능

 

---

🎁 마무리

쿼리 메서드는 Spring Data JPA가 제공하는 최고의 선물입니다.
복잡한 SQL 없이도, 이름만 잘 지으면 JPA가 알아서 데이터를 가져다 줘요!