MyBatis와 SQL 직접 관리

// 1) 매퍼 인터페이스
@Mapper
public interface OrderMapper {

    OrderSummary findById(@Param("orderId") Long orderId);

    List<OrderSummary> search(OrderSearchCondition condition);

    int updateStatus(@Param("orderId") Long orderId,
                     @Param("status") String status);
}

// 2) 설정 (application.yml)
// mybatis:
//   mapper-locations: classpath:mapper/**/*.xml
//   configuration:
//     map-underscore-to-camel-case: true

map-underscore-to-camel-case를 켜면 DB의 order_id 컬럼이 자바의 orderId로 자동 매핑됩니다. 이것만으로도 resultMap 작성이 크게 줄어듭니다.

<mapper namespace="com.example.order.mapper.OrderMapper">

  <select id="findById" resultType="com.example.order.dto.OrderSummary">
    SELECT o.order_id,
           o.status,
           o.total_amount,
           m.name AS member_name
      FROM orders o
      JOIN member m ON m.member_id = o.member_id
     WHERE o.order_id = #{orderId}
  </select>

  <update id="updateStatus">
    UPDATE orders
       SET status = #{status},
           updated_at = NOW()
     WHERE order_id = #{orderId}
  </update>

</mapper>

namespace는 매퍼 인터페이스의 전체 경로와 정확히 일치해야 합니다. id는 메서드 이름과 같아야 합니다. 둘 중 하나라도 어긋나면 기동 시점이나 호출 시점에 오류가 납니다.

<select id="search" resultType="com.example.order.dto.OrderSummary">
  SELECT order_id, status, total_amount, ordered_at
    FROM orders
  <where>
    <if test="status != null">
      AND status = #{status}
    </if>
    <if test="fromDate != null and toDate != null">
      AND ordered_at BETWEEN #{fromDate} AND #{toDate}
    </if>
    <if test="memberIds != null and memberIds.size() > 0">
      AND member_id IN
      <foreach item="id" collection="memberIds" open="(" separator="," close=")">
        #{id}
      </foreach>
    </if>
  </where>
  ORDER BY ordered_at DESC
</select>

where 태그는 조건이 하나도 없으면 WHERE 자체를 빼고, 첫 조건 앞의 AND도 알아서 제거합니다. 직접 문자열을 이어 붙이는 방식보다 안전합니다.

<!-- 위험: 사용자 입력이 SQL에 그대로 들어갑니다 -->
<select id="searchByName" resultType="Member">
  SELECT * FROM member WHERE name = '${name}'
</select>
<!-- name 값으로 ' OR '1'='1 이 들어오면 전체 행이 조회됩니다 -->

<!-- 안전: 값은 바인딩으로 전달합니다 -->
<select id="searchByName" resultType="Member">
  SELECT * FROM member WHERE name = #{name}
</select>

<!-- 정렬 컬럼처럼 식별자가 필요하면 허용 목록으로 제한한 값만 넘깁니다 -->
<select id="findAllSorted" resultType="Member">
  SELECT * FROM member ORDER BY ${sortColumn} DESC
</select>

자바 코드에서 sortColumn을 받을 때 정해진 값 목록에 포함되는지 먼저 검사해야 합니다. 검사 없이 넘기면 위 첫 번째 예시와 같은 문제가 됩니다.