[JdbcTemplate] JDBC Template 이란?

JdbcTemplate 란?

JdbcTemplate은 JDBC 코어 패키지의 중앙 클래스로 JDBC의 사용을 단순화하고 일반적인 오류를 방지하는데 도움을 주는 클래스입니다.

• JdbcTemplate을 사용하여 개발자는 JDBC기술을 쉽게 사용할 수 있습니다.

JdbcTemplate 사용 이점

JdbcTemplate을 사용하면 다음과 같은 반복작업의 코드를 줄일 수 있습니다.

• 커넥션 획득
• 결과를 반복하도록 루프 실행 및 결과 바인딩 
• statement 생성 및 파라미터 바인딩 후 쿼리 실행 
• 트랜잭션을 다루기 위한 커넥션 동기화
• 예외 발생 시 스프링 예외 변환기 실행
• 리소스 종료

JdbcTemplate 은 JDBC로 개발할 때 발생하는 반복을 대부분 해결해줍니다.. 그 뿐만 아니라 지금까지 학습했던, 트랜잭션을 위한 커넥션 동기화는 물론이고, 예외 발생시 스프링 예외 변환기도 자동으로 실행해줍니다.

데이터베이스 접근계층인 리포지토리의 각 메소드를 살펴보면 많은 부분이 반복되고 있습니다.

public void update(String memberId, int money) {
    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) {
        throw exTranslator.translate("update",sql,e);
    }finally
    {
        close(con,pstmt,null);
    }
}

public void delete(String memberId){
    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) {
        throw exTranslator.translate("delete",sql,e);
    }finally {
        close(con,pstmt,null);
    }
}

 

커넥션을 받고, statement를 준비시키고, 쿼리를 실행하고, 리소스를 정리하는 작업까지 .. 꽤 많은 부분들이 반복되고 있습니다.

JdbcTemplate을 적용하면 이 모든 작업을 한줄로 처리할 수 있습니다.

JdbcTemplate 적용

@Slf4j
public class MemberRepositoryV4_3 implements MemberRepository {
//    private final SQLExceptionTranslator exTranslator;
    private final JdbcTemplate template; // 커넥션 수신, 파라미터 조회, result 바인딩 , 등등..

    public MemberRepositoryV4_3(DataSource dataSource)
    {
        this.template = new JdbcTemplate(dataSource);
    }

    public Member save(Member member) {
        String sql = "insert into member(member_id, money) values(?,?)";
        template.update(sql, member.getMemberId(), member.getMoney());
        return member;
    }

    public Member findById(String memberId) {
        String sql = "select * from member where member_id = ?";
        return template.queryForObject(sql, memberRowMapper(), memberId);
    }

    private RowMapper<Member> memberRowMapper() {
        return (rs, rowNum) -> {
            Member member = new Member();
            member.setMemberId(rs.getString("member_id"));
            member.setMoney(rs.getInt("money"));
            return member;
        };
    }

    public void update(String memberId, int money) {
        String sql = "update member set money = ? where member_id = ?";
        template.update(sql, money, memberId);
    }

    public void delete(String memberId) {
        String sql = "delete from member where member_id = ?";
        template.update(sql, memberId);
    }

• JdbcTemplate은 내부에서 예외 변환기를 자동으로 사용하므로, 예외 변환기를 따로 만들어줄 필요가 없습니다.
• 모든 작업을 template.update() / template.queryForObject() 등 메소드 하나로 커넥션 조회부터 리소스 정리까지 한 번에 해결해줍니다.

---

서비스 계층 변경점

• 트랜잭션 추상화 + 트랜잭션 AOP 덕분에 서비스 계층의 순수성을 최대한 유지하면서 서비스 계층에서 트랜잭션을 사용할 수 있습니다.

 

트랜잭션 인터페이스, 트랜잭션 템플릿을 이용한 Service 계층의 Transaction 문제 해결

Spring 트랜잭션 AOP - @Transactional 사용

• 스프링이 제공하는 예외 추상화와 예외 변환기 덕분에, 데이터 접근 기술이 변경되어도 서비스 계층의 순수성을 유지하면서 예외도 사용할 수 있게 되었습니다.

Spring이 제공하는 예외 추상화, 예외 변환기 사용

• 서비스 계층이 리포지토리 인터페이스에 의존한 덕분에 향후 리포지토리가 다른 구현 기술로  변경되어도 서비스 계층을 순수하게 유지할 수 있게 되었습니다.

리포지토리 계층 변경점

• JDBC를 사용하는 반복코드가 jdbcTemplate을 사용함으로써 제거되었습니다.

 

<정리>

• jdbcTemplate을 사용해 리포지토리 계층에서 JDBC를 사용하는 반복코드를 매우 짧게 줄일 수 있었습니다.
• 이제 jdbcTemplate을 사용하는 방법에 대해 자세히 알아보도록 하겠습니다.

---

<참고자료>

[Spring] JdbcTemplate이란? JdbcTemplate 사용법, RowMapper란?

스프링 DB 1편 - 데이터 접근 핵심 원리 - 인프런 | 강의