[Board] 1차 제출입니다!

docs/test.md

@@ -0,0 +1,122 @@
+# Spring Test
+
+---
+
+## @DataJpaTest와 JUnit을 사용한 Repository 테스트
+
+---
+
+### 개요
+
+* Spring Boot 애플리케이션에서 Spring Data JPA를 사용하여 데이터베이스를 다룰 때, JPA Repository가 제대로 동작하는지 테스트하는 것이 중요합니다.
+
+----
+
+### @DataJpaTest
+
+* @DataJpaTest 란? -> JPA Repository 테스트를 위한 애너테이션입니다.
+* 최소한의 Spring 컨텍스트만 로드하여 테스트 속도를 높이고, EntityManager와 TestEntityManager를 자동 제공합니다.
+~~~
+EntityManager란? 
+
+-> JPA(Java Persistence API)에서 제공하는 기본적인 데이터베이스 관리 도구입니다.
+   Spring Boot에서 JPA를 사용할 때, 일반적으로 EntityManager를 사용하여 데이터베이스 작업을 수행합니다.
+
+EntityManager의 주요 기능
+
+1. 엔티티 저장: persist(entity)
+2. 엔티티 수정: merge(entity)
+3. 엔티티 삭제: remove(entity)
+4. 엔티티 조회: find(Class<T>, primaryKey), createQuery()
+
+-----------------------------------------------------------------------------------------
+EntityTestManager란?
+
+-> 테스트용으로 제공되는 EntityManager입니다.
+   Spring Boot의 @DataJpaTest에서 사용할 수 있으며, 일반 EntityManager보다 테스트에 최적화되어 있습니다.
+
+TestEntityManager의 특징
+
+1. 테스트 중 사용할 수 있도록 간편한 메서드 제공
+2. 트랜잭션이 자동 롤백되어 데이터가 남지 않음
+3. flush()를 명시적으로 호출하여 즉시 쿼리를 실행 가능
+
+~~~
+* 애플리케이션 전체를 로드하지 않고, JPA 관련 Bean들만 로드하여 테스트 성능을 최적화합니다.
+
+---
+
+### @DataJpaTest의 선택적 파라미터
+
+**properties 속성**
+* 테스트 환경에서 특정 Spring Boot 설정 값을 변경할 수 있습니다.
+~~~
+@DataJpaTest(properties = {
+    "spring.datasource.url=jdbc:h2:mem:testdb",
+    "spring.jpa.hibernate.ddl-auto=create-drop"
+})
+public class UserRepositoryTest {
+    // 테스트 메서드 작성
+}
+~~~
+
+**showSql 속성**
+* SQL 쿼리 로그를 출력할지 설정하는 옵션입니다.
+~~~
+@DataJpaTest(showSql = false)
+public class UserRepositoryTest {
+    // 테스트 메서드 작성
+}
+~~~
+
+**includeFilters와 excludeFilters**
+* 테스트할 컴포넌트(클래스)를 선택적으로 포함하거나 제외할 수 있습니다.
+
+---
+
+### 주요 기능
+
+* 테스트 환경 구성
+  * @DataJpaTest는 테스트를 위한 DB 환경을 자동으로 구성해줍니다. 
+  * 일반적으로 H2 인메모리 데이터베이스를 사용하여, 테스트 후 자동으로 데이터가 삭제됩니다.
+
+* 의존성 주입
+  * @DataJpaTest를 사용하면 Repository 빈이 자동으로 주입되어 테스트할 수 있습니다.
+
+* 기본적으로 트랜잭션 롤백
+  * 각 테스트 메서드는 트랜잭션 내부에서 실행되며, 테스트가 끝나면 데이터가 자동으로 롤백됩니다.
+  * 테스트 간 데이터가 격리(독립적) 되므로, 테스트 실행 순서에 영향을 받지 않습니다.
+
+---
+
+### Repository 테스트 구현
+
+* 테스트 라이프사이클 관리
+~~~
+private User testUser;
+
+@BeforeEach
+public void setUp() {
+    testUser = new User();
+    testUser.setUsername("testuser");
+    testUser.setPassword("password");
+    userRepository.save(testUser);
+}
+
+@AfterEach
+public void tearDown() {
+    userRepository.delete(testUser);
+}
+~~~
+1. @BeforeEach : 각 테스트 시작 전 실행 → 테스트 데이터를 초기화
+2. @AfterEach : 각 테스트 종료 후 실행 → 테스트 데이터 정리(삭제)
+
+
+출처: baeldung
+
+
+
+
+
+
+

src/test/java/com/board/article/loader/ArticleTestDataLoader.java

@@ -0,0 +1,25 @@
+package com.board.article.loader;
+
+import com.board.article.domain.Article;
+import com.board.article.repository.ArticleRepository;
+import org.springframework.boot.CommandLineRunner;
+import org.springframework.boot.test.context.TestConfiguration;
+import org.springframework.context.annotation.Bean;
+
+@TestConfiguration
+public class ArticleTestDataLoader {
+
+    private final ArticleRepository repository;
+
+    public ArticleTestDataLoader(ArticleRepository repository) {
+        this.repository = repository;
+    }
+
+    @Bean
+    public CommandLineRunner testData() {
+        return args -> {
+            repository.save(new Article(1L, "신형만에 관하여", "아내는 신봉선"));
+            repository.save(new Article(1L, "신짱구", "바보"));
+        };
+    }
+}

src/test/java/com/board/article/repository/ArticleRepositoryTest.java

@@ -0,0 +1,35 @@
+package com.board.article.repository;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+import com.board.article.domain.Article;
+import com.board.article.loader.ArticleTestDataLoader;
+import java.util.List;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTest;
+import org.springframework.context.annotation.Import;
+
+@DataJpaTest
+@Import(ArticleTestDataLoader.class)
+class ArticleRepositoryTest {
+
+    @Autowired
+    private ArticleRepository articleRepository;
+
+    @Test
+    @DisplayName("멤버 아이디에 해당하는 게시글을 가져온다.")
+    void findArticleByMemberId() {
+        // given
+        Long memberId = 1L;
+
+        // when
+        List<Article> articles = articleRepository.findArticleByMemberId(memberId);
+
+        // then
+        assertThat(articles).hasSize(2);
+        assertThat(articles).extracting(Article::getTitle)
+                .containsExactly("신형만에 관하여", "신짱구");
+    }
+}