거북이 developer

개요 Application 에서 정의한 Model 객체가 어떻게 MongoDB 로 변환이 되어 들어가고, 조회시에는 어떻게 Model 객체로 맵핑이 되는지에 대한 궁금증에서 시작. MappingMongoConverter 에서 이러한 기능을 담당하는거로 확인했지만, 이번 시간에는 이부분에 대해 깊게 파진 않고 이러한 Mapping 을 도와주는 Annotation 에 대해 알아보려고 한다. @Document Spring Data Mongodb 에서만 사용할 수 있는 Annotation 어노테이션이 정의된 Class 를 사용할 MongoDB Collection 을 지정할 수 있다. /** * 나는 base collection 에 들어갈거다! */ @Document("base") public class Base..

최근에 Spring Boot 로 개발된 Web Application 을 운영하던 도중에 아래와 같은 Error 를 맞딱뜨렸습니다. 2022-08-30 11:07:35.485 WARN 3038 --- [SpringContextShutdownHook] o.s.c.support.DefaultLifecycleProcessor : Failed to stop bean 'webServerGracefulShutdown' java.lang.BootstrapMethodError: java.lang.NoClassDefFoundError: org/springframework/boot/web/server/GracefulShutdownResult at org.springframework.boot.web.servlet.contex..

💬 Spring Rest Docs 란? Spring REST Docs 는 RESTful 서비스의 문서화를 도와주는 도구이다. 문서 작성 도구로 Asciidoctor 를 기본적으로 사용하며, 이것을 통해 HTML 문서를 생성한다. 필요한 경우 Markdown 문법을 사용하도록 변경할 수 있다. RESTful API를 문서화 할때 중요한 포인트는 API 에서 필요한 HTTP 요청과 응답의 리소스를 설명하는 것인데 Spring REST Docs 를 사용할 경우 테스트 코드를 작성하여 이러한 리소스와 HTTP 요청/응답에 대한 세부 내용을 문서화하는데 편리한 기능을 제공한다. 💬 Swagger 란? RESTful API 를 약속된 규칙에 따라 json 이나 yaml 형식으로 문서화한 Open API Specif..

BlockHound Spring Webflux 는 예상치 못한 blocking 로직이 있을 경우 성능에 큰 영향을 미치기 때문에 이러한 로직이 있는지 탐지하고 수정할 수 있어야 한다. BlockHound 는 비지니스 로직이 수행될 때 blocking 로직이 있으면 exception 을 던져 blocking 로직을 파악할 수 있게 도와준다. 번역 gateway 에서는 아래와 같은 방식으로 blockhound 를 실행한다. Dependency 추가 io.projectreactor.tools blockhound 1.0.3.RELEASE Application class 에서 BlockHound 실행여부를 판단 @SpringBootApplication public class Application { static ..

Test Code StepVerifier Reactor 를 사용할 경우 주로 다루는 Mono/Flux 를 반환하는 리액티브 API 에 대한 테스트는 기존 Test Code 작성 방법으로는 테스트하기 힘들다. 아래와 같이 reactor-test 에 대한 dependency 를 추가해야 사용이 가능하다 io.projectreactor reactor-test test ◉ 일반적인 Test Code 작성시 발생할 수 있는 실수 1 @Test public void mono() { Mono mono = Mono.just(1) // (1) .subscribeOn(Schedulers.single()); // (2) Mono.subscribe(item -> assertThat(item).isEqualTo(1)); // ..

Monitoring Metrics Spring Boot Application 의 Metric 을 수집하는 방법중의 하나로 Spring Actuator 를 사용할 수 있다. Spring Actuator 의 dependency 를 추가한다. org.springframework.boot spring-boot-starter-actuator management.endpoints.web.exposure.include 에 metrics 값을 추가하면 /actuator/metrics API 가 활성화 된다. management: endpoints: web: exposure: include: ["metrics"] HTTP GET method 요청으로 /actuator/metrics/{metric name} 형태로 요청하..

Exception Handle Functional Level Handler 에서 함수 수행시 onErrorReturn, onErrorResume 을 정의하여 에러 핸들링 처리를 할 수 있다. onErrorReturn public Mono handleRequest(ServerRequest request) { return sayHello(request) .onErrorReturn("Request Fail! But Return Success Status!") .flatMap(s -> ServerResponse.ok() .contentType(MediaType.TEXT_PLAIN) .bodyValue(s)); } onErrorResume public Mono handleRequest(ServerRequest r..

Server Configuration @EnableWebFlux @EnableWebFlux 어노테이션을 정의할 경우 DelegatingWebFluxConfiguration 이 동작하는데 해당 Configuration 이 수행하는 기능은 다음과 같다. WebFlux Application 운영을 위한 default spring configuration 을 정의해준다. WebFluxConfigurer 를 정의한 configuration 이 있는지 탐지 및 customizing 된 내용 적용. @Configuration @EnableWebFlux public class WebConfig { // ... } 만약 @EnableWebFlux 를 사용하지 않고 직접 핸들링 하고 싶다면, DelegatingWebFlu..