매퍼 작성하기

매퍼 파일(XML)

•

동작 구조

•

기본 코드

•

매퍼 태그

•

태그 속성

•

예시

동작 구조

MyBatis는 XML 매퍼 파일과 Java 매퍼 인터페이스를 연결하여 SQL 쿼리를 실행합니다.

파일 구조

Mapper.xml 파일: src/main/resources 폴더 아래에 작성

Mapper.java 파일: src/main/java 폴더 아래에 작성

디렉토리 구조: 두 파일은 동일한 패키지 경로에 위치해야 합니다

매핑 원리

id 속성과 메소드명 매핑: XML 매퍼의 id 속성값과 Java 매퍼의 메소드명이 일치해야 합니다

메소드 호출 시: 매퍼 인터페이스의 메소드를 호출하면 XML 매퍼 파일의 해당 쿼리가 실행됩니다

반환 타입

<select> 태그: resultType 또는 resultMap 속성으로 지정한 타입으로 자동 매핑됩니다

<insert>, <update>, <delete> 태그: 데이터베이스에 적용된 행의 개수를 반환합니다 (int 타입)

기본 코드

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">

<!-- namespace="매퍼 인터페이스 경로" -->
<mapper namespace="매퍼인터페이스 경로">

</mapper>
XML
복사

매퍼 태그

태그	설명
<select>	SELECT 쿼리를 정의
<insert>	INSERT 쿼리를 정의
<update>	UPDATE 쿼리를 정의
<delete>	DELETE 쿼리를 정의

태그 속성

속성	설명
id	매퍼 인터페이스의 메서드 이름과 매핑
resultType	쿼리 결과를 매핑할 Java 타입 지정
resultMap	복잡한 결과 매핑을 위한 resultMap의 id 참조
parameterType	파라미터의 Java 타입 지정

예시

BoardMapper.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">

<!-- namespace="매퍼 인터페이스 경로" --> 
<mapper namespace="com.aloha.mybatis.mapper.BoardMapper">
  <!-- 게시글 목록 -->
  <!-- <select id="list" resultType="com.aloha.mybatis.dto.Board"> -->
  <select id="list" resultType="Board">
    SELECT *
    FROM board
    ORDER BY created_at DESC
  </select>

  <!-- 게시글 조회 -->
  <select id="select" resultType="Board">
    SELECT *
    FROM board
    WHERE no = #{no}
  </select>

  <!-- 게시글 등록 -->
  <insert id="insert">
    INSERT INTO board ( id, title, writer, content )
    VALUES ( #{id}, #{title}, #{writer}, #{content} )
  </insert>

  <!-- 게시글 수정 -->
  <update id="update">
    UPDATE board
       SET title = #{title}
          ,writer = #{writer}
          ,content = #{content}
    WHERE no = #{no}
  </update>

  <!-- 게시글 삭제 -->
  <delete id="delete">
    DELETE FROM board
    WHERE no = #{no}
  </delete>
</mapper>
XML
복사

BoardMapper.java

package com.aloha.mybatis.mapper;

import java.util.List;

import org.apache.ibatis.annotations.Mapper;

import com.aloha.mybatis.dto.Board;

@Mapper
public interface BoardMapper {
  // 게시글 목록
  List<Board> list() throws Exception;
  // 게시글 조회
  Board select(Integer no) throws Exception;
  // 게시글 등록
  int insert(Board board) throws Exception;
  // 게시글 수정
  int update(Board board) throws Exception;
  // 게시글 삭제
  int delete(Integer no) throws Exception;
}
Java
복사

@Mapper 어노테이션

MyBatis에서 @Mapper 어노테이션은 해당 인터페이스가 MyBatis 매퍼 인터페이스임을 나타냅니다.

주요 기능

•

자동 스캔: Spring Boot는 @Mapper가 붙은 인터페이스를 자동으로 스캔하여 MyBatis 매퍼로 등록합니다.

•

XML 매핑: 인터페이스의 메서드와 XML 파일의 SQL 쿼리를 자동으로 매핑합니다.

•

구현체 생성: MyBatis가 런타임에 인터페이스의 구현체를 자동으로 생성합니다.

사용 예시

@Mapper
public interface BoardMapper {
    // 메서드 선언만 하면 MyBatis가 XML의 SQL과 자동 매핑
    List<Board> list() throws Exception;
}
Java
복사

@Mapper 어노테이션을 사용하면 별도의 설정 없이 MyBatis 매퍼를 손쉽게 사용할 수 있습니다.