JDBC의 이해

이동건 (불꽃냥펀치)·2025년 2월 12일
부트캠프 이후스프링 DB

JDBC 등장 이유

에플리케이션을 개발할 때 중요한 데이터는 대부분 데이터베이스에 보관한다.

클라이언트가 애플리케이션 서버를 통해 데이터를 저장하거나 조회하면 애플리케이션 서버는 다음 과정을 통해서 데이터베이스를 사용한다.


일반적인 사용법

  • 커넥션 연결: 주로 TCP/IP를 사용해서 커넥션을 연결한다
  • SQL 전달: 애플리케이션 서버는 DB가 이해할 수 있는 SQL을 연결된 커넥션을 통해 DB에 전달한다
  • 결과 응답:DB는 전달된 SQL을 수행하고 그 결과를 응답한다

문제는 각각의 데이터베이스마다 커넥션을 연결하는 방법,SQL을 전달하는 방법 그리고 결과에 응답하는 방법이 모두 다르다는 점이다. 이는 데이터베이스를 다른 종류로 변경하면 애플리케이션 서버에 개발된 데이터베이스 사용 코드도 함께 변경해야한다는 말이다. 개발자가 각각의 데이터베이스마다 커넥션 연결, SQL 전달, 그리고 그 결과를 응답받는 법을 새로 학습해야한다. 이 문제를 해결하고자 JDBC가 등장했다.


JDBC 표준 인터페이스

  • java.sql.Connection - 연결
  • java.sql.Statement - SQL을 담은 내용
  • java.sql.ResultSet - SQL 요청 응답



JDBC와 최신 데이터 접근 기술

  • SQL Mappper
    • 장점: JDBC를 편리하게 사용하도록 도와줌
      • SQL 응답결과를 객체로 편리하게 변환해줌
      • JDBC의 반복 코드를 제거
    • 단점: 개발자가 직접 SQL을 작성해야 함
    • 대표기술: 스프링 jdbcTemplate,MyBatis

  • ORM 기술
    • ORM은 객체를 관계형 데이터베이스 테이블과 매핑해주는 기술이다. 이 기술로 개발자는 반복적인 SQL을 직접 작성하지 않고 ORM 기술이 개발자 대신에 SQL을 동적으로 만들어 실행해 준다.
    • 대표기술: JOA,hibernate
    • JPA는 자바 진영의 ORM 표준 인터페이스이고 이것을 구현한 것으로 하이버네이트와 이클립스 링크등의 구현기술이 있다



JDBC 개발 - 등록

SQL 데이터베이스

  drop table member if exists cascade;
  create table member (
      member_id varchar(10),
      money integer not null default 0,
      primary key (member_id)
);

ConnectionConst

  public abstract class ConnectionConst {
      public static final String URL = "jdbc:h2:tcp://localhost/~/test";
      public static final String USERNAME = "sa";
      public static final String PASSWORD = "";
}

DBConnectionUtil

  @Slf4j
  public class DBConnectionUtil {
      public static Connection getConnection() {
          try {
              Connection connection = DriverManager.getConnection(URL, USERNAME,PASSWORD);
              log.info("get connection={}, class={}", connection,
  			connection.getClass());
              return connection;
          } catch (SQLException e) {
              throw new IllegalStateException(e);
          }
	}
}
  • DriverManager.getConnection(...)으로 커넥션 획득

JDBC가 제공하는 DriverManager 는 라이브러리에 등록된 DB 드라이버들을 관리하고, 커넥션을 획득하는 기능을 제공한다.

  • 애플리케이션 로직에서 커넥션이 필요하면 DriverManager.getConnetction()을 호출한다
  • DriverManager는 라이브러리에 등록된 드라이버 목록을 자동으로 인식한다. 이 드라이버들에게 순서대로 다음 정보를 넘겨서 커넥션을 획득할 수 있는 지 확인한다.
    • URL: 예) jdbc:h2:tcp://localhost/~/test
  • 탐색된 커넥션 구현체가 클라이언트에 반환됨

Member

@Data
public class Member {
    private String memberId;
    private int money;
    public Member() {
    }
    public Member(String memberId, int money) {
        this.memberId = memberId;
        this.money = money;
	} 
}

memberRepositoryV0

public class MemberRepositoryV0 {
    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());
            pstmt.executeUpdate();
            return member;
        } catch (SQLException e) {
            log.error("db error", e);
            throw e;
        } finally {
            close(con, pstmt, null);
		} 
	}
    private void close(Connection con, Statement stmt, ResultSet rs) {
        if (rs != null) {
            try {
                rs.close();
            } catch (SQLException e) {
                log.info("error", e);
			} 
		}
        if (stmt != null) {
            try {
                stmt.close();
            } catch (SQLException e) {
                log.info("error", e);
            }
		}
        if (con != null) {
            try {
			  con.close();
     		} catch (SQLException e) {
              log.info("error", e);
			} 
		}
	}
      private Connection getConnection() {
          return DBConnectionUtil.getConnection();
	}
}

커넥션 획득

  • getConnection(): 이전에 만들어둔 DBConnectionUtil을 통해 데이터베이스 커넥션 획득

save() - SQl 전달

  • String sql: 데이버베이스에 전달할 SQL을 정의한다. 여기서는 데이터를 등록해야 하므로 insert sql을 준비
  • con.prepareStatement(sql): 데이터베이스에 전달할 SQL과 파라미터로 전달할 데이터들을 준비
    • sql: insert into member(member_id,money) values(?,?)
    • pstmt.setString(1,member.getMemberId()): SQL의 첫번째 ?에 값을 지정
    • pstmt.setInt(2,member.getMoney()): SQL의 두번째 ?에 값을 지정
  • pstmt.executeUpdate() : Statement를 통해 준비된 SQL을 커넥션을 통해 실제 데이터베이스에 전달한 다. 참고로 executeUpdate() 은 int 를 반환하는데 영향받은 DB row 수를 반환한다. 여기서는 하나의 row 를 등록했으므로 1을 반환한다.


리소스 정라

쿼리를 실행하고 나면 리소스를 정리해야 한다. 여기서는 Connection , PreparedStatement 를 사용했다. 리소 스를 정리할 때는 항상 역순으로 해야한다. Connection 을 먼저 획득하고 Connection 을 통해
PreparedStatement 를 만들었기 때문에 리소스를 반환할 때는 PreparedStatement 를 먼저 종료하고, 그 다 음에 Connection 을 종료하면 된다. 참고로 여기서 사용하지 않은 ResultSet 은 결과를 조회할 때 사용한다.



JDBC 개발 - 조회

MemberRepositoryV0 - 회원 조회 추가

 public Member findById(String memberId) throws SQLException {
      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.error("db error", e);
          throw e;
      } finally {
          close(con, pstmt, rs);
	}
}

findById() - 쿼리 실행

  • sql : 데이터 조회를 위한 select SQL을 준비한다.
  • rs = pstmt.executeQuery() 데이터를 변경할 때는 executeUpdate() 를 사용하지만, 데이터를 조회
    할 때는 executeQuery() 를 사용한다. executeQuery() 는 결과를 ResultSet 에 담아서 반환한다.

ResultSet

  • ResultSet 은 다음과 같이 생긴 데이터 구조이다. 보통 select 쿼리의 결과가 순서대로 들어간다.
    • 예를 들어서 select member_id, money 라고 지정하면 member_id , money 라는 이름으로 데이터 가 저장된다.
    • 참고로 select * 을 사용하면 테이블의 모든 컬럼을 다 지정한다.
  • ResultSet 내부에 있는 커서( cursor )를 이동해서 다음 데이터를 조회할 수 있다.
  • rs.next() : 이것을 호출하면 커서가 다음으로 이동한다. 참고로 최초의 커서는 데이터를 가리키고 있지 않기 때문에 rs.next() 를 최초 한번은 호출해야 데이터를 조회할 수 있다.
    • rs.next() 의 결과가 true 면 커서의 이동 결과 데이터가 있다는 뜻이다.
    • rs.next() 의 결과가 false 면 더이상 커서가 가리키는 데이터가 없다는 뜻이다.
  • rs.getString("member_id") : 현재 커서가 가리키고 있는 위치의 member_id 데이터를 String 타입 으로 반환한다.
  • rs.getInt("money") : 현재 커서가 가리키고 있는 위치의 money 데이터를 int 타입으로 반환한다.



회원 수정 삭제 예제 코드

회원 수정

 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.error("db error", e);
          throw e;
      } finally {
          close(con, pstmt, null);
      } 
}

executeUpdate() 는 쿼리를 실행하고 영향받은 row수를 반환한다. 여기서는 하나의 데이터만 변경하기 때문에 결 과로 1이 반환된다. 만약 회원이 100명이고, 모든 회원의 데이터를 한번에 수정하는 update sql을 실행하면 결과는 100이 된다.

회원 삭제

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);
          pstmt.executeUpdate();
      } catch (SQLException e) {
          log.error("db error", e);
          throw e;
      } finally {
          close(con, pstmt, null);
	} 
}








출처: https://www.inflearn.com/course/%EC%8A%A4%ED%94%84%EB%A7%81-db-1

profile
이동건 (불꽃냥펀치)
자바를 사랑합니다
이전 포스트

파일 업로드

다음 포스트

커넥션 풀과 데이터소스 이해

0개의 댓글