무한루프/개발, 업무

스프링 부트(Spring Boot), 마이바티스(Mybatis), 메이븐(Maven) 백엔드 연동 설정(1)

시원한생맥주 2025. 2. 25. 09:27

 

스프링 부트(Spring Boot), 마이바티스(Mybatis), 메이븐(Maven) 백엔드 연동 설정(1)

 

이번에는 Spring Boot, MyBatis, Maven을 활용하여 백엔드 개발 환경을 설정하는 과정을 정리해보겠다.
오랜만에 세팅하려니 기억이 가물가물했지만, 그래도 차근차근 진행해보니 어렵지 않았다.

개발 폴더는 C:\project\vue\gallery\로 정하고, 여기서 백엔드 개발을 진행할 예정이다.
설정 과정은 아래 순서대로 진행한다.

 

 

 

설정 순서

  1. JDK 17 다운로드 및 설치
  2. 환경 변수 설정
  3. STS (Spring Tool Suite) 다운로드 및 설치
  4. STS 워크스페이스 및 프로젝트 폴더 설정

 

1. JDK 17 다운로드 및 설치

 

예전에는 Java 다운로드를 위해 Oracle 사이트를 찾았지만, 요즘은 OpenJDK의 종류도 많아졌다.
나는 STS와 호환성이 좋은 OpenJDK 17을 선택했다.

 

OpenJDK 17 다운로드 링크
https://adoptium.net/

 

Home | Adoptium

The Adoptium® Working Group The Adoptium Working Group promotes and supports high-quality runtimes and associated technology for use across the Java ecosystem. Our vision is to meet the needs of Eclipse and the broader Java community by providing runtimes

adoptium.net

 

다운로드할 파일:
OpenJDK17U-jdk_x64_windows_hotspot_17.0.14_7.zip

설치 과정

  1. 다운로드한 압축 파일을 C:\project\에 복사
  2. 압축을 풀어 C:\project\jdk-17.0.14+7 폴더 생성

설치는 끝났고, 이제 환경 변수를 설정해야 한다.


 

2. 환경 변수 설정

 

JDK를 설치한 후에는 환경 변수(PATH)를 설정해야 Java 명령어를 사용할 수 있다.

설정 방법 (Windows 기준)

  1. Windows 검색창에 "환경 변수" 입력 → "시스템 환경 변수 편집" 선택
  2. "고급" 탭에서 "환경 변수" 버튼 클릭
  3. "시스템 변수" 섹션에서 Path 선택 후 "편집" 버튼 클릭
  4. "새로 만들기" 버튼을 누르고 아래 경로 추가
C:\project\jdk-17.0.14+7\bin
  1. "확인" 버튼을 눌러 저장 후 창 닫기

설정 확인

설정이 잘 되었는지 확인하려면 명령 프롬프트(cmd)를 실행하고 아래 명령어를 입력한다.

java -version

정상적으로 출력되면 JDK 설정이 완료된 것이다.


 

3. STS(Spring Tool Suite) 다운로드 및 설치

 

Spring Boot 개발을 위해 IDE는 **STS(Spring Tool Suite)**를 사용한다.
STS는 Eclipse 기반으로 스프링 프로젝트를 쉽게 만들 수 있도록 돕는 도구다.

 

STS 다운로드 링크
https://spring.io/tools

 

Spring | Tools

 

spring.io

 

다운로드할 파일:
spring-tool-suite-4-4.28.1.RELEASE-e4.34.0-win32.win32.x86_64.zip

설치 과정

  1. 다운로드한 압축 파일을 C:\project\에 복사
  2. 압축을 풀어 C:\project\sts-4.28.1.RELEASE 폴더 생성
  3. sts.exe 실행

설치는 어렵지 않지만, 실행 후 기본 설정을 진행해야 한다.


 

4. STS 워크스페이스 및 프로젝트 폴더 설정

STS를 처음 실행하면 워크스페이스(Workspace) 경로를 지정해야 한다.
워크스페이스는 프로젝트를 저장할 폴더로 설정하면 된다.

워크스페이스 및 백엔드 폴더 설정

  • 워크스페이스: C:\project\vue\gallery
  • 백엔드 프로젝트 폴더: C:\project\vue\gallery\backend

STS를 실행한 후 워크스페이스 폴더를 C:\project\vue\gallery로 지정하고 진행하면 된다.
이제 본격적으로 Spring Boot, MyBatis, Maven을 활용한 백엔드 개발을 시작할 준비가 끝났다! 


 

마무리

 

이번 과정에서는 JDK 17 설치부터 STS 설정까지 진행했다.
다음 단계에서는 Spring Boot 프로젝트 생성, MyBatis 연동, 데이터베이스 연결 등을 진행할 예정이다.

 

다음 목표:
Spring Boot 프로젝트 생성
MyBatis 및 Maven 설정
데이터베이스(MySQL 또는 MariaDB) 연동

 

이제 본격적으로 백엔드 개발을 시작해보자!