📌 JPA 함수명 명명규칙 실습

📅 날짜

2025년 5월 7일

📝 학습 내용

1️⃣ 주요 개념: JPA Repository 메서드 이름 규칙

✅ 개념 요약

Spring Data JPA에서는 메서드 이름만으로도 SQL 없이 자동 쿼리를 생성할 수 있다.

findBy, countBy, deleteBy 등의 prefix와 속성명을 조합하여 다양한 검색·조작 기능을 만들 수 있다.

---

✅ BookRepository.java

@Repository
public interface BookRepository extends JpaRepository<Book, Long> {

    // 정확히 일치하는 조건 검색
    List<Book> findByBookName(String bookName);
    List<Book> findByPublisher(String publisher);
    List<Book> findByIsbn(String isbn);

    // 복합 조건 검색
    Book findByBookNameAndIsbn(String bookName, String isbn);

    // 부분 문자열 검색
    List<Book> findByBookNameContains(String keyword);

    // 개수 조회
    int countByBookName(String bookName);
    int countByBookNameContains(String bookName);

    // 삭제
    void deleteByBookName(String bookName);

    // 명명 규칙 참고용 (주석)
//    List<Book> findByBookcodeBetween(long start, long end);
//    List<Book> findByBooknameOrPublisher(String bookname, String publisher);
//    List<Book> findByBooknameOrPublisherOrderByBooknameAsc(String bookname, String publisher);
//    List<Book> findByPublisherStartingWith(String prefix);
//    int countByPublisher(String publisher);
//    void deleteByBookname(String bookname);
}

---

✅ 테스트 메서드: t2() - JPA 네이밍 규칙별 조회 테스트

@Test
public void t2() throws Exception {

    // ID로 조회 테스트
//    Optional<Book> bookOptional = bookRepository.findById(1111L);
//    if (bookOptional.isPresent())
//        System.out.println(bookOptional.get());

    // 도서명으로 검색
//    List<Book> list = bookRepository.findByBookName("이것이리눅스다");
//    list.stream().forEach(System.out::println);

    // 출판사로 검색
//    List<Book> list = bookRepository.findByPublisher("한빛미디어");
//    list.stream().forEach(System.out::println);

    // 도서명 + ISBN 복합 조건 검색
//    Book book = bookRepository.findByBookNameAndIsbn("C언어 기본", "3333");
//    System.out.println(book);

    // 도서명에 "이것"이라는 키워드가 포함된 도서 검색
    List<Book> list = bookRepository.findByBookNameContains("이것");
    list.stream().forEach(System.out::println);
}

🔹 출력 결과 (도서명에 '이것'이 포함된 도서 목록)

Book(bookCode=1111, bookName=이것이리눅스다, publisher=한빛미디어, isbn=1111)
Book(bookCode=4444, bookName=이것이리눅스다, publisher=한빛미디어, isbn=4444)

---

🔥 정리

• JPA는 메서드 이름만으로 쿼리를 생성하는 기능을 제공하여, 개발자가 쿼리문을 직접 작성하지 않아도 된다.
• findBy, countBy, deleteBy 같은 키워드를 시작으로 다양한 조합 검색 가능
• 조건 조합(And, Or), 키워드 검색(Contains, StartingWith), 범위 검색(Between), 정렬(OrderBy) 등 폭넓은 기능 지원
• 코드의 간결성과 유지보수성 향상에 매우 효과적

---

🔗 참고 자료

• Spring Data JPA 공식 문서
• 인프런 스프링 JPA 강의

---

느낀 점

JPA의 메서드 네이밍 규칙은 단순하면서도 강력했다.

특히 도서명 키워드 검색, 복합 조건 조회, 자동 정렬 등은 관리자 페이지나 검색 기능이 자주 필요한 실무에서 매우 유용할 것으로 판단된다.

예를 들어, "책 제목에 특정 단어가 포함된 결과를 정렬해 보여주는 검색 기능"을 SQL 없이도 구현할 수 있다는 점이 매우 인상 깊었다.

이러한 방식은 코드 가독성과 생산성을 동시에 향상시켜주기 때문에, 추후 기업용 웹 서비스나 CMS 구현 시 적극 활용할 계획이다.

---