RestSharp使用總結

RestSharp是一個輕量的，不依賴任何第三方的組件或者類庫的Http的組件。RestSharp具有以下的優點：
   1、支持.NET 3.5+,Silverlight 4, Windows Phone 7, Mono, MonoTouch, Mono for Android, Compact Framework 3.5等
   2、通過NuGet方便引入到任何項目 ( Install-Package restsharp )
   3、可以自動反序列化XML和JSON
   4、支持自定義的序列化與反序列化
   5、自動檢測返回的內容類型
   6、支持HTTP的GET, POST, PUT, HEAD, OPTIONS, DELETE等操作
   7、可以上傳多文件
   8、支持oAuth 1, oAuth 2, Basic, NTLM and Parameter-based Authenticators等授權驗證等
   9、支持異步操作
  10、極易上手並應用到任何項目中

下面則是本人對RestSharp的一些整理和擴展：

using RestSharp;
using System;

namespace HB.Common.Tools.Http
{
    /// <summary>
    /// API請求執行者接口
    /// </summary>
    public interface IRestSharp
    {
        /// <summary>
        /// 同步執行方法
        /// </summary>
        /// <param name="request"></param>
        /// <returns></returns>
        IRestResponse Execute(IRestRequest request);

        /// <summary>
        /// 同步執行方法
        /// </summary>
        /// <typeparam name="T">返回值</typeparam>
        /// <param name="request">請求參數</param>
        /// <returns></returns>
        T Execute<T>(IRestRequest request) where T : new();

        /// <summary>
        /// 異步執行方法
        /// </summary>
        /// <param name="request">請求參數</param>
        /// <param name="callback"></param>
        /// <returns></returns>
        RestRequestAsyncHandle ExecuteAsync(IRestRequest request, Action<IRestResponse> callback);

        /// <summary>
        /// 異步執行方法
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="request"></param>
        /// <param name="callback"></param>
        /// <returns></returns>
        RestRequestAsyncHandle ExecuteAsync<T>(IRestRequest request, Action<IRestResponse<T>> callback) where T : new();
    }
}

using RestSharp;
using RestSharp.Authenticators;
using System;

namespace HB.Common.Tools.Http
{
    /// <summary>
    /// Rest接口執行者
    /// </summary>
    public class RestSharpClient : IRestSharp
    {
        /// <summary>
        /// 請求客戶端
        /// </summary>
        private RestClient client;

        /// <summary>
        /// 接口基地址 格式：http://www.xxx.com/
        /// </summary>
        private string BaseUrl { get; set; }

        /// <summary>
        /// 默認的時間參數格式
        /// </summary>
        private string DefaultDateParameterFormat { get; set; }

        /// <summary>
        /// 默認驗證器
        /// </summary>
        private IAuthenticator DefaultAuthenticator { get; set; }

        /// <summary>
        /// 構造函數
        /// </summary>
        /// <param name="baseUrl"></param>
        /// <param name="authenticator"></param>
        public RestSharpClient(string baseUrl, IAuthenticator authenticator = null)
        {
            BaseUrl = baseUrl;
            client = new RestClient(BaseUrl);
            DefaultAuthenticator = authenticator;

            //默認時間顯示格式
            DefaultDateParameterFormat = "yyyy-MM-dd HH:mm:ss";

            //默認校驗器
            if (DefaultAuthenticator != null)
            {
                client.Authenticator = DefaultAuthenticator;
            }
        }

        /// <summary>
        /// 通用執行方法
        /// </summary>
        /// <param name="request">請求參數</param>
        /// <remarks>
        /// 調用實例：
        /// var client = new RestSharpClient("http://localhost:82/");
        /// var result = client.Execute(new RestRequest("api/values", Method.GET));
        /// var content = result.Content;//返回的字符串數據
        /// </remarks>
        /// <returns></returns>
        public IRestResponse Execute(IRestRequest request)
        {
            request.DateFormat = string.IsNullOrEmpty(request.DateFormat) ? DefaultDateParameterFormat : request.DateFormat;
            var response = client.Execute(request);
            return response;
        }

        /// <summary>
        /// 同步執行方法
        /// </summary>
        /// <typeparam name="T">返回的泛型對象</typeparam>
        /// <param name="request">請求參數</param>
        /// <remarks>
        ///  var client = new RestSharpClient("http://localhost:82/");
        ///  var result = client.Execute<List<string>>(new RestRequest("api/values", Method.GET)); 
        /// </remarks>
        /// <returns></returns>
        public T Execute<T>(IRestRequest request) where T : new()
        {
            request.DateFormat = string.IsNullOrEmpty(request.DateFormat) ? DefaultDateParameterFormat : request.DateFormat;
            var response = client.Execute<T>(request);
            return response.Data;
        }

        /// <summary>
        /// 異步執行方法
        /// </summary>
        /// <param name="request">請求參數</param>
        /// <param name="callback">回調函數</param>
        /// <remarks>
        /// 調用實例：
        /// var client = new RestSharpClient("http://localhost:62981/");
        /// client.ExecuteAsync<List<string>>(new RestRequest("api/values", Method.GET), result =>
        /// {
        ///      var content = result.Content;//返回的字符串數據
        /// });
        /// </remarks>
        /// <returns></returns>
        public RestRequestAsyncHandle ExecuteAsync(IRestRequest request, Action<IRestResponse> callback)
        {
            request.DateFormat = string.IsNullOrEmpty(request.DateFormat) ? DefaultDateParameterFormat : request.DateFormat;
            return client.ExecuteAsync(request, callback);
        }

        /// <summary>
        /// 異步執行方法
        /// </summary>
        /// <typeparam name="T">返回的泛型對象</typeparam>
        /// <param name="request">請求參數</param>
        /// <param name="callback">回調函數</param>
        /// <remarks>
        /// 調用實例：
        /// var client = new RestSharpClient("http://localhost:62981/");
        /// client.ExecuteAsync<List<string>>(new RestRequest("api/values", Method.GET), result =>
        /// {
        ///      if (result.StatusCode != HttpStatusCode.OK)
        ///      {
        ///         return;
        ///      }
        ///      var data = result.Data;//返回數據
        /// });
        /// </remarks>
        /// <returns></returns>
        public RestRequestAsyncHandle ExecuteAsync<T>(IRestRequest request, Action<IRestResponse<T>> callback) where T : new()
        {
            request.DateFormat = string.IsNullOrEmpty(request.DateFormat) ? DefaultDateParameterFormat : request.DateFormat;
            return client.ExecuteAsync<T>(request, callback);
        }
    }
}