📌 Spring Boot 환경에서 JSP, MyBatis, 예외 처리 흐름 정리

My Pale Blue Dot·2025년 5월 2일

MyBatis Spring Spring boot jsp

SPRING BOOT

목록 보기

3/40

📅 날짜

2025-05-02

📝 학습 내용

1️⃣ Spring Boot 환경 설정 (`build.gradle`)

✅ 주요 플러그인 및 의존성

plugins {
	id 'java'
	id 'war'
	id 'org.springframework.boot' version '3.4.5'
	id 'io.spring.dependency-management' version '1.1.7'
}

group = 'com.example'
version = '0.0.1-SNAPSHOT'

java {
	toolchain {
		languageVersion = JavaLanguageVersion.of(21)
	}
}

repositories {
	mavenCentral()
}

dependencies {
	implementation 'org.springframework.boot:spring-boot-starter-web'
	compileOnly 'org.projectlombok:lombok'
	annotationProcessor 'org.projectlombok:lombok'

	testImplementation 'org.springframework.boot:spring-boot-starter-test'
	testRuntimeOnly 'org.junit.platform:junit-platform-launcher'

	// JSP
	implementation 'org.apache.tomcat.embed:tomcat-embed-jasper'

	// JSTL
	implementation 'jakarta.servlet:jakarta.servlet-api'
	implementation 'jakarta.servlet.jsp.jstl:jakarta.servlet.jsp.jstl-api'
	implementation 'org.glassfish.web:jakarta.servlet.jsp.jstl'

	// Validation
	implementation 'org.hibernate.validator:hibernate-validator:8.0.2.Final'
	implementation 'jakarta.validation:jakarta.validation-api:3.1.1'

	// DB
	runtimeOnly 'com.mysql:mysql-connector-j'
	implementation 'org.springframework.boot:spring-boot-starter-jdbc'

	// Connection Pool
	implementation 'org.apache.commons:commons-dbcp2:2.13.0'
}

2️⃣ application.properties 설정

spring.application.name=demo
server.port=8090

# UTF-8 인코딩 필터
spring.servlet.filter.encoding.filter-name=encodingFilter
spring.servlet.filter.encoding.filter-class=org.springframework.web.filter.CharacterEncodingFilter
spring.servlet.filter.encoding.init-param.encoding=UTF-8
spring.servlet.filter.encoding.init-param.forceEncoding=true
spring.servlet.filter.encoding.url-pattern=/*

# JSP 뷰 설정
spring.mvc.view.prefix=/WEB-INF/views/
spring.mvc.view.suffix=.jsp
server.servlet.jsp.init-parameters.development=true

# MySQL 연결 정보
spring.datasource.url=jdbc:mysql://localhost:3306/testdb
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.username=root
spring.datasource.password=1234

3️⃣ 예외 처리 방식 비교

✅ 로컬 예외 처리: `@ExceptionHandler` (Controller 내부)

@Controller
@RequestMapping("/except")
@Slf4j
public class ExceptionTestController {

    @ExceptionHandler(Exception.class)
    public String handleAll(Exception e, Model model) {
        log.error("error: " + e);
        model.addAttribute("ex", e);
        return "except/error";
    }

    @GetMapping("/page01")
    public void triggerError() throws FileNotFoundException {
        throw new FileNotFoundException("파일 없음");
    }

    @GetMapping("/page02/{num}/{div}")
    public String divide(@PathVariable int num, @PathVariable int div, Model model) {
        model.addAttribute("result", num / div);
        return "except/page02";
    }
}

✅ 전역 예외 처리: `@ControllerAdvice`

@ControllerAdvice
@Slf4j
public class GolbalExceptionHandler {

    @ExceptionHandler(Exception.class)
    public String handleAllException(Exception e, Model model) {
        log.info("GlobalExceptionHandler's error : " + e);
        model.addAttribute("ex", e);
        return "global_error";
    }
}

4️⃣ 에러 JSP 페이지 구성

✅ except/error.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8" isErrorPage="true" %>
<html>
<body>
	<h1>EXCEPT/ERROR PAGE</h1>
	EXCEPTION : <%=exception %>
</body>
</html>

✅ global_error.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8" isErrorPage="true" %>
<html>
<body>
	<h1>GLOBAL_ERROR PAGE</h1>
	EXCEPTION : <%=exception %>
</body>
</html>

🧭 예외 처리 흐름 요약

[요청]
   ↓
[Controller 실행 중 예외 발생]
   ↓
[로컬 @ExceptionHandler 또는 전역 @ControllerAdvice 처리]
   ↓
[Model에 예외 정보 전달]
   ↓
[JSP 에러 페이지로 응답 출력]

5️⃣ JDBC 및 MyBatis 테스트

✅ tbl_memo 테이블 구조 (예시)

CREATE TABLE tbl_memo (
  id INT PRIMARY KEY,
  content VARCHAR(255),
  email VARCHAR(255),
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

✅ DataSource 테스트

@SpringBootTest
public class DataSourceTests {

    @Autowired
    private DataSource dataSource;

    @Test
    @DisplayName("MySQL 연동 및 insert 테스트")
    public void testInsert() throws Exception {
        Connection conn = dataSource.getConnection();
        PreparedStatement pstmt = conn.prepareStatement("insert into tbl_memo values(?,?,?,now())");
        pstmt.setInt(1, 111);
        pstmt.setString(2, "ababab");
        pstmt.setString(3, "springboot@test.com");
        pstmt.executeUpdate();
    }
}

✅ SqlSessionFactory 테스트

@SpringBootTest
class MybatisConfigTest {

    @Autowired
    private SqlSessionFactory sqlSessionFactory;

    @Test
    @DisplayName("MyBatis SqlSessionFactory & SqlSession 생성 확인")
    public void testSqlSession() throws Exception {
        assertNotNull(sqlSessionFactory);
        SqlSession sqlSession = sqlSessionFactory.openSession();
        assertNotNull(sqlSession);
    }
}

🔥 정리

Spring Boot는 @SpringBootApplication 안에 @ComponentScan이 포함되어 있어 별도 스캔 설정 없이 자동 탐색된다.
JSP를 사용할 경우 jakarta.servlet 기반 라이브러리 설정 필수
예외 처리는 @ExceptionHandler 또는 @ControllerAdvice 방식으로 유연하게 구성 가능
데이터베이스 연동 테스트는 DataSource 및 SqlSessionFactory 검증 테스트로 수행
실제 SQL 테스트를 통해 설정 유효성까지 확인 완료!

🔗 참고 자료

My Pale Blue Dot

Here, My Pale Blue.🌏

이전 포스트

📌 Spring MVC 파라미터 전달 방식 실습 정리

다음 포스트

📌 Spring Boot 환경에서 JSP, MyBatis, 예외 처리 흐름 정리

SPRING BOOT

📅 날짜

📝 학습 내용

1️⃣ Spring Boot 환경 설정 (`build.gradle`)

✅ 주요 플러그인 및 의존성

2️⃣ application.properties 설정

3️⃣ 예외 처리 방식 비교

✅ 로컬 예외 처리: `@ExceptionHandler` (Controller 내부)

✅ 전역 예외 처리: `@ControllerAdvice`

4️⃣ 에러 JSP 페이지 구성

✅ except/error.jsp

✅ global_error.jsp

🧭 예외 처리 흐름 요약

5️⃣ JDBC 및 MyBatis 테스트

✅ tbl_memo 테이블 구조 (예시)

✅ DataSource 테스트

✅ SqlSessionFactory 테스트

🔥 정리

🔗 참고 자료

📌 Spring MVC 파라미터 전달 방식 실습 정리

📌 Spring Boot JPA 기초

0개의 댓글

📌 Spring Boot 환경에서 JSP, MyBatis, 예외 처리 흐름 정리

SPRING BOOT

📅 날짜

📝 학습 내용

1️⃣ Spring Boot 환경 설정 (build.gradle)

✅ 주요 플러그인 및 의존성

2️⃣ application.properties 설정

3️⃣ 예외 처리 방식 비교

✅ 로컬 예외 처리: @ExceptionHandler (Controller 내부)

✅ 전역 예외 처리: @ControllerAdvice

4️⃣ 에러 JSP 페이지 구성

✅ except/error.jsp

✅ global_error.jsp

🧭 예외 처리 흐름 요약

5️⃣ JDBC 및 MyBatis 테스트

✅ tbl_memo 테이블 구조 (예시)

✅ DataSource 테스트

✅ SqlSessionFactory 테스트

🔥 정리

🔗 참고 자료

📌 Spring MVC 파라미터 전달 방식 실습 정리

📌 Spring Boot JPA 기초

0개의 댓글

1️⃣ Spring Boot 환경 설정 (`build.gradle`)

✅ 로컬 예외 처리: `@ExceptionHandler` (Controller 내부)

✅ 전역 예외 처리: `@ControllerAdvice`