새소식

300x250
2. 웹개발/스프링부트

[스프링부트 (4)] Spring Boot DataBase 연동하기 (MariaDB, MyBatis, HikariCP)

  • -
728x90

[스프링부트 (4)] 스프링부트 DB 연동 (MariaDB, MyBatis, HikariCP)

안녕하세요. 갓대희 입니다. 이번 포스팅은 [ SpringBoot  DB 연동입니다. : ) 

 

0. 들어가기 앞서

Spring Boot를 사용하면서 DB를연결하기 위해 JDBC Connection Pool이란걸 사용 해보셨을 것이다.

 

▶ 커넥션풀(Connection Pool)이란?

1) 정의

 - 풀(Pool)속에 데이터베이스와의 연결(커넥션)들을 미리 만들어 두고 데이터베이스에 접근시 풀에 남아있는 커넥션중 하나를 받아와서 사용한뒤 반환하는 기법.
 - DataBase Connection Pool, DBCP라고도 한다.

 

2) 사용이유

 - 웹 애플리케이션은 다수의 사용자가 데이터베이스에 접근해야 하는 상황에 사용자들이 요청할때마다 연결을 만들고 해제하는 과정을 진행하게되면 비효율적이다.
 따라서 커넥션풀을 이용하여 미리 여러 연결을 만들어놓고 필요한 사용자가 요청시 미리 만들어놓은 연결을 주는 형식으로 효과적으로 DB연결 및 자원사용을 할 수 있다.

 

Spring Boot에 JDBC를 통해 mysql or mariadb을 연결해보자!


특별한 설정이 필요하진 않다.
Dependency와 application.properties에 간단한 설정만 하면 MyBatis 및 MariaDB 연결은 완료 된다. (1 ~ 2번)
앞서 포스팅한 MVC의 기본 개념들을 적용하여 화면에 출력하는 것 까지 간단한 예제로 정리해 보려 한다.

 

1. build.gradle

▶ Dependency 추가

1) mybatis-spring-boot-starter 추가

 - Version선택은 하기와 같이 reference를 참고 하자.

https://mybatis.org/spring-boot-starter/mybatis-spring-boot-autoconfigure/

 - ex) 나와 같은 경우 spring-boot 3.0을 사용하고 있기 때문에, mybatis-spring-boot-starter도 3.0 버전을 사용하도록 한다. 

implementation 'org.mybatis.spring.boot:mybatis-spring-boot-starter:3.0.2'

 

2) mysql or mariaDb 사용 여부에 따른 dependency 추가

2.1) mysql

 - 나의 경우 mysql 8.0을 사용 하려 한다.

implementation 'mysql:mysql-connector-java:8.0.33'

2.2) mariaDB

 - test를 위해 3.1버전을 선택하였다.

implementation 'org.mariadb.jdbc:mariadb-java-client:3.1.4'

 

- maven의 경우(보관용)

<!-- MariaDB -->
<dependency>
	<groupId>org.mariadb.jdbc</groupId>
	<artifactId>mariadb-java-client</artifactId>
    <version>3.1.4</version>
</dependency>

<!-- mysql -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.33</version>
</dependency>

<dependency>
	<groupId>org.mybatis.spring.boot</groupId>
	<artifactId>mybatis-spring-boot-starter</artifactId>
	<version>3.0.2</version>
</dependency>

 

※ MyBatis란?

(MyBatis의 정의를 딥다이브하는 것은 아니니 아주 간단하게만 개념을 남겨 두도록 한다.)

 - 개발자가 지정한 SQL, Procedure, 기타 등등 매핑을 지원하는 프레임워크 이다.

 - jdbc로 처리 하는 상당 부분의 코드, parameter settings, result등을 매핑하도록 도와 준다.

※ MyBatis-Spring

 - MyBatis-Srping 라이브러리를 통해 MyBatis가 Spring Transaction에 쉽게 연동 될 수 있다.

 - Mapper와 SqlSession을 다루고, 다른 Bean에 주입시켜주며, Mybatis Exception을 Spring의 DataAccessException으로 변환 시켜 준다.

 

2. application.properties

▶ driver 및 연결 정보 설정 추가

spring.datasource.driverClassName=org.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/test?characterEncoding=UTF-8&serverTimezone=UTC
spring.datasource.username=스키마계정
spring.datasource.password=비밀번호

#mariadb
#spring.datasource.driverClassName=org.mariadb.jdbc.Driver
#spring.datasource.url=jdbc:mariadb://localhost:3306/test?characterEncoding=UTF-8&serverTimezone=UTC

#oracle
#spring.datasource.driverClassName=net.sf.log4jdbc.sql.jdbcapi.DriverSpy
spring.datasource.url=jdbc:log4jdbc:oracle:thin:@localhost:1532/test

※ 참고

지금은 학습 단계로,  localhost에 DB를 설치하여 사용 하니 이렇게 사용해도 상관 없지만, 사실 DB접속 정보와 같은 부분은 github 등 외부에 노출되면 안되는 정보일 것이다.

이후 이런 설정 정보들을 암호화 하거나, 외부 파일로 따로 관리하는 등의 방법으로 숨길 수 있는데,

그 중 간단하게 설정 파일을 암호화 하는 방법은 다음을 참고 하도록 하자.

2023.07.04 - [3. 웹개발/3_1_4 스프링부트_ETC] - [스프링부트] Spring Boot 설정파일(yaml, properties) 암호화 (with Jasypt)

 

3. testMapper.xml 생성

▶ mapper 추가 

( ※참고 mapper : 간단히 말하자면 Mybatis Mapping(@annotation, xml 등)에 작성된 SQL을 호출하기위한 Interface )

( ※참고2 : 흔히 다음과 같은 구조를 많이 봐왔을 텐데

  지금은 깊은 이해도 있기보단, 가벼운 실습의 목표를 갖고 있기에 1번으로 진행하도록 한다.)

1) Service(@Service) - Mapper(@Mapper) - Mapper.xml

2) Service(@Service) - DAO(@Repository) - Mapper.xml

2) Service(@Service) - DAO(@Repository) - Mapper(@Mapper) - Mapper.xml

 

 

1) mapper.xml 템플릿 생성 (편의를 위해)

2) 하기 예시와 같이 mapper 생성

 - 경로 : resources\mybatis\test\testMapper.xml
 - 주의 : 향후 생성할 mapper interface에 대한 풀패키지 경로가 필요하고, 각 쿼리문의 id값과 mapper interface의 메서드명과 일치 해야 한다. 

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.god.bo.test.mapper.TestMapper">
    <select id="selectTest"  resultType="com.god.bo.test.vo.TestVo">
        SELECT 'GOD' AS NAME
    </select>
</mapper>

 

※ 여기서 간단한 설정을 통해 resultType에 계속 풀패키지를 명시하지 않도록 할 수 있다.
1) application.properties 추가

# mybatis 매핑 type을 짧게 쓰기 위한 설정 
# mapper.xml에서 resultType을 지정할 때 com.god.bo.test.vo.TestVo 대신 TestVo로 간략히 할 수 있다. 
mybatis.type-aliases-package=com.god.bo.test.vo 
# mapper.xml 위치 지정 
# **은 하위 폴더 레벨에 상관없이 모든 경로를 뜻하며, *는 아무 이름이나 와도 된다는것을 뜻합니다. 
mybatis.mapper-locations=mybatis/**/*.xml

 

2) mapper.xml 에서 resultType에 클래스명만 명시

<select id="selectTest"  resultType="TestVo">
	SELECT 'GOD' AS NAME
</select>

 

4. Vo 클래스 생성(model, dto, vo)

 - 경로 : com.god.bo.test.vo.TestVo
 - 데이터를 관리하는 클래스, 데이터를 View로 넘겨줄때 사용하는 객체. 흔히 관념적으로 모델이라고 하며 DTO, VO 라는 표현을 많이 쓴다.

ex)

package com.god.bo.test.vo;

public class TestVo {
    private String id;
    private String name;

    public String getId() {
        return id;
    }
    public void setId(String id) {
        this.id = id;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
}

 

5. Mapper 인터페이스 생성

 - 경로 : com.god.bo.test.mapper.TestMapper
 - 주의 : mapper.xml의 mapper tag 안에 선언한 namespace 에 정확하게 일치하는 위치에 같은 이름으로 생성해야 한다.
 그리고 select tag 안에 선언한 id 값과 각 method 이름을 같게 생성해야 한다.

ex)

package com.god.bo.test.mapper;

import java.util.List;

import com.god.bo.test.vo.TestVo;
import org.apache.ibatis.annotations.Mapper;
import org.springframework.stereotype.Repository;

@Mapper
public interface TestMapper {
    List<TestVo> selectTest();
}

 

6. Service 클래스 생성

 - TestMapper interface를 autowired 하여 메서드를 콜한다.

ex) 

package com.god.bo.test.service;

import com.god.bo.test.mapper.TestMapper;
import com.god.bo.test.vo.TestVo;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.List;

@Service
public class TestService {

    @Autowired
    public TestMapper mapper;

    public List<TestVo> selectTest() {
        return mapper.selectTest();
    }
}

 

7. Controller 생성 및 Service 호출

 - 위에서 생성한 Service의 메서드를 호출하는 Controller를 생성 하도록 하자.

ex) 

@Autowired
TestService testService;

@RequestMapping(value = "/test")
public ModelAndView test() throws Exception{
    ModelAndView mav = new ModelAndView("test");

    List<TestVo> testList = testService.selectTest();
    mav.addObject("list", testList);

    return mav;
}

 

8. 화면에 맞게 출력하자.

ex)

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
<!DOCTYPE html>
<html lang="ko">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>View Test Page</title>
</head>
<body>
    <h2>Hello!</h2>
    <div>JSP List Test</div>
    <c:forEach var="item" items="${list}" varStatus="idx">
        ${idx.index}st, Hello! ${item.name} <br />
    </c:forEach>
</body>
</html>

 

Application을 실행하여 해당하는 경로의 페이지를 호출하여 보자.

올바르게 데이터 베이스가 연동 되어, 화면에 노출되는것을 볼 수 있다. 

여기까지 했다면 Mybatis, MariaDB연동에 성공 하였다.

 

9. HikariCP

1) Spring Boot 2.0 이전 : Tomcat JDBC Connection Pool를 Default로 사용하였다.
2) Spring Boot 2.0 이후 : HikariCP를 Default로 사용하고 있다.
3) hikariCP github사이트에서는 매우 빠르고, 가볍고, 신뢰할 수 있다고 설명한다.
4) "zero-overhead" 엄청나게 높은 성능이라고 강조하며 tomcat, dbcp 등과의 성능 비교 결과도 첨부하고 있다.

사진 출처 : https://github.com/brettwooldridge/HikariCP

결국 예전 버전에서는 명시하여 사용해야했지만, 이제는 application.properties에 간단한 설정만 한다면 쉽게 사용할 수 있다.

 

▶ 설정 예시

#MariaDB
spring.datasource.driverClassName=net.sf.log4jdbc.sql.jdbcapi.DriverSpy
spring.datasource.url=jdbc:log4jdbc:mysql://localhost:3306/test?characterEncoding=UTF-8&serverTimezone=UTC
#Hikari
spring.datasource.hikari.username=username
spring.datasource.hikari.password=password
spring.datasource.hikari.maximum-pool-size=10
spring.datasource.hikari.connection-test-query=SELECT 1

 

혹시나 하여 HikariConfig클래스 파일도 확인해 보았다.

여러 프로퍼티를 설정할수 있는 것 같다.

 

▶ HikariCP 옵션

 -  HikariCP 옵션 (다음 github에서 더 자세히 나와 있다.)

참고 : https://github.com/brettwooldridge/HikariCP 

 - HikariCP설정의 시간 단위는 밀리세컨즈(ms)이다.

 

◎ autoCommit (default: true) - auto-commit설정 

◎ connectionTimeout (default : 30000(30초))
 - 풀에서 커넥션을 얻어오기전까지 기다리는 최대 시간, 허용가능한 wait time을 초과시 SQLException이 발생한다.
 - 설정가능한 최소 값 : 250

◎ validationTimeout (default : 5000(5초))
 - valid 쿼리를 통해 커넥션이 유효한지 검사할 때 사용되는 timeout시간.(커넥션이 유효 검사 시 대기 시간을 지정)
 - 이 값은 connectionTimeout보다 작아야 한다.
 - 설정가능한 최소 값 : 250

◎ maximumPoolSize (default: 10)
 - 풀에 유지시킬 수 있는 최대 커넥션 수.
 - 풀의 커넥션 수가 옵션 값에 도달하게 되면 idle인 상태는 존재하지 않는다.
 - 풀이 이 크기에 도달하고 유휴 커넥션이 없을 때 connectionTimeout이 지날 때까지 getConnection() 호출은 블록킹된다.

◎ idleTimeout (default : 600000(10분))
 - pool에 일하지 않는 커넥션을 유지하는 시간.
 - 이 옵션은 minimumIdle이 maximumPoolSize보다 작게 설정되어 있을 때만 적용된다.
 - 이 옵션이 0이면 유휴 커넥션을 풀에서 제거하지 않는다.
 - 설정가능한 최소 값 : 10000(10초)

◎ minimumIdle (default: same as maximumPoolSize)
 - 유휴 커넥션의 최소 개수(아무런 일을 하지않아도 적어도 이 옵션 값의 size로 커넥션들을 유지해주는 설정이다.)
 - default값이 유동적이기 때문에 최적의 성능과 응답성을 생각하면 구지 설정하지 않는게 좋을 것 같다.

◎ maxLifetime (default : 1800000(30분))
 - 커넥션의 최대 유지 시간. 이 시간이 지난 커넥션 중에서 사용중인 커넥션은 종료된 이후에 풀에서 제거한다.
 - 갑자기 풀에서 많은 커넥션이 제거되는 것을 피하기 위해 negative attenuation을 적용해 점진적으로 제거한다.
 - 이 값이 0이면 풀에서 제거하지 않지만 idleTimeout은 적용된다.
 
◎ connectionTestQuery (default : 없음)
 - 커넥션이 유효한지 검사할 때 사용할 쿼리를 지정한다.(보통 SELECT 1 로 설정 한다.)
 - 드라이버가 JDBC4를 지원하면 이 프로퍼티를 설정하지 말자.(이 프로퍼티를 설정하지 않으면 JDBC4의 Conneciton.isValid()를 사용하여 유효성 검사 수행)
 - JDBC4 드라이버를 지원하지않는 환경에서 이 값을 설정하지 않는다면 error레벨 로그 리턴.

◎ leakDetectionThreshold
 - 커넥션이 누수 로그메시지가 나오기 전에 커넥션을 검사하여 pool에서 커넥션을 내보낼 수 있는 시간 설정.
 - 0으로 설정하면 누수 발견을 하지 않는다(leak detection 이용하지 않음). 허용하는 최소 값은 2000(2초)이다.
 - 설정가능한 최소 값 : 2000(2초)

 

300x250
Contents

포스팅 주소를 복사했습니다

이 글이 도움이 되었다면 공감 부탁드립니다.