📌 MyBatis Mapper 완전 정복 ① - 어노테이션 기반 CRUD

📅 날짜

2025-04-25

---

📝 1️⃣ MyBatis Mapper란?

MyBatis는 SQL 중심의 퍼시스턴스 프레임워크로,

복잡한 JDBC 코드를 대체해 SQL과 자바 객체를 매핑해주는 역할을 한다.

그 중심에 있는 것이 바로 Mapper!

Mapper는 자바 메서드와 SQL을 연결해주는 인터페이스로,

XML 또는 어노테이션을 통해 SQL을 정의할 수 있다.

💡 즉, 직접 JDBC 코드 없이도 깔끔하게 DB 작업 가능!

---

📝 2️⃣ 어노테이션 기반 Mapper의 특징

✅ 장점	⚠️ 단점
빠르고 간단한 개발	복잡한 동적 SQL 처리 어려움
설정 파일 최소화	SQL 관리 및 수정 시 불편
코드와 SQL이 한눈에 보임	대규모 프로젝트에선 비추천
소규모, 단순 CRUD에 적합	재사용성, 유지보수에 한계

💡 Tip:

단순 CRUD ➔ 어노테이션

복잡한 로직 ➔ XML 매퍼 추천!

---

📝 3️⃣ 어노테이션 기반 CRUD 예제

@Mapper
public interface MemoMapper {

    @Insert("INSERT INTO tbl_memo (id, text, writer, createAt) VALUES (#{id}, #{text}, #{writer}, #{createAt})")
    int insert(MemoDto memoDto);

    @Update("UPDATE tbl_memo SET text=#{text} WHERE id=#{id}")
    int update(MemoDto dto);

    @Delete("DELETE FROM tbl_memo WHERE id=#{id}")
    int delete(int id);

    @Select("SELECT * FROM tbl_memo WHERE id=#{id}")
    MemoDto selectAt(int id);

    @Select("SELECT * FROM tbl_memo")
    List<MemoDto> selectAll();
}

⚡ 실무 팁:

• 항상 컬럼명을 명시하자!
• SELECT *보다는 명확한 컬럼 지정이 유지보수에 유리.

---

📝 4️⃣ @Results와 Map 기반 조회

@Results(id="MemoResultMap", value={
    @Result(property="id", column="id"),
    @Result(property="text", column="text")
})
@Select("SELECT * FROM tbl_memo")
List<Map<String, Object>> selectAllResultMap();

🔹 DTO vs Map 비교

구분	DTO 매핑	Map 조회
타입	타입 안전	Object 기반
사용처	정형 데이터	유동적 데이터
장점	명확한 구조	유연성
단점	변경 시 DTO 수정 필요	타입 캐스팅 필요

✔️ 출력 예시

{id=1010, text=Hello}
{id=1011, text=World}

---

📝 5️⃣ 테스트 코드 & 실행 결과

@Test
void testInsert() {
    MemoDto dto = new MemoDto(1010, "Test Memo", "tester@naver.com", LocalDateTime.now(), null);
    int result = memoMapper.insert(dto);
    assertEquals(1, result);
}

✅ DB 확인 결과

id	text	writer	createAt
1010	Test Memo	tester@naver.com	2025-04-25 12:30

---

⚠️ 자주 발생하는 실수

1. 세미콜론(;) 사용
   • MyBatis SQL 끝에 ; 작성 금지!
2. 파라미터 매핑 오류
   • DTO 필드명 ↔️ SQL 컬럼명 일치 여부 확인!
   • 다중 파라미터 시 @Param 꼭 사용.
3. @Mapper 어노테이션 누락
   • Mapper 인식이 안되면 등록부터 확인!

---

🔥 정리

• 어노테이션 기반 Mapper는 빠른 개발과 단순 CRUD에 적합.
• 복잡한 쿼리는 XML 매퍼로 분리하는 게 베스트 프랙티스.
• 실수 방지 포인트를 숙지하고, 테스트 코드로 검증하자!

---

🔗 참고 자료

• MyBatis 공식 문서
• MyBatis 어노테이션 가이드

---