[스프링 DB 2편] #1. 데이터 접근 기술 - 시작

[6om1n]

1️⃣ 데이터 접근 기술 진행 방식 소개

적용 데이터 접근 기술

• JdbcTemplate
• MyBatis
• JPA , Hibernate
• 스프링 데이터 JPA
• Querydsl

여기에는 크게 2가지 분류가 있다.

SQLMapper

• JdbcTemplate
• MyBatis

ORM 관련 기술

• JPA, Hibernate
• 스프링 데이터 JPA
• Querydsl

SQLMapper 주요기능

• 개발자는 SQL만 작성하면 해당 SQL의 결과를 객체로 편리하게 매핑해준다.
• JDBC를 직접 사용할 때 발생하는 여러가지 중복을 제거해주고, 기타 개발자에게 여러가지 편리한 기능을 제공한다.

ORM 주요 기능

• JdbcTemplate 이나 MyBatis 같은 SQL 매퍼 기술은 SQL을 개발자가 직접 작성해야 하지만, JPA를 사용하면 기본적인 SQL은 JPA가 대신 작성하고 처리해준다. 개발자는 저장하고 싶은 객체를 마치 자바 컬렉션에 저장하고 조회하듯이 사용하면 ORM 기술이 데이터베이스에 해당 객체를 저장하고 조회해준다.
• JPA는 자바 진영의 ORM 표준이고, Hibernate 는 JPA에서 가장 많이 사용하는 구현체이다. 자바에서 ORM을 사용할 때는 JPA 인터페이스를 사용하고, 그 구현체로 하이버네이트를 사용한다고 생각하면 된다.
• 스프링 데이터 JPA, Querydsl 은 JPA를 더 편리하게 사용할 수 있도록 도와주는 프로젝트이다. 실무에서는 JPA를 사용하면 이 프로젝트도 꼭 !!! 함께 사용하는 것이 좋다.

---

2️⃣ 프로젝트 설정과 메모리 저장소

프로젝트 설정 순서

1. itemservice-db-start 의 폴더 이름을 itemservice-db 로 변경
2. 프로젝트 임포트해서 실행

• localhost:8080 에 들어가서 각각의 기능이 잘 동작하는 지 확인
  

---

3️⃣ 프로젝트 구조 설명1 - 기본

프로젝트 설정

build.gradle

plugins {
	id 'org.springframework.boot' version '2.6.5'
	id 'io.spring.dependency-management' version '1.0.11.RELEASE'
	id 'java'
}

group = 'com.example'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '11'

configurations {
	compileOnly {
		extendsFrom annotationProcessor
	}
}

repositories {
	mavenCentral()
}

dependencies {
	implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
	implementation 'org.springframework.boot:spring-boot-starter-web'
	compileOnly 'org.projectlombok:lombok'
	annotationProcessor 'org.projectlombok:lombok'
	testImplementation 'org.springframework.boot:spring-boot-starter-test'

	//테스트에서 lombok 사용
	testCompileOnly 'org.projectlombok:lombok'
	testAnnotationProcessor 'org.projectlombok:lombok'
}

tasks.named('test') {
	useJUnitPlatform()
}

• spring-boot-starter-thymeleaf : 타임리프 사용
• spring-boot-starter-web : 스프링 웹, MVC 기능 사용
• spring-boot-starter-test : 스프링이 제공하는 테스트 기능
• lombok : lombok을 추가로 테스트에서도 사용하는 설정 주의

도메인 분석

item

package hello.itemservice.domain;

import lombok.Data;

@Data
public class Item {

    private Long id;

    private String itemName;
    private Integer price;
    private Integer quantity;

    public Item() {
    }

    public Item(String itemName, Integer price, Integer quantity) {
        this.itemName = itemName;
        this.price = price;
        this.quantity = quantity;
    }
}

• Item 은 상품 자체를 나타내는 객체이며, 이름, 가격, 수량을 속성으로 가지고 있다.

리포지토리 분석

ItemRepository 인터페이스

 package hello.itemservice.repository;

import hello.itemservice.domain.Item;

import java.util.List;
import java.util.Optional;

public interface ItemRepository {

    Item save(Item item);

    void update(Long itemId, ItemUpdateDto updateParam);

    Optional<Item> findById(Long id);

    List<Item> findAll(ItemSearchCond cond);

}

• 메모리 구현체에서 향후 다양한 데이터 접근 기술 구현체로 손쉽게 변경하기 위해 리포지토리에 인터페이스를 도입하였다.

ItemSearchCond

package hello.itemservice.repository;

import lombok.Data;

@Data
public class ItemSearchCond {

    private String itemName;
    private Integer maxPrice;

    public ItemSearchCond() {
    }

    public ItemSearchCond(String itemName, Integer maxPrice) {
        this.itemName = itemName;
        this.maxPrice = maxPrice;
    }
}

• 검색 조건으로 사용되며, 상품명, 최대 가격이 있다. 참고도 상품명의 일부만 포함되어도 검색이 가능해야 한다. (like 검색)

ItemUpdateDto

package hello.itemservice.repository;

import lombok.Data;

@Data
public class ItemUpdateDto {
    private String itemName;
    private Integer price;
    private Integer quantity;

    public ItemUpdateDto() {
    }

    public ItemUpdateDto(String itemName, Integer price, Integer quantity) {
        this.itemName = itemName;
        this.price = price;
        this.quantity = quantity;
    }
}

• 상품을 수정할 때 사용하는 객체이다.
• 단순히 데이터를 전달하는 용도로 사용되므로 DTO 를 뒤에 붙였다.

📍 DTO(data transfer object)

• 데이터 전송 객체로 , 기능은 없고 데이터를 전달만 하는 용도로 사용되는 객체를 뜻한다.
  • DTO 에 기능이 있어도 된다. 객체의 주 목적이 데이터를 전송하는 것이라면 DTO라고 할 수 있다.
• 객체 이름에 DTO를 꼭 붙여야 하는 것은 아니지만, 붙여두면 용도를 알 수 있다는 장점이 있다.
• ItemSearchCond 도 DTO의 역할을 하지만 이 프로젝트에서는 Cond 는 검색 조건으로 사용한다는 규칙을 정했기 때문에 DTO를 붙이기 않아도 된다.
• 규칙은 정해진 것이 없기 때문에 일관성 있게 규칙을 정하면 된다.

MemoryItemRepository

  package hello.itemservice.repository.memory;

import hello.itemservice.domain.Item;
import hello.itemservice.repository.ItemRepository;
import hello.itemservice.repository.ItemSearchCond;
import hello.itemservice.repository.ItemUpdateDto;
import org.springframework.stereotype.Repository;
import org.springframework.util.ObjectUtils;

import java.util.*;
import java.util.stream.Collectors;

@Repository
public class MemoryItemRepository implements ItemRepository {

    private static final Map<Long, Item> store = new HashMap<>(); //static
    private static long sequence = 0L; //static

    @Override
    public Item save(Item item) {
        item.setId(++sequence);
        store.put(item.getId(), item);
        return 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 Optional.ofNullable(store.get(id));
    }

    @Override
    public List<Item> findAll(ItemSearchCond cond) {
        String itemName = cond.getItemName();
        Integer maxPrice = cond.getMaxPrice();
        return store.values().stream()
                .filter(item -> {
                    if (ObjectUtils.isEmpty(itemName)) {
                        return true;
                    }
                    return item.getItemName().contains(itemName);
                }).filter(item -> {
                    if (maxPrice == null) {
                        return true;
                    }
                    return item.getPrice() <= maxPrice;
                })
                .collect(Collectors.toList());
    }

    public void clearStore() {
        store.clear();
    }

}

• ItemRepository 인터페이스를 구현한 메모리 저장소이다. 메모리이기에 다시 실행하면 기존에 저장된 데이터가 모두 사라진다.
• findById 는 Optional 을 반환해야 하기 때문에 Optional.ofNullable 을 사용했다.
• findAll 은 ItemSearchCond 이라는 검색 조건을 받아서 내부에서 데이터를 검색하는 기능을 한다. where 구문을 사용해서 필요한 데이터를 필터링 하는 과정을 거치는 것이다.
  • 여기서 자바 스트림을 사용한다.
  • itemName 이나, maxPrice 가 null 이거나 비었으면 해당 조건을 무시한다.
  • itemName 이나 maxPrice 에 값이 있을 때만 해당 조건으로 필터링 기능을 수행한다.
• clearStore() 메모리에 저장된 Item 을 모두 삭제해서 초기화한다. 테스트 용도로만 사용된다.

서비스 분석

ItemService 인터페이스

package hello.itemservice.service;

import hello.itemservice.domain.Item;
import hello.itemservice.repository.ItemSearchCond;
import hello.itemservice.repository.ItemUpdateDto;

import java.util.List;
import java.util.Optional;

public interface ItemService {

    Item save(Item item);

    void update(Long itemId, ItemUpdateDto updateParam);

    Optional<Item> findById(Long id);

    List<Item> findItems(ItemSearchCond itemSearch);
}

• 서비스의 구현체를 쉽게 변경하기 위해 인터페이스를 사용했다.
• 서비스는 구현체를 변경할 일이 많지는 않기 때문에 서비스에 인터페이스를 잘 도입하지는 않는다.

ItemServiceV1

package hello.itemservice.service;

import hello.itemservice.domain.Item;
import hello.itemservice.repository.ItemRepository;
import hello.itemservice.repository.ItemSearchCond;
import hello.itemservice.repository.ItemUpdateDto;
import lombok.RequiredArgsConstructor;
import org.springframework.stereotype.Service;

import java.util.List;
import java.util.Optional;

@Service
@RequiredArgsConstructor
public class ItemServiceV1 implements ItemService {

    private final ItemRepository itemRepository;

    @Override
    public Item save(Item item) {
        return itemRepository.save(item);
    }

    @Override
    public void update(Long itemId, ItemUpdateDto updateParam) {
        itemRepository.update(itemId, updateParam);
    }

    @Override
    public Optional<Item> findById(Long id) {
        return itemRepository.findById(id);
    }

    @Override
    public List<Item> findItems(ItemSearchCond cond) {
        return itemRepository.findAll(cond);
    }
}

• ItemServiceV1 서비스 구현체는 대부분의 기능을 단순히 리포지토리에 위임한다.

컨트롤러 분석

HomeController

• 단순히 홈으로 요청이 왔을 때 items 로 이동하는 컨트롤러

ItemController

• 상품을 CRUD 하는 컨트롤러이다.
• 화면을 출력하기 위한 리소스는 MVC1편 참고

---

4️⃣ 프로젝트 구조 설명2 - 설정

스프링 부트 설정 분석

MemoryConfig

package hello.itemservice.config;

import hello.itemservice.repository.ItemRepository;
import hello.itemservice.repository.memory.MemoryItemRepository;
import hello.itemservice.service.ItemService;
import hello.itemservice.service.ItemServiceV1;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MemoryConfig {

    @Bean
    public ItemService itemService() {
        return new ItemServiceV1(itemRepository());
    }

    @Bean
    public ItemRepository itemRepository() {
        return new MemoryItemRepository();
    }

}

• ItemServiceV1 , MemoryItemRepository 를 스프링 빈으로 등록하고 생성자를 통해 의존관계를 주입한다.
• 서비스와 리포지토리는 구현체를 편리하게 변경하기 위해 수동으로 빈을 등록했다.
• 컨트롤러는 컴포넌트 스캔을 사용한다.

TestDataInit

package hello.itemservice;

import hello.itemservice.domain.Item;
import hello.itemservice.repository.ItemRepository;
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.boot.context.event.ApplicationReadyEvent;
import org.springframework.context.event.EventListener;

@Slf4j
@RequiredArgsConstructor
public class TestDataInit {

    private final ItemRepository itemRepository;

    /**
     * 확인용 초기 데이터 추가
     */
    @EventListener(ApplicationReadyEvent.class)
    public void initData() {
        log.info("test data init");
        itemRepository.save(new Item("itemA", 10000, 10));
        itemRepository.save(new Item("itemB", 20000, 20));
    }

}

• 애플리케이션을 실행할 때 초기 데이터를 저장한다.
• 리스트에서 데이터가 잘 나오는 지 편리하게 확인할 용도로 사용한다. (이 기능이 없으면 서버 실행할 때마다 데이터를 입력해야함)
• @EvenListener(ApplicationReadyEvent.class); : 스프링 컨테이너가 완전히 초기화를 다 끝내고, 실행 준비가 되었을 때 발생하는 이벤트이다. 스프링은 이 시점에 해당 애노테이션이 붙은 initData() 메소드를 호출해준다.
  • 이 기능 대신 @PostConstruct 를 사용할 경우 AOP 같은 부분이 아직 다 처리되지 않은 시점에 호출될 수 있기에 문제가 발생할 수 있다. 예를 들어 @Transactional 과 관련된 AOP가 적용되지 않은 상태로 호출될 수 있다.

ItemServiceApplication

 package hello.itemservice;

import hello.itemservice.config.*;
import hello.itemservice.repository.ItemRepository;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Import;
import org.springframework.context.annotation.Profile;


@Import(MemoryConfig.class)
@SpringBootApplication(scanBasePackages = "hello.itemservice.web")
public class ItemServiceApplication {

	public static void main(String[] args) {
		SpringApplication.run(ItemServiceApplication.class, args);
	}

	@Bean
	@Profile("local")
	public TestDataInit testDataInit(ItemRepository itemRepository) {
		return new TestDataInit(itemRepository);
	}

}

• @Import(MemoryConfig.class) : 앞서 설정한 MemoryConfig 를 설정 파일로 사용한다.
• scanBasePackages = "hello.itemservice.web": 여기서는 컨트롤러만 컴포넌트 스캔을 사용하고, 나머지는 직접 수동 등록한다. 그래서 컴포넌트 스캔 경로를 hello.itemservice.web 하위로 지정했다.
• @Profile("local") : 특정 프로필의 경우에만 해당 스프링 빈을 등록한다. local 이라는 이름의 프로필이 사용되는 경우에만 testDataInit 이라는 스프링 빈을 등록한다.

프로필

스프링은 로딩 시점에 application.properties 의 spring.profiles.active 속성을 읽어서 프로필로 사용한다.
예를 들어 로컬PC에서는 로컬PC에 설치된 데이터베이스에 접근해야 하고, 운영 환경에서는 운영 데이터베이스에 접근해야 한다면 서로 설정 정보가 달라야 한다. 환경에 따라서는 다른 스프링 빈을 등록해야 할 수도 있다.
프로필을 사용하면 이런 문제를 깔끔하게 해결할 수 있다.

main 프로필

/src/main/resources 하위의 application.properties

spring.profiles.active=local

• 이 위치의 application.properties 는 /src/main 하위의 자바 객체를 실행할 때 동작하는 스프링 설정이다. 스프링은 local 이라는 프로필로 동작한다.
• 직전에 설명한 @Profile("local") 이 동작하고, testDataInit 이 스프링 빈으로 등록된다.

• 실행하면 확인할 수 있는 로그
• 프로필을 지정하지 않으면 디폴트(default) 프로필이 실행된다.

test 프로필

/src/test/resources 하위의 application.properties

spring.profiles.active=test

• application.properties 는 /src/test 하위의 자바 객체를 실행할 때 동작하는 스프링 설정이다.

• 주로 테스트 케이스를 실행할 때 동작한다.

• 이 경우에는 직전에 설명한 @Profile("local") 는 프로필 정보가 맞지 않아서 동작하지 않는다. testDataInit 스프링 빈도 등록되지 않고, 초기 데이터도 추가하지 않는다.

• 프로필 기능을 사용해서 스프링으로 웹 애플리케이션을 로컬에서 직접 실행할 때는 testDataInit 이 스프링 빈으로 등록된다. 따라서 등록한 초기화 데이터를 편리하게 확인할 수 있다.

• 초기화 데이터 덕에 편리한 점도 있지만 테스트 케이스를 실행할 때는 문제가 될 수 있다. 데이터를 하나 저장하고 전체 카운트를 확인하는데 1이 아니라 testDataInit 때문에 데이터가 2건 추가되어 3건이 되는 일이 발생한다.

• 프로필 기능 덕분에 테스트 케이스에서는 test 프로필이 실행된다. 따라서 TestDataInit 는 스프링 빈으로 추가되지 않고, 초기 데이터로 추가되지 않는다.

---

5️⃣ 프로젝트 구조 설명3 - 테스트

ItemRepositoryTest

package hello.itemservice.domain;

import hello.itemservice.repository.ItemRepository;
import hello.itemservice.repository.ItemSearchCond;
import hello.itemservice.repository.ItemUpdateDto;
import hello.itemservice.repository.memory.MemoryItemRepository;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;

import java.util.List;

import static org.assertj.core.api.Assertions.assertThat;

@SpringBootTest
class ItemRepositoryTest {

    @Autowired
    ItemRepository itemRepository;

    @AfterEach
    void afterEach() {
        //MemoryItemRepository 의 경우 제한적으로 사용
        if (itemRepository instanceof MemoryItemRepository) {
            ((MemoryItemRepository) itemRepository).clearStore();
        }
    }

    @Test
    void save() {
        //given
        Item item = new Item("itemA", 10000, 10);

        //when
        Item savedItem = itemRepository.save(item);

        //then
        Item findItem = itemRepository.findById(item.getId()).get();
        assertThat(findItem).isEqualTo(savedItem);
    }

    @Test
    void updateItem() {
        //given
        Item item = new Item("item1", 10000, 10);
        Item savedItem = itemRepository.save(item);
        Long itemId = savedItem.getId();

        //when
        ItemUpdateDto updateParam = new ItemUpdateDto("item2", 20000, 30);
        itemRepository.update(itemId, updateParam);

        //then
        Item findItem = itemRepository.findById(itemId).get();
        assertThat(findItem.getItemName()).isEqualTo(updateParam.getItemName());
        assertThat(findItem.getPrice()).isEqualTo(updateParam.getPrice());
        assertThat(findItem.getQuantity()).isEqualTo(updateParam.getQuantity());
    }

    @Test
    void findItems() {
        //given
        Item item1 = new Item("itemA-1", 10000, 10);
        Item item2 = new Item("itemA-2", 20000, 20);
        Item item3 = new Item("itemB-1", 30000, 30);

        itemRepository.save(item1);
        itemRepository.save(item2);
        itemRepository.save(item3);

        //둘 다 없음 검증
        test(null, null, item1, item2, item3);
        test("", null, item1, item2, item3);

        //itemName 검증
        test("itemA", null, item1, item2);
        test("temA", null, item1, item2);
        test("itemB", null, item3);

        //maxPrice 검증
        test(null, 10000, item1);

        //둘 다 있음 검증
        test("itemA", 10000, item1);
    }

    void test(String itemName, Integer maxPrice, Item... items) {
        List<Item> result = itemRepository.findAll(new ItemSearchCond(itemName, maxPrice));
        assertThat(result).containsExactly(items);
    }
}

• afterEach() : 테스트는 서로 영향을 주면 안되기 때문에 각각 테스트가 끝나고 저장한 데이터를 제거해야 한다. @AfterEach 는 각각의 테스트의 실행이 끝나는 시점에 호출된다. 메모리 저장소를 완전히 삭제해서 다음 테스트에 영향을 주지 않도록 초기화 한다.
• 인터페이스에는 clearStore() 가 없기 때문에 MemoryItemRepository 인 경우에만 다운 캐스팅을 해서 데이터를 초기화한다.
• save() : 상품 하나를 저장하고 잘 저장되었는지 검증한다.
• updateItem() : 상품을 하나 수정하고 잘 수정되었는지 검증한다.
• findItems() : 상품을 찾는 테스트이다.
  • 상품명과 상품 가격 조건을 다양하게 비교하는 것을 확인할 수 있다.
  • 문자의 경우 null 조건도 있지만, 빈 문자("") 의 경우에도 잘 동작하는 지 검증한다.

---

6️⃣ 데이터베이스 테이블 생성

item 테이블 생성

 drop table if exists item CASCADE;
 create table item
 (
    id        bigint generated by default as identity,
    item_name varchar(10),
    price     integer,
    quantity  integer,
   primary key (id)
 );

• generated by default as identity
  • identity 전략이라고 하는데, 기본 키 생성을 데이터베이스에 위임하는 방법이다. MySQL의 AutoIncrement 와 같은 방법이다.
  • 여기서 PK로 사용되는 id 는 개발자가 직접 지정하는 것이 아니라 비워두고 저장하면 된다. 데이터베이스가 순서대로 증가하는 값을 사용해서 넣어준다.

테이블 생성과 동작하는 지 확인

• 등록쿼리

  insert into item(item_name, price, quantity) values ('ItemTest', 10000, 10)

• 조회쿼리

 select * from item;

• 실행결과
  

📍 참고 - 권장하는 식별자 선택 전략

데이터베이스의 기본 키는 다음 3가지 조건을 모두 만족해야 한다.

1. null 값은 허용하지 않는다.
2. 유일해야 한다.
3. 변해선 안된다.

테이블의 기본 키를 선택하는 전략을 크게 2가지가 있다.

• 자연 키
  • 비즈니스에 의미가 있는 키
  • 예를 들어, 주민등록번호, 이메일, 전화번호
• 대리 키
  • 비즈니스와 관련 없는 임의로 만들어진 키, 대체 키로도 불린다.
  • 예를 들어 오라클 시퀀스, auto_increment, identity, 키 생성 테이블 사용

자연 키 보다는 대리 키를 권장한다 .

• 현실과 비즈니스 규칙은 생각보다 쉽게 변한다 !! 주민등록번호 조차 미래에 여러 가지 이유로 변경될 수 있기에 대리 키의 사용을 권장한다.

비즈니스 환경은 언젠가 변한다.

---

🔗 출처

김영한 - 스프링 DB 2편 - 데이터 접근 활용 기술

---

[newh08]

고생하셨습니다! DB 2편도 뿌셔버려요!

[YuDeokRin]

고생하셨습니다! DB 2편 출발 !