JDBC는 무엇을 연결하는 다리인가

쉽게 말하면: JDBC는 Java 코드와 데이터베이스 사이에 놓인 “표준 통역 창구”입니다.

Java 프로그램은 그 자체로 Oracle이나 MySQL 같은 데이터베이스와 직접 대화할 수 없습니다. 각 DB 제조사는 서로 다른 통신 방식을 쓰기 때문입니다. JDBC(Java DataBase Connectivity, 자바 데이터베이스 연결)는 “Java 코드는 이 정해진 방법으로만 요청하면, 어떤 DB든 알아서 응답을 돌려준다”는 표준 인터페이스(interface, 12_java-exception-collection에서 다룬 것과 같은 의미의, 구현은 없고 규칙만 정한 설계)의 집합입니다.

Java 코드는 항상 같은 JDBC API(Connection, Statement, ResultSet 등)만 호출하면 되고, 실제로 Oracle과 대화하는 세부 방식은 드라이버(driver, DB 제조사가 만들어 배포하는 통역 프로그램)가 담당합니다. 이 구조 덕분에 DB를 바꾸더라도 애플리케이션 코드 대부분은 그대로 두고 드라이버만 교체하면 됩니다.

JDBC 프로그래밍의 고정된 5단계

쉽게 말하면: JDBC 코드는 “문 열기 → 주문서 준비하기 → 주문 넣기 → 결과 받기 → 문 닫기”라는 다섯 단계를 항상 같은 순서로 반복합니다.

Class.forName("oracle.jdbc.driver.OracleDriver");

String url = "jdbc:oracle:thin:@localhost:1521:orcl";
Connection conn = DriverManager.getConnection(url, "user", "password");

String sql = "SELECT 이름, 성적 FROM 수강 WHERE 학번 = ?";
PreparedStatement pstmt = conn.prepareStatement(sql);
pstmt.setString(1, "S01");

ResultSet rs = pstmt.executeQuery();
while (rs.next()) {
  String 이름 = rs.getString("이름");
  int 성적 = rs.getInt("성적");
  System.out.println(이름 + ": " + 성적);
}

5. 자원 반납(close)

rs.close();
pstmt.close();
conn.close();

Connection, Statement(및 PreparedStatement), ResultSet은 모두 JVM 바깥의 DB 서버 쪽 자원을 차지하고 있습니다. 다 쓴 뒤 닫지 않으면 그 연결이 계속 점유된 채로 남아 DB가 허용하는 동시 연결 수를 소진시키는 자원 누수(resource leak)가 발생합니다. 닫는 순서는 만든 순서의 역순(ResultSet → Statement → Connection)이 원칙입니다. 안쪽에서 만들어진 객체가 바깥쪽 객체에 의존하기 때문입니다.

예외 처리와 안전한 자원 반납 패턴

쉽게 말하면: DB 연결은 언제든 실패할 수 있으므로, “성공하든 실패하든 반드시 문을 닫는다”는 약속이 필요합니다.

12_java-exception-collection에서 다룬 try-catch-finally 구조가 JDBC 코드에서 가장 정형화된 형태로 등장합니다. Class.forName, getConnection, executeQuery 등은 모두 실패할 수 있는 checked exception(컴파일 시점에 처리를 강제하는 예외, 12편 참고)을 던지도록 선언되어 있으므로 반드시 처리해야 합니다.

Connection conn = null;
PreparedStatement pstmt = null;
ResultSet rs = null;
 
try {
  conn = DriverManager.getConnection(url, "user", "password");
  pstmt = conn.prepareStatement(sql);
  rs = pstmt.executeQuery();
  while (rs.next()) {
    System.out.println(rs.getString("이름"));
  }
} catch (SQLException e) {
  System.out.println("DB 처리 중 오류: " + e.getMessage());
} finally {
  try {
    if (rs != null) rs.close();
    if (pstmt != null) pstmt.close();
    if (conn != null) conn.close();
  } catch (SQLException e) {
    System.out.println("자원 반납 중 오류: " + e.getMessage());
  }
}

finally 블록은 try 블록이 정상 종료되든 예외로 중간에 빠져나가든 반드시 실행됩니다. 그래서 자원을 닫는 코드를 finally에 넣으면, 쿼리 실행 도중 예외가 터지더라도 이미 열린 연결이 닫히지 않은 채 남는 사태를 막을 수 있습니다. 각 close() 호출 앞에 if (변수 != null)을 붙이는 이유는, try 블록 초반(예: getConnection 단계)에서 예외가 발생하면 pstmt나 rs가 아직 null인 상태로 finally에 도달하기 때문입니다. null인 객체의 close()를 호출하면 NullPointerException(12편 참고)이 새로 발생해 원래 예외 처리 흐름을 방해합니다.

Java 7부터는 이 반복적인 패턴을 줄여주는 try-with-resources 문법을 지원합니다. Connection, PreparedStatement, ResultSet이 모두 AutoCloseable(자동으로 닫히는) 인터페이스를 구현하고 있어서, 다음처럼 쓰면 블록을 벗어날 때 선언의 역순으로 자동으로 close()가 호출됩니다.

String sql = "SELECT 이름, 성적 FROM 수강 WHERE 학번 = ?";
 
try (Connection conn = DriverManager.getConnection(url, "user", "password");
     PreparedStatement pstmt = conn.prepareStatement(sql)) {
  pstmt.setString(1, "S01");
  try (ResultSet rs = pstmt.executeQuery()) {
    while (rs.next()) {
      System.out.println(rs.getString("이름"));
    }
  }
} catch (SQLException e) {
  System.out.println("DB 처리 중 오류: " + e.getMessage());
}

try 옆 괄호 안에 선언한 자원은 finally 절을 직접 쓰지 않아도 자동으로 닫히므로, 코드가 훨씬 짧아지고 자원 반납 순서 실수도 줄어듭니다. 최신 기출·모의 문제에서는 이 문법이 정답 선택지로도, “왜 이 방식이 더 안전한가”를 묻는 서술형으로도 등장할 수 있습니다.

트랜잭션과 자원 반납의 관계

17편에서 DELETE·TRUNCATE의 되돌리기 가능 여부를 언급했는데, JDBC의 Connection은 기본적으로 자동 커밋(auto-commit) 모드로 동작해 SQL 문 하나가 실행될 때마다 즉시 확정(commit, 변경을 실제로 반영)됩니다. 여러 SQL을 하나의 작업 단위로 묶어 “전부 성공하거나 전부 취소”하고 싶다면 자동 커밋을 꺼야 합니다.

conn.setAutoCommit(false);
try {
  // INSERT, UPDATE 등 여러 SQL 실행
  conn.commit();   // 모두 성공 시 확정
} catch (SQLException e) {
  conn.rollback();  // 하나라도 실패 시 전부 되돌림
}

commit()은 지금까지의 변경을 DB에 실제로 반영해 확정하고, rollback()(되돌리기)은 마지막 커밋 이후의 변경 사항을 모두 취소해 이전 상태로 되돌립니다. 계좌 이체처럼 “출금과 입금이 둘 다 성공해야만 의미가 있는” 작업에서 이 구조가 필수적입니다.

핵심 정리

• JDBC는 Java 코드와 DB 사이의 표준 인터페이스이며, DB 제조사가 제공하는 드라이버가 실제 통신을 담당한다.
• JDBC 코드의 고정 순서는 드라이버 로딩 → Connection 생성 → Statement/PreparedStatement 준비 → executeQuery()로 실행하고 ResultSet을 rs.next()로 순회 → close()로 자원 반납이다.
• PreparedStatement의 자리표시자(?)는 1번부터 번호가 매겨지며, setXxx(번호, 값)으로 값을 채운다.
• 자원은 만든 순서의 역순(ResultSet → Statement → Connection)으로 닫아야 하며, finally 블록 안에서 각 close() 호출 전에 null 검사와 별도의 예외 처리가 필요하다.
• Java 7 이상의 try-with-resources 문법을 쓰면 AutoCloseable 자원이 자동으로, 선언의 역순으로 닫힌다.
• 여러 SQL을 하나의 단위로 묶으려면 setAutoCommit(false) 후 commit()/rollback()으로 직접 트랜잭션을 제어한다.

마무리 복습

참고 자료

• Oracle JDBC 튜토리얼(Java SE Documentation) 
• 국가평생교육진흥원 독학학위제