📙 MyBatis란?

MyBatis는 Java 기반의 SQL 매퍼 프레임워크로, SQL 쿼리를 직접 작성하고 XML 또는 어노테이션을 통해 SQL 쿼리와 객체를 매핑합니다. 이는 ORM 프레임워크인 JPA와는 다르게, SQL을 더 세밀하게 제어할 수 있다는 장점이 있습니다.

📙 1. MyBatis의 주요 특징

• 직접적인 SQL 제어: 개발자가 SQL을 직접 작성하여 데이터베이스 작업을 수행하므로, SQL 쿼리를 세부적으로 제어할 수 있습니다.
• 유연한 매핑: XML 파일 또는 어노테이션을 통해 SQL 쿼리와 Java 객체 간의 매핑을 설정할 수 있습니다.
• 복잡한 쿼리 처리: 복잡한 SQL 쿼리나 데이터베이스 특화된 기능을 사용할 때 유리합니다.
• 간단한 설정: JPA와 비교했을 때 설정이 간단하며, SQL을 잘 아는 개발자에게 친숙합니다.
• 자동화 기능 부족: CRUD 작업을 자동으로 생성하지 않으며, 개발자가 직접 모든 SQL 쿼리를 작성해야 합니다.

✏️ MyBatis의 주요 컴포넌트

✏️ MyBatis DB Access 아키텍처

• 기존 JDBC 프로그래밍의 경우 Repository에서 곧바로 JDBC API 쪽으로 접근하여 DB를 연결하였지만, 위의 그림에 나와있듯이 MyBatis를 사용할 경우 Repository와 JDBC API사이에 MyBatis가 위치함으로서 편리한 Access를 제공한다.
• JDBC API를 감싸서 개발자가 조금 더 편리하게 접근할 수 있도록 도와주는 것이 MyBatis이다.
• 서비스에서 DAO를 호출하고 DAO에서 Mybatis를 사용하게된다.

✏️ MyBatis DB Access 순서

(1) ~ (3)은 애플리케이션 시작할 시 수행되는 프로세스다.
1. 애플리케이션이 SqlSessionFactoryBuilder를 통해 SqlSessionFactory를 빌드하도록 요청한다.
2. SqlSessionFactoryBuilder는 SqlSessionFactory를 생성하기 위한 Mybatis Config 파일을 읽고,
3. SqlSessionFactoryBuilder는 MyBatis Config 파일에 따라 SqlSessionFactory를 생성한다.

(4) ~ (10)은 클라이언트의 각 요청에 대해 수행되는 프로세스다.
4. 클라이언트가 웹 애플리케이션에 요청을 보낸다.
5. 애플리케이션은 SqlSessionFactoryBuilder를 사용하여 빌드된 SqlSessionFactory에서 SqlSession을 가져오도록 명령한다.
6. SqlSessionFactory는 SqlSession를 생성하고 이를 애플리케이션에 반환한다.
7. 애플리케이션이 SqlSession에서 Mapper 인터페이스의 구현 객체를 가져오고,
8. 애플리케이션이 Mapper 인터페이스 메서드를 호출한다.
9. Mapper 인터페이스의 구현 객체가 SqlSession 메서드를 호출하고 SQL 실행을 요청한다.
10. SqlSession은 Mapping 파일에서 실행할 SQL을 가져와 실행한다.

📙 2. MyBatis 구성 요소

1. SQL Mapper XML 파일

• SQL 쿼리를 정의하고, 이 쿼리와 Java 객체를 매핑하는 역할을 합니다.
• 예시:

<!-- UserMapper.xml -->
<mapper namespace="com.example.mapper.UserMapper">
  <select id="selectUserById" resultType="com.example.dto.User">
    SELECT * FROM user WHERE id = #{id}
  </select>
</mapper>

2. Mapper Interface

• XML 파일에 정의된 SQL 쿼리와 매핑되는 Java 인터페이스입니다.
• 예시:

public interface UserMapper {
    User selectUserById(int id);
}

3. Configuration File

• MyBatis 설정을 정의하는 XML 파일로, 데이터베이스 연결 정보, 매퍼 파일 위치 등을 설정합니다.
• 예시:

<!-- mybatis-config.xml -->
<configuration>
  <environments default="development">
    <environment id="development">
      <transactionManager type="JDBC"/>
      <dataSource type="POOLED">
        <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
        <property name="url" value="jdbc:mysql://localhost:3306/mydb"/>
        <property name="username" value="root"/>
        <property name="password" value="password"/>
      </dataSource>
    </environment>
  </environments>
  <mappers>
    <mapper resource="com/example/mapper/UserMapper.xml"/>
  </mappers>
</configuration>

4. SqlSessionFactory

• MyBatis의 핵심 객체로, SQL 실행, 트랜잭션 관리 등을 제공합니다. SqlSession을 생성하는 데 사용됩니다.

SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

📙 3. MyBatis 설정 과정

1. Dependency 추가

• Maven 또는 Gradle 프로젝트에서 MyBatis와 MyBatis-Spring Starter를 추가합니다.

<!-- Maven dependency -->
<dependency>
  <groupId>org.mybatis.spring.boot</groupId>
  <artifactId>mybatis-spring-boot-starter</artifactId>
  <version>2.2.0</version>
</dependency>

2. Mapper XML 파일 및 인터페이스 작성

• SQL 쿼리를 정의하는 XML 파일과 Java 인터페이스를 작성합니다.

3. SqlSessionFactory 설정

• mybatis-config.xml을 통해 MyBatis 설정을 정의하고, SqlSessionFactory를 생성합니다.

4. SQL 실행

• SqlSession 객체를 사용하여 SQL 쿼리를 실행하고 결과를 반환합니다.

📙 4. MyBatis 코드 예제

UserMapper.xml

<mapper namespace="com.example.mapper.UserMapper">
  <select id="selectUserById" resultType="com.example.dto.User">
    SELECT * FROM user WHERE id = #{id}
  </select>
</mapper>

UserMapper.java

public interface UserMapper {
    User selectUserById(int id);
}

MyBatis 설정 파일 (mybatis-config.xml)

<configuration>
  <environments default="development">
    <environment id="development">
      <transactionManager type="JDBC"/>
      <dataSource type="POOLED">
        <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
        <property name="url" value="jdbc:mysql://localhost:3306/mydb"/>
        <property name="username" value="root"/>
        <property name="password" value="password"/>
      </dataSource>
    </environment>
  </environments>
  <mappers>
    <mapper resource="com/example/mapper/UserMapper.xml"/>
  </mappers>
</configuration>

SqlSessionFactory 및 SqlSession 사용

InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

try (SqlSession session = sqlSessionFactory.openSession()) {
    UserMapper mapper = session.getMapper(UserMapper.class);
    User user = mapper.selectUserById(1);
    System.out.println(user);
}

참고 출처

• https://velog.io/@kjenotn/Spring-MyBatis-%EA%B0%9C%EB%85%90-%ED%8A%B9%EC%A7%95#%EB%8D%B0%EC%9D%B4%ED%84%B0-%EC%A0%91%EA%B7%BC-%EA%B0%9D%EC%B2%B4-%EA%B5%AC%ED%98%84
• https://byul91oh.tistory.com/232
• https://jangjjolkit.tistory.com/42