리포지토리 인터페이스 표준 (Spring Data JPA)
-
어노테이션: 리포지토리 인터페이스에 반드시
@Repository어노테이션을 사용해야 합니다. -
타입: 반드시 인터페이스여야 합니다.
-
상속: 반드시
JpaRepository<EntityName, EntityIdType>(또는 유사한 Spring Data 인터페이스)를 확장해야 합니다. -
쿼리 언어: 네이티브 SQL이 필요하지 않는 한
@Query어노테이션에 JPQL을 사용해야 합니다. -
N+1 문제: 지연 로딩 관계를 로드할 때 N+1 이슈를 방지하기 위해
@EntityGraph(attributePaths = {...})또는 JPQL의JOIN FETCH를 사용해야 합니다. -
복잡한 프로젝션: 특히 조인에서 특정 데이터를 선택할 때
@Query에서 DTO 프로젝션(인터페이스 또는 클래스 기반)을 사용하세요.
예시 코드
@Repository
public interface UserRepository extends JpaRepository<User, Long> {
// 기본 메서드는 JpaRepository에서 자동으로 제공됨
// 사용자 지정 쿼리 - JPQL 사용
@Query("SELECT u FROM User u WHERE u.email = :email")
Optional<User> findByEmail(@Param("email") String email);
// N+1 문제 방지를 위한 EntityGraph 사용
@EntityGraph(attributePaths = {"orders"})
@Query("SELECT u FROM User u WHERE u.id = :id")
Optional<User> findByIdWithOrders(@Param("id") Long id);
// DTO 프로젝션 사용 (인터페이스 기반)
@Query("SELECT u.id as id, u.username as username, u.email as email FROM User u")
List<UserSummaryDto> findAllUserSummaries();
// 네이티브 쿼리 - 필요한 경우에만 사용
@Query(value = "SELECT * FROM users WHERE created_at > :date", nativeQuery = true)
List<User> findRecentUsers(@Param("date") Date date);
}
인터페이스 기반 DTO 프로젝션 예시:
public interface UserSummaryDto {
Long getId();
String getUsername();
String getEmail();
}