📌 Spring Boot 프로젝트를 위한 Gradle 설정 및 IntelliJ 세팅 총정리

📅 날짜

2025-05-02

---

📝 학습 내용

1️⃣ Spring Boot란?

✅ 개념 정리

• Spring Boot는 복잡한 설정 없이 빠르게 웹 애플리케이션을 개발할 수 있도록 도와주는 스프링 프레임워크의 하위 프로젝트다.
• 내장 톰캣, 자동 설정(Auto Configuration), 스타터 의존성, 운영환경 진단 툴(Actuator) 등을 제공한다.
• main() 메서드 하나로 서버 실행 가능하며, '설정보다 관례(Convention over Configuration)' 원칙을 따른다.

---

2️⃣ IntelliJ 설치 및 설정

#### 📥 설치 과정

1. 공식 IntelliJ 다운로드 사이트 접속
2. Community (무료) 또는 Ultimate (유료) 선택
3. 설치 후 첫 실행 시 JDK 설정 필수 (Java 17 이상 권장)

#### ⚙️ 초기 세팅

• File → Settings (macOS: Preferences)에서 다음 설정 추천:
  • Code Style → Java: 들여쓰기 4칸
  • Build, Execution, Deployment → Compiler: 자동 빌드 체크
  • Plugins: Lombok, Spring Assistant 등 설치
• Project Structure → Project SDK: JDK 17 이상 설정

---

3️⃣ Gradle 기반 프로젝트 생성

#### ✅ IntelliJ에서 생성하는 법

1. New Project → Spring Initializr
2. Project Type: Gradle - Groovy
3. Language: Java / JDK 17 이상 선택
4. Dependencies 추가: Spring Web, Lombok, Thymeleaf 등

---

4️⃣ Gradle 설정 예시 및 설명

plugins {
	id 'java'
	id 'war' // 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)
	}
}

configurations {
	compileOnly {
		extendsFrom annotationProcessor
	}
}

repositories {
	mavenCentral()
}

dependencies {
	// 스프링 웹 스타터
	implementation 'org.springframework.boot:spring-boot-starter-web'

	// Lombok 설정
	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 설정 (Spring Boot 3 이상은 Jakarta EE 사용)
	implementation 'jakarta.servlet:jakarta.servlet-api' // jakarta 네임스페이스로 변경됨
	implementation 'jakarta.servlet.jsp.jstl:jakarta.servlet.jsp.jstl-api'
	implementation 'org.glassfish.web:jakarta.servlet.jsp.jstl'
}

tasks.named('test') {
	useJUnitPlatform()
}

☑️ Spring Boot 3.0 이상에서는 JSTL/JSP 관련 라이브러리가 javax → jakarta로 변경되었기 때문에 위처럼 jakarta.servlet 기반 라이브러리를 사용해야 정상 작동함.

---

5️⃣ JVM 및 UI 설정

#### 🔧 Gradle에서 JVM 옵션 설정

bootRun {
	jvmArgs = ['-Xms512m', '-Xmx1024m', '-Dspring.profiles.active=dev']
}

# gradle.properties 또는 .gradle/gradle.properties에 작성
org.gradle.jvmargs=-Xmx2048m -Xms1024m -Dfile.encoding=UTF-8

---

#### 🛠 IntelliJ UI 설정 경로 정리

설정 항목	경로
Project SDK	File → Project Structure → Project
Module SDK	File → Project Structure → Modules → Dependencies
Gradle JDK	File → Settings → Build Tools → Gradle
Run 설정 JVM 옵션	Run → Edit Configurations → VM Options 입력

---

🔥 정리

항목	설명
빌드 도구	Gradle (Groovy DSL)
JDK	Java 21 (Toolchain 사용)
패키징	WAR
JSP/JSTL	Jakarta EE 기반 설정 포함
테스트	JUnit Platform 사용
개발 도구	IntelliJ IDEA + Gradle + Spring Boot

---

🔗 참고 자료

• Gradle 공식 문서
• Spring Boot Gradle Plugin
• IntelliJ IDEA Gradle 연동

---

✨ 느낀 점

이번 설정 과정을 통해 Spring Boot + Gradle 환경을 전체적으로 구조화하고, IntelliJ의 UI 기능을 적극 활용하는 방법까지 이해할 수 있었다. DSL 문법 외에도 GUI 설정을 병행하면서 직관적인 개발환경 세팅이 가능함을 느꼈다.

---

📌 요약

• Spring Boot는 빠른 개발 환경을 제공하는 프레임워크
• Gradle은 유연하고 빠른 빌드 도구
• IntelliJ 설정은 Project Structure, Settings, Run Config 세 가지로 정리 가능
• JSP/JSTL 사용 시 Jakarta EE 설정이 필수

---