Streamlining HTTP client definition in Spring 6, CoApi provides zero boilerplate code auto-configuration for more convenient and efficient interface calls | 简化 Spring 6 中 HTTP 客户端定义,提供零样板代码自动配置,让接口调用更便捷高效
APACHE-2.0 License
In Spring Framework 6, a new HTTP client, Spring6 HTTP Interface, has been introduced. This interface allows developers to define HTTP services as Java interfaces using the @HttpExchange
annotation.
However, the current Spring ecosystem does not yet provide support for automatic configuration, and developers need to implement the configuration themselves.
While the Spring ecosystem already has Spring Cloud OpenFeign, it lacks support for the reactive programming model. To address this, Spring Cloud OpenFeign recommends an alternative solution, feign-reactive. However, this alternative is currently not actively maintained and does not support Spring Boot 3.2.x.
CoApi is here to help with zero-boilerplate code auto-configuration similar to Spring Cloud OpenFeign, as well as support for both reactive and synchronous programming models. Developers only need to define the interface, and it is easy to use.
Use Gradle(Kotlin) to install dependencies
implementation("me.ahoo.coapi:coapi-spring-boot-starter")
Use Gradle(Groovy) to install dependencies
implementation 'me.ahoo.coapi:coapi-spring-boot-starter'
Use Maven to install dependencies
<dependency>
<groupId>me.ahoo.coapi</groupId>
<artifactId>coapi-spring-boot-starter</artifactId>
<version>${coapi.version}</version>
</dependency>
CoApi
- a third-party interface
baseUrl
: Define the base address of the request, which can be obtained from the configuration file, for example:baseUrl = "${github.url}"
,github.url
is the configuration item in the configuration file
@CoApi(baseUrl = "${github.url}")
public interface GitHubApiClient {
@GetExchange("repos/{owner}/{repo}/issues")
Flux<Issue> getIssue(@PathVariable String owner, @PathVariable String repo);
}
Configuration:
github:
url: https://api.github.com
CoApi
- Client Load Balancing@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")
}
}
classDiagram
direction BT
class TodoApi {
<<Interface>>
}
class TodoClient {
<<Interface>>
}
class TodoController
TodoClient --> TodoApi
TodoController ..> TodoApi
TodoApi
: A common contract between the client consumer and the service provider is defined to prevent the risk of duplicate redundant definitions and to eliminate inconsistencies between the service provider implementation and the client SDK.TodoClient
:The client consumer accesses the service provider's API via TodoClient
.TodoController
: The service provider is responsible for implementing the TodoApi
interface.@HttpExchange("todo")
interface TodoApi {
@GetExchange
fun getTodo(): Flux<Todo>
}
@CoApi(serviceId = "provider-service")
interface TodoClient : TodoApi
@RestController
class TodoController : TodoApi {
override fun getTodo(): Flux<Todo> {
return Flux.range(1, 10)
.map {
Todo("todo-$it")
}
}
}
The service consumer turns on the automatic configuration of the CoApi
via the @EnableCoApi
annotation.
@EnableCoApi(clients = [TodoClient::class])
@SpringBootApplication
class ConsumerServer
@RestController
class TodoController(private val todoClient: TodoClient) {
@GetExchange
fun getProviderTodo(): Flux<Todo> {
return todoClient.getTodo()
}
}