[Spring] MyBatis 와 Spring 연동하기(2) : DBCP 사용하기

🔻Connection 객체 생성

이전에는 DBUtil.open()으로 DB 연결하여 Connection 객체 생성하는 것을 반복했다.

관리되지않는 Connection 객체들은 메모리를 차지하고 성능을 저하시킨다. 그래서 사용 완료된 Connection들은 close() 해줘야하는데 번거롭다는 문제가 있다.

 

이것을 보완하기 위한 Connection Pool(커넥션 풀) 이 탄생하였다.

 

미리 만들어진 Connection Pool를 접속한 사용자에게 대여한다.

사용자가 다 사용하면 시스템이 Connection을 회수한다.

 

 

🔻Connection Pool 라이브러리

MyBatis를 사용하기 위해 아래 세가지의 라이브러리 중 하나의 Connection Pool 라이브러리가 설정되어 있어야한다.

 

1. Commos DBCP

DBCP는 일반적으로 Jakarta Tomcat에서 사용되며, 특히 웹 애플리케이션에서 데이터베이스 연결을 관리하기 위해 표준으로 채택되어 있습니다. DBCP는 JDBC 드라이버와 함께 사용되어 커넥션 풀링을 구현하고, 애플리케이션에서 데이터베이스와의 연결을 효율적으로 관리합니다.

 

2. Tomcat DBCP

 

3. HikariCP

스프링부트 2.0부터 기본으로 사용한다.

HikariCP는 현대적이고 경량화된 자바용 커넥션 풀 라이브러리로, 대규모 애플리케이션에서 높은 성능을 제공한다. HikariCP는 적은 메모리 사용량과 빠른 커넥션 획득 속도로 유명하며, 대부분의 환경에서 뛰어난 성능을 발휘한다. 특히, 대규모 및 고트랜잭션 환경에서의 효율성을 중시하는 애플리케이션에서 많이 사용된다.

 

현재 많이 사용하는 HikariCP와 고전적인 Commos 사용법에 대해 알아보겠다.

 

 

Commos DBCP 사용하기

1. commos-dbcp 의존성 추가

pom.xml

<dependency>
          <groupId>commons-dbcp</groupId>
          <artifactId>commons-dbcp</artifactId>
          <version>1.4</version>
      </dependency>

 

 

2. 설정 추가

WEB-INF > spring > root-context.xml

<!-- Commons DBCP -->
	<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource">
		<property name="driverClassName" value="oracle.jdbc.driver.OracleDriver"></property>
		<property name="url" value="jdbc:oracle:thin:@localhost:1521:xe"></property>
		<property name="username" value="hr"></property>
		<property name="password" value="java1234"></property>
	</bean>

 

 

3. 연결 테스트

package com.test.persistence;

import static org.junit.Assert.assertNotNull;
import java.sql.Connection;
import javax.sql.DataSource;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
import lombok.extern.log4j.Log4j;

@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration("file:src/main/webapp/WEB-INF/spring/root-context.xml")
@Log4j
public class DBCPTest {
	@Autowired
	private DataSource dataSource;
	
	@Test
	public void testConnection() {
		assertNotNull(dataSource);
		try {
			Connection conn = dataSource.getConnection();
			log.info(conn.isClosed());
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
}

 

 

 

HikariCP 사용하기

1. 의존성 추가

pom.xml

<dependency>
          <groupId>com.zaxxer</groupId>
          <artifactId>HikariCP</artifactId>
          <version>2.7.4</version>
      </dependency>

 

 

2. 설정 추가

WEB-INF > spring > root-context.xml

<!-- 설정파일 -->
	<bean id="hikariConfig" class="com.zaxxer.hikari.HikariConfig">
		<property name="driverClassName" value="oracle.jdbc.driver.OracleDriver"></property>
		<property name="jdbcUrl" value="jdbc:oracle:thin:@localhost:1521:xe"></property>
		<property name="username" value="hr"></property>
		<property name="password" value="java1234"></property>
	</bean>
	
	<!-- 설정파일 의존주입 -->
	<bean id="dataSource" class="com.zaxxer.hikari.HikariDataSource" destroy-method="close">
		<constructor-arg ref="hikariConfig"></constructor-arg>
	</bean>

 

설정파일 의존 주입 부분에서 class의 HikariDataSource 는 커넥션을 자동으로 연결해준다는 의미를 가지고 있다. destroy-method는 자원 해제 옵션으로 close() 메서드를 호출하여 데이터 소스가 소멸될 때 커넥션 풀을 정리하도록 한다.

 

 

🔻MyBatis 사용하기

의존성 추가 - pom.xml

<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.2</version>
</dependency>

<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis-spring</artifactId>
    <version>1.3.2</version>
</dependency>

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-tx</artifactId>
    <version>${org.springframework-version}</version>
</dependency>

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-jdbc</artifactId>
    <version>${org.springframework-version}</version>
</dependency>

 

 

(DB관련)설정 추가 - root-context.xml 

	<!-- 환경설정 -->
	<bean id="sessionfactory" class="org.mybatis.spring.SqlSessionFactoryBean">
		<property name="dataSource" ref="dataSource"></property>
		<property name="mapperLocations" value="classpath*:mapper/*.xml"></property>
	</bean>
	
	<!-- 환경설정 의존주입 -->
	<bean class="org.mybatis.spring.SqlSessionTemplate">
		<constructor-arg ref="sessionfactory"></constructor-arg>
	</bean>

 

<환경설정>

sessionfactory: SqlSessionFactory의 빈을 정의한다. SqlSessionFactory는 MyBatis에서 세션을 생성하는 공장 역할을 한다.

dataSource: 데이터베이스 연결을 관리하는 데 사용될 데이터 소스를 설정한다. 앞서 설명한 것처럼 HikariCP를 사용하는 경우 dataSource 빈을 참조하게 된다.

mapperLocations: MyBatis 매퍼 파일의 위치를 지정한다. 매퍼 파일은 SQL 쿼리와 자바 객체 간의 매핑을 담당한다.

classpath*:mapper/*.xml : classpath는 루트 폴더의 4가지 폴더를 의미한다. 그 중에서 mapper 폴더를 찾아 .xml 파일을 찾는다.

mapper 폴더 속 xml 파일

<환경설정 의존주입>

SqlSessionTemplate: MyBatis에서 제공하는 세션 관리를 위한 템플릿이다. 이를 통해 세션을 생성하고 데이터베이스와의 상호 작용을 간소화할 수 있다.
sessionfactory: 앞서 설정한 sessionfactory 빈을 참조하여 SqlSessionTemplate을 생성한다.

 

 

연결 테스트

package com.test.persistence;

import static org.junit.Assert.assertNotNull;
import org.apache.ibatis.session.SqlSessionFactory;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
import lombok.extern.log4j.Log4j;

@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration("file:src/main/webapp/WEB-INF/spring/root-context.xml")
@Log4j
public class MapperTest {
	@Autowired
	private SqlSessionFactory sqlSessionFactory;
	@Test
	public void testQuery() {
		assertNotNull(sqlSessionFactory);
	}
}

 

연결 성공

 

---

🔻Controller 파일에 'S' 마크가 없다면

Spring이 스캔하는 파일에는 S마크가 붙는데 S마크가 없는 파일들이 존재할 때 있다. 이럴 때는 스캔할 수 있도록 패키지 경로를 등록해줘야한다.

아래 사진 같은 경우에는 com.test.mybatis는 스캔 영역에 포함되어 있지만, com.test.controller 패지키는 스캔 영역으로 설정을 해주지 않아 MyBatisController.java 파일에 S 마크가 없다.

스캔 폴더 관리는 servlet-context.xml에서 관리한다.

 

servlet-context.xml

<context:component-scan base-package="com.test.controller" />

 

Spring 에 등록할 패키지의 경로를 입력한다.

그러면 등록한 패키지 내부의 @Controller 어노테이션을 인식할 수 있게된다.

 

등록 완료

 

---

🔻유기적 관계

Controller, SqlSessionTemplate, SqlSessionFactoryBean, DataSource, 그리고 HikariConfig 는 유기적으로 이어져있다.

 

Controller가 요청을 받아서 비즈니스 로직을 처리하기 위해 DAOImpl, SqlSessionTemplate을 사용한다. SqlSessionTemplate은 SqlSessionFactoryBean을 사용하여 DataSource를 통해 데이터베이스와의 연결을 관리하고, 이 DataSource는 HikariConfig를 기반으로 생성된다.

 

각자의 역할

Controller
Controller는 웹 애플리케이션의 요청을 처리하고 적절한 비즈니스 로직을 호출하는 역할을 담당한다.
주로 사용자의 입력을 받아서 비즈니스 로직을 실행하고, 그 결과를 뷰에 전달하여 화면에 표시한다.

 

SqlSessionTemplate
SqlSessionTemplate은 MyBatis의 SqlSession을 구현한 클래스로, 데이터베이스와의 상호 작용을 담당한다.
SqlSession은 SQL 매핑을 실행하는데 사용되며, SqlSessionTemplate은 이를 편리하게 사용할 수 있도록 해준다.

SqlSessionFactoryBean
SqlSessionFactoryBean은 MyBatis에서 사용하는 SqlSessionFactory를 생성하는데 필요한 설정을 제공한다.
SqlSessionFactory는 MyBatis의 핵심이며, 데이터베이스와의 연결 및 SQL 문을 실행하는 데 사용된다.

 

DataSource
DataSource는 데이터베이스 연결 풀링을 관리하는 객체이다.
데이터베이스와의 연결을 효율적으로 관리하기 위해 사용된다. SqlSessionFactoryBean은 이 DataSource를 사용하여 데이터베이스와의 연결을 관리한다.

HikariConfig
HikariConfig는 HikariCP 데이터베이스 커넥션 풀의 설정을 담당하는 클래스이다.
HikariCP는 높은 성능의 데이터베이스 커넥션 풀 라이브러리로, 데이터베이스 연결을 효율적으로 관리하여 성능을 향상시킨다. HikariConfig에서 설정된 정보는 DataSource를 생성할 때 사용된다.