Xamarin Forms Api请求开源框架Refit

用于.NET Core，Xamarin和.NET的自动类型安全的REST库，Refit是一个受Square Square Retrofit库影响的库，但它比REST API更容易：

public interface IGitHubApi { [Get("/users/{user}")] Task 
            
            GetUser(string user); }

RestService类生成一个使用HttpClient进行调用的IGitHubApi实现：

var gitHubApi = RestService.For 
      
        ( 
       "https://api.github.com"); var octocat = await gitHubApi.GetUser("octocat");

兼容的平台

Refit目前支持以下平台和任何.NET Standard 1.3Taget

Xamarin.Android
Xamarin.Mac
Xamarin.iOS 64-bit (Unified API)
Desktop .NET 4.5
Windows Store 8.1+
Windows Phone 8.1 Universal Apps
.NET Core

以下平台不支持

Xamarin.iOS 32-bit

关于.NET Core

对于.NET Core支持，您必须使用csproj类型的项目托管您的Refit接口。这是因为xproj无法执行不包含在项目文件中的编译时代码生成。如果您使用xproj作为网站，类库或应用程序，您仍然可以通过创建一个netstandard csproj然后使用从xproj到csproj的项目到项目的引用来使用Refit。一旦出现“VS 15”和最终的.NET Core工具，此解决方法就不需要了。

API属性

每个方法都必须有一个HTTP属性，提供请求方法和相对URL。有五个内置注释：Get，Post，Put，Delete和Head。资源的相对URL在注释中指定。
[Get("/users/list")]
你可以在URL中指定查询参数：
[Get("/users/list?sort=desc")]
可以使用方法上的替换块和参数动态更新请求URL。替换块是由{}包围的字母数字字符串。如果您的参数名称与URL路径中的名称不匹配，请使用AliasAs属性。

[Get("/group/{id}/users")] Task 
      
        >> GroupList([AliasAs( 
       "id")] int groupId)

未指定为URL替换的参数将自动用作查询参数。这与Retrofit不同，其中必须明确指定所有参数。参数名称和URL参数之间的比较不区分大小写，因此如果您在路径/ group/{groupid} /show中命名参数”groupId”，它将正常工作。

[Get("/group/{id}/users")] Task 
      
        > GroupList([AliasAs( 
       "id")] int groupId, [AliasAs("sort")] string sortOrder); GroupList(4, "desc"); >>> "/group/4/users?sort=desc"

PS：这里就是说如果你在GroupList的签名里面使用[AliasAs("sort")] 变量类型变量名的方式，即使原本的路径里面没有“sort”的属性，也会自动加上去。

Body内容

通过使用Body属性，方法中的一个参数可以作为Body

[Post("/users/new")] Task CreateUser([Body] User user);

根据参数的类型，提供Body数据有四种可能：

如果类型为Stream，则内容将通过StreamContent流式传输。
如果类型是字符串，则该字符串将直接用作内容
如果参数具有[Body（BodySerializationMethod.UrlEncoded）]属性，内容将被URL编码（见下面的Form Posts部分）
对于所有其他类型，对象将被序列化为JSON。

JSON内容

JSON请求和响应使用Json.NET进行序列化/反序列化。默认情况下，Refit将使用可以通过设置Newtonsoft.Json.JsonConvert.DefaultSettings定义序列化器的设置：

JsonConvert.DefaultSettings = () => new JsonSerializerSettings() { ContractResolver = new CamelCasePropertyNamesContractResolver(), Converters = { 
         new StringEnumConverter()} }; // Serialized as: {"day":"Saturday"} await PostSomeStuff(new { Day = DayOfWeek.Saturday });

因为这些是全局设置，它们会影响整个应用程序。将请求的设置隔离到特定的AP也许是有益的。当创建一个Refit生成的实时界面时，您可以选择传递一个RefitSettings，这将允许您指定你想要的serializer设置。这允许您为不同的API具有不同的序列化器设置。

var gitHubApi = RestService.For 
       
         ( 
        "https://api.github.com",new RefitSettings { JsonSerializerSettings = new JsonSerializerSettings { ContractResolver = new SnakeCasePropertyNamesContractResolver() } } ); var otherApi = RestService.For 
              
                ( 
               "https://api.example.com",new RefitSettings { JsonSerializerSettings = new JsonSerializerSettings { ContractResolver = new CamelCasePropertyNamesContractResolver() } } );

属性序列化/反序列化可以使用Json.NET的JsonProperty属性进行定制：

public class Foo { // 像[AliasAs（“b”）]的使用将以form posts发布（见下文） [JsonProperty(PropertyName="b")] public string Bar { get; set; } }

Form posts

对于采用表单帖子（即序列化为应用程序/ x-www-form-urlencoded）的API，使用BodySerializationMethod.UrlEncoded初始化Body属性。参数可以是一个IDictionary

public interface IMeasurementProtocolApi { [Post("/collect")] Task Collect([Body(BodySerializationMethod.UrlEncoded)] Dictionary 
             
               data); } var data = 
              new Dictionary 
               
                 { { 
                 
                "v", 1}, { 
                  "tid", "UA-1234-5"}, { 
                    "cid", new Guid("d1e9ea6b-2e8b-4699-93e0-0bcbd26c206c")}, { 
                       "t", "event"}, }; // 序列化为: v=1&tid=UA-1234-5&cid=d1e9ea6b-2e8b-4699-93e0-0bcbd26c206c&t=event await api.Collect(data);

或者您可以传递任何对象，所有公共可读属性将作为请求中的表单字段序列化。该方法允许您使用[AliasAs（“whatever”）]来别名属性名称，如果API具有隐藏字段名称，则可以帮助您：

public interface IMeasurementProtocolApi { [Post("/collect")] Task Collect([Body(BodySerializationMethod.UrlEncoded)] Measurement measurement); } public class Measurement { // 属性可以是只读的，不需要[AliasAs] public int v { get { return 1; } [AliasAs("tid")] public string WebPropertyId { get; set; } [AliasAs("cid")] public Guid ClientId { get;set; } [AliasAs("t")] public string Type { get; set; } public object IgnoreMe { private get; set; } } var measurement = new Measurement { WebPropertyId = "UA-1234-5", ClientId = new Guid("d1e9ea6b-2e8b-4699-93e0-0bcbd26c206c"), Type = "event" }; //序列化为: v=1&tid=UA-1234-5&cid=d1e9ea6b-2e8b-4699-93e0-0bcbd26c206c&t=event await api.Collect(measurement);

设置请求标头

静态标题

您可以为应用Headers属性的方法设置一个或多个静态请求标头：

[Headers("User-Agent: Awesome Octocat App")] [Get("/users/{user}")] Task 
       
         GetUser( 
        string user);

也可以通过将Headers属性应用于接口，将静态标头添加到API中的每个请求中：

[Headers("User-Agent: Awesome Octocat App")] public interface IGitHubApi { [Get("/users/{user}")] Task 
             
             GetUser(string user); [Post("/users/new")] Task CreateUser([Body] User user); }

动态标题

如果头文件的内容需要在运行时设置，则可以通过将Header属性应用到参数来为请求添加具有动态值的头文件：

[Get("/users/{user}")] Task 
      
        GetUser( 
       string user, [Header("Authorization")] string authorization); // 将标题“Authorization：token OAUTH-TOKEN”添加到请求中 var user = await GetUser("octocat", "token OAUTH-TOKEN");

授权（动态标题缩减）

使用标头的最常见原因是授权。今天，大多数API使用一些口味的oAuth，访问令牌到期并刷新取得更长寿命的令牌。封装这些令牌用法的一种方法是，可以插入一个自定义的HttpClientHandler。举个例子：

class AuthenticatedHttpClientHandler : HttpClientHandler { private readonly Func 
         
           string>> getToken; 
          public AuthenticatedHttpClientHandler(Func 
              
                string>> getToken) { 
               if (getToken == null) throw new ArgumentNullException("getToken"); this.getToken = getToken; } protected override async Task 
                     
                       SendAsync(HttpRequestMessage request, CancellationToken cancellationToken) { 
                      // See if the request has an authorize header var auth = request.Headers.Authorization; if (auth != null) { var token = await getToken().ConfigureAwait(false); request.Headers.Authorization = new AuthenticationHeaderValue(auth.Scheme, token); } return await base.SendAsync(request, cancellationToken).ConfigureAwait(false); } }

虽然HttpClient包含几乎相同的方法签名，但使用方式不同。 HttpClient.SendAsync不被调用。必须修改HttpClientHandler。这个类是这样使用的（例如使用ADAL库来管理Xamarin.Auth或任何其他库的自动令牌刷新：

class LoginViewModel { AuthenticationContext context = new AuthenticationContext(...); private async Task 
            
            GetToken() { // 如果需要，AquireTokenAsync调用将提示用户界面 // 否则默认使用刷新令牌返回一个有效的访问令牌 var token = await context.AcquireTokenAsync("http://my.service.uri/app", "clientId", new Uri("callback://complete")); return token; } public async void LoginAndCallApi() { var api = RestService.For 
                          
                            ( 
                           new HttpClient(new AuthenticatedHttpClientHandler(GetToken)) { BaseAddress = new Uri("https://the.end.point/") }); var location = await api.GetLocationOfRebelBase(); } } interface IMyRestService { [Get("/getPublicInfo")] Task 
                                     
                                     SomePublicMethod(); [Get("/secretStuff")] [Headers("Authorization: Bearer")] Task 
                                           
                                           GetLocationOfRebelBase(); }

在上面的例子中，任何时候调用需要身份验证的方法，AuthenticatedHttpClientHandler将尝试获取一个新的访问令牌。由应用程序提供一个，检查现有访问令牌的到期时间，并在需要时获取新的访问令牌。

重新定义标题

不同于Retrofit，其中标题不会相互覆盖，并且都添加到请求中，而不管定义同一个标题的次数如何，Refit对ASP.NET MVC采用与动作过滤器相似的方法采用类似的方法 – 重新定义标题将替换它按以下顺序排列：

接口上的标题属性（最低优先级）
标题属性在方法
方法参数的标题属性（最高优先级）

[Headers("X-Emoji: :rocket:")] public interface IGitHubApi { [Get("/users/list")] Task 
             
             GetUsers(); [Get("/users/{user}")] [Headers("X-Emoji: :smile_cat:")] Task 
                   
                   GetUser(string user); [Post("/users/new")] [Headers("X-Emoji: :metal:")] Task CreateUser([Body] User user, [Header("X-Emoji")] string emoji); } // X-Emoji: :rocket: var users = await GetUsers(); // X-Emoji: :smile_cat: var user = await GetUser("octocat"); // X-Emoji: :trollface: await CreateUser(user, ":trollface:");

删除标题

在界面或方法上定义的标题可以通过重新定义没有值的静态标题（即不使用：

）或为动态标题传递null来删除。空字符串将被包括为空标题。

[Headers("X-Emoji: :rocket:")] public interface IGitHubApi { [Get("/users/list")] [Headers("X-Emoji")] // 删除X-Emoji标题 Task 
               
               GetUsers(); [Get("/users/{user}")] [Headers("X-Emoji:")] // 将X-Emoji标题重新定义为空 Task 
                      
                      GetUser(string user); [Post("/users/new")] Task CreateUser([Body] User user, [Header("X-Emoji")] string emoji); } // 没有X-Emoji标题 var users = await GetUsers(); // X-Emoji: var user = await GetUser("octocat"); // 没有X-Emoji标题 await CreateUser(user, null); // X-Emoji: await CreateUser(user, "");

断点上传

使用Multipart属性装饰的方法将使用多部分内容类型提交。此时，multipart方法支持以下参数类型：

字符串（参数名称将用作名称和字符串值作为值）
字节数组
流
FileInfo
参数名称将用作多部分数据中字段的名称。这可以被AliasAs属性覆盖。要指定字节数组（byte []），Stream和FileInfo参数的文件名和内容类型，需要使用包装类。 ByteArrayPart，StreamPart和FileInfoPart。

public interface ISomeApi { [Multipart] [Post("/users/{id}/photo")] Task UploadPhoto(int id, [AliasAs("myPhoto")] StreamPart stream); }

检索回应

请注意，在Refit中，与Retrofit不同，没有同步网络请求的选项 – 所有请求都必须通过任务或通过IObservable进行异步。不像Retrofit，只能通过回调参数创建异步，因为我们生活在async/await未来。

[Post("/users/new")] Task CreateUser([Body] User user); // 如果网络呼叫失败，则会发生这种情况 await CreateUser(someUser);

如果type参数是’HttpResponseMessage’或’string’，则原始响应消息或作为字符串的内容将分别返回。

// Returns the content as a string (i.e. the JSON data) [Get("/users/{user}")] Task<string> GetUser(string user); //返回原始响应，作为可用于Reactive Extensions的IObservable [Get("/users/{user}")] IObservable 
           
             GetUser( 
            string user);

使用通用接口

当使用像ASP.NET Web API这样的东西，它是一个相当普遍的模式，拥有一整套CRUD REST服务。 Refit现在允许您使用通用类型定义单个API接口：

public interface IReallyExcitingCrudApi 
      
        where T : 
       class { [Post("")] Task 
          
            Create([Body] T paylod); [Get( 
           "")] Task 
            
              > ReadAll(); [Get( 
             "/{key}")] Task 
              
                ReadOne(TKey key); [Put( 
               "/{key}")] Task Update(TKey key, [Body]T payload); [Delete("/{key}")] Task Delete(TKey key); }

可以这样使用：

// 这里的“/ users”部分是很重要的，如果您希望它可以使用多种类型（除非每种类型都有不同的域） var api = RestService.For 
        
          >( 
         "http://api.example.com/users");

转载于:https://www.cnblogs.com/mschen/p/10199452.html

发布者：全栈程序员-站长，转载请注明出处：https://javaforall.net/209368.html原文链接：https://javaforall.net

Xamarin Forms Api请求开源框架Refit

兼容的平台

Refit目前支持以下平台和任何.NET Standard 1.3Taget

以下平台不支持

关于.NET Core

API属性

Body内容

通过使用Body属性，方法中的一个参数可以作为Body

根据参数的类型，提供Body数据有四种可能：

JSON内容

Form posts

设置请求标头

静态标题

动态标题

授权（动态标题缩减）

重新定义标题

删除标题

断点上传

检索回应

使用通用接口

可以这样使用：

关于作者

全栈程序员-站长

发表回复

Xamarin Forms Api请求开源框架Refit

兼容的平台

Refit目前支持以下平台和任何.NET Standard 1.3Taget

以下平台不支持

关于.NET Core

API属性

Body内容

通过使用Body属性，方法中的一个参数可以作为Body

根据参数的类型，提供Body数据有四种可能：

JSON内容

Form posts

设置请求标头

静态标题

动态标题

授权（动态标题缩减）

重新定义标题

删除标题

断点上传

检索回应

使用通用接口

可以这样使用：

关于作者

全栈程序员-站长

相关推荐

矢量编程——随着MNIST案例

Retinex图像增强算法

pytest skipif_pytest失败重跑

缓冲区溢出流程

Android学习路径（两）项目文件本身使用场景和文件演示

豆包1.6模型震撼升级！实测效果解析与AI云原生Agent开发示例，不容错过！

发表回复