[작성일: 2023. 05. 17]
H2 데이터베이스 설치
나는 지금 데이터베이스로 dbeaver를 쓰고 있기는 하지만 강의를 더 완벽하게 흡수하기 위해 똑같이 h2를 설치해서 사용해보기로 했다.
강의에서는 1.4.200 버전을 사용하고 있기도 하고, 최근 버전을 사용하면 일부 기능이 정상 동작 하지 않는다고하여 1.4.200 버전을 설치하면 된다.
https://www.h2database.com/html/download-archive.htm
(window 기준) 패키지를 다운받았다면 압축을 풀고 bin 폴더의 h2.bat을 실행해주면 H2콘솔 창이 인터넷으로 연결된다.

데이터베이스 파일 생성 방법
- 최초 한 번은 JDBC URL을 jdbc:h2:~/test로 접속한다.
- 그 이후부터는 jdbc:h2:tcp://localhost/~/test로 접속할 수 있다.
테이블 생성하기
- 테이블 관리를 위해 프로젝트 루트에 sq/ddl.sql 파일 생성
- 작성한 쿼리로 H2 데이터베이스에 member 테이블을 생성
CREATE TABLE member ( id bigint generated by default as identity, /* 널값을 자동으로 채워줌. */ name varchar(255), primary key(id) );
순수 JDBC
환경 설정
build.gradle
- jdbc, h2 데이터베이스 관련 라이브러리 추가
implementation 'org.springframework.boot:spring-boot-starter-jdbc' runtimeOnly 'com.h2database:h2'
스프링 부트 데이터베이스 연결 추가
- resources/application.properties
spring.datasource.url=jdbc:h2:tcp://localhost/~/test spring.datasource.driver-class-name=org.h2.Driver spring.datasource.username=sa
JDBC 리포지토리 구현
JdbcMemberRepository
- 이렇게 JDBC API로 직접 코딩하는 것은 20년 전에 사용하던 방식이라고 한다. 참고만 하고 넘어가는 것이 정신건강에 좋다고 한다. (...)
public class JdbcMemberRepository implements MemberRepository { private final DataSource dataSource; public JdbcMemberRepository(DataSource dataSource) { this.dataSource = dataSource; } @Override public Member save(Member member) { String sql = "insert into member(name) values(?)"; Connection conn = null; PreparedStatement pstmt = null; ResultSet rs = null; try { conn = getConnection(); pstmt = conn.prepareStatement(sql, Statement.RETURN_GENERATED_KEYS); pstmt.setString(1, member.getName()); pstmt.executeUpdate(); rs = pstmt.getGeneratedKeys(); if (rs.next()) { member.setId(rs.getLong(1)); } else { throw new SQLException("id 조회 실패"); } return member; } catch (Exception e) { throw new IllegalStateException(e); } finally { close(conn, pstmt, rs); } } @Override public Optional<Member> findById(Long id) { String sql = "select * from member where id = ?"; Connection conn = null; PreparedStatement pstmt = null; ResultSet rs = null; try { conn = getConnection(); pstmt = conn.prepareStatement(sql); pstmt.setLong(1, id); rs = pstmt.executeQuery(); if(rs.next()) { Member member = new Member(); member.setId(rs.getLong("id")); member.setName(rs.getString("name")); return Optional.of(member); } else { return Optional.empty(); } } catch (Exception e) { throw new IllegalStateException(e); } finally { close(conn, pstmt, rs); } } @Override public List<Member> findAll() { String sql = "select * from member"; Connection conn = null; PreparedStatement pstmt = null; ResultSet rs = null; try { conn = getConnection(); pstmt = conn.prepareStatement(sql); rs = pstmt.executeQuery(); List<Member> members = new ArrayList<>(); while(rs.next()) { Member member = new Member(); member.setId(rs.getLong("id")); member.setName(rs.getString("name")); members.add(member); } return members; } catch (Exception e) { throw new IllegalStateException(e); } finally { close(conn, pstmt, rs); } } @Override public Optional<Member> findByName(String name) { String sql = "select * from member where name = ?"; Connection conn = null; PreparedStatement pstmt = null; ResultSet rs = null; try { conn = getConnection(); pstmt = conn.prepareStatement(sql); pstmt.setString(1, name); rs = pstmt.executeQuery(); if(rs.next()) { Member member = new Member(); member.setId(rs.getLong("id")); member.setName(rs.getString("name")); return Optional.of(member); } return Optional.empty(); } catch (Exception e) { throw new IllegalStateException(e); } finally { close(conn, pstmt, rs); } } private Connection getConnection() { return DataSourceUtils.getConnection(dataSource); } private void close(Connection conn, PreparedStatement pstmt, ResultSet rs) { try { if (rs != null) { rs.close(); } } catch (SQLException e) { e.printStackTrace(); } try { if (pstmt != null) { pstmt.close(); } } catch (SQLException e) { e.printStackTrace(); } try { if (conn != null) { close(conn); } } catch (SQLException e) { e.printStackTrace(); } } private void close(Connection conn) throws SQLException { DataSourceUtils.releaseConnection(conn, dataSource); } }
스프링 설정 변경
SpringConfig
- DataSource는 데이터베이스 커넥션을 획득할 때 사용하는 객체이다.
- 스프링부트는 데이터베이스 커넥션 정보를 바탕으로 DataSource를 생성하고 스프링 빈으로 만들어두기 때문에 DI를 받을 수 있다.
@Configuration public class SpringConfig { private final DataSource dataSource; public SpringConfig(DataSource dataSource) { this.dataSource = dataSource; } @Bean // 스프링 빈 등록으로 이해 -> 등록 public MemberService memberService() { return new MemberService(memberRepository()); } @Bean public MemberRepository memberRepository() { // return new MemoryMemberRepository(); return new JdbcMemberRepository(dataSource); } }


- 개방-폐쇄의 원칙(OCP, Open Closed Principle) : 확장에는 열려있고 수정/변경에는 닫힘.
- 스프링의 DI(Dependencies Injection)을 사용하면 기존 코드를 전혀 손대지 않고 설정으로만 구현 클래스를 변경할 수 있다.
- 회원을 등록하고 DB에 결과가 잘 입력되는지 확인한다.
- 데이터를 DB에 저장하므로 스프링 서버를 다시 실행해도 데이터가 날아가지 않고 안전하게 저장된다.


스프링 통합 테스트
MemberServiceIntegrationTest
- 스프링 컨테이너와 DB까지 연결한 통합테스트를 진행한다.
- @SpringBootTest : 스프링 컨테이너와 테스트를 함께 실행한다.
- @Transactional : 테스트 케이스에 이 애노테이션이 있으면 테스트 시작 전 트랜젝션을 시작하고, 테스트 완료 후에 항상 롤백해준다. 이렇게 하면 DB에 데이터가 남지 않으므로 다음 테스트에 영향을 주지 않는다.
@SpringBootTest @Transactional public class MemberServiceIntegrationTest { @Autowired MemberService memberService; @Autowired MemberRepository memberRepository; @Test void 회원가입() { // given Member member = new Member(); member.setName("hello"); // when 무엇을 검증할 것인가 Long saveId = memberService.join(member); // then 검증 Member findMember = memberService.findOne(saveId).get(); assertThat(member.getName()).isEqualTo(findMember.getName()); } @Test public void 중복_회원_예외() { // given Member member1 = new Member(); member1.setName("spring"); Member member2 = new Member(); member2.setName("spring"); // when memberService.join(member1); IllegalStateException e = assertThrows(IllegalStateException.class, () -> memberService.join(member2)); assertThat(e.getMessage()).isEqualTo("이미 존재하는 회원입니다."); } }
스프링 Jdbc Template
- 순수 JDBC와 동일한 환경설정으로 진행한다.
- 스프링 JDBC Template과 MyBatis 같은 라이브러리는 JDBC API에서 본 반복 코드를 대부분 제거해주지만 SQL은 직접 작성해야 한다.
- 실무에서도 많이 쓴다.
JdbcTemplateMemberRepository
public class JdbcTemplateMemberRepository implements MemberRepository { private final JdbcTemplate jdbcTemplate; @Autowired // 생성자가 하나만 있다면 Autowired 애노테이션 생략 가능하다. public JdbcTemplateMemberRepository(DataSource dataSource) { jdbcTemplate = new JdbcTemplate(dataSource); } @Override public Member save(Member member) { SimpleJdbcInsert jdbcInsert = new SimpleJdbcInsert(jdbcTemplate); jdbcInsert.withTableName("member").usingGeneratedKeyColumns("id"); Map<String, Object> parameters = new HashMap<>(); parameters.put("name", member.getName()); Number key = jdbcInsert.executeAndReturnKey(new MapSqlParameterSource(parameters)); member.setId(key.longValue()); return member; } @Override public Optional<Member> findById(Long id) { List<Member> result = jdbcTemplate.query("select * from member where id = ?", memberRowMapper(), id); return result.stream().findAny(); } @Override public List<Member> findAll() { return jdbcTemplate.query("select * from member", memberRowMapper()); } @Override public Optional<Member> findByName(String name) { List<Member> result = jdbcTemplate.query("select * from member where name = ?", memberRowMapper(), name); return result.stream().findAny(); } private RowMapper<Member> memberRowMapper() { return (RowMapper<Member>) (rs, rowNum) -> { Member member = new Member(); member.setId(rs.getLong("id")); member.setName(rs.getString("name")); return member; }; } }
SpirngConfig
- JdbcTemplate을 사용하도록 스프링 설정 변경
@Bean public MemberRepository memberRepository() { // return new MemoryMemberRepository(); // return new JdbcMemberRepository(dataSource); return new JdbcTemplateMemberRepository(dataSource); }
🐣 출처: 인프런 김영한님 강의
이 글은 인프런의 김영한님 스프링 강의를 보고 작성한 글입니다.
강의를 들으면서 정리한 글이므로 틀린 내용이나 오타가 있을 수 있습니다.