Spring Boot 개발 환경 준비

Об этом предложении

Spring Boot 개발 환경 준비 📚 인프런 「2026년! 백엔드 개발자를 위한 Redis 실전 가이드」 실습 자료를 Spring Boot(Java) 기준으로 바꿔 정리한 노트 1. 준비물 확인 준비물 버전 비고 JDK 21 (17 이상) java -version 으로 확인 IntelliJ IDEA Community도 가능 Spring 개발 표준 IDE Docker Desktop 최신 Redis, PostgreSQL 실행용 java -version docker --version 2. 프로젝트 만들기 (Spring Initializr) https://start.spring.io 에서 아래처럼 설정하고 GENERATE 를 누른 뒤, 압축을 풀어 IntelliJ로 엽니다. 항목 값 Project Gradle - Groovy Language Java Spring Boot 3.5.x Group / Artifact com.study / redis-practice Packaging / Java Jar / 21 Dependencies Spring Web Spring Data Redis (Access+Driver) Spring Data JPA MyBatis Framework PostgreSQL Driver Lombok 💡 Initializr 기본값이 Spring Boot 4.x라면 생성 후 build.gradle 에서 3.5.x로 맞춰 주세요. 이 노트의 라이브러리 버전은 Boot 3.5 기준입니다. 3. 왜 가상환경(venv)이 필요 없을까? Python은 라이브러리를 PC 전역에 설치하므로 프로젝트마다 venv로 격리해야 합니다. Java는 빌드 도구(Gradle)가 프로젝트별로 의존성을 관리 합니다. Python Java (Gradle) python -m venv venv 필요 없음 (프로젝트 폴더 자체가 격리 단위) pip install fastapi build.gradle 의 dependencies 에 한 줄 추가 requirements.txt build.gradle 가상환경 활성화 IntelliJ가 Gradle을 자동 인식 (Gradle 새로고침 🐘) 프로젝트 A는 Spring Boot 3.5를, 프로젝트 B는 4.0을 써도 서로 간섭하지 않습니다. 4. 의존성 확인 ( build.gradle ) plugins { id 'java' id 'org.springframework.boot' version '3.5.6' id 'io.spring.dependency-management' version '1.1.7' } group = 'com.study' 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' implementation 'org.springframework.boot:spring-boot-starter-data-redis' implementation 'org.springframework.boot:spring-boot-starter-data-jpa' implementation 'org.mybatis.spring.boot:mybatis-spring-boot-starter:3.0.5' runtimeOnly 'org.postgresql:postgresql' // Swagger UI (FastAPI의 /docs 역할) - 직접 추가 implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.8.9' // 코드 수정 시 자동 재시작 (uvicorn --reload 역할) - 직접 추가 developmentOnly 'org.springframework.boot:spring-boot-devtools' compileOnly 'org.projectlombok:lombok' annotationProcessor 'org.projectlombok:lombok' testImplementation 'org.springframework.boot:spring-boot-starter-test' testRuntimeOnly 'org.junit.platform:junit-platform-launcher' } tasks.named('test') { useJUnitPlatform() } 라이브러리 역할 spring-boot-starter-web 웹 프레임워크 + 내장 톰캣 서버 (FastAPI + uvicorn 역할) spring-boot-starter-data-redis Redis 클라이언트(Lettuce) + Spring 연동 spring-boot-starter-data-jpa JPA(Hibernate) mybatis-spring-boot-starter MyBatis springdoc-openapi Swagger UI 자동 생성 spring-boot-devtools 코드 변경 시 자동 재시작 5. 실습용 Redis, PostgreSQL 실행 # Redis docker run -d --name my-redis -p 127.0.0.1:6379:6379 redis:8 # PostgreSQL (DB 이름: redis_study) docker run -d --name my-postgres -p 127.0.0.1:5432:5432 \ -e POSTGRES_PASSWORD=postgres -e POSTGRES_DB=redis_study postgres:17 로컬에 PostgreSQL이 이미 설치되어 있다면 컨테이너 대신 redis_study DB만 만들어도 됩니다. 6. 연결 설정 ( application.yml ) src/main/resources/application.properties 를 지우고 application.yml 을 만듭니다. spring: data: redis: host: localhost port: 6379 database: 0 datasource: url: jdbc:postgresql://localhost:5432/redis_study username: postgres password: postgres jpa: open-in-view: false hibernate: ddl-auto: none show-sql: true mybatis: mapper-locations: classpath:mapper/*.xml configuration: map-underscore-to-camel-case: true springdoc: swagger-ui: path: /docs 🚨 주의 : JPA나 MyBatis 의존성이 있는데 datasource 설정이 없으면 서버가 시작되지 않습니다 . ( Failed to configure a DataSource ) DB 설정은 처음부터 넣어 두세요. 7. 첫 번째 코드 (Hello World) com.study.redis 패키지에 HelloController.java 를 만듭니다. package com.study.redis; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RestController; import java.util.Map; @RestController public class HelloController { @GetMapping("/") public Map<String, String> readRoot() { return Map.of("Hello", "World"); } } @RestController : 이 클래스의 메서드가 반환하는 값을 JSON으로 응답 합니다. @GetMapping("/") : 사용자가 / 로 GET 요청을 보내면 이 메서드를 실행합니다. (FastAPI의 @app.get("/") ) Map 을 반환하면 Spring(Jackson)이 JSON으로 바꿔줍니다. (파이썬의 dict 반환과 같음) 8. 서버 실행하기 방법 1. IntelliJ RedisPracticeApplication.java 의 main 옆 ▶ 버튼을 누릅니다. 방법 2. 터미널 ./gradlew bootRun # Windows: gradlew.bat bootRun uvicorn Spring Boot uvicorn main:app main() 실행 (톰캣이 내장되어 있음) 기본 포트 8000 기본 포트 8080 ( server.port 로 변경) --reload spring-boot-devtools 확인 방법 브라우저에서 http://localhost:8080 접속 {"Hello":"World"} 가 보이면 성공! 💡 IntelliJ에서 devtools 자동 재시작이 안 된다면: Settings → Build → Compiler → Build project automatically 체크, Advanced Settings → Allow auto-make to start even if developed application is currently running 체크