# 12장 스프링 데이터 JPA ## 스프링 데이터 JPA 소개 스프링 데이터 JPA는 스프링 프레임워크에서 `JPA`를 편리하게 사용할 수 있도록 지원한다. 따라서 `데이터 접근` 계층을 개발할 때 구현 클래스 없이 인터페이스만 작성해도 개발을 완료할 수 있다. ![](https://2649832514-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M5HOStxvx-Jr0fqZhyW%2F-MAJgpNyk3o7JmXymWX7%2F-MAJzQOHADQ82yF7Urcz%2F1.png?alt=media\&token=e662cafd-1158-4f66-be5e-c11e9d911ba1) ## 쿼리 메소드 기능 쿼리 메소드 기능은 스프링 데이터 `JPA`가 제공하는 마법 같은 기능이다. 스프링 데이터 `JPA`가 제공하는 쿼리 메소드 기능은 크게 3가지가 있다. ### 메소드 이름으로 쿼리 생성 ```java public interface MemberRepository extends Repository { List findByEmailAndName(String email, String name); } // select m from Member m where m.email = ?1 and m.name = ?2 ``` ### 메소드 이름으로 JPA NamedQuery 호출 `JPA Named` 쿼리는 이름 그대로 쿼리에 이름을 부여해서 사용하는 방법인데, 어노테이션이나 `XML`에 쿼리를 정의할 수 있다. ```java // 어노테이션 방식 @Entity @NamedQuery( name="Member.findByUsername", query="select m from Member m where m.username = :username") public class Member { ... } ``` ```java // XML 방식 ``` ### @Query, 리포지터리 메소드에 쿼리 직접 정의 리포지터리 메소드에 직접 쿼리를 정의하려면 `Query` 어노테이션을 사용한다. 또한 `JPA Named` 쿼리처럼 애플리케이션 실행 시점에 문법 오류를 발견할 수 있는 장점이 있다. ```java public interface MemberRepository extends JpaRepository { @Query("select m from Member m where m.username = ?1") Member findByUsername (String username); } ``` 네이티브 SQL을 사용하려면 `@Query` 어노테이션에 '`nativeQuery = true`'를 설정한다. ```java public interface MemberRepository extends JpaRepository { @Query(value = "SELECT * FROM MEMBER WHERE USERNAME = ?0”, nativeQuery = true) Member findByUsername (String username); } ``` ### 파라미터 바인딩 스프링 데이터 `JPA`는 위치 기반 파라미터 바인딩과 이름 기반 파라미터 바인딩을 모두 지원한다. ```java select m from Member m where m.username = ?1 //위치 기반 select m from Member m where m.username = :name //이름기반 ``` ### 벌크성 수정 쿼리 스프링 데이터 `JPA`에서 벌크성 수정, 삭제 쿼리는 `Modifying` 어노테이션을 사용하면 된다. `벌크성 쿼리`를 실행하고 나서 영속성 컨텍스트를 초기화하고 싶으면 `@Modifying(clearAutomatically = true)`를 사용하면 된다. 기본값은 false이다. ```java @Modifying @Query("update Product p set p.price = p.price * 1.1 where p.stockAmount < :stockAmount") int bulkPriceUp(@Param("stockAmount") String stockAmount); ``` ### 페이징과 정렬 `Page`를 사용하면 스프링 데이터 `JPA`는 페이징 기능을 제공하기 위해 검색된 전체 데이터 건수를 조회하는 `count` 쿼리를 추가로 호출한다. ```java //count 쿼리 사용 Page findByName(String name, Pageable pageable); //count 쿼리 사용 안 함 List findByName(String name, Pageable pageable); ``` ```java //페이징 조건과 정렬 조건 설정 PageRequest pageRequest = new PageRequest(0, 10, new Sort(Direction.DESC, "name")); Page result = memberRepository.findByNameStartingWith("김", pageRequest); List members = result.getContent (); //조회된 데이터 int totalPages = result.getTotalPages (); //전체 페이지 수 boolean hasNextPage = result .hasNextPage (); //다음 페이지 존재 여부 ``` ## 명세 명세(`Specification`)를 이해하기 위한 핵심 단어는 술어(`Predicate`)인데 이것은 단순히 참이나 것으로 평가된다. 그리고 이것은 `AND`, `OR` 같은 연산자로 조합할 수 있다. `Specification`은 컴포지트 패턴으로 구성되어 있어서 여러 `Specification`을 조합할 수 있다. ### 사용자 정의 리포지터리 구현 스프링 데이터 `JPA`로 리포지터리를 개발하면 `인터페이스`만 정의하고 구현체는 만들지 않는다. 하지만 다양한 이유로 `메소드`를 직접 구현해야 할 때도 있다. 그렇다고 리포지터리를 직접 구현하면 공통 인터페이스가 제공하는 기능까지 모두 구현해야 한다. **스프링 데이터 JPA는 이런 문제를 우회해서 필요한 메소드만 구현할 수 있는 방법을 제공한다.** ```java public interface MemberRepositoryCustom { public List findMemberCustom(); } ``` 이때 클래스 이름을 짓는 규칙이 있는데 리포지터리 인터페이스 이름 + Impl로 지어야 한다. 이렇게 하면 스프링 데이터 JPA가 사용자 정의 구현 클래스로 인식한다. ```java public class MemberRepositorylmpl implements MemberRepositoryCustom { @Override public List findMemberCustom () { ... //사용자정의구현 } } ``` 만약 사용자 정의 구현 클래스 이름 끝에 Impl 대신 다른 이름을 붙이고 싶으면 `repository-impl-postfix` 속성을 변경하면 된다. 참고로 `Impl`이 기본값이다. ```java @EnableJpaRepositories(basePackages = "jpabook.jpashop.repository", repositorylmplementationPostfix = "Impl") ``` ## Web 확장 스프링 데이터 프로젝트는 스프링 `MVC`에서 사용할 수 있는 편리한 기능을 제공한다. `식별자`로 도메인 클래스를 바로 `바인딩`해주는 `도메인 클래스 컨버터 기능`과, `페이징`과 `정렬` 기능을 알아보자 ### 설정 `JavaConfig`를 사용하면 다음과 같이 `EnableSpringDataWebSupport` 어노테이션을 사용하면 된다. ```java @Configuration @EnableWebMvc @EnableSpringDataWebSupport public class WebAppConfig { ... } ``` 설정을 완료하면 도메인 클래스 컨버터와 페이징과 정렬을 위한 `HandlerMethodArgumentResolver`가 스프링 빈으로 등록된다. ### 도메인 클래스 컨버터 기능 ```java @Controller public class MemberController { @RequestMapping ("meinber/memberUpdateForm") public String memberUpdateForm(@RequestParam("id") Member member, Model model) { model.addAttribute("member", member); return "member/memberSaveFom"; } } ``` '`@RequestParam("id") Member member`' 부분을 보면 `HTTP` 요청으로 회원 아이디(id)를 받지만 도메인 클래스 컨버터가 중간에 동작해서 아이디를 회원 엔티티 객체로 변환해서 넘겨준다. 따라서 컨트롤러를 단순하게 사용할 수 있다. 도메인 클래스 컨버터를 통해 넘어온 회원 엔티티를 컨트롤러에서 직접 수정해도 실제 데이터베이스에는 반영되지 않는다. 이는 스프링 데이터와는 관련이 없고 순전히 영속성 컨텍스트의 동작 방식과 관련이 있다. * OSIV를 사용하지 않으면: 조회한 엔티티는 준영속 상태다. 따라서 변경 감지기능이 동작하지 않는다. 만약 수정한 내용을 데이터베이스에 반영하고 싶으면 병합(merge)을 사용해야 한다. * OSIV를 사용하면: 조회한 엔티티는 영속 상태다. 하지만 OSIV의 특성상 컨트롤러와 뷰에서는 영속성 컨텍스트를 플러시하지 않는다. 만약 데이터베이스에 반영하고 싶으면 서비스 계층을 호출해야 한다. 그러면 서비스 계층이 종료될 때 플러시와 커밋이 일어나서 반영될 것이다. ### 페이징과 정렬 기능 스프링 데이터가 제공하는 페이징과 정렬 기능을 스프링 MVC에서 편리하게 사용할 수 있도록 `HandlerMethodArgumentResolver`를 제공한다. * 페이징 기능 : `PageableHandlerMethodArgumentResolver` * 정렬 기능 : `SortHandlerMethodArgumentResolver` ```java @RequestMapping(value = "/members", method = RequestMethod.GET) public String list(Pageable pageable, Model model) { Page page = memberService.findMembers(pageable); model.addAttribute("members", page.getContent()); return "members/memberList"; } ``` #### 접두사 사용해야 할 페이징 정보가 둘 이상이면 접두사를 사용해서 구분할 수 있다. 접두사는 스프링 프레임워크가 제공하는 `@Qualifier` 어노테이션을 사용한다. 그리고 "`{접두사명}_`"로 구분한다. ```java public String list( @Qualifier ("member") Pageable memberPageable, @Qualifier ("order") Pageable orderPageable, ... // ex) members?member_jpage=0&order_page=1 ``` ### 정리 * `getOne()` 사용하면 프록시인데 컨트롤러 영역에서 그대로 response를 내려준다면 괜찮은가? * 간단한 조인은 `'_'`로 할수 있다. 실행해볼것 * jpql은 파라미터 순서가 1, 네이티브 파라미터는 순서가 0 부터 시작한다 * `clearAutomatically`옵션 사용방법 * 페이징 쿼리 하나의 쿼리로 나올 순 없을까? * sql 힌트 사용해보았나? * sql hint? jpa hint? 차이는?? * lock? 트랜잭션 차이는?? * 커스텀이랑 레파지토리랑 메소드가 겹칠때 우선순위는 어떤게 더 높을까?