스프링 부트는 일반적인 REST 마이크서비스의 작업 (비즈니스 로직에 경로 설정 및 URL에서 HTTP 매개변수 파싱, JSON을 자바 객체로 상호 매핑)을 추상화하고 개발자가 서비스 비즈니스 로직에 집중할 수 있게 한다.
| 단계 | 내용 |
|---|---|
| GET http://localhost:8080/hello/john/camell | 클라이언트가 Hello 마이크로서비스에 HTTP GET 요청을 보낸다 |
| 경로매핑 | 스프링 부트는 HTTP 요청을 파싱하고 HTTP 동사 (Verb)와 URL, URL에 정의된 매개변수를 기반으로 경로를 매핑한다. 경로는 스프링 RestController 클래스의 메서드에 매핑된다 |
| 매개변수 분해 | 스프링 부트가 경로를 인식하면 경로 내부에 정의된 매개변수를 작업을 수행할 자바 메서드에 매핑한다 |
| JSON -> 자바 객체 매핑 (Serialization) | HTTP PUT 이나 POST는 HTTP 본문 (body) 에서 전달된 JSON을 자바 클래스에 매핑한다. |
| 비즈니스 로직 실행 | 모든 데이터가 매핑되면 스프링 부트는 비즈니스 로직을 실행한다 |
| 자바 -> JSON 객체 매핑 | 비즈니스 로직이 실행되면 스프링 부트는 자바 객체를 JSON 으로 변환한다 |
| HTTP STATUS: 200 ("message":"Hello john camel") | 클라이언트는 서비스에서 JSON 으로 응답을 받는다. 호출 성공과 실패는 HTTP 상태 코드로 반환된다. |
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;
@SpringBootApplication
@RestController
@RequestMapping(value="hello")
public class MssbSimplecloudApplication {
public static void main(String[] args) {
SpringApplication.run(MssbSimplecloudApplication.class, args);
}
@RequestMapping(value = "/{firstName}/{lastName}", method = RequestMethod.GET)
public String hello(@PathVariable("firstName") String firstName, @PathVariable("lastName") String lastName) {
return String.format("{\"message\":\"Hello %s %s\"}", firstName, lastName);
}
}| 키워드 | 설명 |
|---|---|
| @SpringBootApplication | 스프링 부트 프레임워크에 이 클래스가 스프링 부트 서비스의 진입점이라고 지정한다 |
| @RestController | 스프링 부트에 이 클래스의 코드를 스프링 RestController 클래스로 노출하도록 지정한다 |
| @RequestMapping(value="hello") | 이 애플리케이션에서 노출된 URL은 /hello가 앞에 붙는다. |
| @PathVariable("firstName") | URL에 전달된 firstName 매개변수를 hello 함수에 전달하는 두 변수에 매핑한다 |
| String.format("{"message":"Hello %s %s"}", firstName, lastName) | 간단한 JSON 문자열을 직접 만들어 반환한다 |
위의 코드에서 기본적으로 GET HTTP 엔드포인트를 하나 노출한다. URL에 2개의 매개변수를 사용해 "Hello firstName lastName" 메시지 페이로드가 포함된 JSON 스트링을 반환한다.
- 호출된 반환 값은 아래와 같다
{"message":"Hello john carnell}"}- 서비스 실행
터미널을 통해 다음 명령어를 입력하면 스프링 부트 플러그인을 사용해 내장된 톰캣 서버를 사용하는 애플리케이션을 시작할 수 있다.
mvn spring-boot:run자바 vs 그루비 / 메이븐 vs 그레이들 스프링 부트 프레임워크는 자바와 그루비를 강력히 지원한다. 프로젝트 설정 없이 그루비를 사용해 마이크로서비스를 빌드할 수 있다.
- 실행 결과
13:35:50.337 [Thread-0] DEBUG org.springframework.boot.devtools.restart.classloader.RestartClassLoader - Created RestartClassLoader org.springframework.boot.devtools.restart.classloader.RestartClassLoader@500c9eeb
. ____ _ __ _ _
/\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
\\/ ___)| |_)| | | | | || (_| | ) ) ) )
' |____| .__|_| |_|_| |_\__, | / / / /
=========|_|==============|___/=/_/_/_/
:: Spring Boot :: (v2.7.3)
2022-09-16 13:35:50.629 INFO 2988 --- [ restartedMain] c.e.m.MssbSimplecloudApplication : Starting MssbSimplecloudApplication using Java 17.0.2 on KunYoung with PID 2988 (C:\Users\ur2ku\OneDrive\바탕 화면\WORKSPACE\[Spring]workspace\mssb_simplecloud\target\classes started by ur2ku in C:\Users\ur2ku\OneDrive\바탕 화면\WORKSPACE\[Spring]workspace\mssb_simplecloud)
2022-09-16 13:35:50.630 INFO 2988 --- [ restartedMain] c.e.m.MssbSimplecloudApplication : No active profile set, falling back to 1 default profile: "default"
2022-09-16 13:35:50.696 INFO 2988 --- [ restartedMain] .e.DevToolsPropertyDefaultsPostProcessor : Devtools property defaults active! Set 'spring.devtools.add-properties' to 'false' to disable
2022-09-16 13:35:50.697 INFO 2988 --- [ restartedMain] .e.DevToolsPropertyDefaultsPostProcessor : For additional web related logging consider setting the 'logging.level.web' property to 'DEBUG'
2022-09-16 13:35:51.316 INFO 2988 --- [ restartedMain] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat initialized with port(s): 8080 (http)
2022-09-16 13:35:51.322 INFO 2988 --- [ restartedMain] o.apache.catalina.core.StandardService : Starting service [Tomcat]
2022-09-16 13:35:51.323 INFO 2988 --- [ restartedMain] org.apache.catalina.core.StandardEngine : Starting Servlet engine: [Apache Tomcat/9.0.65]
2022-09-16 13:35:51.364 INFO 2988 --- [ restartedMain] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring embedded WebApplicationContext
2022-09-16 13:35:51.364 INFO 2988 --- [ restartedMain] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 667 ms
2022-09-16 13:35:51.590 INFO 2988 --- [ restartedMain] o.s.b.d.a.OptionalLiveReloadServer : LiveReload server is running on port 35729
2022-09-16 13:35:51.612 INFO 2988 --- [ restartedMain] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port(s): 8080 (http) with context path ''
2022-09-16 13:35:51.620 INFO 2988 --- [ restartedMain] c.e.m.MssbSimplecloudApplication : Started MssbSimplecloudApplication in 1.274 seconds (JVM running for 1.959)- 서비스는 유입될 HTTP 요청에 대해 HTTP 8080 포트를 통해 수신 대기함 확인할 수 있다.
Tomcat initialized with port(s): 8080 (http)- 테스팅
테스팅을 위해 REST 도구인 POSTMAN 을 활요해 서비스를 호출해보자.
http://localhost:8080/hello/john/carnell 엔드포인트를 호출해보면 JSON 페이로드 (
{"message":"Hello john carnell}"}) 가 정상적으로 호출된 것을 확인할 수 있다.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent