ABP開發框架先後端開發系列---（10）Web API調用類的簡化處理

在較早期的隨筆《ABP開發框架先後端開發系列---（5）Web API調用類在Winform項目中的使用》已經介紹了Web API調用類的封裝處理，雖然這些調用類咱們可使用代碼生成工具快速生成，不過自定義接口，仍是須要咱們對這些接口進行實現，以便發起對Web API的調用，並得到相應的數據返回。本篇隨筆介紹使用API調用類的封裝類，進行函數的抽象，根據方法名稱的推斷，構建URL或者WebClient的請求類型，從而實現全部API調用函數的簡化處理。

一、ABP框架服務端和客戶端的處理

ABP框架的架構圖示，以下圖所示（以字典模塊爲例說明）

針對Web API接口調用的封裝，爲了適應客戶端快速調用的目的，這個封裝做爲一個獨立的封裝層，以方便各個模塊之間進行共同調用。

而ABP的Web API調用類則須要對Web API接口調用進行封裝，以下所示。

如對於字典模塊的API封裝類，它們繼承一個相同的基類，而後實現特殊的自定義接口便可，這樣能夠減小常規的Create、Get、GetAll、Update、Delete等操做的代碼，這些所有由調用基類進行處理，而只須要實現自定義的接口調用便可。

 

二、Web API調用類的簡化處理

咱們對於常規的Web API調用接口處理，以下代碼所示。

        public async virtual Task<AuthenticateResult> Authenticate(string username, string password)
        {
            var url = string.Format("{0}/api/TokenAuth/Authenticate", ServerRootAddress);
            var input = new
            {
                UsernameOrEmailAddress = username,
                Password = password
            };

            var result = await apiClient.PostAsync<AuthenticateResult>(url, input);
            return result;
        }

這種方法的處理，就須要本身拼接URL地址，以及傳遞相關的參數，通常狀況下，咱們的Web API Caller層類的函數和Web API控制器的方法是一一對應的，所以方法名稱能夠經過對當前接口名稱的推斷進行得到，以下所示。

        public async Task<bool> ChangePassword(ChangePasswordDto input)
        {
            AddRequestHeaders();//加入認證的token頭信息
            string url = GetActionUrl(MethodBase.GetCurrentMethod());//獲取訪問API的地址（未包含參數）

            return await apiClient.PostAsync<bool>(url, input);
        }

函數AddRequestHeaders 經過在調用前增長對應的AccessToken信息，而後URL經過當前方法的推斷便可構建一個完整的URL，可是這個也僅僅是針對POST的方法，由於ABP框架根據方法的名稱前綴的不一樣，而採用POST、GET、Delete、PUT等不一樣的HTTP處理操做。

如GET方法，則是須要使用GET請求

        public async Task<List<RoleDto>> GetRolesByUser(EntityDto<long> input)
        {
            AddRequestHeaders();//加入認證的token頭信息
            string url = GetActionUrl(MethodBase.GetCurrentMethod());//獲取訪問API的地址（未包含參數）
            url = GetUrlParam(input, url);

            var result = await apiClient.GetAsync<List<RoleDto>>(url);
            return result;
        }

而對於刪除方法，則使用下面的DELETE請求，DELETE 和PUT操做，須要把參數串聯成GET的URL形式，相似 url += string.Format("?Id={0}", id); 這樣方式

        public virtual async Task Delete(TDeleteInput input)
        {
            AddRequestHeaders();//加入認證的token頭信息
            string url = GetActionUrl(MethodBase.GetCurrentMethod());//獲取訪問API的地址（未包含參數）
            url += GetUrlParam(input, url);
            var result = await apiClient.DeleteAsync(url);
            return result;
        }

對於更新的操做，使用了PUT方法

        public async virtual Task<TEntityDto> Update(TUpdateInput input)
        {
            AddRequestHeaders();//加入認證的token頭信息
            string url = GetActionUrl(MethodBase.GetCurrentMethod());//獲取訪問API的地址（未包含參數）
            var result = await apiClient.PutAsync<TEntityDto>(url, input, null);
            return result;
        }

上面這些方法，咱們根據規律，其實能夠進一步進行簡化，由於這些操做大多數相似的。

首先咱們看到變化的地方，就是根據方法的前綴採用GET、POST、DELETE、PUT方法，還有就是URL串聯字符串的不一樣，對於GET、Delete方法，參數使用的是組成URL方式，參數使用的是JSON提交內容方式。

根據這些變化，咱們在基類提煉一個統一的處理方法DoActionAsync 來處理這些不一樣的操做。

        /// <summary>
        /// 根據方法名稱自動執行GET/POST/PUT/DELETE請求方法
        /// </summary>
        /// <param name="method"></param>
        /// <param name="input"></param>
        protected virtual async Task DoActionAsync(MethodBase method, object input = null)
        {
            await DoActionAsync<object>(method, input);
        }

        /// <summary>
        /// 根據方法名稱自動執行GET/POST/PUT/DELETE請求方法
        /// </summary>
        /// <param name="method"></param>
        /// <param name="input"></param>
        protected virtual async Task<TResult> DoActionAsync<TResult>(MethodBase method, object input = null)
        {
            AddRequestHeaders();//加入認證的token頭信息

            string action = GetMethodName(method);
            var url = string.Format("{0}/api/services/app/{1}/{2}", ServerRootAddress, DomainName, action);//獲取訪問API的地址（未包含參數）
            var httpVerb = DynamicApiVerbHelper.GetConventionalVerbForMethodName(action);
            if(httpVerb == HttpVerb.Get || httpVerb == HttpVerb.Delete)
            {
                if (input != null)
                {
                    //Get和Delete的操做，須要組裝URL參數
                    url = GetUrlParam(input, url);
                }
            }

            int? timeout = null;
            return await apiClient.DoActionAsync<TResult>(url, timeout, httpVerb.ToString().ToLower(), input);
        }

這樣，有了這兩個函數的支持，咱們能夠簡化不少操做代碼了。

例如對於Update方法，簡化的代碼以下所示。

        public async virtual Task<TEntityDto> Update(TUpdateInput input)
        {
            return await DoActionAsync<TEntityDto>(MethodBase.GetCurrentMethod(), input);
        }

對於刪除操做，簡化的代碼依舊也是一行代碼

        public virtual async Task Delete(TDeleteInput input)
        {
            await DoActionAsync(MethodBase.GetCurrentMethod(), input);
        }

GET操做，也是一行代碼

        public async virtual Task<TEntityDto> Get(TGetInput input)
        {
            return await DoActionAsync<TEntityDto>(MethodBase.GetCurrentMethod(), input);
        }

如今你看到，全部的客戶端API封裝類調用，都已經很是簡化，大同小異了，主要就是交給基類函數進行推斷調用處理便可。

如用戶操做的APICaller類的代碼以下所示。

這樣咱們再多的接口，都一行代碼調用解決問題，很是簡單，今後客戶端封裝類的實現就很是簡單了，只須要注意有沒有返回值便可，其餘的都沒有什麼不一樣。

只須要注意的是，咱們定義接口的時候，儘量使用複雜類型對象，這樣就能夠根據對象屬性名稱和值進行構建URL或者JSON的了。