[스프링 DB 2편] #8. 데이터 접근 기술 - 활용방안

[YuDeokRin]

데이터 접근 기술 - 활용 방안

1️⃣ 스프링 데이터 JPA 예제와 트레이드 오프

• 스프링 데이터 JPA 예제를 다시 보기

• 런타임 객체 의존 관계

• 중간에서 JpaItemRepositoryV2가 어댑터 역할을 해준 덕분에 ItemService가 사용하는 ItemRepository 인터페이스를 그대로 유지할 수 있고 클라이언트 ItemService의 코드를 변경하지 않아도 되는 장점이 있다.

➡️ 고민

• 구조를 맞추기 위해서, 중간에 어댑터가 들어가면서 전체 구조가 복잡해지고 사용하는 클래스도 많아지는 단점이 생김.
• 실제 이 코드를 구현해야하는 개발자 입장에서 보면 중간에 어댑터도 만들고, 실제 코드까지 만들어야 하는 불편성
• 유지보수 관점에서 ItemService를 변경하지않고 ItemRepository의 구현체를 변경할 수 있는 장점이 있다.
  • DI, OCP를 지킬수 있다는 장점
  • 반면에, 구조가 복잡해지면서 어댑터 코드와 실제 코드까지 함께 유지보수 해야 하는 단점

➡️ 다른 선택

• 여기서 완전히 다른 선택을 할 수도 있다.
• ItemService 코드를 일부 고쳐서 직접 스프링 데이터 JPA를 사용하는 방법이다.
• DI, OCP 원칙을 포기하는 대신에, 복잡한 어댑터를 제거하고, 구조를 단순하게 가져갈 수 있는 장점이 있다.

• ItemService 에서 스프링 데이터 JPA로 만든 리포지토리를 직접 참조한다. 물론 이 경우 ItemService 코 드를 변경해야 한다.

• 런타임 객체 의존 관계

➡️ 트레이드 오프

• DI, OCP를 지키기 위해 어댑터를 도입하고, 더 많은 코드를 유지한다.

• 어댑터를 제거하고 구조를 단순하게 가져가지만, DI, OCP를 포기하고, ItemService 코드를 직접 변경한다.

• 여기서 발생하는 트레이드 오프

  • 구조의 안정성 vs 단순한 구조와 개발의 편리성 사이의 선택

개발을 할 때는 항상 자원이 무한하지 않다. 어설픈 추상화는 오히려 독이 되는 경우도 많다. 무엇보다 추상화도 비용이 든다. 인터페이스도 비용이 든다. 여기서 말하는 비용은 유지보수 관점에서 비용을 뜻한다. 이 추상화 비용을 넘어설 만큼 효과가 있을 때 추상화를 도입하는 것이 실용적

2️⃣ 실용적인 구조

• 스프링 데이터 JPA의 기능은 최대한 살리면서 Querydsl도 편리하게 사용할 수 있는 구조를 만들어 보자.

• 복잡한 쿼리 분리

  • ItemRepositoryV2는 스프링 데이터 JPA의 기능을 제공하는 리포지토리이다.
  • ItemQueryRepositoryV2는 Querydsl을 사용해서 복잡한 쿼리 기능을 제공하는 리포지토리이다.

• 아래와 같이 분리하면 기본 CRUD와 단순 조회는 스프링 데이터 JPA가 담당, 복잡한 쿼리 조회는 Querydsl담당

• ItemRepositoryV2
  • ItemRepositoryV2는 JpaRepository를 인터페이스 상속 받아서 스프링 데이터 JPA의 기능을 제공하는 리포지토리가 된다.
  • 기본 CRUD는 이 기능 사용
  • 단순한 조회 쿼리 추가해서 사용

package hello.itemservice.repository.v2;

import hello.itemservice.domain.Item;
import org.springframework.data.jpa.repository.JpaRepository;
 
 
public interface ItemRepositoryV2 extends JpaRepository<Item, Long> {}

• ItemQueryRepositoryV2
  • Querydsl을 사용한 쿼리 문제에 집중되어 있어서, 복잡한 쿼리는 이 부분만 유지보수 하면 되는 장점이 있다.

@Repository
public class ItemQueryRepositoryV2 { //Querydsl을 사용해서 복잡한 쿼리 문제를 해결한다.
    private final JPAQueryFactory query;
    public ItemQueryRepositoryV2(EntityManager em) {
        this.query = new JPAQueryFactory(em);
		}
    
    public List<Item> findAll(ItemSearchCond cond) {
        return query.select(item)
				        .from(item)
				        .where(
						        maxPrice(cond.getMaxPrice()),
						        likeItemName(cond.getItemName()))
								.fetch();
		}
		
		

    private BooleanExpression likeItemName(String itemName) {
        if (StringUtils.hasText(itemName)) {
            return item.itemName.like("%" + itemName + "%");
        }
        return null;
    }
    
    private BooleanExpression maxPrice(Integer maxPrice) {
        if (maxPrice != null) {
            return item.price.loe(maxPrice);
        }
        return null;
    }
}

• ItemServiceV2
  • 기존 ItemServiceV1 코드를 남겨두기 위해서 ItemServiceV2를 만들었다.
  • ItemServiceV2 는 ItemRepositoryV2 와 ItemQueryRepositoryV2 를 의존한다.

@Service
 @RequiredArgsConstructor
 @Transactional
 public class ItemServiceV2 implements ItemService {
     private final ItemRepositoryV2 itemRepositoryV2;
     private final ItemQueryRepositoryV2 itemQueryRepositoryV2;
     @Override
     public Item save(Item item) {
         return itemRepositoryV2.save(item);
     }
     @Override
     public void update(Long itemId, ItemUpdateDto updateParam) {
         Item findItem = findById(itemId).orElseThrow();
         findItem.setItemName(updateParam.getItemName());
         findItem.setPrice(updateParam.getPrice());
         findItem.setQuantity(updateParam.getQuantity());
		}
    @Override
    public Optional<Item> findById(Long id) {
         return itemRepositoryV2.findById(id);
    }	
     
    @Override
    public List<Item> findItems(ItemSearchCond cond) {
        return itemQueryRepositoryV2.findAll(cond);
    }

}

• V2Confog
  • ItemRepository는 테스트에서 사용하므로 여전히 필요하다.

@Configuration
 @RequiredArgsConstructor
 public class V2Config {
     private final EntityManager em;
     private final ItemRepositoryV2 itemRepositoryV2; //SpringDataJPA
     
     @Bean
     public ItemService itemService() {
         return new ItemServiceV2(itemRepositoryV2, itemQueryRepository());
     }
     
     @Bean
     public ItemQueryRepositoryV2 itemQueryRepository() {
         return new ItemQueryRepositoryV2(em);
     }
     
     @Bean
     public ItemRepository itemRepository() {
       return new JpaItemRepositoryV3(em);
    }
}

• ItemServiceApplication - 변경

//@Import(QuerydslConfig.class)
@Import(V2Config.class)
@SpringBootApplication(scanBasePackages = "hello.itemservice.web")
public class ItemServiceApplication {}

➡️ 테스트 실행 해보기

• 먼저 ItemRepositoryTest 를 통해서 리포지토리가 정상 동작하는지 확인해보자. 참고로 테스트는
  ItemRepository 를 테스트 하는데, 현재 JpaItemRepositoryV3 가 스프링 빈으로 등록되어 있다.
  V2Config 에서 사용한 리포지토리를 테스트 하려면 ItemQueryRepositoryV2 , ItemRepositoryV2 용 테스 트가 별도로 필요하다.

참고: 스프링 데이터 JPA가 제공하는 커스텀 리포지토리를 사용해도 비슷하게 문제를 해결할 수는 있다.

3️⃣ 다양한 데이터 접근 기술 조합

➡️ 어떤 데이터 접근 기술을 선택하는 것이 좋을까?

• 이 부분은 하나의 정답이 있다기 보다는, 비즈니스 상황과, 현재 프로젝트 구성원의 역량에 따라서 결정하는 것이 맞다 생각한다.

• JdbcTemplate이나MyBatis는 SQL을 직접 작성해야하지만, 기술이 단순하기 때문에 SQL에 익숙한 개발자 개발 비용이 줄어든다.

• JPA, 스프링 데이터 JPA, Querydsl 같은 기술들은 개발 생산성을 혁신할 수 있지만, 학습 곡선이 높기 때문에, 이런 부분을 감안해야 한다. 매우 복잡한 통계 쿼리를 주로 작성하는 경우에는 잘 맞지 않는다.

➡️트랜잭션 매니저 선택

• JPA, 스프링 데이터 JPA, Querydsl은 모두 JPA 기술을 사용하는 것이기 때문에 트랜잭션 매니저로
  JpaTransactionManager 를 선택하면 된다. 스프링 부트는 자동으로 JpaTransactionManager를 스프링 빈에 등록한다.
• JdbcTemplate , MyBatis 와 같은 기술들은 내부에서 JDBC를 직접 사용하기 때문에DataSourceTransactionManager를 사용

JPA와 JdbcTemplate 두 기술을 함께 사용하면 트랜잭션 매니저가 달라진다. 결국 트랜잭션을 하나로 묶을 수 없는 문제가 발생할 수 있다. 그런데 이 부분은 걱정하지 않아도 된다.

➡️JpaTransactionManager의 다양한 지원

• JpaTransactionManager 는 놀랍게도 DataSourceTransactionManager 가 제공하는 기능도 대부분 제공한다
• JPA라는 기술도 결국 내부에서는 DataSource와 JDBC 커넥션을 사용하기 때문이다. 따라서 JdbcTemplate , MyBatis 와 함께 사용할 수 있다.
• JpaTransactionManager 를 하나만 스프링 빈에 등록하면, JPA, JdbcTemplate, MyBatis 모두를 하나의 트랜잭션으로 묶어서 사용할 수 있다

➡️ 주의점

• JPA와 JdbcTemplate을 함께 사용할 경우 JPA의 플러시 타이밍에 주의해야 한다.

• JPA는 데이터를 변경하면 변경 사항을 즉시 데이터베이스에 반영하지 않는다. 기본적으로 트랜잭션이 커밋되는 시점에 변경 사항을 데이터베이스에 반영한다.

• 하나의 트랜잭션 안에서 JPA를 통해 데이터를 변경한 다음에 JdbcTemplate을 호출하는 경우
  JdbcTemplate에서는 JPA가 변경한 데이터를 읽기 못하는 문제가 발생한다.

• 위 문제 해결 방법

  • 문제를 해결하려면 JPA 호출이 끝난 시점에 JPA가 제공하는 플러시라는 기능을 사용해서 JPA의 변경 내역을 데이 터베이스에 반영해주어야 한다.

[6om1n]

수고하셨습니당 ~~~~ 👍