Spring Boot 로 프로젝트 만들기

아래는 필요한 도구 설치부터 Spring Boot 프로젝트 실행 및 테스트 방법까지를 안내합니다.

 

---

1. 필수 소프트웨어 설치

1.1 Java Development Kit (JDK)

• Spring Boot는 Java 기반이므로 JDK가 필요합니다.
• 최소 요구사항:
  • Spring Boot 3.x 이상 → JDK 17 이상 필요
  • Spring Boot 2.x → JDK 8 이상

설치 방법:

• Oracle JDK 또는 OpenJDK를 설치합니다.
• 설치 후, 터미널이나 명령 프롬프트에서 확인:

java -version

 

결과:

java version "17.0.x"

 

 

---

1.2 빌드 도구

• Gradle 또는 Maven을 사용합니다. Spring Boot는 둘 다 지원합니다.
• 빌드 도구 확인 명령:

gradle -v   # Gradle 설치 확인  mvn -v      # Maven 설치 확인

 

 

---

1.3 IDE (통합 개발 환경)

• Spring Boot 프로젝트 개발을 위한 추천 IDE:
  • IntelliJ IDEA (추천)
  • Eclipse
  • Visual Studio Code

 

---

1.4 Spring Boot CLI (선택 사항)

• Spring Boot CLI(Command Line Interface)는 빠르게 Spring Boot 애플리케이션을 실행하기 위한 도구입니다.
• 설치:

sdk install springboot

 

Spring CLI 설치 후 확인:

spring --version

 

 

---

2. Spring Boot 프로젝트 생성

2.1 Spring Initializr 사용 (온라인 생성)

1. Spring Initializr로 이동합니다.
2. 필요한 설정을 입력:
   • Project: Maven or Gradle
   • Language: Java
   • Spring Boot Version: 최신 안정 버전 (예: 3.1.x)
   • Dependencies:
     • Spring Web
     • Spring Boot DevTools (선택)
     • H2 Database (간단한 테스트용)
   • Packaging: Jar
   • Java Version: JDK 17 이상
3. Generate 버튼을 클릭하여 프로젝트를 다운로드합니다.
4. 프로젝트 압축을 해제하고, IDE로 엽니다.

 

---

2.2 IntelliJ IDEA에서 생성

1. IntelliJ IDEA를 실행합니다.
2. New Project → Spring Initializr 선택.
3. 위와 동일한 설정을 입력 후 프로젝트 생성.

 

---

3. 프로젝트 실행

3.1 내장 서버로 실행

• IDE의 실행 버튼 클릭 또는 아래 명령어 사용:

./mvnw spring-boot:run     # Maven 사용 시  ./gradlew bootRun            # Gradle 사용 시

• 애플리케이션이 성공적으로 실행되면, 기본적으로 http://localhost:8080에서 서버가 작동합니다.

 

---

4. 테스트

4.1 간단한 REST 컨트롤러 생성

프로젝트의 src/main/java 디렉토리에 컨트롤러 클래스 추가:

@RestController  public class HelloController {      @GetMapping("/hello")      public String hello() {          return "Hello, Spring Boot!";     } }

 

4.2 브라우저 또는 Postman으로 테스트

1. 서버 실행 중에 브라우저로 http://localhost:8080/hello에 접속.
2. "Hello, Spring Boot!"가 출력되면 성공입니다.

 

---

5. 주요 파일 및 설정

5.1 application.properties

• 설정 파일로, 프로젝트의 포트, 데이터베이스 설정 등을 관리합니다.
• 예: 기본 포트를 8081로 변경:

 

server.port=8081

5.2 의존성 관리 (pom.xml 또는 build.gradle)

• 프로젝트의 필요한 라이브러리를 추가하거나 관리.
• 예: Spring Security 추가 (Maven):

<dependency>      <groupId>org.springframework.boot</groupId>      <artifactId>spring-boot-starter-security</artifactId>  </dependency>

 

 

 

---

6. 문제 해결

6.1 포트 충돌 문제

• 이미 8080 포트를 사용 중인 경우:

        application.properties에 포트 변경:

server.port=8081

 

6.2 빌드 실패

• Java 버전 확인:

java -version

  Spring Boot 버전과 호환되는 JDK를 사용해야 합니다.

 

 

---

이 과정을 통해 Spring Boot 프로젝트를 설치하고 테스트할 수 있습니다.