📌 MyBatis Mapper 완전 정복 ⑤ - 동적 SQL 완전 정복

📅 날짜

2025-04-25

---

📝 1️⃣ 동적 SQL이란?

동적 SQL(Dynamic SQL)은 조건에 따라 SQL문이 유동적으로 생성되는 기능입니다.

복잡한 검색 조건, 선택적 필터링이 필요한 경우에 필수적으로 사용됩니다.

💡 예시 상황

• 검색창에서 입력한 값에 따라 WHERE 조건이 달라질 때
• 특정 파라미터가 있을 때만 쿼리 조건 추가

---

📝 2️⃣ MyBatis 동적 SQL 태그 정리

태그	설명
<if>	조건에 따라 SQL 일부를 포함
<choose>	자바의 switch-case와 유사
<when>	<choose> 내부 조건 분기
<otherwise>	모든 <when> 조건이 false일 때 실행
<where>	자동으로 WHERE 절 추가, 불필요한 AND/OR 제거
<trim>	SQL 앞뒤로 특정 문자열 추가/제거

---

📝 3️⃣ 실습 예제 ① - <if> 태그 활용

🔹 XML 매퍼 코드

<select id="Select_if_xml" parameterType="java.util.Map" resultType="java.util.Map">
    SELECT * FROM tbl_memo
    <if test="type != null and type.equals('text')">
        WHERE text LIKE CONCAT('%', #{keyword}, '%')
    </if>
</select>

🔹 테스트 코드

@Test
void testSelectIfXml() {
    Map<String,Object> param = new HashMap<>();
    param.put("type", "text");
    param.put("keyword", "a");

    List<Map<String,Object>> response = memoMapper.Select_if_xml(param);
    response.forEach(System.out::println);
}

🔹 출력 결과

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

⚡ 포인트:

파라미터 type이 "text"일 때만 WHERE 조건이 추가됩니다.

---

📝 4️⃣ 실습 예제 ② - <choose>로 조건 분기

🔹 XML 매퍼 코드

<select id="Select_when_xml" parameterType="java.util.Map" resultType="java.util.Map">
    SELECT * FROM tbl_memo
    <if test="type != null">
        WHERE
        <choose>
            <when test="type.equals('id')">
                id LIKE CONCAT('%', #{keyword}, '%')
            </when>
            <when test="type.equals('writer')">
                writer LIKE CONCAT('%', #{keyword}, '%')
            </when>
            <otherwise>
                createAt <= #{keyword}
            </otherwise>
        </choose>
    </if>
</select>

🔹 테스트 코드

@Test
void testSelectWhenXml() {
    Map<String,Object> param = new HashMap<>();
    param.put("type", "writer");
    param.put("keyword", "example");

    List<Map<String,Object>> response = memoMapper.Select_when_xml(param);
    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}

💡 포인트:

type 값에 따라 검색 컬럼이 유동적으로 변경됩니다.

조건이 없으면 <otherwise>가 실행됩니다.

---

⚠️ 동적 SQL 사용 시 주의사항

1. ❗ WHERE 절 누락 방지 ➡️ <where> 태그 적극 활용
2. ❗ Null 체크 필수 (test="param != null")
3. ❗ 복잡한 조건은 서비스 로직에서 사전 처리
4. ❗ 너무 많은 <if> 남발 금지 ➡️ 가독성 저하

---

📝 Best Practice

• 조건부 쿼리는 가급적 명확하게 구분할 것
• 반복되는 조건문은 <trim>으로 정리
• 유지보수성을 위해 SQL 로직은 XML에서 관리하는 것이 유리

---

🔥 요약

• 동적 SQL은 복잡한 검색 조건 처리에 필수
• <if>와 <choose>를 적절히 조합하면 깔끔한 쿼리 작성 가능
• 주의사항을 지켜야 가독성과 성능을 모두 잡을 수 있다

---

🔗 참고 자료

• MyBatis 공식 문서

---

💭 느낀 점

직접 테스트 코드를 작성하며 동적 SQL의 동작 방식을 확실히 이해할 수 있었습니다.

복잡한 조건일수록 XML 매퍼의 필요성을 다시 한번 느꼈고, 실무에서 어떻게 활용할지 감이 잡혔습니다! 😄

---