default method로 JpaRepository 좀 더 우아하게 써보기

개요

Spring Data JPA에서 JpaRepository 인터페이스를 사용할 때 Java 8에서 도입된 default method를 활용하면 기존 코드를 좀 더 깔끔하고 효율적으로 사용할 수 있다.

 

Optional 제거하기

Spring Data JPA의 findByXX 메서드는 기본적으로 Optional을 반환한다. 이로 인해 비즈니스 로직에서 Optional 처리를 위한 추가적인 작업이 필요하게 되는데, 이럴 때 default 메서드를 활용하면 이 문제를 우아하게 해결할 수 있다.

public interface UserRepository extends JpaRepository<User, Long> {
    // Default 메소드를 사용하여 findById의 Optional을 내부적으로 처리
    default User findUserById(Long id) {
        return findById(id).orElseThrow(() -> new DataNotFoundException("User not found with id: " + id));
    }
}

 

메서드명 간소화하기

Spring Data JPA를 사용하다 보면 복잡한 쿼리 때문에 메서드명이 길어져 가독성을 해치는 경우가 있다. 이럴 때도 default 메서드를 활용하면 긴 메서드명을 간결하고 명확하게 표현할 수 있다.

public interface ProductRepository extends JpaRepository<Product, Long> {
    // 기존의 긴 쿼리 메소드
    List<Product> findAllByCategoryAndPriceGreaterThanEqualAndPriceLessThanEqualOrderByPriceAsc(String category, BigDecimal minPrice, BigDecimal maxPrice);

    // Default 메소드를 사용하여 간결한 메소드명 제공
    default List<Product> findProductsByCategoryAndPriceRange(String category, BigDecimal minPrice, BigDecimal maxPrice) {
        return findAllByCategoryAndPriceGreaterThanEqualAndPriceLessThanEqualOrderByPriceAsc(category, minPrice, maxPrice);
    }
}

 

비즈니스 로직 통합

여러 기본 제공 메서드를 하나의 고차 작업으로 결합할 수도 있다. 다만 Spring Data JPA의 Repository는 Data Access Layer의 일부로, 데이터베이스와의 상호작용만을 담당하는 것이 일반적이기 때문에 이 부분은 서비스 레이어에서 처리하는 것이 일반적이다.

public interface UserRepository extends JpaRepository<User, Long> {
    
    // 사용자 ID로 사용자를 찾고, 존재할 경우 연락처 정보를 업데이트하는 메소드
    default void updateUserContact(Long userId, String newContact) {
        findById(userId).ifPresent(user -> {
            user.setContact(newContact);
            save(user);
        });
    }
}

 

주의해야 할 점

코틀린을 사용하는 경우에는 조금 달라진다. 코틀린에서는 자바의 default method를 직접 지원하지 않는다. 다시 말해 코틀린의 인터페이스에서는 기본 구현을 메서드에 제공할 수 있지만, 이는 자바의 default method와 동일한 방식으로 작동하지 않는다는 것을 의미한다.

• 자바의 컴파일러는 인터페이스에 선언된 default method를 'interface' 클래스 파일에 직접 포함시키며, 이 메서드들은 일반 인스턴스 메서드처럼 'invokespecial' 명령어를 사용하여 호출된다.
• 코틀린 컴파일러는 각 메서드에 대해 스태틱 메서드를 생성하고, 이들을 'DefaultImpls'라는 내부 클래스에 포함시킨다. 인터페이스를 구현하는 클래스에서는 이러한 스태틱 메서드를 호출하여 default method의 기능을 사용한다.

실제로 코틀린 환경에서 JpaRepository를 상속하는 인터페이스에 메서드 구현부를 포함하면, 컴파일 과정에서 다음과 같은 에러가 발생할 수 있다.

No property betweenOsVer found for type ${EntityName}

이는 Spring Data JPA가 "쿼리 메서드" 기능을 통해 JpaRepository를 상속한 인터페이스의 메서드 이름을 기반으로 쿼리를 생성하기 때문이다. 이 기능을 활용하려면 메서드 이름이 find…By, read…By, count…By 등 사전에 정의된 네이밍 규칙을 따라야 하는데, 사용자가 직접 쿼리를 정의해야 하는 경우를 고려해 default method는 "쿼리 메서드" 대상에서 제외되어 있다. 하지만 코틀린은 default method를 지원하지 않기 때문에 모든 메서드에 "쿼리 메서드"가 적용되며, 네이밍 규칙을 따르지 않는 메서드는 컴파일 에러가 발생한다.

결국, 코틀린에서 JpaRepository를 상속하는 인터페이스에 메서드 구현부를 포함하려면, 자바의 default method와 같은 방식으로는 사용할 수 없다는 말이다.

코틀린에서 JpaRepository dafult method를 사용하는 방법에 대한 더 자세한 내용은 아래의 글을 참고하면 좋을 것 같다.

• https://zorba91.tistory.com/340
• https://findmypiece.tistory.com/263