[20250217] webclient 기본 예시로 사용방법 알아보기!

WebClient 완전 정복 가이드: 초보자도 이해하는 핵심 개념과 활용법

WebClient는 Spring 5부터 새롭게 추가된 비동기 방식의 HTTP 클라이언트입니다. 기존의 RestTemplate에 비해 Non-Blocking 방식으로 동작하여 높은 성능을 제공하며, 함수형 프로그래밍 스타일을 지원하여 코드를 간결하고 유연하게 작성할 수 있다는 장점이 있습니다.

 

1. WebClient란?

WebClient는 HTTP 요청을 보내고 응답을 처리하는 역할을 합니다. RestTemplate와 마찬가지로 GET, POST, PUT, DELETE 등 다양한 HTTP 메서드를 지원하며, 비동기 방식으로 동작하여 애플리케이션의 성능을 향상시킬 수 있습니다.

 

2. WebClient 사용 방법

 

2.1. 의존성 추가

WebClient를 사용하기 위해서는 Spring WebFlux 의존성을 추가해야 합니다. Maven 프로젝트의 경우 pom.xml 파일에 다음을 추가합니다.

XML

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-webflux</artifactId>
</dependency>

 

Gradle 프로젝트의 경우 build.gradle 파일에 다음을 추가합니다.  

Gradle

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

 

2.2. WebClient 인스턴스 생성

WebClient를 사용하기 위해서는 먼저 WebClient 인스턴스를 생성해야 합니다. 다음과 같이 WebClient.create() 메서드를 사용하여 간단하게 생성할 수 있습니다.

Java

WebClient webClient = WebClient.create();

 

2.3. HTTP 요청 보내기

WebClient 인스턴스를 생성한 후에는 다양한 HTTP 메서드를 사용하여 요청을 보낼 수 있습니다. 다음은 GET 요청을 보내는 예시입니다.

Java

Mono<String> response = webClient.get()
        .uri("https://example.com/api/data")
        .retrieve()
        .bodyToMono(String.class);

위 코드는 https://example.com/api/data URL에 GET 요청을 보내고, 응답 결과를 String 타입으로 Mono에 담아 반환합니다. Mono는 비동기 스트림을 나타내는 객체로, 응답이 도착할 때까지 기다리지 않고 다른 작업을 수행할 수 있습니다.

 

2.4. 응답 처리

Mono 또는 Flux 객체를 사용하여 응답 결과를 처리할 수 있습니다. 다음은 Mono 객체에서 응답 결과를 가져오는 예시입니다.

Java

response.subscribe(data -> {
    System.out.println("응답 결과: " + data);
});

위 코드는 Mono 객체에 subscribe() 메서드를 호출하여 응답 결과를 구독하고, 응답이 도착하면 data 변수에 담아 처리합니다.

 

3. WebClient 기본 예제

다음은 WebClient를 사용하여 GET, POST 요청을 보내고 응답을 처리하는 간단한 예제입니다.

Java

import org.springframework.web.reactive.function.client.WebClient;
import reactor.core.publisher.Mono;

public class WebClientExample {

    public static void main(String[] args) {
        WebClient webClient = WebClient.create();

        // GET 요청
        Mono<String> getResponse = webClient.get()
                .uri("https://jsonplaceholder.typicode.com/todos/1")
                .retrieve()
                .bodyToMono(String.class);

        getResponse.subscribe(data -> System.out.println("GET 응답: " + data));

        // POST 요청
        Mono<String> postResponse = webClient.post()
                .uri("https://jsonplaceholder.typicode.com/todos")
                .bodyValue("{\"title\": \"foo\", \"body\": \"bar\", \"userId\": 1}")
                .retrieve()
                .bodyToMono(String.class);

        postResponse.subscribe(data -> System.out.println("POST 응답: " + data));
    }
}

위 코드는 https://jsonplaceholder.typicode.com API를 사용하여 GET 요청과 POST 요청을 보내고, 각각의 응답 결과를 콘솔에 출력합니다.

 

4. WebClient 추가 기능

WebClient는 다음과 같은 다양한 기능을 제공합니다.

• 헤더 설정: 요청에 필요한 헤더를 설정할 수 있습니다.
• 쿠키 설정: 요청에 필요한 쿠키를 설정할 수 있습니다.
• 타임아웃 설정: 요청에 대한 타임아웃 시간을 설정할 수 있습니다.
• 에러 처리: 응답 에러를 처리할 수 있습니다.