📌 MyBatis Mapper 완전 정복 ⑥ - 테스트 코드 작성법 & 실행 결과 정리

📅 날짜

2025-04-25

---

📝 1️⃣ 왜 Mapper 테스트가 중요할까?

MyBatis Mapper는 DB와 직접 연결되기 때문에,

SQL 문법 오류, 파라미터 매핑 오류, 결과 매핑 오류가 런타임에 발생합니다.

💡 테스트 코드를 작성함으로써

개발 단계에서 문제를 조기에 발견하고,

안정적인 DB 연동을 보장할 수 있습니다!

---

📝 2️⃣ 테스트 환경 설정

MyBatis Mapper 테스트를 위해서는 스프링 환경에서 다음과 같이 설정합니다.

@SpringBootTest
public class MemoMapperTest {

    @Autowired
    private MemoMapper memoMapper;

    // 테스트 메서드 작성
}

• @SpringBootTest : 스프링 컨텍스트를 로드하여 통합 테스트 실행
• @Autowired : Mapper 인터페이스 주입

⚡ Tip:

테스트 클래스는 보통 ~Test 또는 ~Tests로 네이밍합니다.

---

📝 3️⃣ 테스트 데이터 준비

• 테스트 실행 전, DB에 필요한 데이터가 사전에 존재해야 합니다.
• 또는 테스트 메서드 내에서 데이터를 삽입하는 방식도 사용합니다.

@BeforeEach
void setUp() {
    // 테스트용 데이터 세팅 (필요 시)
}

💡 테스트 자동화를 위해 데이터 초기화 전략을 세우는 것이 중요합니다!

---

📝 4️⃣ 실습 예제 ① - <if> 동적 SQL 테스트

@Test
void testSelectIfXml() {
    Map<String,Object> param = createSearchParam("text", "a");

    List<Map<String,Object>> response = memoMapper.Select_if_xml(param);

    // ✅ 결과가 비어있지 않은지 검증
    Assertions.assertFalse(response.isEmpty(), "조회 결과가 없습니다.");

    response.forEach(System.out::println);
}

private Map<String, Object> createSearchParam(String type, String keyword) {
    Map<String, Object> param = new HashMap<>();
    param.put("type", type);
    param.put("keyword", keyword);
    return param;
}

🔹 출력 결과 해석

{id=3002, text=aaaaa, writer=example@example.com, createAt=2025-04-25T15:38}

➡️ type="text" 조건으로, text 컬럼에 "a"가 포함된 데이터가 정상 조회되었습니다.

---

📝 5️⃣ 실습 예제 ② - <choose> 조건 분기 테스트

@Test
void testSelectWhenXml_WithWriter() {
    Map<String,Object> param = createSearchParam("writer", "example");

    List<Map<String,Object>> response = memoMapper.Select_when_xml(param);

    Assertions.assertTrue(response.size() >= 3, "조회된 데이터가 예상보다 적습니다.");

    response.forEach(System.out::println);
}

🔹 출력 결과 해석

{id=3001, text=asd, writer=example@example.com, createAt=2025-04-25T15:38}
{id=3002, text=aaaaa, writer=example@example.com, createAt=2025-04-25T15:38}
{id=3003, text=bbbb, writer=example@example.com, createAt=2025-04-25T15:38}

➡️ writer 컬럼에 "example"이 포함된 데이터가 정상적으로 조회되었습니다.

---

⚠️ 테스트 작성 시 주의사항

1. 데이터 일관성 유지

   ➡️ 테스트 전/후 데이터 초기화 고려

2. 검증 로직 필수

   ➡️ 단순 출력 ❌ → assert 활용 ✅

3. 명확한 메서드명

   ➡️ 테스트 목적을 드러내기

4. 반복 코드 최소화

   ➡️ Helper 메서드 활용

---

📝 Best Practice

• Helper 메서드 활용 예시

private Map<String, Object> createSearchParam(String type, String keyword) {
    Map<String, Object> param = new HashMap<>();
    param.put("type", type);
    param.put("keyword", keyword);
    return param;
}

• 좋은 테스트 메서드명

void testSelectWhenXml_WithValidWriterKeyword() { ... }

💡 Tip:

테스트 코드는 가독성과 유지보수성이 중요합니다.

"어떤 상황에서 무엇을 검증하는지" 명확히 작성하세요!

---

🔥 요약

• Mapper 테스트는 SQL 오류를 사전에 방지하는 가장 확실한 방법!
• 테스트 데이터 관리와 검증 로직 작성 습관화
• 반복되는 로직은 효율적으로 분리
• 실무에서는 CI와 연계하여 테스트 자동화 권장

---

🔗 참고 자료

• JUnit5 공식 문서
• MyBatis 테스트 가이드

---

💭 느낀 점

이번 테스트 코드를 작성하면서,

동적 SQL 테스트의 중요성과 함께

테스트 데이터 준비, 검증 로직의 필요성을 제대로 체감했습니다.

특히 조건에 따라 다양한 결과가 나오는 동적 SQL 특성상,

여러 케이스에 대한 테스트 시나리오를 준비해야겠다는 생각이 들었습니다.

앞으로 더 견고한 코드를 위해 테스트 문화를 습관화해야겠습니다! 😄

---