1. Spring Data JPA Query Method란 ?
메서드 이름만으로 자동으로 쿼리를 생성해주는 기능
// Repository 인터페이스에 메서드 선언만 하면
boolean existsByCrtPartyIdAndOriginalResocIdAndIsSharedAndHistEndDate(
BigDecimal crtPartyId,
BigDecimal originalResocId,
String isShared,
LocalDateTime histEndDate
);
// Spring Data JPA가 자동으로 SQL을 생성하여 실행
2. 메서드 이름 분석
메서드 이름은 규칙에 따라 구성됩니다:
existsBy + CrtPartyId + And + OriginalResocId + And + IsShared + And + HistEndDate
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
동작 + 필드명 + 조건 + 필드명 + 조건 + 필드명 + 조건 + 필드명
각 부분 설명:
| 부분 |
의미 |
설명 |
| exists |
존재 여부 확인 |
해당 조건의 레코드가 있으면 true, 없으면 false |
| By |
조건 시작 |
WHERE 절 시작 |
| CrtPartyId |
필드명 |
ResocMstr.crtPartyId |
| And |
논리 연산자 |
SQL의 AND |
| OriginalResocId |
필드명 |
ResocMstr.originalResocId |
| And |
논리 연산자 |
SQL의 AND |
| IsShared |
필드명 |
ResocMstr.isShared |
| And |
논리 연산자 |
SQL의 AND |
| HistEndDate |
필드명 |
ResocMstr.histEndDate |
3. 자동 생성되는 SQL
SELECT
CASE WHEN COUNT(*) > 0 THEN TRUE ELSE FALSE END
FROM chatbi.resoc_mstr
WHERE crt_party_id = ? -- 첫 번째 파라미터
AND original_resoc_id = ? -- 두 번째 파라미터
AND is_shared = ? -- 세 번째 파라미터
AND hist_end_date = ? -- 네 번째 파라미터
4. 실제 동작 예시
// Service에서 호출
private boolean isDuplicateShare(BigDecimal originalResocId, BigDecimal targetOrgId) {
return resocMstrRepository.existsByCrtPartyIdAndOriginalResocIdAndIsSharedAndHistEndDate(
targetOrgId, // crtPartyId = 10
originalResocId, // originalResocId = 100
"Y", // isShared = 'Y'
MAX_HIST_END_DATE // histEndDate = '9999-12-31'
);
}
// 실행되는 SQL
// SELECT CASE WHEN COUNT(*) > 0 THEN TRUE ELSE FALSE END
// FROM resoc_mstr
// WHERE crt_party_id = 10
// AND original_resoc_id = 100
// AND is_shared = 'Y'
// AND hist_end_date = '9999-12-31 00:00:00'
// 결과: 레코드가 존재하면 true, 없으면 false
existsByCrtPartyIdAndOriginalResocIdAndIsSharedAndHistEndDate 사용 목적
중복 공유 방지를 위해 사용합니다:
// 상황: 조직 10에게 메뉴 100을 공유하려고 함
// 체크 로직
boolean isDuplicate = isDuplicateShare(100, 10);
if (isDuplicate) {
// 이미 조직 10에게 메뉴 100(또는 그 복사본)이 공유되어 있음
// → 재공유 방지
throw new DuplicateShareException("이미 공유된 자원입니다.");
}
// 데이터 예시
// resoc_mstr 테이블:
// resoc_id | crt_party_id | original_resoc_id | is_shared | hist_end_date
// ---------|--------------|-------------------|-----------|---------------
// 500 | 10 | 100 | Y | 9999-12-31 ← 이미 존재!
//
// → isDuplicate = true
6. Query Method의 다른 예시
// 1. 단순 조회
List findByCrtPartyId(BigDecimal crtPartyId);
// → WHERE crt_party_id = ?
// 2. 정렬
List findByCrtPartyIdOrderBySortSeq(BigDecimal crtPartyId);
// → WHERE crt_party_id = ? ORDER BY sort_seq
// 3. 범위 조회
List findByResocIdBetween(BigDecimal start, BigDecimal end);
// → WHERE resoc_id BETWEEN ? AND ?
// 4. Like 검색
List findByResocNameContaining(String keyword);
// → WHERE resoc_name LIKE %?%
// 5. Count
long countByCrtPartyIdAndIsShared(BigDecimal crtPartyId, String isShared);
// → SELECT COUNT(*) WHERE crt_party_id = ? AND is_shared = ?
7. Query Method vs @Query
Query Method (자동 생성)
boolean existsByCrtPartyIdAndOriginalResocId(
BigDecimal crtPartyId,
BigDecimal originalResocId
);
장점:
- 구현 불필요, 선언만 하면 됨
- 타입 안정성 보장
- 메서드 이름으로 의도 명확
- 단점:
- 복잡한 쿼리는 메서드 이름이 너무 길어짐
- Join이나 서브쿼리 등 복잡한 로직 구현 어려움@Query("""
SELECT CASE WHEN COUNT(*) > 0 THEN TRUE ELSE FALSE END
FROM ResocMstr r
WHERE r.crtPartyId = :crtPartyId""")
boolean checkDuplicateShare(
@Param("crtPartyId") BigDecimal crtPartyId,
@Param("originalResocId") BigDecimal originalResocId,
@Param("isShared") String isShared
);
- 장점:
AND r.originalResocId = :originalResocId AND r.isShared = :isShared- @Query (수동 작성)
- 복잡한 쿼리 작성 가능
- Join, 서브쿼리, 집계 함수 등 자유롭게 사용
- 단점:
- 직접 JPQL/SQL 작성 필요
- 오타나 문법 오류 가능성