欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

在Winform混合式框架中整合外部API接口的调用

程序员文章站 2022-03-29 11:13:57
在我们常规的业务处理中,一般内部处理的接口多数都是以数据库相关的,基于混合式开发的Winform开发框架,虽然在客户端调用的时候,一般选择也是基于Web API的调用,不过后端我们可能不仅仅是针对我们业务数据库的处理,也可以能是调用其他外部接口,如物流、供应商接口等接口,本随笔就是主要介绍基于混合式... ......

在我们常规的业务处理中,一般内部处理的接口多数都是以数据库相关的,基于混合式开发的Winform开发框架,虽然在客户端调用的时候,一般选择也是基于Web API的调用,不过后端我们可能不仅仅是针对我们业务数据库的处理,也可以能是调用其他外部接口,如物流、供应商接口等接口,本随笔就是主要介绍基于混合式开发框架如何整合外部API接口的调用。

1、混合式框架的结构介绍

 我们知道,混合式的框架是可以在客户端访问Web API服务、WCF服务或者直接连接数据库几种方式的综合,而尤以Web API为最广泛的应用,它的整个框架的结构如下所示。

在Winform混合式框架中整合外部API接口的调用

在Winform混合式框架中整合外部API接口的调用

在客户端中,通过统一的工厂类CallerFactory<T>对相应的接口进行访问,这里主要就是服务器端Web API服务接口的处理,以及客户端对Web API接口的封装,两部分通过一些基类进行简化处理,可以极大提高开发效率。

对于外部第三方的Web API接口,我们也可以在自己的Web API接口中进行包装,使得客户端通过相应的接口进行交互即可,不需要理会内部还是外部的接口,从而实现透明的接口调用。

 2、RFID外部接口的整合处理

 在一个客户的应用案例中,需要整合服务商RFID接口实现相应的数据交互,本篇随笔也是基于这个案例进行整个过程的分析和操作,使得我们了解在混合框架中如何整合第三方Web API接口为我们内部框架所用。

一般来说,Web API接口,需要明确API的URL、数据提交方式(POST/GET)、提交参数、返回集合,以及一些特殊的数据等,而一般接口的操作,也是需要一个访问令牌的,这些都是Web API接口调用的关键。

在Winform混合式框架中整合外部API接口的调用

在Winform混合式框架中整合外部API接口的调用

在Winform混合式框架中整合外部API接口的调用

基本上我们有了上面Web API的1/2/3步骤的信息就可以进行接口编程了,这些是Web API开发非常重要的信息。

我们需要特别主要到,步骤1中的信息

在Winform混合式框架中整合外部API接口的调用

这里面的token是额外的接口信息,是需要设置Http Request请求的头部信息里面的,是用户身份的重要信息,所以我们一般需要先通过指定的授权接口获取这个token信息。

在这个外部的接口集合里面,我们找到统一登录验证的接口定义如下所示。

在Winform混合式框架中整合外部API接口的调用

在Winform混合式框架中整合外部API接口的调用

 通过上面的分析,我们首先需要需要处理好登录验证接口,然后通过接口传递令牌token给其他接口进行数据处理的。

结合我们的混合框架结构,这里我以测试项目TestProject项目为例进行介绍,我们调整WHC.TestProject.Caller项目的对应类,如下所示。

在Winform混合式框架中整合外部API接口的调用

其中Facade层接口类IRFIDService.cs代码如下所示。

    /// <summary>
    /// RFID服务外部接口
    /// </summary>
    [ServiceContract]
    public interface IRFIDService 
    {

        /// <summary>
        /// 终端用户统一登录验证
        /// </summary>
        [OperationContract]
        CheckinResult CheckIn(string username, string password, string device_uuid, string device_type, string last_app_version, string app_id);

        /// <summary>
        /// 获取标签发货通知单批量
        /// </summary>
        [OperationContract]
        TagOrderAsnResult TagOrderAsn(int brand_id, string factcode, string start_time, string end_time, PagerInfo pagerInfo, string token);

        /// <summary>
        /// 标签订单出库物流信息回写
        /// </summary>
        [OperationContract]
        CommonResult TagOutPost(string docno_asn, string factcode, string dest_factcode, List<FreightInfo> freight, string token);
    }

这里面的接口定义,我们是根据输入参数、输出参数进行定义的,另外token是额外增加的令牌参数,用于请求头部写入信息的。

这个接口的定义其实和我们常规的Web API接口定义没有太多的不同,如下是一个内部客户信息接口定义。

    /// <summary>
    /// 客户信息的服务接口
    /// </summary>
    [ServiceContract]
    public interface ICustomerService : IBaseService<CustomerInfo>
    {               
        /// <summary>
        /// 根据客户名称获取客户列表
        /// </summary>
        /// <param name="name">客户名称</param>
        /// <returns></returns>
        [OperationContract]
        List<CustomerInfo> FindByName(string name);
    }

差别就是它们接口继承类有所不同,外部接口由于不需要和数据库打交道,我们不需要继承IBaseService接口

根据这些接口的定义,我们还需要实现我们具体的Web API 服务,逻辑上它是对外部Web API接口的封装,但是对于客户端来说,并不需要知道是内部还是外部接口,客户端只需要知道如果提交参数或者结果即可。

由于Web API涉及多个参数的数据提交,一般来说这种情况都是以POST方式处理的,数据参数则统一在Web API端通过定义一个JObject对象来传递即可,登录认证的Web API接口定义如下所示。

    /// <summary>
    /// 基于RFID的应用接口
    /// </summary>
    public class RFIDController : BaseApiController
    {
        /// <summary>
        /// 终端用户统一登录验证
        /// </summary>
        /// <param name="param">包含多个属性的对象</param>
        /// <param name="token">访问令牌</param>
        [HttpPost]
        public CheckinResult CheckIn(JObject param)
        {
            CheckinResult result = null;
            dynamic obj = param;
            if (obj != null)
            {
                //使用POST数据
                var postData = param.ToJson();
                //使用具体的URL
                var queryUrl = "https://***.***.***/api/v6/rfid/terminal/checkin/post";

                var helper = new HttpHelper();
                helper.ContentType = "application/json";
                var content = helper.GetHtml(queryUrl, postData, true);
                RFIDBaseData<CheckinResult> jsonResult = JsonConvert.DeserializeObject<RFIDBaseData<CheckinResult>>(content);
                if (jsonResult != null && jsonResult.code == 0)
                {
                    result = jsonResult.data;
                }
                return result;
            }
            else
            {
                throw new MyApiException("传递参数错误");
            }
        }

其中输入的参数这里用了JObject param的参数,我们提交给外部Web API接口的时候,我们把这个参数再次序列号为JSON格式的字符串即可:

var postData = param.ToJson();

其中CheckinResult和RFIDBaseData是根据输入参数、输出结果进行的实体类定义,目的是序列化为强类型的实体类,方便数据处理操作。

在客户端,我们只需要对接好和Web API服务端的接口,那么调用起来就非常方便,其中对应的Web API接口客户端封装类 RFIDCaller 如下所示。

    /// <summary>
    /// 对RFID控制的接口调用封装
    /// </summary>
    public class RFIDCaller : NormalApiService, IRFIDService
    {
        public RFIDCaller()
        {
            this.ConfigurationPath = ApiConfig.ConfigFileName; //Web API配置文件
            this.configurationName = ApiConfig.RFID;
        }

        public CheckinResult CheckIn(string username, string password, string device_uuid, string device_type, string last_app_version, string app_id)
        {
            var action = System.Reflection.MethodBase.GetCurrentMethod().Name;
            string url = GetNormalUrl(action);
            var postData = new
            {
                username = username,
                password = password,
                device_uuid = device_uuid,
                device_type = device_type,
                last_app_version = last_app_version,
                app_id = app_id,
            }.ToJson();

            var result = JsonHelper<CheckinResult>.ConvertJson(url, postData);
            return result;
        }

有了这些,我们直接在客户端的界面里面,就可以通过调用CallerFactory<T>进行处理操作了,如下是客户端窗体获取验证身份令牌数据的代码

        private string token = null;//访问RFID接口的token
        /// <summary>
        /// 根据终端用户统一登录验证获取相关访问token
        /// </summary>
        /// <returns></returns>
        private string GetRFIDToken()
        {
            string username = "wuhuacong";
            string password = "123456";
            string device_uuid = "aaaaaaa";
            string device_type = "iphone";
            string last_app_version = "xxxxxxx";
            string app_id = "ntdf5543581a2f066e74cf2fe456";
            
            var result = CallerFactory<IRFIDService>.Instance.CheckIn(username, password, device_uuid, device_type, last_app_version, app_id);
            if(result != null)
            {
                token = result.token;
            }
            return token;
        }

 

 上面是认证身份的接口,其他类型的接口类似的处理方式,如增加了一个

获取标签发货通知单批量

操作后,对应的客户端封装类如下所示。

    /// <summary>
    /// 对RFID控制的接口调用封装
    /// </summary>
    public class RFIDCaller : NormalApiService, IRFIDService
    {
        public RFIDCaller()
        {
            this.ConfigurationPath = ApiConfig.ConfigFileName; //Web API配置文件
            this.configurationName = ApiConfig.RFID;
        }

        public CheckinResult CheckIn(string username, string password, string device_uuid, string device_type, string last_app_version, string app_id)
        {
            var action = System.Reflection.MethodBase.GetCurrentMethod().Name;
            string url = GetNormalUrl(action);
            var postData = new
            {
                username = username,
                password = password,
                device_uuid = device_uuid,
                device_type = device_type,
                last_app_version = last_app_version,
                app_id = app_id,
            }.ToJson();

            var result = JsonHelper<CheckinResult>.ConvertJson(url, postData);
            return result;
        }

        public TagOrderAsnResult TagOrderAsn(int brand_id, string factcode, string start_time, string end_time, Pager.Entity.PagerInfo pagerInfo, string token)
        {
            var action = System.Reflection.MethodBase.GetCurrentMethod().Name;
            string url = GetNormalUrl(action) + string.Format("?token={0}", token);
            var postData = new
            {
                page = pagerInfo.CurrenetPageIndex,
                pagesize = pagerInfo.PageSize,
                brand_id = brand_id,
                factcode = factcode,
                start_time = start_time,
                end_time = end_time,
            }.ToJson();

            var result = JsonHelper<TagOrderAsnResult>.ConvertJson(url, postData);
            return result;
        }

获取标签发货通知单批量

 的Web API接口如下代码定义

 

        /// <summary>
        /// 获取标签发货通知单批量
        /// </summary>
        /// <param name="param"></param>
        /// <param name="token"></param>
        /// <returns></returns>
        [HttpPost]
        public TagOrderAsnResult TagOrderAsn(JObject param, string token)
        {
            TagOrderAsnResult result = null;
            dynamic obj = param;
            if (obj != null)
            {
                //使用POST方式
                var postData = param.ToJson();
                var queryUrl = "https://***.***.***/api/v6/rfid/tag/tag_order_asn/get";
                                
                var helper = new HttpHelper();
                helper.ContentType = "application/json";
                helper.Header.Add("token", token); 
                var content = helper.GetHtml(queryUrl, postData, true);

                RFIDBaseData<TagOrderAsnResult> jsonResult = JsonConvert.DeserializeObject<RFIDBaseData<TagOrderAsnResult>>(content);
                if (jsonResult != null && jsonResult.code == 0)
                {
                    result = jsonResult.data;
                }

                return result;
            }
            else
            {
                throw new MyApiException("传递参数错误");
            }

其中表头信息,我们通过下面的代码指定,设置特殊的token表头信息

                var helper = new HttpHelper();
                helper.ContentType = "application/json";
                helper.Header.Add("token", token); 

而在客户端的调用窗体里面,我们调用对应的接口就可以获取该接口的数据了。

        private TagOrderAsnResult asnResult;
        /// <summary>
        /// 根据参数获取标签生产订单批量信息
        /// </summary>
        /// <returns></returns>
        private TagOrderAsnResult GetResult()
        {
            PagerInfo pagerInfo = new PagerInfo() { PageSize = 50, CurrenetPageIndex = 1 };//初始化一个分页条件
            var brand_id = this.txtbrand_id.Text.ToInt32();
            var factcode = this.txtfactcode.Text;
            var start_time = this.txtstart_time.DateTime.ToString("yyyy-MM-dd HH:mm:ss");
            var end_time = this.txtend_time.DateTime.ToString("yyyy-MM-dd HH:mm:ss");

            asnResult = CallerFactory<IRFIDService>.Instance.TagOrderAsn(brand_id, factcode, start_time, end_time, pagerInfo, Token);
            return asnResult;
        }

通过上面的代码演示,我们了解了在混合框架基础上增加外部Web API接口的方法,通过增加Facade层接口,增加Web API接口,以及对应的客户端封装类,具体处理参数根据Web API接口的输入参数、输出数据等信息进行综合处理即可。

最后我们来看看数据的展示界面。

在Winform混合式框架中整合外部API接口的调用