Eclipse에서 Spring Boot를 활용하여 REST API 구축하기

Rest API를 사용하기 위해 서버를 만들려고 합니다.
api 서버를 쉽게 만들기 위해 Eclipse + Spring Boot를 활용하여 만드는 방법에 대해 알아봅시다.

 

 

Spring Boot란 무엇인가?

Spring Boot는 자바 플랫폼을 위한 오픈소스 프레임워크입니다. 이는 Spring 프레임워크를 기반으로 하여, 애플리케이션 개발을 보다 간편하게 만드는 것을 목적으로 합니다. Spring Boot는 **"convention over configuration"**의 원칙을 따르며, 개발자가 번거로운 설정 과정 없이 즉시 웹 애플리케이션을 구축할 수 있게 도와줍니다. 기본적으로 제공되는 여러 스타터 패키지를 통해, 다양한 종류의 의존성들이 사전에 구성되어 제공됩니다.

 

Spring Boot의 장점은?

간편한 설정: 

전통적인 Spring 프레임워크와 달리, Spring Boot는 간소화된 설정과 빠른 개발 프로세스를 제공합니다.

자동 구성: 

Spring Boot는 클래스패스 세팅, 다양한 빈들, 그리고 다수의 설정들을 자동으로 처리합니다.

독립적 실행: 

Spring Boot 애플리케이션은 별도의 서버에 배포할 필요 없이 독립적으로 실행될 수 있습니다.

내장된 서버: 

Apache Tomcat, Jetty 또는 Undertow와 같은 내장 서버를 사용하여 쉽게 웹 애플리케이션을 실행할 수 있습니다.

마이크로서비스 친화적: 

마이크로서비스 아키텍처를 쉽게 구축하고 관리할 수 있게 해 줍니다.

 

 

Eclipse에 Spring Boot 설치 방법은?

1. 'help > Eclipse Marketplace..' 메뉴 진입

Eclipse 마켓플레이스

 

2. 'spring'으로 검색하여 'Spring Tools 4' 항목 설치

Spring SW 설치

 

3. 이후 모든 항목들 체크 후 '다음' 후 Eclipse ReStart

 

4. 'File > New > Spring Starter Project'를 선택하여 새 Spring Boot 프로젝트를 시작

Spring Project 생성

 

 

5. 프로젝트 기본 구성 항목 설정.

프로젝트 구성 설정

 

 

6. 필요한 의존성들을 선택

 - 우측에 추가한 5개 항목은 기본 설정해주는게 좋습니다.

의존성 항목 추가

 

7. Rest Api 로직 추가.

 - 프로젝트를 설치하고 나면 아래의 구성으로 만들어 진다.

 - restapi라는 임의 패키지를 생성한뒤 Controller.java 파일을 추가 합니다. (이름은 맘대로..)

프로젝트 구성

 

8. 샘플 rest api 로직 구현

 - 예로 'http://localhost:8080/version' 을 호출했을 때의 출력할 로직을 구성합니다.

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

@RestController
public class Controller {

	@GetMapping("/version")
	public String version() {
		return "1.0";
	}
	
}

 

 

9. 설정파일

 - 'resource/application.properties' 파일에 설정을 구성합니다.

# context path
server.servlet.context-path=/test
# url port
server.port=9090

# db info
spring.datasource.url=jdbc:mysql://11.11.11.11/dbName?serverTimezone=UTC&useSSL=false
spring.datasource.username=NAME
spring.datasource.password=PWD
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

 

10. Spring Boot 실행

  - 'Spring Boot App' 을 클릭하여 서버를 실행합니다.

서버 실행

 

11. 접속하기

 - 브라우저를 통해 실행된 서버에 접속해봅니다.

 - 서버포트: 9090 및 컨텍스트루트: /test  는 설정파일에서 작성한 내용으로 입력합니다.

브라우저를 통해 서버 접속

 

마치며..

Eclipse에서 Spring Boot를 사용하여 REST API를 구축하는 것은 간단하면서도 효과적인 방법입니다. 이 글이 Spring Boot의 기본적인 이해와 Eclipse에서의 사용 방법에 대해 도움이 되었기를 바랍니다. Spring Boot를 사용하여 빠르고 효율적인 웹 애플리케이션을 구축해 보세요!