Spring Boot를 사용해 RESTful API 서버 만들기 - 1 차[설치 및 환경설정]

Before you start...

---

예전에 했던 MVC를 뒤로 두고 Spring Boot를 열심히 공부를 해보았다.

 

그리고 1시간 뒤..

무수한 에러와의 고독한 싸움 너무나 처절했다.. 여러 블로그와 해외 자료들을 찾아보며 모든 것들을 정리하였고, 그 결과 결국 Spring Boot를 사용해 RESTful API 서버를 만들 수 있게 되었다.

 

Prerequirement Install & Environment Setup

---

자바 설치와 Eclipse 설치는 전편(https://psource.tistory.com/16)을 참고하면 된다.

 

대신 Java 버전은 1.8.0+, Eclipse는 Enterprise 2019.06+을 설치하면된다.

 

Help > Eclipse Marketplace...

이전에 설치할때 사용했던 Eclipse marketplace를 사용해 Spring Boot을 설치해보자.

 

이젠 익숙해져버린 Eclipse Marketplace(나도 언젠간 여기에 업로드를..)

Spring Tools 4 - for Spring Boot (aka STS 4...!)

위 처럼 Spring Tool 4가 있을 것이다. 이미 설치가 되있어 사진에는 Change로 표시되어있지만, 처음 설치하는 분이시라면 Install이라고 뜰것이다.

 

Hello, spring world !!

---

Hello, World ! Baby ~~!

역시 프로그래머 하면 헬로우 월드 프로젝트부터 시작 해야죠 ? 

 

File > New > Other...

Wizards에 spring을 검색

위 Select a wizard창이 뜨면 검색창에 spring을 검색한 뒤, Spring Starter Project를 선택하고 Next를 눌러주면 된다.

 

세상에서 제일 힘든 작업 창

그러면 프로젝트 이름과 다양한 설정을 할 수 있는 스프링 스타터 프로젝트 창이 뜬다.

 

위 항목들은 HelloSpringWorld 프로젝트를 예시로 한 내용이며, 본인이 진행할 프로젝트에 대해 작성하면 된다.

 

모두 작성한 뒤에는 Next 버튼을 눌러 진행하자.

 

편리성 제공을 너무나 잘 해준 예시

그럼 친절하게 Spring Boot Version과 내가 사용할 라이브러리 들의 목록을 보여준다. 한번 사용했던 라이브러리라면 위 사진 처럼 Frequently Used에 저장도 된다.(옛날과 다르게 정말 사용자를 위해 신경쓴 모습이 보인다..)

 

여기서 Spring Web Starter를 클릭해서 웹도 사용할 수 있도록 셋업 해주도록하자.

 

위 항목을 체크한뒤 Finish를 눌러주면 ? 

 

스트레스 받는 원인

x표시를 보자마자 스트레스가 상승한다...

 

Spring 프로젝트는 이전 편에서도 말했듯이 초반 메이븐을 통해 디펜던시에 있는 라이브러리들의 파일을 설치한다고 에러가 뜬다. 오른쪽 아래를 보면서 그래프가 100%가 되길 기다리면 된다.(Spring Boot는 빨라져서 좋음)

 

매우 간결해진 프로젝트 구조

Spring Boot로 넘어오면서 코드가 더욱더 간결해지고 구현하기 쉽게 만들어졌다. 특히 위 프로젝트 구조만 봐도 이전 Sping MVC와는 확연한 차이가 느껴질 것이다.

 

일단 Java 폴더 부터 확인해보자 ! 

?! main이 생겼네 ?!

예전 Spring MVC로 프로젝트를 사용했던 분들이라면 매우 당황스럽지가 않을 수 없다...

 

main 이라니 ! 

 

궁금해서 run을 ctrl + 클릭으로 코드를 봐도 되게 코드가 복잡하다.

 

그래서 그냥 실행 해보니

 

엥? 에러가 안뜨네 ?

분명 에러가 뜨고 위 사진 처럼 한동안 고민 할 꺼라고 생각 했으나,

실행이 되니 더욱더 의심이 되기 시작했다.

 

그래서 급한대로 http://localhost:8080에 접속을 해봤는데,

 

휴.. 역시 에러가 떠주는 구나 !

역시나 페이지는 404에러가 뜬다.

 

Spring Boot의 경우에는 기본 Controller가 없기 때문에 먼저 작업을 한뒤에 실행을 해야한다.

 

그럼 먼저 Controller.java파일을 만들어 주기 위해 package부터 생성해보자.

 

생성된 package를 오른쪽 클릭한 뒤 New > Package 버튼을 클릭해서 생성하면 된다.

 

간결 하게 controller로 이름을 지워주었다.

 

그러고 난뒤 controller 패키지에서 오른쪽 클릭을 해서 Java 파일을 추가해주면 된다.

 

호호 완전 친절해 ! 이런것도 다 알려주는 TMI..

HelloController.java라고 이름은 지었으나 이름은 본인이 원하는 대로 해도 상관은 없다.

 

대신 @RestController와 @GetMapping은 필수로 작성해야한다.

 

@RestController
  
REST(Representational State Transfer) 서비스를 제공하기 위한 컨트롤러를 지정하는 어노테이션

 

@GetMapping

GET 요청을 받기 위한 Mapping 어노테이션(PostMapping, DeleteMapping, PutMapping 등이 있다.)

 

이렇게 작성을 하고 다시 실행을 한뒤, /hello 경로로 접속하면 ?

 

이상할만큼 너무 잘된다.. ! 

 

Finally & Next Subject

---

 

오늘은 여기까지 마무리를 하고 다음편에는 RESTful에 대한 개념과 Json 요청 처리방법에 대해 알아보도록 하자 !