.NET6之Mini API【二十三、Refit】

本篇是与上篇HttpClient有关联的，有前篇中，我们是直接使用HttpClient来发出请求的，所有的请求信息都是我们根据需要自己来填充的。那Refit是什么呢？它是一个让我们调用API就像调用一个对象的方法一样简单，是通过把http请求信息，配置到一个接口，由refit把这些信息转成一个标准的http请求，然后再把请求回的结果转成标准的实体返回给我们，所以我们更像在使用一个对象的方法。

下面是一个get，post，put，delete的极简事例。

这里定义了一个内存集合来充当数据库，User是实体类。

#region 存储和实体类
/// <summary>
/// 假装数据库
/// </summary>
public static class DB
{
    /// <summary>
    /// 假装数据表
    /// </summary>
    public static List<User> users = new List<User>() {
    new User{ID=1,UserName="gsw",Name="张三",Password="ABCDE",CreateTime=DateTime.Now}
    };
}
/// <summary>
/// 实体类
/// </summary>
public class User
{
    public int ID { get; set; }
    public string UserName { get; set; }
    public string Password { get; set; }
    public string Name { get; set; }
    public DateTime CreateTime { get; set; }
    public DateTime ModifyTime { get; set; }
}
#endregion

被调用的API如下，对内存集合进行增删改查。

#region 被调用API
app.MapGet("/users/{username}", (ILogger<Program> Logger, string userName) =>
{
    Logger.LogInformation("被调用 get user");
    return DB.users.SingleOrDefault(s => s.UserName == userName);
});

app.MapPost("/user", (ILogger<Program> Logger, User user) =>
{
    Logger.LogInformation("被调用 add user");
    user.ID = DB.users.Count + 1;
    DB.users.Add(user);
    return user;
});
app.MapPut("/user", (ILogger<Program> Logger, User user) =>
{
    Logger.LogInformation("被调用 modify user");
    var oldUser = DB.users.SingleOrDefault(s => s.ID == user.ID);
    if (oldUser != null)
    {
        oldUser.UserName = user.UserName;
        oldUser.Password = user.Password;
        oldUser.Name = user.Name;
        oldUser.ModifyTime = DateTime.Now;
    }
    return oldUser;
});
app.MapDelete("/user/{id}", (ILogger<Program> Logger, int id) =>
{
    Logger.LogInformation("被调用 remove user");
    var oldUser = DB.users.SingleOrDefault(s => s.ID == id);
    if (oldUser != null)
    {
        return DB.users.Remove(oldUser);
    }
    else
    {
        return false;
    }
});
#endregion

这是Refit的使用方式，首先引入Refit.HttpClientFactory NuGet包，注入RefitClient服务到服务容器中，这里要把IUserAPI带上，并配置BaseAddress。IUserAPI定义的是API接口类型，各个方法上的特性决定了请求下游API的信息。再用就是三个调用方法，这里只是演示简单的调用，所以参数都是固定的。

using Refit;

var builder = WebApplication.CreateBuilder(args);
//配置RefitClient
builder.Services
    .AddRefitClient<IUserAPI>()
    .ConfigureHttpClient(httpclient => httpclient.BaseAddress = new Uri("http://localhost:5026"));

var app = builder.Build();

#region 调用者
app.MapGet("/user", async (ILogger<Program> Logger, IUserAPI userAPI) =>
 {
     Logger.LogInformation("调用者 get user");
     var user = await userAPI.GetUser("gsw");
     user.Name += "丰";
     return user;
 });
app.MapPost("/user", async (ILogger<Program> Logger, IUserAPI userAPI) =>
{
    Logger.LogInformation("调用者 add user");
    var user = new User { UserName = "ls", Name = "李四", Password = "EDCBA", CreateTime = DateTime.Now };
    var newUser = await userAPI.AddUser(user);
    return newUser;
});
app.MapPut("/user", async (ILogger<Program> Logger, IUserAPI userAPI) =>
{
    Logger.LogInformation("调用者 modify user");
    var user = new User { ID = 2, UserName = "ls", Name = "李四收", Password = "AAAAA" };
    return await userAPI.ModifyUser(user);
});
app.MapDelete("/user", async (ILogger<Program> Logger, IUserAPI userAPI) =>
{
    Logger.LogInformation("调用者 remove user");
    return await userAPI.RemoveUser(2);
});
#endregion
app.Run();

/// <summary>
/// 定义Refit接口
/// </summary>
public interface IUserAPI
{
    [Get("/users/{username}")]
    Task<User> GetUser(string userName);
    [Post("/user")]
    Task<User> AddUser(User user);
    [Put("/user")]
    Task<User> ModifyUser(User user);
    [Delete("/user/{id}")]
    Task<bool> RemoveUser(int id);
}

其实HttpClient调用API是个大知识点，很多API不可能这么简单，Refit也提供了一些复杂的配置接口方式，详见

https://github.com/reactiveui/refit

因为场景很多，大家可以按文档找适合自己的配置，但Refit也不是万能的，只是把常用的场景作了适配，所以择优而用，不必纠结大而完美的解决方案，毕竟它是一个库而已。

全部.NET6之MiniAPI-PDF版本下载地址 https://club.51aspx.com/circle/10569.html