DBCP

DBCP (Database Connection Pooling)

DB 연결을 풀(Pool)을 사용하여, 연결을 재사용함으로써 성능을 향상시키는 기술

DBCP를 사용하면 매번 새로운 연결을 생성하지 않고, 기존의 연결을 재사용할 수 있습니다.

DBCP (Database Connection Pooling)

풀(Pool)? : 여러 사람이 함께 사용하고 나누어 쓰는 자원 집합

Pool 은 수영장입니다. 수영장에는 여러 사람이 들어가서 수영하면서 물이라는 자원을 공유합니다. 마찬가지로 프로그램에서의 Pool 은 자원을 공유해서 효율적으로 사용하는 방식 지원해주는 영역입니다.

DBCP 라이브러리

Apache Commons DBCP

자바 애플리케이션에서 많이 사용되는 연결 풀 구현 라이브러리

다운로드

https://mvnrepository.com/artifact/org.apache.commons/commons-pool2/2.12.0

https://mvnrepository.com/artifact/org.apache.commons/commons-dbcp2/2.12.0

https://mvnrepository.com/artifact/commons-logging/commons-logging/1.3.4

https://mvnrepository.com/artifact/javax.transaction/javax.transaction-api/1.3

https://mvnrepository.com/artifact/com.mysql/mysql-connector-j/9.5.0

DBCP 예시 프로젝트

프로젝트 구조

DBCP/
 ├─ src/
 │   ├─ DBCP/
 │   │   └─ Main.java
 │   └─ module-info.java
 └─ lib/
     ├─ commons-dbcp2-2.12.0.jar
     ├─ commons-logging-1.3.4.jar
     ├─ commons-pool2-2.12.0.jar
     ├─ javax.transaction-api-1.3.jar
     └─ mysql-connector-j-9.5.0.jar
Plain Text
복사

Main.java (DBCP 기본 예시 코드)

package DBCP;

import java.sql.Connection;
import java.sql.ResultSet;
import java.sql.Statement;
import org.apache.commons.dbcp2.BasicDataSource;

public class Main {
    public static void main(String[] args) {
        // BasicDataSource 객체 생성 (DB 연결 풀 설정)
        BasicDataSource ds = new BasicDataSource();
        ds.setUrl("jdbc:mysql://localhost:3306/aloha");
        ds.setUsername("aloha");
        ds.setPassword("123456");
        ds.setDriverClassName("com.mysql.cj.jdbc.Driver");

        // 풀 설정
        ds.setInitialSize(5);   // 초기 연결 개수
        ds.setMaxTotal(10);     // 최대 연결 개수

        try (Connection conn = ds.getConnection();
             Statement stmt = conn.createStatement();
             ResultSet rs = stmt.executeQuery("SELECT * FROM board")) {

            while (rs.next()) {
                System.out.println("제목: " + rs.getString("title"));
                System.out.println("작성자: " + rs.getString("writer"));
                System.out.println("내용: " + rs.getString("content"));
                System.out.println("------");
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}
Java
복사

module-info.java

module DBCP {
    requires java.sql;
    requires static java.transaction.xa;
    requires org.apache.commons.dbcp2;
    requires org.apache.commons.pool2;
}
Java
복사

SQL

-- 데이터베이스 생성
CREATE DATABASE aloha;

-- 테이블 생성
-- 게시판 테이블 생성
CREATE TABLE `aloha`.`board` (
  `no`			INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT '번호',
  `title`		VARCHAR(100) NOT NULL COMMENT '제목',
  `writer`		VARCHAR(100) NOT NULL COMMENT '작성자',
  `content`		TEXT	NULL COMMENT '내용',
  `created_at`	TIMESTAMP NOT NULL DEFAULT now() COMMENT '등록일자',
  `updated_at`	TIMESTAMP NOT NULL DEFAULT now() COMMENT '수정일자'
) COMMENT = '게시판';

-- 데이터 추가
INSERT INTO board (title, writer, content)
VALUES
	('제목01', '작성자01', '내용01'),
    ('제목02', '작성자02', '내용02'),
    ('제목03', '작성자03', '내용03'),
    ('제목04', '작성자04', '내용04'),
    ('제목05', '작성자05', '내용05')
;
SQL
복사

DBCP 관련 라이브러리 역할 정리

라이브러리 파일명	주요 역할	필수 여부
commons-dbcp2-2.12.0.jar	핵심 DBCP 라이브러리. BasicDataSource, 커넥션 풀 관리, 커넥션 재사용/회수 기능 제공	필수
commons-pool2-2.12.0.jar	객체 풀(Object Pool) 구현 라이브러리. DBCP가 내부적으로 커넥션을 관리할 때 사용	필수
commons-logging-1.3.4.jar	Apache 공용 로깅 라이브러리. DBCP 내부 동작 로그를 표준 로깅 인터페이스로 출력	선택(권장)
javax.transaction-api-1.3.jar	트랜잭션 관련 API (JTA). DBCP 내부에서 트랜잭션 연동 시 필요	선택(모듈 사용 시 필수)
mysql-connector-j-9.0.0.jar	MySQL JDBC 드라이버. 실제 DB 연결을 위한 필수 드라이버	필수

작동 흐름 요약

단계	동작	주요 클래스
①	BasicDataSource 생성	BasicDataSource
②	DB 연결 정보 설정 (URL, user, password, driver)	BasicDataSource
③	초기 커넥션 풀 생성 (setInitialSize)	GenericObjectPool (내부)
④	getConnection() 호출 시 풀에서 연결 제공	PoolableConnectionFactory
⑤	사용 후 자동으로 반환 (try-with-resources 사용)	Connection.close() 내부에서 반환

DBCP 커넥션 풀 구조도

graph TB
    subgraph Application["애플리케이션"]
        A["프로그램 코드"]
    end
    
    subgraph DBCP["DBCP (Connection Pool)"]
        B["BasicDataSource"]
        C["GenericObjectPool"]
        D["Active Connections<br/>(사용 중인 연결)"]
        E["Idle Connections<br/>(대기 중인 연결)"]
    end
    
    subgraph Database["데이터베이스"]
        F["MySQL/Oracle/PostgreSQL 등"]
    end
    
    A -->|"1. getConnection() 요청"| B
    B -->|"2. 연결 요청"| C
    C -->|"3. 사용 가능한 연결 확인"| E
    E -->|"4. 연결 제공"| D
    D -->|"5. Connection 반환"| A
    A -->|"6. 쿼리 실행"| F
    F -->|"7. 결과 반환"| A
    A -->|"8. close() 호출<br/>(연결 반환)"| D
    D -->|"9. 풀로 반환"| E
    
    C -.->|"최대 연결 수<br/>초과 시 대기"| C
    E -.->|"InitialSize: 5<br/>MaxTotal: 10"| E
    
    style A fill:#e1f5ff
    style B fill:#fff4e6
    style C fill:#fff4e6
    style D fill:#ffe6e6
    style E fill:#e6ffe6
    style F fill:#f0e6ff
Mermaid
복사

구조도 설명

•

Application (애플리케이션): 프로그램 코드에서 DB 연결이 필요할 때 DBCP에 요청

•

BasicDataSource: DBCP의 핵심 클래스로, 연결 풀을 관리하는 진입점

•

GenericObjectPool: 실제 커넥션 객체들을 풀(Pool)로 관리하는 내부 구조

•

Idle Connections (대기 연결): 사용되지 않고 풀에서 대기 중인 연결들

InitialSize: 초기에 생성되는 연결 개수

MaxTotal: 풀에서 유지할 수 있는 최대 연결 개수

•

Active Connections (활성 연결): 현재 애플리케이션에서 사용 중인 연결들

•

연결 흐름:

getConnection() 호출 → 풀에서 연결 가져오기

DB 쿼리 실행

close() 호출 → 연결을 풀로 반환 (실제로 닫지 않고 재사용)