※ 이전 포스팅
https://drcode-devblog.tistory.com/583
[Spring] 커넥션 풀과 데이터 소스 개념
데이터베이스 커넥션을 매번 획득 데이터베이스 커넥션을 획득할 때는 다음과 같은 복잡한 과정을 거친다. 1) 애플리케이션 로직은 DB 드라입러를 통해 커넥션을 조회한다. 2) DB 드라이버는 DB와
drcode-devblog.tistory.com
DataSource 를 실제로 적용한 내용을 살펴보면 아래와 같다.
ConnectionTest - 드라이버 매니저
package hello.jdbc.connection;
import lombok.extern.slf4j.Slf4j;
import org.junit.jupiter.api.Test;
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;
import static hello.jdbc.connection.ConnectionConst.*;
@Slf4j
public class ConnectionTest {
@Test
void driverManager() throws SQLException {
Connection con1 = DriverManager.getConnection(URL, USERNAME, PASSWORD);
Connection con2 = DriverManager.getConnection(URL, USERNAME, PASSWORD);
log.info("connection={}, class={}", con1, con1.getClass());
log.info("connection={}, class={}", con2, con2.getClass());
}
}
실행 결과
16:06:36.680 [main] INFO h.jdbc.connection.ConnectionTest --
connection=conn0: url=jdbc:h2:tcp://localhost/~/dbAccess user=SA, class=class org.h2.jdbc.JdbcConnection
16:06:36.685 [main] INFO h.jdbc.connection.ConnectionTest --
connection=conn1: url=jdbc:h2:tcp://localhost/~/dbAccess user=SA, class=class org.h2.jdbc.JdbcConnection
Process finished with exit code 0
이번에는 스프링이 제공하는 DataSource 가 적용된 DriverManager 인 DriverManagerDataSource 를 사용한다.
ConnectionTest - 데이터소스 드라이버 매니저 추가
package hello.jdbc.connection;
import lombok.extern.slf4j.Slf4j;
import org.junit.jupiter.api.Test;
import org.springframework.jdbc.datasource.DriverManagerDataSource;
import javax.sql.DataSource;
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;
import static hello.jdbc.connection.ConnectionConst.*;
@Slf4j
public class ConnectionTest {
@Test
void driverManager() throws SQLException {
Connection con1 = DriverManager.getConnection(URL, USERNAME, PASSWORD);
Connection con2 = DriverManager.getConnection(URL, USERNAME, PASSWORD);
log.info("connection={}, class={}", con1, con1.getClass());
log.info("connection={}, class={}", con2, con2.getClass());
}
@Test
void dataSourceDriverManager() throws SQLException {
//DriverManagerDataSource - 항상 새로운 커넥션 획득
DriverManagerDataSource dataSource = new DriverManagerDataSource(URL,
USERNAME, PASSWORD);
useDataSource(dataSource);
}
private void useDataSource(DataSource dataSource) throws SQLException {
Connection con1 = dataSource.getConnection();
Connection con2 = dataSource.getConnection();
log.info("connection={}, class={}", con1, con1.getClass());
log.info("connection={}, class={}", con2, con2.getClass());
}
}
dataSourceDriverManager() - 실행 결과
16:11:43.600 [main] DEBUG o.s.j.d.DriverManagerDataSource --
Creating new JDBC DriverManager Connection to [jdbc:h2:tcp://localhost/~/dbAccess]
16:11:43.719 [main] DEBUG o.s.j.d.DriverManagerDataSource --
Creating new JDBC DriverManager Connection to [jdbc:h2:tcp://localhost/~/dbAccess]
16:11:43.723 [main] INFO h.jdbc.connection.ConnectionTest --
connection=conn0: url=jdbc:h2:tcp://localhost/~/dbAccess user=SA, class=class org.h2.jdbc.JdbcConnection
16:11:43.725 [main] INFO h.jdbc.connection.ConnectionTest --
connection=conn1: url=jdbc:h2:tcp://localhost/~/dbAccess user=SA, class=class org.h2.jdbc.JdbcConnection
Process finished with exit code 0
기존 코드와 비슷하지만 DriverManagerDataSource 는 DataSource 를 통해서 커넥션을 획득할 수 있다.
참고로 DriverManagerDataSource 는 스프링이 제공하는 코드이다
파라미터 차이
기존 DriverManager 를 통해서 커넥션을 획득하는 방법과 DataSource 를 통해서 커넥션을 획득하는 방법에는 큰 차이가 있다.
DriverManager
DriverManager.getConnection(URL, USERNAME, PASSWORD)
DriverManager.getConnection(URL, USERNAME, PASSWORD)
DataSource
void dataSourceDriverManager() throws SQLException {
DriverManagerDataSource dataSource = new DriverManagerDataSource(URL,
USERNAME, PASSWORD);
useDataSource(dataSource);
}
private void useDataSource(DataSource dataSource) throws SQLException {
Connection con1 = dataSource.getConnection();
Connection con2 = dataSource.getConnection();
log.info("connection={}, class={}", con1, con1.getClass());
log.info("connection={}, class={}", con2, con2.getClass());
}
DriverManager 는 커넥션을 획득할 때 마다 URL , USERNAME , PASSWORD 같은 파라미터를 계속 전달해야 한다.
반면에 DataSource 를 사용하는 방식은 처음 객체를 생성할 때만 필요한 파리미터를 넘겨두고,
커넥션을 획득할 때는 단순히 dataSource.getConnection() 만 호출하면 된다
설정과 사용의 분리
설정: DataSource 를 만들고 필요한 속성들을 사용해서 URL , USERNAME , PASSWORD 같은 부분을 입력하는 것을 말한다. 이렇게 설정과 관련된 속성들은 한 곳에 있는 것이 향후 변경에 더 유연하게 대처할 수 있다.
사용: 설정은 신경쓰지 않고, DataSource 의 getConnection() 만 호출해서 사용하면 된다
설정과 사용의 분리 설명
이 부분이 작아보이지만 큰 차이를 만들어내는데, 필요한 데이터를 DataSource 가 만들어지는 시점에 미리 다 넣어두게 되면, DataSource 를 사용하는 곳에서는 dataSource.getConnection() 만 호출하면 되므로,
URL , USERNAME , PASSWORD 같은 속성들에 의존하지 않아도 된다.
그냥 DataSource 만 주입받아서 getConnection() 만 호출하면 된다.
쉽게 이야기해서 리포지토리(Repository)는 DataSource 만 의존하고, 이런 속성을 몰라도 된다.
애플리케이션을 개발해보면 보통 설정은 한 곳에서 하지만, 사용은 수 많은 곳에서 하게 된다.
덕분에 객체를 설정하는 부분과, 사용하는 부분을 좀 더 명확하게 분리할 수 있다
DataSource - 커넥션 풀
ConnectionTest - 데이터소스 커넥션 풀 추가
import com.zaxxer.hikari.HikariDataSource;
@Test
void dataSourceConnectionPool() throws SQLException, InterruptedException {
//커넥션 풀링: HikariProxyConnection(Proxy) -> JdbcConnection(Target)
HikariDataSource dataSource = new HikariDataSource();
dataSource.setJdbcUrl(URL);
dataSource.setUsername(USERNAME);
dataSource.setPassword(PASSWORD);
dataSource.setMaximumPoolSize(10);
dataSource.setPoolName("MyPool");
useDataSource(dataSource);
Thread.sleep(1000); //커넥션 풀에서 커넥션 생성 시간 대기
}
HikariCP 커넥션 풀을 사용한다. HikariDataSource 는 DataSource 인터페이스를 구현하고 있다.
커넥션 풀 최대 사이즈를 10으로 지정하고, 풀의 이름을 MyPool 이라고 지정했다.
커넥션 풀에서 커넥션을 생성하는 작업은 애플리케이션 실행 속도에 영향을 주지 않기 위해 별도의 쓰레드에서 작동한다.
별도의 쓰레드에서 동작하기 때문에 테스트가 먼저 종료되어 버린다.
예제처럼 Thread.sleep 을 통해 대기 시간을 주어야 쓰레드 풀에 커넥션이 생성되는 로그를 확인할 수 있다.
실행 결과
#커넥션 풀 초기화 정보 출력
HikariConfig - MyPool - configuration:
HikariConfig - maximumPoolSize................................10
HikariConfig - poolName................................"MyPool"
#커넥션 풀 전용 쓰레드가 커넥션 풀에 커넥션을 10개 채움
[MyPool connection adder] MyPool - Added connection conn0: url=jdbc:h2:..
user=SA
[MyPool connection adder] MyPool - Added connection conn1: url=jdbc:h2:..
user=SA
[MyPool connection adder] MyPool - Added connection conn2: url=jdbc:h2:..
user=SA
[MyPool connection adder] MyPool - Added connection conn3: url=jdbc:h2:..
user=SA
[MyPool connection adder] MyPool - Added connection conn4: url=jdbc:h2:..
user=SA
...
[MyPool connection adder] MyPool - Added connection conn9: url=jdbc:h2:..
user=SA
#커넥션 풀에서 커넥션 획득1
ConnectionTest - connection=HikariProxyConnection@446445803 wrapping conn0:
url=jdbc:h2:tcp://localhost/~/test user=SA, class=class
com.zaxxer.hikari.pool.HikariProxyConnection
#커넥션 풀에서 커넥션 획득2
ConnectionTest - connection=HikariProxyConnection@832292933 wrapping conn1:
url=jdbc:h2:tcp://localhost/~/test user=SA, class=class
com.zaxxer.hikari.pool.HikariProxyConnection
MyPool - After adding stats (total=10, active=2, idle=8, waiting=0)
HikariConfig
HikariCP 관련 설정을 확인할 수 있다. 풀의 이름( MyPool )과 최대 풀 수( 10 )을 확인할 수 있다
MyPool connection adder
별도의 쓰레드 사용해서 커넥션 풀에 커넥션을 채우고 있는 것을 확인할 수 있다.
이 쓰레드는 커넥션 풀에 커넥션을 최 대 풀 수( 10 )까지 채운다.
그렇다면 왜 별도의 쓰레드를 사용해서 커넥션 풀에 커넥션을 채우는 것일까?
커넥션 풀에 커넥션을 채우는 것은 상대적으로 오래 걸리는 일이다.
애플리케이션을 실행할 때 커넥션 풀을 채울 때 까 지 마냥 대기하고 있다면 애플리케이션 실행 시간이 늦어진다.
따라서 이렇게 별도의 쓰레드를 사용해서 커넥션 풀을 채 워야 애플리케이션 실행 시간에 영향을 주지 않는다.
커넥션 풀에서 커넥션 획득
커넥션 풀에서 커넥션을 획득하고 그 결과를 출력했다.
여기서는 커넥션 풀에서 커넥션을 2개 획득하고 반환하지는 않았다.
따라서 풀에 있는 10개의 커넥션 중에 2개를 가지고 있는 상태이다.
그래서 마지막 로그를 보면 사용중인 커넥션 active=2 , 풀에서 대기 상태인 커넥션 idle=8 을 확인할 수 있다.
MyPool - After adding stats (total=10, active=2, idle=8, waiting=0)
참고
HikariCP 커넥션 풀 공식 사이트
https://github.com/brettwooldridge/HikariCP
※ 스프링 부트 3.1 이상 버전에서 로그 출력이 안되는 문제를 해결하려면??
Hikari Connection Pool을 테스트하는 dataSourceConnectionPool() 을 실행할 때, 스프링 부트 3.1 이상을 사용한다면 전체 로그가 가이날 다음과 같은 간략한 로그만 출력한다.
14:14:55.926 [Test worker] INFO com.zaxxer.hikari.HikariDataSource -- MyPool -
Starting...
14:14:55.993 [Test worker] INFO com.zaxxer.hikari.pool.HikariPool -- MyPool -
Added connection conn0: url=jdbc:h2:tcp://localhost/~/test user=SA
14:14:55.994 [Test worker] INFO com.zaxxer.hikari.HikariDataSource -- MyPool -
Start completed.
14:14:55.997 [Test worker] INFO hello.jdbc.connection.ConnectionTest --
connection=HikariProxyConnection@2066892165 wrapping conn0: url=jdbc:h2:tcp://
localhost/~/test user=SA, class=class
com.zaxxer.hikari.pool.HikariProxyConnection
14:14:56.000 [Test worker] INFO hello.jdbc.connection.ConnectionTest --
connection=HikariProxyConnection@276869158 wrapping conn1: url=jdbc:h2:tcp://
localhost/~/test user=SA, class=class
com.zaxxer.hikari.pool.HikariProxyConnection
이때는 다음 위치에 파일을 만들어서 넣으면 된다
src/main/resources/logback.xml
<configuration>
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
<encoder>
<pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} -%kvp-%msg%n</pattern>
</encoder>
</appender>
<root level="DEBUG">
<appender-ref ref="STDOUT" />
</root>
</configuration>
스프링 부트 3.1 부터 기본 로그 레벨을 INFO 로 빠르게 설정하기 때문에 로그를 확인할 수 없는데, 이렇게하면 기본 로그 레벨을 DEBUG 로 설정해서 강의 내용과 같이 로그를 확인할 수 있다.
DataSource 적용
어플리케이션에 DataSource를 적용
MemberRepositoryV1.java
package hello.jdbc.repository;
import hello.jdbc.connection.DBConnectionUtil;
import hello.jdbc.domain.Member;
import lombok.extern.slf4j.Slf4j;
import org.springframework.jdbc.support.JdbcUtils;
import javax.sql.DataSource;
import java.sql.*;
import java.util.NoSuchElementException;
/**
* JDBC - DataSource 사용, JdbcUtils 사용
* */
@Slf4j
public class MemberRepositoryV1 {
private final DataSource dataSource;
public MemberRepositoryV1(DataSource dataSource) {
this.dataSource = dataSource;
}
public Member save(Member member) throws SQLException {
String sql = "insert into member(member_id, money) values(?, ?)";
Connection con = null;
PreparedStatement pstmt = null;
try {
con = getConnection();
pstmt = con.prepareStatement(sql);
pstmt.setString(1, member.getMemberId());
pstmt.setInt(2, member.getMoney());
int count = pstmt.executeUpdate();
return member;
} catch (SQLException e) {
e.printStackTrace();
throw e;
} finally {
close(con, pstmt, null);
}
}
public Member findById(String memberId) {
String sql = "select * from member where member_id = ?";
Connection con = null;
PreparedStatement pstmt = null;
ResultSet rs = null;
try {
con = getConnection();
pstmt = con.prepareStatement(sql);
pstmt.setString(1, memberId);
rs = pstmt.executeQuery();
if(rs.next()) {
Member member = new Member();
member.setMemberId(rs.getString("member_id"));
member.setMoney(rs.getInt("money"));
return member;
} else {
throw new NoSuchElementException("member not found memberId = " + memberId);
}
} catch (SQLException e) {
log.info("error", e);
} finally {
close(con, pstmt, rs);
}
return null;
}
public void update(String memberId, int money) throws SQLException {
String sql = "update member set money=? where member_id=?";
Connection con = null;
PreparedStatement pstmt = null;
try {
con = getConnection();
pstmt = con.prepareStatement(sql);
pstmt.setInt(1, money);
pstmt.setString(2, memberId);
int resultSize = pstmt.executeUpdate();
log.info("resultSize={}", resultSize);
} catch (SQLException e) {
log.info("error", e);
throw e;
} finally {
close(con, pstmt, null);
}
}
public void delete(String memberId) throws SQLException {
String sql = "delete from member where member_id = ?";
Connection con = null;
PreparedStatement pstmt = null;
try {
con = getConnection();
pstmt = con.prepareStatement(sql);
pstmt.setString(1, memberId);
int resultSize = pstmt.executeUpdate();
log.info("resultSize={}", resultSize);
} catch (SQLException e) {
log.info("error", e);
throw e;
}
finally {
close(con, pstmt, null);
}
}
private void close(Connection con, Statement stmt, ResultSet rs) {
JdbcUtils.closeResultSet(rs);
JdbcUtils.closeStatement(stmt);
JdbcUtils.closeConnection(con);
}
private Connection getConnection() throws SQLException {
Connection con = dataSource.getConnection();
log.info("get connection={}, class={}", con, con.getClass());
return con;
}
}
DataSource 의존관계 주입
- 외부에서 DataSource 를 주입 받아서 사용한다. 이제 직접 만든 DBConnectionUtil 을 사용하지 않아도 된다.
- DataSource 는 표준 인터페이스 이기 때문에 DriverManagerDataSource 에서 HikariDataSource 로 변경되어도
해당 코드를 변경하지 않아도 된다.
JdbcUtils 편의 메서드
- 스프링은 JDBC를 편리하게 다룰 수 있는 JdbcUtils 라는 편의 메서드를 제공한다.
- JdbcUtils 을 사용하면 커넥션을 좀 더 편리하게 닫을 수 있다.
MemberRepositoryV1Test.java
package hello.jdbc.repository;
import com.zaxxer.hikari.HikariDataSource;
import hello.jdbc.domain.Member;
import lombok.extern.slf4j.Slf4j;
import org.assertj.core.api.Assertions;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.springframework.jdbc.datasource.DriverManagerDataSource;
import java.sql.SQLException;
import java.util.NoSuchElementException;
import static org.assertj.core.api.Assertions.assertThat;
import static hello.jdbc.connection.ConnectionConst.*;
@Slf4j
class MemberRepositoryV1Test {
MemberRepositoryV1 repository;
@BeforeEach
void beforeEach() {
// 기본 DriverManager - 항상 새로운 커넥션을 획득
// DriverManagerDataSource dataSource = new DriverManagerDataSource(URL, USERNAME, PASSWORD);
// 커넥션 풀링
HikariDataSource dataSource = new HikariDataSource();
dataSource.setJdbcUrl(URL);
dataSource.setUsername(USERNAME);
dataSource.setPassword(PASSWORD);
repository = new MemberRepositoryV1(dataSource);
}
@Test
void crud() throws SQLException {
// save
Member member = new Member("memberV5", 10000);
repository.save(member);
// findById
Member findMember = repository.findById(member.getMemberId());
log.info("findMember={}", findMember);
log.info("member != findMember {}", member.equals(findMember));
assertThat(findMember).isEqualTo(member);
// update : money : 10000 -> 20000
repository.update(member.getMemberId(), 20000);
Member updateMember = repository.findById(member.getMemberId());
assertThat(updateMember.getMoney()).isEqualTo(20000);
// delete
repository.delete(member.getMemberId());
Assertions.assertThatThrownBy(() -> repository.findById(member.getMemberId()))
.isInstanceOf(NoSuchElementException.class);
try {
Thread.sleep(1000);
} catch (InterruptedException e) {
e.printStackTrace();
}
}
}
- MemberRepositoryV1 은 DataSource 의존관계 주입이 필요하다
DriverManagerDataSource 사용
08:53:41.709 [main] INFO h.jdbc.connection.DBConnectionUtil --get connection=conn0: url=jdbc:h2:tcp://localhost/~/dbAccess user=SA, class=class org.h2.jdbc.JdbcConnection
08:53:41.736 [main] INFO h.jdbc.connection.DBConnectionUtil --get connection=conn1: url=jdbc:h2:tcp://localhost/~/dbAccess user=SA, class=class org.h2.jdbc.JdbcConnection
08:53:41.863 [main] INFO h.jdbc.connection.DBConnectionUtil --get connection=conn2: url=jdbc:h2:tcp://localhost/~/dbAccess user=SA, class=class org.h2.jdbc.JdbcConnection
08:53:41.877 [main] INFO h.jdbc.connection.DBConnectionUtil --get connection=conn3: url=jdbc:h2:tcp://localhost/~/dbAccess user=SA, class=class org.h2.jdbc.JdbcConnection
08:53:41.892 [main] INFO h.jdbc.connection.DBConnectionUtil --get connection=conn4: url=jdbc:h2:tcp://localhost/~/dbAccess user=SA, class=class org.h2.jdbc.JdbcConnection
08:53:41.904 [main] INFO h.jdbc.connection.DBConnectionUtil --get connection=conn5: url=jdbc:h2:tcp://localhost/~/dbAccess user=SA, class=class org.h2.jdbc.JdbcConnection
Process finished with exit code 0
DriverManagerDataSource 를 사용하면 conn0~5 번호를 통해서 항상 새로운 커넥션이 생성되어서
사용 되는 것을 확인할 수 있다
HikariDataSource 사용
08:56:06.693 [main] INFO com.zaxxer.hikari.HikariDataSource --HikariPool-1 - Starting...
08:56:06.704 [main] DEBUG c.z.hikari.util.DriverDataSource --Loaded driver with class name org.h2.Driver for jdbcUrl=jdbc:h2:tcp://localhost/~/dbAccess
08:56:06.870 [main] INFO com.zaxxer.hikari.pool.HikariPool --HikariPool-1 - Added connection conn0: url=jdbc:h2:tcp://localhost/~/dbAccess user=SA
08:56:06.874 [main] INFO com.zaxxer.hikari.HikariDataSource --HikariPool-1 - Start completed.
08:56:06.878 [main] INFO h.jdbc.repository.MemberRepositoryV1 --get connection=HikariProxyConnection@1845623216 wrapping conn0: url=jdbc:h2:tcp://localhost/~/dbAccess user=SA, class=class com.zaxxer.hikari.pool.HikariProxyConnection
08:56:06.922 [main] INFO h.jdbc.repository.MemberRepositoryV1 --get connection=HikariProxyConnection@1758624236 wrapping conn0: url=jdbc:h2:tcp://localhost/~/dbAccess user=SA, class=class com.zaxxer.hikari.pool.HikariProxyConnection
08:56:07.027 [main] INFO h.jdbc.repository.MemberRepositoryV1 --get connection=HikariProxyConnection@46453164 wrapping conn0: url=jdbc:h2:tcp://localhost/~/dbAccess user=SA, class=class com.zaxxer.hikari.pool.HikariProxyConnection
08:56:07.030 [main] INFO h.jdbc.repository.MemberRepositoryV1 --get connection=HikariProxyConnection@2131597042 wrapping conn0: url=jdbc:h2:tcp://localhost/~/dbAccess user=SA, class=class com.zaxxer.hikari.pool.HikariProxyConnection
08:56:07.036 [main] INFO h.jdbc.repository.MemberRepositoryV1 --get connection=HikariProxyConnection@1027495011 wrapping conn0: url=jdbc:h2:tcp://localhost/~/dbAccess user=SA, class=class com.zaxxer.hikari.pool.HikariProxyConnection
08:56:07.040 [main] INFO h.jdbc.repository.MemberRepositoryV1 --get connection=HikariProxyConnection@1180858072 wrapping conn0: url=jdbc:h2:tcp://localhost/~/dbAccess user=SA, class=class com.zaxxer.hikari.pool.HikariProxyConnection
커넥션 풀 사용시 conn0 커넥션이 재사용 된 것을 확인할 수 있다.
테스트는 순서대로 실행되기 때문에 커넥션을 사용하고 다시 돌려주는 것을 반복한다. 따라서 conn0 만 사용된다.
웹 애플리케이션에 동시에 여러 요청이 들어오면 여러 쓰레드에서 커넥션 풀의 커넥션을 다양하게 가져가는 상황 을 확인할 수 있다.
DI
DriverManagerDataSource → HikariDataSource 로 변경해도 MemberRepositoryV1 의 코드는 전혀 변 경하지 않아도 된다.
MemberRepositoryV1 는 DataSource 인터페이스에만 의존하기 때문이다.
이것이 DataSource 를 사용하는 장점이다.(DI + OCP)
'스프링 > 스프링 DB 접근' 카테고리의 다른 글
[Spring] DB Lock (1) | 2024.12.18 |
---|---|
[Spring] 트랜잭션 이해 - 트랜잭션 개념 (0) | 2024.12.17 |
[Spring] 커넥션 풀과 데이터 소스 개념 (0) | 2024.01.19 |
[Spring] JDBC CRUD(등록, 조회, 수정, 삭제) (0) | 2024.01.18 |
[Spring] JDBC의 이해와 JDBC 관련 기술 (+ H2 Database 설치), 데이터베이스 연결 (0) | 2024.01.18 |
댓글