新增 `HttpFile` 类，针对远程请求上传文件封装 · Pull Request !553 · dotNET China/Furion

### 关联 Issue

https://gitee.com/dotnetchina/Furion/issues/I5PMS5

### 功能描述

在过去版本，如果使用远程请求代理模式进行上传文件，只能提前固定上传文件名和键，如：

```cs
public interface IHttp : IHttpDispatchProxy
{
    [Post("https://www.furion.icu/upload", ContentType = "multipart/form-data")]
    Task<HttpResponseMessage> PostXXXAsync([BodyBytes("键","文件名")]Byte[] bytes);

// 支持多个文件
    [Post("https://www.furion.icu/upload", ContentType = "multipart/form-data")]
    Task<HttpResponseMessage> PostXXXAsync([BodyBytes("键","文件名")]Byte[] bytes,[BodyBytes("键","文件名")]Byte[] bytes2);
}
```

这样无疑是写死了处理，无法进行动态化操作。

### 相关资料

https://gitee.com/dotnetchina/Furion/issues/I5PIYI

### 功能清单

- [x] 支持远程请求代理模式动态设置一个或多个文件信息，如 `HttpFile`，`HttpFile[]`，`IList<HttpFile>`
- [x] 支持远程请求所有模式支持 `HttpFile` 或集合方式
- [x] 调整 `.SetBodyBytes` 为 `.SetFiles`
- [x] 调整 `.SetBodyBytes` 参数签名为 `params HttpFile[] files`
- [x] 移除 `[BodyBytes]` 特性设计
- [x] 更新远程请求文档
- [x] 编写更新日志内容

### 期望效果

- 代理模式定义方式

```cs
public interface IHttp : IHttpDispatchProxy
{
    [Post("https://www.furion.icu/upload", ContentType = "multipart/form-data")] 
    Task<HttpResponseMessage> PostXXXAsync(HttpFile file);

// 支持多个文件
    [Post("https://www.furion.icu/upload", ContentType = "multipart/form-data")] 
    Task<HttpResponseMessage> PostXXXAsync(HttpFile[] files);
    
    // 支持多个文件
    [Post("https://www.furion.icu/upload", ContentType = "multipart/form-data")] 
    Task<HttpResponseMessage> PostXXXAsync(IList<HttpFile> files);
}
```

- 字符串使用方式：

```cs
var bytes = File.ReadAllBytes("image.png");

// 单个文件
var result = await "https://localhost:44316/api/test-module/upload-file".SetContentType("multipart/form-data").SetFiles(HttpFile.Create("file", bytes, "image.png")).PostAsync();

// 多个文件
var result = await "https://localhost:44316/api/test-module/upload-muliti-file".SetContentType("multipart/form-data").SetFiles(HttpFile.CreateMultiple("files", (bytes, "image1.png"), (bytes, "image2.png"))).PostAsync();
```

类型	指派人员	状态
审查	百小僧已审查通过	已完成 (1/1人)
测试	百小僧已测试通过	已完成 (1/1人)

GVPdotNET China/Furion

搜索帮助

GVP dotNET China/Furion