Feign을 사용하여 Java API 개발에서 HTTP 호출 만들기

Java API 개발에서 Feign을 사용하여 HTTP 호출 만들기

Java 애플리케이션 개발에서 외부 서비스에서 데이터를 얻거나 원격 API를 호출하기 위해 HTTP 호출이 이루어지는 경우가 많습니다. 현재로서는 일반적으로 이러한 요청을 처리하기 위해 HTTP 클라이언트 라이브러리를 선택해야 합니다. 이 분야에서는 Feign이 의심할 여지 없이 좋은 선택입니다.

Feign은 RESTful API 호출을 단순화하는 선언적 HTTP 클라이언트 라이브러리입니다. Retrofit의 주석 스타일에서 영감을 받았습니다. Feign을 사용하면 개발자는 기본 HTTP 클라이언트 구현 세부 정보를 몰라도 쉽게 HTTP 요청을 할 수 있습니다.

이 기사에서는 Feign을 사용하여 HTTP 호출을 수행하는 방법에 대한 기본 사용법과 몇 가지 예를 소개합니다. 시작하기 전에 Feign의 라이브러리를 가져와야 합니다. Maven 프로젝트에서는 pom.xml 파일에 다음과 같은 종속성을 추가할 수 있습니다.

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
    <version>2.2.2.RELEASE</version>
</dependency>

다음으로 사용 방법을 설명하겠습니다.

기본 사용법

먼저 원격 서비스 인터페이스를 정의해야 합니다. 이 인터페이스에는 호출하려는 각 HTTP 엔드포인트에 대한 메서드가 포함되어야 합니다. 각 메서드에 대해 Feign에서 제공하는 주석을 사용하여 URL, HTTP 메서드, 요청 본문, 요청 헤더 등과 같이 보내려는 HTTP 요청의 다양한 측면을 정의할 수 있습니다. 샘플 코드는 다음과 같습니다.

@FeignClient(name = "github", url = "https://api.github.com")
public interface GitHubApiClient {
    @RequestMapping(value = "/users/{username}", method = RequestMethod.GET)
    GitHubUser getUserByName(@PathVariable("username") String username);
}

이 예에서는 @FeignClient 주석을 사용하여 "github"라는 원격 서비스와 상호 작용하는 Feign 클라이언트 인터페이스 GitHubApiClient를 정의하며 서비스의 URL은 https://입니다. api.github.com. 인터페이스에 getUserByName 메소드가 있습니다. 이 메소드에서는 @RequestMapping 및 @PathVariable 주석을 사용하여 보내려는 HTTP GET 요청의 URL 및 경로 매개변수를 지정합니다.

다음으로 인터페이스를 코드에 삽입하고 해당 메서드를 호출하여 HTTP 요청을 할 수 있습니다. 샘플 코드는 다음과 같습니다.

@RestController
public class GitHubUserController {
    @Autowired
    private GitHubApiClient gitHubApiClient;

    @GetMapping("/users/{username}")
    public GitHubUser getUserByName(@PathVariable("username") String username) {
        return gitHubApiClient.getUserByName(username);
    }
}

이 예에서는 GitHubApiClient를 GitHubUserController에 삽입하고 getUserByName 메서드에서 이 인터페이스를 사용하여 GitHub 사용자 정보를 얻습니다. 이 메서드는 Feign이 반환한 응답 개체를 반환합니다. 이 경우 구체적인 클래스는 GitHubUser입니다.

맞춤형 Feign 구성

때로는 Feign의 동작을 맞춤설정해야 할 때가 있습니다. 예를 들어 요청 인터셉터를 추가하거나, 시간 제한을 변경하거나, 로그 수준을 변경해야 할 수도 있습니다. 이 경우 해당 구성을 추가하여 이러한 사용자 지정 동작을 구현할 수 있습니다.

Feign 구성을 위해 Spring Cloud에서 제공하는 @ConfigurationProperties 및 @Bean 주석을 사용하여 구성 클래스를 정의할 수 있습니다. 다음은 Feign 구성의 예입니다.

@ConfigurationProperties("feign.client.config.github")
public class GitHubFeignConfiguration {
    @Bean
    public RequestInterceptor requestInterceptor() {
        return new BasicAuthRequestInterceptor("username", "password");
    }
}

이 예에서는 Feign의 BasicAuthRequestInterceptor 클래스를 사용하여 요청 인터셉터를 추가합니다. 또한 @ConfigurationProperties 주석을 사용하여 사용자 정의 구성을 속성 파일의 속성과 매핑했습니다.

이 구성을 Feign 클라이언트 인터페이스와 연결하려면 @Configuration 및 @Import 주석을 사용해야 합니다. 샘플 코드는 다음과 같습니다.

@Configuration
@Import({GitHubFeignConfiguration.class})
public class GitHubApiConfiguration {
    @Bean
    public GitHubApiClient gitHubApiClient() {
        return Feign.builder()
                .decoder(new JacksonDecoder())
                .encoder(new JacksonEncoder())
                .contract(new SpringMvcContract())
                .target(GitHubApiClient.class, "https://api.github.com");
    }
}

이 예제에서는 Feign의 빌더 패턴을 사용하여 GitHubApiClient 객체를 생성합니다. build() 메서드에서는 반환된 Feign 클라이언트 개체에 대한 인코더, 디코더 및 계약을 정의합니다. 또한 GitHubApiClient 유형의 대상 주소를 https://api.github.com으로 설정했습니다.

요약

이번 글에서는 Feign 클라이언트 라이브러리의 사용법과 몇 가지 예시를 소개했습니다. Feign을 사용하면 선언적 방식으로 HTTP 호출을 쉽게 할 수 있습니다. 일상적인 개발 과정에서 특정 비즈니스 요구 사항에 따라 Feign의 동작을 맞춤 설정할 수 있습니다. 아직 개발에 Feign을 사용해보지 않으셨다면, 사용해 보시는 것도 좋을 것 같습니다. 더욱 편리하고 효율적인 개발 경험을 선사해드릴 거라 믿습니다.

위 내용은 Feign을 사용하여 Java API 개발에서 HTTP 호출 만들기의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!