基于华为物联网IOT的应用开发 ---界面管理开发
在前面随笔《基于华为物联网IOT的应用开发 --- 基于.net 的SDK封装》介绍过IOT中应用侧SDK的封装,主要就是基于华为IOT的应用侧封装,以便在应用系统中进行调用。应用侧SDK的封装是一切应用开发的基础,不过华为并没有提供对应.net的SDK封装,不过SDK都是基于Web API 的JSON数据进行交互,因此花了一点时间进行了华为.net 的SDK进行了全面封装,本篇随笔介绍如何基于封装好的IOT 应用侧的SDK进行界面管理的开发,实现对IOT业务数据的管理等。
1、应用侧SDK封装回顾
应用侧的开发接口一般云平台都会提供不同平台的SDK,如阿里云开源提供Java SDK/C# SDK等;而华为则提供了Java、PHP等SDK,没有包含.net 的SDK。华为物联网云的应用侧API接口包括:
基于对应应用侧API接口的定义,我们使用C#进行了对应接口的封装。
包含了一个测试接口项目、一个SDK封装接口项目,以及一个订阅的消息推送接口的解析和处理,例如新增设备、设备信息变化、设备绑定激活等。
对于事件的通知,我们一般是在应用端被动的进行相应的处理,因此需要对它们的消息进行转换和处理。
类似在管理后台订阅这些事件,然后这些事件触发后会推送给应用服务器。
2、接口的测试使用
根据IOT的应用侧API的定义,我们编写一个快速测试SDK工作情况的Winform程序来测试,如获取授权信息,以及查询产品、注册设备、修改设备、获取设备状态和详细等等接口的正常与否,然后再在Web应用中进行整合,这样可以减少返工调试的问题。
按照业务接口的归类测试,我们编写如下程序用来测试对应SDK接口。
在使用SDK接口前,我们需要知道,华为IOT的API接口,基本上全部需要证书的对接的,这个和我们开发微信API有所差异。例如,我们的Winform测试程序,让它带有一个Cert目录下的证书文件,这个证书文件可以在API的Demo里面找到,或者在华为IOT平台上下载。
我们最终用到的是cert/outgoing.CertwithKey.pkcs12这个证书文件。
我们创建一个HTTPRequest对象获取数据的时候,需要指定这个证书,如下所示。
helper.ContentType = "application/json"; helper.ClientCertificates = new X509CertificateCollection() { new X509Certificate2(Constants.CertFilePath, Constants.CertPassword) };
其他部分就是对API接口封装的调用测试了。
如首先是授权的测试,用来获取AccessToken的,这个是调用其他接口的前提。
private void btnLogin_Click(object sender, EventArgs e) { var result = basicApi.Authentication(); Console.WriteLine(result != null ? "accessToken:" + result.ToJson() : "获取结果出错"); if (result != null) { var refreshResult = basicApi.RefreshToken(result.refreshToken); Console.WriteLine(refreshResult != null ? "accessToken:" + refreshResult.ToJson() : "获取结果出错"); this.accessToken = refreshResult.accessToken;//记录待用 } }
华为IOT接口很多没有全部整合在一起,有的在https://support.huaweicloud.com/api-IoT/iot_06_0003.html ,而有的则在https://support.huaweicloud.com/api-iothub/iot_06_0008.html, 就拿授权来说,还有另外一个版本的接口可以获取,两个接口获得的token都可以通用。
var url = Constants.AppBaseUrl + "/iocm/app/sec/v1.1.0/login";
var url = Constants.AppBaseUrl + "/api/v3.0/auth/tokens";
这两个地址都可以获取AccessToken,如设备创建,也是有多个接口,版本不同。
我们针对各个接口的封装,对相关接口进行测试,如基于产品、产品下面的列表等信息,可以在一个接口测试代码里面进行测试,如下所示。
/// <summary> /// 产品相关接口测试 /// </summary> private void btnProduct_Click(object sender, EventArgs e) { if (string.IsNullOrEmpty(accessToken)) { MessageUtil.ShowTips("请先鉴权获取AccessToken"); return; } try { var productApi = new ProductApi(); var deviceApi = new DataCollectionApi(); //查询产品列表 var queryJson = new QueryProductJson { ownerAppId = Constants.AppId }; var result = productApi.QueryProduct(accessToken, queryJson); Console.WriteLine(result != null ? result.ToJson() : "no result"); if (result != null && result.products != null) { //遍历产品,根据产品ID获取产品信息 foreach (var p in result.products) { var detailResult = productApi.QueryProduct(accessToken, p.productId, Constants.AppId); Console.WriteLine(detailResult != null ? detailResult.ToJson() : "no result"); } //遍历产品下面的设备信息 foreach (var p in result.products) { var deviceJson = new QueryDeviceJson { ownerAppId = Constants.AppId, productId = p.productId }; var deviceResult = deviceApi.BatchQueryDevice2(accessToken, deviceJson); Console.WriteLine(deviceResult != null ? deviceResult.ToJson() : "no result"); } } } catch (Exception ex) { MessageUtil.ShowError(ex.Message); } }
对于设备,产品、设备组,都属于设备的入口之一,因此设备组也是管理接口设备的一个类别,我们可以根据SDK对设备组接口进行测试,如下代码所示。
/// <summary> /// 设备分组测试 /// </summary> private void btnDeviceGroup_Click(object sender, EventArgs e) { if (string.IsNullOrEmpty(accessToken)) { MessageUtil.ShowTips("请先鉴权获取AccessToken"); return; } try { //根据自己数据修改 var deviceId = "64bf5869-b271-4007-8db8-fab185e19c10"; var groupName = "testGroup"; var groupApi = new DeviceGroupApi(); var groupJson = new CreateDeviceGroupJson() { appId = Constants.AppId, name = groupName, description = "测试设备分组", deviceIds = { deviceId } }; //创建设备组 var result = groupApi.CreateDeviceGroup(accessToken, groupJson); Console.WriteLine(result != null ? result.ToJson() : "no result"); //查询设备组 var queryJson = new QueryDeviceGroupJson() { accessAppId = Constants.AppId, name = groupName }; var queryResult = groupApi.QueryDeviceGroup(accessToken, queryJson); Console.WriteLine(queryResult != null ? queryResult.ToJson() : "no result"); //查询设备组成员 if (queryResult != null && queryResult.list != null) { foreach (var group in queryResult.list) { //设备明细 var groupResult = groupApi.GetDeviceGroup(accessToken, group.id, Constants.AppId); Console.WriteLine(groupResult != null ? groupResult.ToJson() : "no result"); //设备组成员 var queryMemberJson = new QueryDeviceGroupMemberJson() { appId = Constants.AppId, devGroupId = group.id }; var queryMemberResult = groupApi.QueryDeviceGroupMember(accessToken, queryMemberJson); Console.WriteLine(queryMemberResult != null ? queryMemberResult.ToJson() : "no result"); } } } catch (Exception ex) { MessageUtil.ShowError(ex.Message); } }
3、IOT业务界面管理开发
当我们把大多数接口都跑一遍,并解决相关问题后,我们就可以根据这些接口进行Web应用的开发了。
为了方便,我们把IOT相关的业务,定义在一个控制器里面,方便管理,以后如果有需要,可以拆分进行管理。
例如,对于数据提供,主要就是分页JSON数据的处理,方便界面控件通过Ajax进行获取数据显示。
例如,对于产品列表,我们构建了一个控制器方法,如下所示。
/// <summary> /// 根据条件查询产品列表,并返回对象集合(用于分页数据显示) /// </summary> /// <returns>指定对象的集合</returns> public virtual ActionResult FindProductWithPager() { var pagerInfo = GetPagerInfo(); var sort = GetSortOrder(); var accessToken = GetAccessToken(); var queryJson = new QueryProductJson(pagerInfo) { ownerAppId = Constants.AppId }; var result = productApi.QueryProduct(accessToken, queryJson); var list = result != null ? result.products : null; var totalCount = result != null ? result.totalCount : 0; //Json格式的要求{total:22,rows:{}} var jsonResult = new { total = totalCount, rows = list }; return ToJsonContent(jsonResult); }
其他,如设备组、设备列表等类似的处理,都是先通过接口获取数据,然后组装为对应的JSON格式提供给视图即可。
有时候,除了列表展示外,我们可能还需要对视图中创建、删除、获取单个明细的接口进行处理,如下所示是设备分组的管理接口。
其他的业务对象也是类似的封装,有了这些接口,我们就可以处理分页、获取详细、编辑、删除等接口的处理了。
在Web应用中定义几个业务菜单,用来管理产品信息、设备组和设备信息。
产品管理界面如下所示。
如果我们要查看产品明细,调用对应接口进行展示即可。
包含设备列表,我们根据产品ID获取对应设备列表返回到界面进行展示即可,如下所示效果。
设备分组如下所示。
而设备列表展示可以通过产品和设备组进行限定查询,我们如下管理这个设备列表的展示的。
同样,设备详细信息,通过对应ID调用SDK接口获取数据,并返回到视图即可展示出来了。设备的相关信息,如下历史数据、历史命令等,我们也可以通过对应接口进行数据获取返回,在界面的Tab控件进行展示即可。
如设备历史命令,可以获取到相关历史命令信息。
以上就是对IOT应用侧API接口的封装和应用界面的管理开发,不过使用过程中,对于IOT的接口还是不够完善,希望华为在这方便能够继续完善和提供良好的开发人员支持,我们也继续关注,以便在后续项目中整合物联网的硬件设备进行使用。
![](http://www.cnblogs.com/Images/OutliningIndicators/None.gif)
转载请注明出处:撰写人:伍华聪 http://www.iqidi.com