JPA · 리포지토리와 쿼리 메서드

// 이 한 줄만 선언하면 save·findById·findAll 등이 바로 동작
public interface UserRepo extends JpaRepository<User, Long> { }
//                                              └엔티티┘ └PK타입┘

Repository<T, ID>                       // 마커(메서드 없음)
  ├─ CrudRepository<T, ID>              // 기본 CRUD (반환: Iterable)
  │    └─ ListCrudRepository<T, ID>     // 같은 CRUD, 반환을 List 로
  └─ PagingAndSortingRepository<T, ID>  // 페이징·정렬 추가
       └─ ListPagingAndSortingRepository<T, ID>

JpaRepository<T, ID>
  extends ListCrudRepository, ListPagingAndSortingRepository  // 둘을 합치고
  // + JPA 전용 기능(flush, saveAndFlush, getReferenceById, 일괄 삭제 …)

Optional<User> findByUserid(String userid);
//             find  By userid           → SELECT ... WHERE userid = ?1
//             주제   ↑   속성 이름

public interface UserRepo extends JpaRepository<User, Long> {

  // 이름 바인딩: :name 자리에 @Param("name") 값이 들어감
  @Query("select u from User u where u.name = :name and u.active = true")
  List<User> searchActive(@Param("name") String name);

  // 위치 바인딩: ?1 은 첫 번째 인자
  @Query("select u from User u where u.userid = ?1")
  Optional<User> byUserid(String userid);

  // 네이티브 SQL: 실제 테이블 이름으로, DB 고유 문법 사용 가능
  @Query(value = "select * from lds.tb_user where userid = :uid", nativeQuery = true)
  Optional<User> byUseridNative(@Param("uid") String uid);
}

@Modifying(clearAutomatically = true)   // 실행 후 영속성 컨텍스트 비움
@Transactional
@Query("update User u set u.active = false where u.lastLoginAt < :cutoff")
int deactivateIdle(@Param("cutoff") LocalDateTime cutoff);
// 반환 int = 변경된 행 수

// page=0(첫 페이지), size=20, 이름 오름차순 정렬
Pageable pageable = PageRequest.of(0, 20, Sort.by("name").ascending());
Page<User> page = userRepo.findByActiveTrue(pageable);

page.getContent();        // 이번 페이지 목록(List)
page.getTotalElements();  // 전체 개수
page.getTotalPages();     // 전체 페이지 수
page.hasNext();           // 다음 페이지 존재 여부

interface UserNameOnly {       // getter 이름이 엔티티 속성과 일치
  String getUserid();
  String getName();
}
List<UserNameOnly> findByActiveTrue();   // userid, name 만 조회

record UserDTO(String userid, String name) {}

// @Query 에서 생성자 표현식으로 DTO 만들기 (FQDN 전체 경로 필요)
@Query("select new com.example.study.web.dto.UserDTO(u.userid, u.name) from User u where u.active = true")
List<UserDTO> findActiveDTOs();

@EntityGraph(attributePaths = {"roles"})   // roles 를 함께 fetch
@Query("select u from User u where u.active = true")
List<User> findActiveWithRoles();

@Transactional(readOnly = true)
public List<User> listActive() {
  return userRepo.findByActiveTrue();   // 조회만 → 읽기 전용으로
}

var q = queryFactory.selectFrom(user);
if (filter.keyword() != null)
  q.where(user.name.containsIgnoreCase(filter.keyword()));   // 있을 때만 조건 추가
if (filter.activeOnly())
  q.where(user.active.isTrue());
return q.fetch();   // 타입 안전 + 동적 조립

public interface UserRepo extends JpaRepository<User, Long> {

  // 파생 쿼리
  Optional<User> findByUserid(String userid);
  List<User> findByNameContainingIgnoreCase(String keyword);
  boolean existsByUserid(String userid);
  long countByActiveTrue();
  List<User> findTop5ByOrderByCreatedAtDesc();

  // @Query (JPQL + 이름 바인딩). LIKE 와일드카드는 concat 으로 붙인다
  // (JPQL 에서 %:kw% 처럼 직접 붙이는 표기는 표준이 아니라 오류가 난다)
  @Query("select u from User u where u.active = true and u.name like concat('%', :kw, '%')")
  List<User> searchActive(@Param("kw") String kw);

  // 페이징 + DTO 프로젝션
  @Query("select new com.example.study.web.dto.UserDTO(u.userid, u.name) from User u where u.active = true")
  Page<UserDTO> pageActive(Pageable pageable);
}