🍃 Spring Framework로 Web Server 실행하기

Dev_An_Student·2024년 10월 18일

Spring Framework Web Server 스프링프레임워크 웹서버

Java

목록 보기

4/5

이번 포스팅에서는 Spring Framework로 Web Server를 실행하는 방법에 대해 다뤄보겠습니다.

0. eclipse에 Spring Tools Suite 설치하기

먼저, 이클립스를 실행해 줍니다.

이클립스를 실행하면 나오는 첫 화면에서, 상단 메뉴 Help -> Eclipse Marketplace를 클릭해 줍니다.

Eclipse Marketplace 창이 열리면, 검색창에 Spring Tools 또는 STS를 입력합니다.

Spring Tools를 검색하면, 여러 항목이 검색이 됩니다.
그 중에서 네모 박스가 가르키는 2가지 항목에 대해 잠시 알아보고 넘어가도록 하겠습니다.

1. Spring Tools 3 Add-on for Spring Tools 4 3.9.22.release

Spring Tools 3 Add-on은 주로 이전 버전의 Spring Tools와의 호환성을 유지하거나 특정 기능을 추가하기 위한 용도로 사용됩니다. 현재로서는 최신 버전인 STS4를 사용하는 것이 더 유리합니다.

2. Spring Tools 4 (aka Spring Tool Suite 4) 4.25.0 release

Spring Tools 4 (STS4)는 Spring Framework와 Spring Boot 개발을 위한 최신 도구와 기능을 제공합니다. 이는 최신 Spring 프로젝트와 호환되며, 최신 기능을 활용할 수 있습니다.**

1. Spring Starter Project 생성하기

eclipse를 재시작한 후, File -> New -> Other를 선택합니다.

검색창에 Spring을 입력하고, Spring Starter Project가 있는지 확인합니다.
Spring Starter Project를 선택하고 Next를 클릭하여 프로젝트 생성 과정을 시작합니다.

필요한 프로젝트 설정 정보를 입력하는 화면이 나타납니다.

Service URL: Spring Initializer 서비스 URL 입니다.
Name: 프로젝트 이름 (예: demo)
Type: 어플리케이션 빌드 타입
Packaging: Packaging 타입
Java Version: 자바 버전
Language: 사용 언어
Group: 그룹 아이디
Artifact: 아티팩트 아이디
Version: 버전 정보
Description: 어플리케이션 설명
Package: 패키지 정보

처음에는 기본 설정값이 있으므로 저는 기본 설정값으로 사용하도록 하겠습니다.
설정을 바꾸고 싶으면 바꿔도 무방합니다.

자바 버전은 명령프롬프트 창에서 java -version을 입력하면 나옵니다.
만약 나오지 않거나 프로젝트 설정 목록에 맞는 버전이 없다면 Oracle 홈페이지에 접속하여 JDK 파일을 다운로드하면 됩니다.

💾 JDK 다운로드 ⬅️ 클릭

설정을 마친 후 Next를 클릭하여 다음으로 넘어갑니다.

Spring Web을 선택하여 Spring Boot 웹 애플리케이션을 개발할 수 있도록 설정한 후 Finish를 눌러 마무리 합니다.

2. Web Server 실행하기

프로젝트를 성공적으로 만들었으면, 이제 웹서버를 실행하겠습니다.

먼저, 웹 요청을 처리할 컨트롤러를 생성하겠습니다.

좌측에 보이는 프로젝트 폴더 목록에서 src -> main -> java -> com.example.demo를 선택합니다.

위 이미지에 보이는 경로로 들어가도 무방합니다.

이 후 우클릭을 한 다음에 New -> Class를 클릭해줍니다.

그러면 생성할 클래스의 옵션을 설정하는 화면이 나오게 됩니다.

저는 다른 부분은 건드리지 않고 파일 이름만 HelloController로 작성해준 뒤 Finish 버튼을 눌러 완료하겠습니다.

package com.example.demo;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {
	//기본 경로
    @GetMapping("/")
    public String hello() {
    	//웹서버 실행시 페이지에 나타날 문구
        return "Hello, Spring Boot!";
    }
}

이후엔 다음과 같이 코드를 작성해주고 저장해주도록 합니다.

그 다음엔 폴더에서 DemoApplication.java 파일을 우클릭 한 다음에 Run As -> Spring Boot App을 클릭하여 서버를 실행합니다.

프로젝트 생성단계에서 프로젝트 명을 저와 다른 이름으로 설정하였다면, 파일 이름이 다를 수도 있습니다.

프로젝트 생성 직후 src -> main -> java -> com.example.demo 경로에 있던 첫 파일을 실행하면 됩니다.

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class DemoApplication {

	public static void main(String[] args) {
		SpringApplication.run(DemoApplication.class, args);
	}

}

위 코드와 비슷한 내용으로 작성되어 있을 것 입니다.

🎉 이제 마지막 입니다!

웹 브라우저에서 URL 검색 창에 http://localhost:8080 을 입력한 후 Hello, Spring Boot! 메세지가 출력이 된다면, 성공적으로 웹서버를 실행시킨 것 입니다.

3. 에러 해결

포스팅을 따라서 웹서버를 실행시키다 보면 마주칠 수 있는 에러가 간혹 있습니다.

1. problem occurred

import getting started ontent has encounted a problem
toolchaindownloadFailedexception: no installed toolchains match and toolchain download repostrories have not been configured.

에러 메세지를 살펴보면 Eclipse나 Maven에서 Toolchain 관련 설정이 제대로 되어 있지 않아서 발생하는 것입니다. 특히, Maven이나 Gradle 같은 빌드 도구가 특정 JDK 또는 Toolchain을 찾지 못할 때 발생할 수 있습니다. 이 문제는 프로젝트를 생성할 때 필요한 JDK 또는 특정 개발 도구가 설치되지 않았거나, 다운로드 설정이 되어 있지 않아서 발생할 수 있습니다.

대부분은 JDK 버전이 맞지 않아서 그런 것 입니다.

네모 박스가 가르키는 부분을 확인한 후 숫자에 맞는 버전으로 설치하면 됩니다.

2. ToolchainDownloadFailedException

ToolchainDownloadFailedException: No locally installed toolchains match and toolchain download repositories have not been configured.
java.lang.reflect.InvocationTargetException

이 에러도 대부분 JDK 버전으로 인해 발생합니다.
설정에 맞는 JDK를 설치해주면 됩니다.

3. 의존성 에러

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

혹시라도 Java 코드 중 해당 부분에서 에러가 발견되었다면, Spring Web 관련 의존성이 프로젝트에 추가되지 않았거나, Gradle이 의존성을 제대로 다운로드하지 못한 경우입니다.

implementation 'org.springframework.boot:spring-boot-starter-web'

이 경우 네모 박스가 가르키는 코드를 추가해주면 됩니다.

🎆 마무리

이것으로 Spring Framework를 활용한 웹서버 실행하기를 마치겠습니다.

웹서버를 활용하여 다양한 주제의 개발을 하면서, 실력을 더욱 키워 나가시길 바랍니다.

감사합니다. 😌

Dev_An_Student

Enjoy Develog!

이전 포스트

❓ Spring Framework란?

다음 포스트