[설정] SpringBoot + MyBatis + Oracle + JSP 연동 프로젝트 환경 설정 정보

SpringBoot는 주로 JPA와 Thymeleaf를 파트너로 삼아 개발자들에게 널리 알려져 있습니다.
그러나 기술의 세계에서는 언제나 예외가 존재합니다.....
본 글에서는 SpringBoot를 MyBatis와 Oracle DB에 연결하고,
JSP를 활용하여 뷰를 구성하는 과정에 필요한 설정들에 대해 기록하였습니다.


프로젝트 환경은 인텔리제이와 윈도우이며,
게시판의 글목록을 불러오기까지의 간단한 코드로 이루어져있습니다.
스프링부트 2.X.X 버전, 자바 11 등 낮은 버전일 때의 설정입니다.

 

 

준비물: SpringBoot 프로젝트

• 이 글에서 사용하는 build.gradle 입니다. 

plugins {
	id 'org.springframework.boot' version '2.4.1'  //스프링부트 2.X.X 버전
	id 'io.spring.dependency-management' version '1.0.10.RELEASE'
	id 'java'
}

group = 'com.프로젝트.패키지이름'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '11'   //자바 11

configurations {
	compileOnly {
		extendsFrom annotationProcessor
	}
}

repositories {
	mavenCentral()
}

dependencies {
	implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
	implementation 'org.springframework.boot:spring-boot-starter-validation'
//	implementation 'org.springframework.boot:spring-boot-starter-thymeleaf' //JSP를 이용하므로 주석처리
	implementation 'org.springframework.boot:spring-boot-starter-web'

	implementation 'org.mybatis.spring.boot:mybatis-spring-boot-starter:2.1.4' // MyBatis 스프링 부트 스타터
    implementation 'com.oracle.database.jdbc:ojdbc8:21.9.0.0' // 오라클 JDBC 드라이버


	implementation 'org.apache.tomcat.embed:tomcat-embed-jasper' //JSP 이용을 위한 의존성
    implementation 'javax.servlet:jstl'  //JSTL 이용하기


	compileOnly 'org.projectlombok:lombok'
//	runtimeOnly 'com.h2database:h2'

	annotationProcessor 'org.projectlombok:lombok'
	testImplementation 'org.springframework.boot:spring-boot-starter-test'
	//JUnit4 추가
	testImplementation("org.junit.vintage:junit-vintage-engine") {
		exclude group: "org.hamcrest", module: "hamcrest-core"
	}

}

test {
	useJUnitPlatform()
}

• 스프링부트 버전, 자바 컴파일러 버전, MyBatis 스타터 버전, 오라클 JDBC 드라이버 버전을 확인하세요
• JSP이용을 위한 의존성을 추가하세요

 

Oracle 데이터베이스 통합

• application.properties 에 자신의 DB정보를 등록해서 Oracle 연결합니다

# application.properties
spring.datasource.url=jdbc:oracle:thin:@여기에IP번호등록하고:여기는포트4자리:xe
spring.datasource.username=디비로그인유저네임
spring.datasource.password=디비로그인패스워드
spring.datasource.driver-class-name=oracle.jdbc.OracleDriver
spring.jpa.database-platform=org.hibernate.dialect.Oracle12cDialect

# HikariCP 
spring.datasource.hikari.maximum-pool-size=10
spring.datasource.hikari.minimum-idle=5
spring.datasource.hikari.idle-timeout=30000
spring.datasource.hikari.pool-name=MyHikariCP
spring.datasource.hikari.max-lifetime=600000
spring.datasource.hikari.connection-timeout=30000

# MyBatis 
mybatis.type-aliases-package=com.프로젝트.패키지명.domain
mybatis.mapper-locations=classpath:/mappers/**/*.xml
mybatis.configuration.map-underscore-to-camel-case=true

# 
spring.application.name=개인마다다름

# JSP 위치
spring.mvc.view.prefix=/WEB-INF/jsp/
spring.mvc.view.suffix=.jsp

• 직접 등록할 수도 있습니다.

 

 

MyBatis 설정

• 아래 계층의 형태로 폴더 구조를 만들고, mapper.xml파일을 생성한다.

• boardMapper.xml의 내용

<?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.프로젝트.패키지명.repository.BoardMapper">


    <select id="selectList" resultType="BoardDto">
        SELECT  /*+ INDEX(BOARD_STUDY idx_BOARD_STUDY_SEQ) */
                SEQ
             , MEM_NAME
             , MEM_ID
             , BOARD_SUBJECT
             , BOARD_CONTENT
             , REG_DATE
             , UPT_DATE
             , VIEW_CNT
             , USEYN
        FROM BOARD_STUDY
        WHERE ROWNUM <![CDATA[ <= ]]> 20
        ORDER BY SEQ DESC
    </select>


</mapper>

• 현재 패키지에 하위 패키지인 config 패키지를 만든다. 그 안에 MabatisConfig 클래스를 만든다.

package com.프로젝트.패키지명.config;

import org.mybatis.spring.annotation.MapperScan;
import org.springframework.context.annotation.Configuration;

@Configuration
@MapperScan("com.프로젝트.패키지명.repository") // MyBatis Mapper 인터페이스가 있는 패키지를 스캔
public class MyBatisConfig {
    // 추가적인 MyBatis 설정 및 빈 정의 할 수 있음
}

• repository패키지 안에 BoardMapper 인터페이스를 생성한다.

package com.프로젝트.패키지.repository;

import com.프로젝트.패키지.domain.BoardDto;
import org.apache.ibatis.annotations.Mapper;

import java.util.List;

@Mapper
public interface BoardMapper {
    // 게시물 목록 조회
    List<BoardDto> selectList();


}

• Repository클래스에서 BoardMapper를 주입받고, Mapper.xml의 쿼리문을 사용해서 DB에서 값을 가져온다.

package com.프로젝트.패키지명.repository;


import com.프로젝트.패키지명.domain.BoardDto;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Repository;

import java.util.List;

@Repository
public class BoardRepository {

    private final BoardMapper boardMapper;

    @Autowired
    public BoardRepository(BoardMapper boardMapper) {
            this.boardMapper = boardMapper;
        }

    public List<BoardDto> findAll() {
        return boardMapper.selectList();
    }

}

 

 

 

❓ DTO 및 그 외의 코드

패키지 구조

 

컨트롤러

@Controller
public class BoardController {

    @Autowired
    BoardService boardService;

    @GetMapping("/boardList")
    public String boardList(Model model) throws SQLException {
        List<BoardDto> list = new ArrayList<>();

        try {
            list = boardService.findBoards();
            model.addAttribute("boardList",list);
        } catch (SQLException e){
            model.addAttribute("boardList",list);
        }
        
        return "boardList";
    }

}

 

 서비스

@Service
public class BoardService {

    @Autowired
    private BoardRepository boardRepository;

    //보드 리스트 가져오기
    public List<BoardDto> findBoards() throws SQLException {
        List<BoardDto> list = new ArrayList<>();
        list = boardRepository.findAll();
        return list;
    }

}

 간단한 작성을 위해 인터페이스를 사용하지 않은점 양해부탁드립니다.

 

board 게시글 dto (각자 만든 Table에 맞춰 수정하세요)

@Getter @Setter
@ToString
@AllArgsConstructor
public class BoardDto {

    private int seq;
    private String mem_name;
    private String mem_id;
    private String board_subject;
    private String board_content;
    private LocalDateTime reg_date;
    private LocalDateTime upt_date;
    private String view_cnt;
    private String useyn;


}

 

 

JSP를 위한 뷰 설정

• main폴더 아래에 기존에 있는 java, resources와 같은 레벨로 webapp 폴더를 만든다. 그리고 아래와 같은 구조로 폴더를 만들하고 jsp파일을 생성한다

• JSP파일

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>

<html>
<head>
    <title>게시판</title>
    <script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
    <script src="/resources/js/boardList.js"></script>

    <style>
    .fixed-col-title {
      width: 150px;
      background-color: cornsilk;
    }
    .fixed-col-s {
      width: 80px;
    }
    .fixed-col-m {
      width: 180px;
    }
    </style>

</head>
<body>
<p> 게시판 글 목록 </p>
<table border="1">
    <thead>
    <tr>
        <th><input type="checkbox" name="allChk" id="allChk"></th>
        <th class="fixed-col-s">글번호</th>
        <th class="fixed-col-s">작성자 ID</th>
        <th class="fixed-col-title">제목</th>
        <th class="fixed-col-m">작성일</th>
        <th class="fixed-col-m">수정일</th>
        <th class="fixed-col-s">조회수</th>
    </tr>
    </thead>
    <tbody>
    <!-- List를 반복하면서 index를 사용 -->

    <c:forEach items="${boardList}" var="board" varStatus="status">
        <tr name="trBoard${status.index}" id="trBoard${status.index}">
            <td><input type="checkbox" name="tdBoard${status.index}" id="tdBoard${status.index}"></td>
            <td>${board.getSeq()}</td>
            <td>${board.getMem_id()}</td>
            <td><a href="">${board.getBoard_subject()}</a></td>
            <td>${board.getReg_date()}</td>
            <td>${board.getUpt_date()}</td>
            <td>${board.getView_cnt()}</td>
        </tr>
    </c:forEach>

    <!--반복 예시-->
    <%--    <tr>--%>
    <%--        <td><input type="checkbox" name="" id=""></td>--%>
    <%--        <td>행 1, 열 2</td>--%>
    <%--        <td>행 1, 열 3</td>--%>
    <%--        <td>행 1, 열 4</td>--%>
    <%--        <td>행 1, 열 5</td>--%>
    <%--        <td>행 1, 열 6</td>--%>
    <%--        <td>행 1, 열 7</td>--%>
    <%--    </tr>--%>
    <!--반복 예시-->
    </tbody>
</table>

</body>
</html>