10/30 TIL | getReferenceById & findById 정리.

우선 getReferenceById에 대해서 말하려면, getOne과 getById도 등장해야 한다. 이 셋은 같은 메서드인데, getOne이 스프링 2.5 버전에 deprecated되면서 getById라는 메서드로 바뀌었고, 스프링 2.7 버전에 다시 deprecated되고 getReferenceById라고 이름이 바뀌었다. 공식 문서에서 똑같은 기능을 기술하고 있기 때문에 더 나은 네이밍을 위해 기능은 같으나 이름이 변경된 케이스라고 생각하면 된다.

그렇다면 어떤 경우에 getReferenceById를 사용하고, 어떤 경우에 findById를 사용해야 할까? 우선 getReferenceById는 찾으려는 대상이 없는 경우 내부에서 예외를 발생시킨다. 반면, findById는 찾으려는 대상이 없는 경우 예외가 따로 발생하거나 하지는 않는다. 그렇기 때문에 조회하고자 할 때 반드시 결과를 돌려받아야 하는 경우에는 getReferenceById를 사용하는 것이 적당하고, 그렇지 않아도 되는 경우에는 findById를 사용하는 것이 적당하겠다.

의미론적으로 생각해보면 비교적 명쾌해지는데 get은 "가지다"라는 의미를 뜻하고, find는 "찾다"라는 의미를 뜻한다. 하여 find를 하게 되면 저장소는 무언가를 "찾는" 반면, get을 하게 되면 저장소는 무언가를 "가져온다". 그렇기 때문에 "찾기"를 통해 결과를 찾지 못할 수도 있지만 "가져오기"는 항상 무언가를 반환해야 한다. 그렇기 때문에 getReferenceById는 예외가 발생하고, findById는 예외가 발생하지 않는다라고 맥락적으로 이해할 수 있다.

또한 findById는 요청하는 순간 쿼리가 처리되는 반면, getReferenceById는 EntityManager의 getReference 메서드를 호출하여 참조 값만 가져온 후, 조회된 entity를 사용하는 순간에 쿼리가 처리되는 lazy loading으로 DB를 조회해 값을 가져온다. 요청하는 시점에 DB를 조회하는 getReferenceById는 내부 값을 필요로 하지 않고, 다른 객체에 할당할 때 사용하면 좋다.

참고

JpaRepository.getOne/getById method name should indicate that it returns a reference · Issue #2232 · spring-projects/spring-da

find vs. get – Thomas Uhrig