CoApi - 同时支持响应式编程和同步编程模型的 HTTP 客户端

更新内容

• 特性: 新增 BearerTokenFilter 过滤器，以支持自动认证、注入 BearerToken 到请求头。
• 特性: 新增 HeaderSetFilter 过滤器，以支持自定义请求头。
• 特性: 新增 ExpirableTokenProvider 过滤器，以支持 Token 过期后的自动重新刷新。
• 特性: 支持在 CoApiProperties 自定义 baseUrl。
• 特性: 仅当请求头中不存在 KEY 时才设置请求头值。
• 特性: 支持根据定义判断是否添加负载均衡拦截器
• 特性: WebClientFactoryBean 支持自动注入负载均衡过滤器
• 依赖: 升级 org.springframework.boot:spring-boot-dependencies 版本 v3.3.1
• 依赖: 升级 org.springframework.cloud:spring-cloud-dependencies 版本 v2023.0.2
• 依赖: 升级 org.jetbrains.dokka 版本 v1.9.20
• 依赖: 升级 io.mockk:mockk 版本 v1.13.11
• 依赖: 升级 kotlin 版本 v2.0.0
• 依赖: 升级 detekt 版本 v1.23.6
• 依赖: 升级 codecov/codecov-action 版本 v4
• 依赖: 升级 gradle 版本 v8.8
• 依赖: 升级 enricomi/publish-unit-test-result-action action 版本 v2.16.1

简介

在 Spring Framework 6 中，引入了全新的 HTTP 客户端 - Spring6 HTTP Interface。 该接口允许开发者通过使用 @HttpExchange 注解将 HTTP 服务定义为 Java 接口。

然而，当前版本尚未提供自动配置的支持，需要开发者自己实现配置。

虽然 Spring 生态中已经存在 Spring Cloud OpenFeign ，但它并未支持响应式编程模型。 为解决这个问题，Spring Cloud OpenFeign 推荐了替代方案 feign-reactive。然而，这个替代方案目前已处于不积极维护状态，并且不支持 Spring Boot 3.2.x。

CoApi 应运而生，它提供了类似于 Spring Cloud OpenFeign 的零样板代码自动配置的支持，同时支持响应式编程模型和同步编程模型。开发者只需定义接口，即可轻松使用。

安装

使用 Gradle(Kotlin) 安装依赖

implementation("me.ahoo.coapi:coapi-spring-boot-starter")

使用 Gradle(Groovy) 安装依赖

implementation 'me.ahoo.coapi:coapi-spring-boot-starter'

使用 Maven 安装依赖

<dependency>
    <groupId>me.ahoo.coapi</groupId>
    <artifactId>coapi-spring-boot-starter</artifactId>
    <version>${coapi.version}</version>
</dependency>

使用

定义 CoApi - 第三方接口

baseUrl ： 定义请求的基础地址，该参数可以从配置文件中获取，如：baseUrl = "${github.url}"，github.url 是配置文件中的配置项 }

@CoApi(baseUrl = "${github.url}")
public interface GitHubApiClient {

    @GetExchange("repos/{owner}/{repo}/issues")
    Flux<Issue> getIssue(@PathVariable String owner, @PathVariable String repo);
}

配置文件：

github:
  url: https://api.github.com

定义 CoApi - 客户端负载均衡

@CoApi(serviceId = "github-service")
public interface ServiceApiClient {

    @GetExchange("repos/{owner}/{repo}/issues")
    Flux<Issue> getIssue(@PathVariable String owner, @PathVariable String repo);
}

使用 CoApi

@RestController
class GithubController(
    private val gitHubApiClient: GitHubApiClient,
    private val serviceApiClient: ServiceApiClient
) {

    @GetMapping("/baseUrl")
    fun baseUrl(): Flux<Issue> {
        return gitHubApiClient.getIssue("Ahoo-Wang", "CoApi")
    }

    @GetMapping("/serviceId")
    fun serviceId(): Flux<Issue> {
        return serviceApiClient.getIssue("Ahoo-Wang", "CoApi")
    }
}

案例参考

Example

服务提供者

Example-Provider

• TodoApi : 规定了客户端消费方与服务提供者之间的共同契约，旨在防范重复冗余定义的风险，同时消除了服务提供者实现与客户端 SDK 的不一致性。
• TodoClient : 客户端消费方通过 TodoClient 访问服务提供者的 API。
• TodoController : 服务提供者负责实现 TodoApi 接口。

定义 API

@HttpExchange("todo")
interface TodoApi {

    @GetExchange
    fun getTodo(): Flux<Todo>
}

定义 Client

@CoApi(serviceId = "provider-service")
interface TodoClient : TodoApi

实现 API

@RestController
class TodoController : TodoApi {
    override fun getTodo(): Flux<Todo> {
        return Flux.range(1, 10)
            .map {
                Todo("todo-$it")
            }
    }
}

服务消费者

Example-Consumer

服务消费者通过 @EnableCoApi 注解开启 CoApi 的自动配置。

@EnableCoApi(clients = [TodoClient::class])
@SpringBootApplication
class ConsumerServer

@RestController
class TodoController(private val todoClient: TodoClient) {

    @GetExchange
    fun getProviderTodo(): Flux<Todo> {
        return todoClient.getTodo()
    }
}