Devgraphy

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
↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓
동작 + 필드명 + 조건 + 필드명 + 조건 + 필드명 + 조건 + 필드명

각 부분 설명:

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 작성 필요
• 오타나 문법 오류 가능성

1. 가장 간단한 판단법

✅ ① View Page Source (페이지 소스 보기)

• 브라우저에서 Ctrl+U 또는 우클릭 → “페이지 소스 보기”
• HTML 내용이 꽉 차 있으면 SSR,
  <div id="app"> 또는 <div id="root">만 있고 내용이 비어 있으면 CSR 입니다.

예시:

• SSR (서버에서 렌더링된 HTML)
•  
  <div id="app"> <h1>오늘의 뉴스</h1> <p>실시간 속보...</p> </div>
• CSR (클라이언트 렌더링)→ 내용이 JS 로드 후에만 보이면 CSR
•  
  <div id="app"></div> <script src="/assets/app.js"></script>

2. Network 탭에서 확인

1. F12 → Network 탭 → 새로고침(Ctrl+R)
2. 첫 번째 요청(document 또는 index.html) 클릭
3. “Response” 탭에서 HTML을 확인
   • 서버에서 바로 렌더링된 콘텐츠가 있으면 SSR
   • 비어 있고 JS를 불러온 뒤 렌더링되면 CSR

3. Disable JavaScript 후 확인

1. 크롬 개발자 도구 → Settings(F1) → Debugger → “Disable JavaScript” 체크
2. 새로고침
   • 화면이 거의 비어 있으면 CSR
   • 콘텐츠가 그대로 보이면 SSR

👉 SSR은 JS 없이도 HTML이 완성되어 있으므로, JS 비활성화 상태에서도 글자가 보입니다.
CSR은 JS 실행이 안 되면 아무 것도 안 보입니다.

4. Lighthouse / Chrome DevTools “Performance” 탭

• “Main Thread” 타임라인을 보면:
  • HTML 로드 후 JS 실행으로 렌더링 시간 지연 → CSR
  • HTML 로드 시점에 이미 콘텐츠가 표시 → SSR

5. 간단한 JS 콘솔 확인

• 비어 있거나 <noscript>만 있으면 CSR
• HTML 요소가 이미 존재하면 SSR

⚡추가 팁