[java] MyBatis에서 데이터베이스 테스트 환경 구축하기

17 Nov 2023

java

MyBatis는 자바 언어로 작성된 ORM(Object-Relational Mapping) 프레임워크로, 데이터베이스와의 상호작용을 쉽게 할 수 있게 도와줍니다. 이번 글에서는 MyBatis를 사용하여 데이터베이스 테스트 환경을 구축하는 방법에 대해 알아보겠습니다.

1. 데이터베이스 테스트 환경 설정

먼저, MySQL 데이터베이스를 사용하여 테스트 환경을 구축해보겠습니다. 다음과 같은 단계를 따라주세요:

1.1 MySQL 데이터베이스 설치

MySQL을 먼저 설치해야 합니다. MySQL 공식 웹사이트에서 다운로드 받을 수 있습니다.

1.2 데이터베이스 및 테이블 생성

MySQL에 접속하여 테스트에 사용할 데이터베이스를 생성하고, 필요한 테이블을 생성합니다. 테이블의 구조와 필드명은 프로젝트에 맞게 설계하시면 됩니다.

1.3 JDBC 드라이버 설정

MyBatis는 JDBC 드라이버를 사용하여 데이터베이스와 연결합니다. 따라서, 사용하는 데이터베이스의 JDBC 드라이버를 다운로드 받아 프로젝트에 추가해야 합니다. Maven을 사용하는 경우, pom.xml 파일에 의존성을 추가하면 됩니다.

<dependencies>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.23</version>
    </dependency>
</dependencies>

1.4 MyBatis 설정 파일 작성

MyBatis는 mybatis-config.xml 파일에서 데이터베이스 연결 및 매퍼 설정 등을 관리합니다. 다음은 기본적인 MyBatis 설정 파일의 예입니다.

<configuration>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC" />
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver" />
                <property name="url" value="jdbc:mysql://localhost:3306/test" />
                <property name="username" value="root" />
                <property name="password" value="password" />
            </dataSource>
        </environment>
    </environments>

    <mappers>
        <mapper resource="mappers/UserMapper.xml" />
    </mappers>
</configuration>

위의 설정 파일에서는 데이터베이스 연결 정보와 매퍼 파일의 경로를 설정하고 있습니다. 실제 데이터베이스 정보에 맞게 수정해주세요.

2. 데이터베이스 테스트 코드 작성

이제 MyBatis를 사용하여 데이터베이스와 상호작용하는 테스트 코드를 작성해보겠습니다.

2.1 테스트용 데이터베이스 연결 설정

Junit을 사용하여 테스트 코드를 작성하는 경우, @BeforeClass 어노테이션을 사용하여 데이터베이스 연결을 설정할 수 있습니다. 아래의 예시 코드를 참고하세요.

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

public class MyBatisTest {
    private static SqlSessionFactory sqlSessionFactory;

    @BeforeClass
    public static void setUp() throws Exception {
        String resource = "mybatis-config.xml";
        Reader reader = Resources.getResourceAsReader(resource);
        sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader);
    }

    // 테스트 메소드 작성
}

2.2 데이터베이스 테스트 코드 작성

테스트할 기능에 맞게 자바 코드를 작성하여 MyBatis와 데이터베이스를 상호작용하도록 만들어줍니다. 아래의 예시 코드는 사용자 정보를 조회하는 테스트 코드입니다.

import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

public class UserMapperTest {
    @Test
    public void testGetUser() {
        SqlSession sqlSession = sqlSessionFactory.openSession();
        try {
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            User user = userMapper.getUser(1);
            
            // 테스트 결과를 검증하는 코드 작성
        } finally {
            sqlSession.close();
        }
    }
}

위의 코드에서 UserMapper는 MyBatis의 매퍼 인터페이스로, 데이터베이스 조회, 삽입, 업데이트 등의 작업을 수행할 수 있는 메소드를 정의합니다. 필요에 따라 UserMapper.xml 파일을 작성하여 SQL 쿼리를 매핑할 수 있습니다.

3. 테스트 실행

테스트 코드를 작성한 후, Junit을 실행하여 테스트를 진행합니다. 이때, 데이터베이스에 정상적인 연결이 이루어지고, 원하는 결과가 반환되는지 확인하는 것이 중요합니다.

결론

이번 글에서는 MyBatis를 사용하여 데이터베이스 테스트 환경을 구축하는 방법에 대해 알아보았습니다. MyBatis의 다양한 기능을 활용하여 프로젝트의 데이터베이스 연동 작업을 수월하게 진행할 수 있습니다. 추가적인 정보는 MyBatis 공식 문서를 참고해주세요.