동적쿼리

동적 쿼리

MyBatis는 동적 쿼리를 작성하기 위한 다양한 태그를 제공합니다. 이를 통해 조건에 따라 SQL 쿼리를 동적으로 구성할 수 있습니다.

주요 동적 쿼리 태그

태그	설명
<if>	조건이 참일 때만 SQL 구문 포함
<choose>	Java의 switch 문과 유사 (when, otherwise와 함께 사용)
<when>	choose 내에서 조건 분기
<otherwise>	choose 내에서 모든 when 조건이 거짓일 때 실행
<where>	WHERE 절을 동적으로 생성하고 불필요한 AND/OR 제거
<set>	UPDATE의 SET 절을 동적으로 생성하고 불필요한 쉼표 제거
<trim>	접두사/접미사를 추가하거나 제거
<foreach>	컬렉션을 순회하며 SQL 구문 반복

<if> 태그

조건이 참일 때만 SQL 구문을 포함합니다.

<select id="select" resultType="User">
    SELECT * FROM users
    <where>
        <if test="name != null">
            AND name = #{name}
        </if>
        <if test="age != null">
            AND age = #{age}
        </if>
    </where>
</select>
XML
복사

<choose>, <when>, <otherwise> 태그

여러 조건 중 하나만 선택할 때 사용합니다.

<select id="select" resultType="User">
    SELECT * FROM users
    <where>
        <choose>
            <when test="name != null">
                AND name = #{name}
            </when>
            <when test="email != null">
                AND email = #{email}
            </when>
            <otherwise>
                AND status = 'ACTIVE'
            </otherwise>
        </choose>
    </where>
</select>
XML
복사

<where> 태그

WHERE 절을 자동으로 생성하고, 첫 번째 AND/OR를 제거합니다.

<select id="select" resultType="User">
    SELECT * FROM users
    <where>
        <if test="name != null">
            AND name = #{name}
        </if>
        <if test="age != null">
            AND age = #{age}
        </if>
    </where>
</select>
XML
복사

<set> 태그

UPDATE의 SET 절을 동적으로 생성하고, 마지막 쉼표를 제거합니다.

<update id="update">
    UPDATE users
    <set>
        <if test="name != null">
            name = #{name},
        </if>
        <if test="age != null">
            age = #{age},
        </if>
    </set>
    WHERE id = #{id}
</update>
XML
복사

<trim> 태그

접두사나 접미사를 추가하거나 제거합니다.

<select id="findUsers" resultType="User">
    SELECT * FROM users
    <trim prefix="WHERE" prefixOverrides="AND |OR ">
        <if test="name != null">
            AND name = #{name}
        </if>
        <if test="age != null">
            AND age = #{age}
        </if>
    </trim>
</select>
XML
복사

<trim> 태그 속성

속성	설명
prefix	생성된 SQL 앞에 추가할 접두사
suffix	생성된 SQL 뒤에 추가할 접미사
prefixOverrides	생성된 SQL 앞에서 제거할 문자열 (공백으로 구분)
suffixOverrides	생성된 SQL 뒤에서 제거할 문자열 (공백으로 구분)

<trim> 태그 동작 설명

<trim> 태그는 동적으로 생성되는 SQL 구문의 앞뒤에 특정 문자열을 추가하거나 제거할 수 있습니다.

위 예제 분석:

•

prefix="WHERE": trim 블록 내용이 있으면 앞에 "WHERE"를 추가합니다.

•

prefixOverrides="AND |OR ": 생성된 SQL의 맨 앞에 "AND " 또는 "OR "가 있으면 제거합니다.

•

만약 name과 age가 모두 null이 아니라면, 최종 SQL은 SELECT * FROM users WHERE name = ? AND age = ?가 됩니다.

•

첫 번째 조건의 "AND"가 prefixOverrides에 의해 제거되어 올바른 SQL이 생성됩니다.

추가 예제 - suffixOverrides 사용:

<update id="updateUser">
    UPDATE users
    <trim prefix="SET" suffixOverrides=",">
        <if test="name != null">
            name = #{name},
        </if>
        <if test="age != null">
            age = #{age},
        </if>
    </trim>
    WHERE id = #{id}
</update>
XML
복사

이 예제에서는 마지막 쉼표가 자동으로 제거됩니다. <set> 태그와 동일한 효과를 냅니다.

<foreach> 태그

컬렉션을 순회하며 SQL 구문을 반복합니다. IN 절을 생성할 때 유용합니다.

<select id="findUsersByIds" resultType="User">
    SELECT * FROM users
    WHERE id IN
    <foreach item="id" collection="list" open="(" separator="," close=")">
        #{id}
    </foreach>
</select>
XML
복사

<foreach> 태그 속성

속성	설명
collection	반복할 컬렉션 (list, array, map 등)
item	현재 반복 항목을 참조할 변수명
index	현재 반복의 인덱스를 참조할 변수명
open	반복 시작 시 추가할 문자열
close	반복 종료 시 추가할 문자열
separator	각 항목 사이에 추가할 구분자

<bind> 태그

OGNL 표현식을 사용하여 변수를 생성합니다. LIKE 검색 시 유용합니다.

<select id="findUsersByName" resultType="User">
    <bind name="pattern" value="'%' + name + '%'" />
    SELECT * FROM users
    WHERE name LIKE #{pattern}
</select>
XML
복사

<bind> 태그 동작 설명

<bind> 태그는 OGNL(Object-Graph Navigation Language) 표현식을 사용하여 새로운 변수를 생성합니다.

위 예제 분석:

•

name="pattern": 생성할 변수의 이름을 지정합니다.

•

value="'%' + name + '%'": OGNL 표현식을 사용하여 변수의 값을 정의합니다. 여기서는 입력받은 name 값 앞뒤에 %를 붙입니다.

•

만약 name이 "홍길동"이라면, pattern 변수는 "%홍길동%"이 됩니다.

•

생성된 pattern 변수는 #{pattern}으로 SQL 쿼리에서 사용할 수 있습니다.

<bind> 태그의 장점:

•

SQL 쿼리를 더 깔끔하게 유지할 수 있습니다.

•

복잡한 문자열 조작을 SQL 외부에서 처리할 수 있습니다.

•

재사용 가능한 변수를 생성하여 쿼리 내에서 여러 번 참조할 수 있습니다.

추가 예제 - 날짜 형식 변환:

<select id="findUsersByDate" resultType="User">
    <bind name="startDate" value="startDate + ' 00:00:00'" />
    <bind name="endDate" value="endDate + ' 23:59:59'" />
    SELECT * FROM users
    WHERE created_at BETWEEN #{startDate} AND #{endDate}
</select>
XML
복사

이 예제에서는 날짜 문자열에 시간을 추가하여 범위 검색을 수행합니다.

OGNL(Object-Graph Navigation Language) 표현식이란?

OGNL은 Java 객체의 속성을 탐색하고 조작하기 위한 강력한 표현 언어입니다. MyBatis에서는 동적 SQL을 작성할 때 OGNL을 사용하여 파라미터 값을 참조하고 연산을 수행합니다.

OGNL의 주요 기능

•

속성 접근: 객체의 속성에 접근할 수 있습니다. 예: user.name, user.address.city

•

메서드 호출: 객체의 메서드를 호출할 수 있습니다. 예: name.length(), name.toUpperCase()

•

연산: 산술, 논리, 비교 연산을 수행할 수 있습니다. 예: age + 1, age > 18

•

문자열 조작: 문자열을 결합하거나 조작할 수 있습니다. 예: '%' + name + '%'

•

컬렉션 접근: 리스트나 배열의 요소에 접근할 수 있습니다. 예: list[0], map['key']

MyBatis에서 OGNL 사용 예제

1. 조건 체크:

<if test="name != null and name != ''">
    AND name = #{name}
</if>
XML
복사

2. 컬렉션 체크:

<if test="list != null and list.size() > 0">
    AND id IN
    <foreach item="id" collection="list" open="(" separator="," close=")">
        #{id}
    </foreach>
</if>
XML
복사

3. 문자열 조작:

<bind name="pattern" value="'%' + keyword + '%'" />
SELECT * FROM users WHERE name LIKE #{pattern}
XML
복사

4. 복잡한 조건:

<if test="age != null and (age >= 18 and age <= 65)">
    AND age BETWEEN 18 AND 65
</if>
XML
복사

OGNL 주요 연산자

연산자	설명	예제
.	속성 접근	user.name
==, !=	동등 비교	name == 'admin'
>, <, >=, <=	크기 비교	age > 18
and, or, not	논리 연산	name != null and age > 18
+, -, *, /, %	산술 연산	price * quantity
[]	컬렉션 접근	list[0],map['key']

주의사항

•

XML에서는 <와 >를 직접 사용할 수 없으므로 &amp;lt;와 &amp;gt;로 표현하거나, <![CDATA[]]>를 사용해야 합니다.

•

null 체크를 할 때는 != null을 명시적으로 사용하는 것이 좋습니다.

•

문자열 비교 시 작은따옴표('')를 사용합니다.