JPA 기초

@Entity
@Table(name = "orders")
@Getter
@NoArgsConstructor(access = AccessLevel.PROTECTED)
public class Order {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(nullable = false, length = 20)
    @Enumerated(EnumType.STRING)
    private OrderStatus status;

    @Column(nullable = false)
    private int totalAmount;

    private LocalDateTime orderedAt;

    // 상태 변경은 의미가 드러나는 메서드로 제공합니다
    public void cancel() {
        if (this.status != OrderStatus.PAID) {
            throw new BusinessException("결제 완료 상태만 취소할 수 있습니다");
        }
        this.status = OrderStatus.CANCELED;
    }
}

public interface OrderRepository extends JpaRepository<Order, Long> {

    // 메서드 이름으로 쿼리를 만듭니다
    List<Order> findByStatusOrderByOrderedAtDesc(OrderStatus status);

    // 복잡해지면 JPQL을 직접 씁니다
    @Query("select o from Order o where o.totalAmount >= :amount")
    List<Order> findExpensiveOrders(@Param("amount") int amount);
}

기본 생성자를 protected로 막고 setter를 두지 않은 점을 보세요. 아무 데서나 상태를 바꾸지 못하게 하면 잘못된 데이터가 저장되는 경로가 줄어듭니다.

@Transactional
public void cancelOrder(Long orderId) {
    Order order = orderRepository.findById(orderId)
            .orElseThrow(() -> new BusinessException("주문을 찾을 수 없습니다"));

    order.cancel();   // 값만 바꿉니다

    // save를 호출하지 않아도 트랜잭션 종료 시 UPDATE가 실행됩니다
}

반대로 말하면, 조회한 엔티티를 무심코 수정하면 의도하지 않은 UPDATE가 나갑니다. 조회 전용 메서드에 readOnly를 붙이는 이유이기도 합니다.

// 1) 개발 환경에서 실행되는 SQL을 눈으로 확인합니다
// application-local.yml
// spring.jpa.show-sql: true
// spring.jpa.properties.hibernate.format_sql: true

// 2) fetch join으로 한 번에 조회
@Query("select o from Order o join fetch o.member where o.status = :status")
List<Order> findWithMember(@Param("status") OrderStatus status);

// 3) @EntityGraph로 선언
@EntityGraph(attributePaths = {"member"})
List<Order> findByStatus(OrderStatus status);

// 4) 컬렉션은 batch size로 조회 횟수를 줄입니다
// spring.jpa.properties.hibernate.default_batch_fetch_size: 100

show-sql은 개발 환경에서만 켭니다. 운영에서 켜 두면 로그가 폭증하고 성능에 영향을 줍니다.