背景
.NET 中 有没有类似 Java 中 Feign 这样的框架?经过查找和实验,发现 在 .NET 平台上,虽然没有直接的 Feign 框架的端口,但是有一些类似的框架和库,它们提供了类似的功能和设计理念。下面是一些在 .NET 中用于声明式 HTTP 客户端的框架和库:
- Refit:
Refit 是一个用于构建声明式、类型安全的 HTTP 客户端的库。它允许您通过定义接口来描述 HTTP API,并生成客户端代码。Refit 使用属性路由的方式定义 API 调用,类似于 Feign。它支持各种 HTTP 方法,如 GET、POST、PUT、DELETE 等,并支持异步操作。
https://github.com/reactiveui/refit - RestEase:
RestEase 也是一个用于创建类型安全的 HTTP 客户端的库。它提供了类似于 Refit 的声明式 API 定义方式,允许您通过编写接口来描述 HTTP API。RestEase 支持各种 HTTP 方法,并提供了简单易用的 fluent API。
https://github.com/canton7/RestEase - Feign.net
feign.net 是一个基于 .NET Standard 2.0 的库,它实现了与 Feign 类似的接口定义和调用方式。feign.net 支持异步操作,并提供了与 Refit 和 RestEase 类似的特性。
https://github.com/daixinkai/feign.net
集成 Refit
要在 ASP.NET Core 中集成 Refit,首先需要安装 Refit 包。可以通过 NuGet 包管理器或者 .NET CLI 来完成:
dotnet add package Refit
接下来,您可以创建一个接口,用于定义对远程 API 的调用。例如:
using Microsoft.AspNetCore.Mvc; using Refit; using RefitDemo.Models; namespace RefitDemo.WebApi { public interface IWeatherForecastApi { [Get("/WeatherForecast/Get")] Task<string> GetWeatherForecast(string id); [Post("/WeatherForecast/Post")] Task<WeatherForecast> PostWeatherForecast(WeatherForecast weatherForecast); } }
然后,您可以在 ASP.NET Core 应用程序中使用 Refit 客户端。一种常见的方法是将其注入到服务中,以便在需要时进行使用。例如,在 Startup.cs 中配置:
builder.Services.AddRefitClient<IWeatherForecastApi>(new RefitSettings { ContentSerializer = new NewtonsoftJsonContentSerializer( new JsonSerializerSettings { ContractResolver = new CamelCasePropertyNamesContractResolver() } ) }).ConfigureHttpClient(c => c.BaseAddress = new Uri("http://localhost:5237")); //封装 builder.Services.AddRefitClients("RefitDemo.WebApi", "http://localhost:5237"); public static class RefitExtensions { public static void AddRefitClients(this IServiceCollection services, string targetNamespace, string baseAddress, RefitSettings? refitSettings = null) { // 获取指定命名空间中的所有类型 var types = Assembly.GetExecutingAssembly().GetTypes() .Where(t => t.Namespace == targetNamespace && t.IsInterface).ToList(); foreach (var type in types) { services.AddRefitClient(type, refitSettings).ConfigureHttpClient(c => c.BaseAddress = new Uri(baseAddress)); } } }
最后,您可以在需要使用 API 客户端的地方注入 IWeatherForecastApi 接口,并使用它来调用远程 API:
using Microsoft.AspNetCore.Mvc; using RefitDemo.WebApi; namespace RefitDemo.Controllers { [ApiController] [Route("[controller]")] public class WeatherForecastController : ControllerBase { private readonly ILogger<WeatherForecastController> _logger; private readonly IWeatherForecastApi _weatherForecastApi; public WeatherForecastController(ILogger<WeatherForecastController> logger, IWeatherForecastApi weatherForecastApi) { _logger = logger; _weatherForecastApi = weatherForecastApi; } [HttpGet("GetWeatherForecast")] public async Task<string> GetWeatherForecast() { return await _weatherForecastApi.GetWeatherForecast("1111"); } [HttpGet("PostWeatherForecast")] public async Task<WeatherForecast> PostWeatherForecast() { return await _weatherForecastApi.PostWeatherForecast(new WeatherForecast { Date = DateOnly.MaxValue,Summary = "1111" }); } [HttpGet("Get")] public string Get(string id) { return id; } [HttpPost("Post")] public WeatherForecast Post(WeatherForecast weatherForecast) { return weatherForecast; } } }

其它功能:https://github.com/reactiveui/refit?tab=readme-ov-file#table-of-contents
集成 RestEase
要在 ASP.NET Core 中集成 RestEase,首先需要安装 RestEase 包。可以通过 NuGet 包管理器或者 .NET CLI 来完成:
dotnet add package RestEase
接下来,您可以创建一个接口,用于定义对远程 API 的调用。例如:
using Microsoft.AspNetCore.Mvc; using RestEase; using RestEaseDemo.Models; namespace RestEaseDemo.WebApi { public interface IWeatherForecastApi { [Get("/WeatherForecast/Get")] Task<string> GetWeatherForecast(string id); [Post("/WeatherForecast/Post")] Task<WeatherForecast> PostWeatherForecast(WeatherForecast weatherForecast); } }
然后,您可以在 ASP.NET Core 应用程序中使用 RestEase 客户端。一种常见的方法是将其注入到服务中,以便在需要时进行使用。例如,在 Startup.cs 中配置:
builder.Services.AddRestEaseClient<IWeatherForecastApi>("http://localhost:5252");
然后,您可以在 ASP.NET Core 应用程序中使用 RestEase 客户端。与 Refit 不同的是,RestEase 不需要额外的配置,您只需要直接使用接口即可。在需要使用 API 客户端的地方注入 IMyApi 接口,并使用它来调用远程 API:
using Microsoft.AspNetCore.Mvc; using RestEaseDemo.WebApi; namespace RestEaseDemo.Controllers { [ApiController] [Route("[controller]")] public class WeatherForecastController : ControllerBase { private readonly ILogger<WeatherForecastController> _logger; private readonly IWeatherForecastApi _weatherForecastApi; public WeatherForecastController(ILogger<WeatherForecastController> logger, IWeatherForecastApi weatherForecastApi) { _logger = logger; _weatherForecastApi = weatherForecastApi; } [HttpGet("GetWeatherForecast")] public async Task<string> GetWeatherForecast() { return await _weatherForecastApi.GetWeatherForecast("1111"); } [HttpGet("PostWeatherForecast")] public async Task<WeatherForecast> PostWeatherForecast() { return await _weatherForecastApi.PostWeatherForecast(new WeatherForecast { Date = DateOnly.MaxValue,Summary = "1111" }); } [HttpGet("Get")] public string Get(string id) { return id; } [HttpPost("Post")] public WeatherForecast Post(WeatherForecast weatherForecast) { return weatherForecast; } } }
其它功能:https://github.com/canton7/RestEase?tab=readme-ov-file#table-of-contents