微信快速开发框架(九)-- V3.0发布,代码已更新至Github 新增微店功能

版本内容

1、修正了缺少对Event.View的支持

2、增加了用户UnionID

3、新增微信小店功能

4、多客服功能

5、单元测试

什么是UnionID

我们知道,每个用户针对一个微信公众账号都有一个openId,对于不同的公众账号,openId都是不同的,但很多公司都有很多微信号,用户也会同时关注同个公司的多个微信账号,为确保用户的唯一性,腾讯增加了UnionID字段,它可以确保在同个微信开放平台(open.weixin.qq.com)账号下的多个公众号的同个用户的唯一性。点击传送门,查看使用方法。

以前我们的开发,都是在mp.weixin.qq.com微信公众账号后台的开发者中心里,现在我们可以在微信开放平台里,把多个公众账号绑定到一个开发者账号中,目前一个账号可以绑定10个公众号。目前2套系统还是分开的,估计以后都会统一到Open系统中,目前Open已经有网站登录、移动登入、移动支付等接口,老应我也会继续跟进的。

UnionID目前只在“获取用户基本信息”中增加,UserInfoResponse增加string类型的UnionID属性。

微信小店

微信公众平台本次更新增加了微信小店功能,微信小店基于微信支付,包括添加商品、商品管理、订单管理、货架管理、维权等功能,开发者可使用接口批量添加商品,快速开店。

必须是已微信认证已接入微信支付的服务号,才可在服务中心中申请开通微信小店功能。

微信小店其实就是一个微店功能,公众号可以在公众平台后台进行添加、修改、删除等功能,用户可以在其微店下单,使用微信支付。这次微信小店的api文档比较大,所以这次更新慢了点,而且无法进行测试,我只能对每个api进行了单元测试,比对文档中提供的json数据,虽说简单,但工作量巨大,pdf文档无法进行复制黏贴,所以可能会存在一定的bug,如果发现bug,请及时与我联系。

这次的Api中,增加了一个DefaultResponse的响应类,主要是针对一些api请求只需要返回errcode和errmsg,比如在修改商品、删除商品等api中都会遇到,这些api只需要返回成功与否即可,所以就不增加其相对应的Response了。

微信小店有个货架功能,他与库存不是一个概念,它的概念相当于超市的货品摆放架,你可以创建多个货架,每个货架可以包含一个或多个货架控件。这个可能很难理解,你可以理解成页面和控件,一个货架就是一个页面,货架控件相当于我们的web控件。目前微信小店提供了5种货架控件,摆放和关联都有一定的限制。

控件1:是由一个分组组成,展示该指定数量的商品列表可与控件,可以与控件2、控件3、控件4联合使用

控件2:是由多个分组组成(最多有4个分组),展示指定分组的名称,可以与控件1、控件3、控件4联合使用

控件3:是由一个分组组成,展示指定分组的分组图片,可以与控件1、控件2、控件4联合使用

控件4:是由多个分组组成(最多3个分组),展示指定分组的分组图片,可以与控件1、控件2、控件3联合使用

控件5:是由多个分组组成,展示指定分组的名称,不可以与其他控件联合使用。

具体的样式,大家可以参考pdf文档。

因为控件我都继承了ShelfModule的抽象类,在json反序列化时造成了很大的麻烦,最后虽然解决了,但总觉得不够理想,过几天我会整理下,把我的方案分享下,也希望有大虾指点下。

以下是微信小店的API的Request和Response的对应表:

商品管理接口
增加商品 MerchantCreateRequest MerchantCreateResponse
删除商品 MerchantDelRequest DefaultResponse
修改商品 MerchantUpdateRequest DefaultResponse
查询商品 MerchantGetRequest MerchantGetResponse
获取指定状态的所有商品 MerchantGetbystatusRequest MerchantGetbystatusResponse
商品上下架 MerchantModproductstatusRequest DefaultResponse
获取指定分类的所有子分类 MerchantCategoryGetsubRequest MerchantCategoryGetsubResponse
获取指定子分类的所有SKU MerchantCategoryGetskuRequest MerchantCategoryGetskuResponse
获取指定分类的所有属性 MerchantCategoryGetpropertyRequest MerchantCategoryGetpropertyResponse
库存管理接口
增加库存 MerchantStockAddRequest DefaultResponse
减少库存 MerchantStockReduceRequest DefaultResponse
邮费模板管理接口
增加邮费模板 MerchantExpressAddRequest MerchantExpressAddResponse
删除邮费模板 MerchantExpressDelRequest DefaultResponse
修改邮费模板 MerchantExpressUpdateRequest DefaultResponse
获取指定ID的邮费模板 MerchantExpressGetbyidRequest MerchantExpressGetbyidResponse
获取所有邮费模板 MerchantExpressGetallRequest MerchantExpressGetallResponse
分组管理接口
增加分组 MerchantGroupAddRequest MerchantGroupAddResponse
删除分组 MerchantGroupDelRequest DefaultResponse
修改分组属性 MerchantGroupPropertymodRequest DefaultResponse
修改分组商品 MerchantGroupProductmodRequest DefaultResponse
获取所有分组 MerchantGroupGetallRequest MerchantGroupGetallResponse
根据分组ID获取分组信息 MerchantGroupGetbyidRequest MerchantGroupGetbyidResponse
货架管理接口
增加货架 MerchantShelfAddRequest MerchantShelfAddResponse
删除货架 MerchantShelfDelRequest DefaultResponse
修改货架 MerchantShelfModRequest DefaultResponse
获取所有货架 MerchantShelfGetallRequest MerchantShelfGetallResponse
根据货架ID获取货架信息 MerchantShelfGetbyidRequest MerchantShelfGetbyidResponse
货架上下架 MerchantShelfUpdatestatusRequest MerchantShelfUpdatestatusResponse
订单管理接口
订单付款通知 RequestOrderEventMessage(通知信息)
根据订单ID获取订单详情 MerchantOrderGetbyidRequest MerchantOrderGetbyidResponse
根据订单状态/创建时间获取订单详情 MerchantOrderGetbyfilterRequest MerchantOrderGetbyFilterResponse
设置订单发货信息 MerchantOrderSetdeliveryRequest DefaultResponse
关闭订单 MerchantOrderCloseRequest DefaultResponse
功能接口
上传图片 MerchantCommonUploadimgRequest MerchantCommonUploadimgResponse

这里大家要注意一点,这里接口所用到的图片url,都需要通过上传图片api上传后获取的url

多客服功能

1、将消息转发到多客服:

在收到客户消息时,只要返回 ResponseTransferCustomServiceMessage 的实例即可。

2、获取客服聊天记录:

使用了高级接口,创建一个CustomServiceGetRecordRequest实例,提交后获取CustomServiceGetRecordResponse。

单元测试

这次因为没有测试接口,所以对所有的api进行的Mock测试,基本是通过了,但还是无法保证正确性,希望大家在试用中能与我多交流,尽量的消灭bug。

之前因为有测试接口,我都能实地的测试,这次呢通过单元测试,虽然很枯燥,但帮助真的很大,其中测试出了很多小bug,单词拼错,报错等等,所以希望大家在自己的项目中,不要压缩测试的时间,这个真的很重要。

相关文档

1、微信公众平台开发者文档 点击进入

2、微信小店文档 点击下载

3、源代码已更新至Github 点击进入

写在最后

最近微信的升级加快,由于精力有限,所以这次版本升级较慢,造成的不便深感抱歉,很多朋友问我为什么做框架而不是实例?实例至少可以卖钱,但本人不是这样想,做这个框架是第一是为了完成自己对开源的一个理想,第二呢也是方便大家能够对公众平台的快速入门。后续呢可能会针对微信的开放平台进行框架设计,也有可能完成对公众平台的一个实例,至于时间,无法保障。

很多人觉得项目名称有点变扭,没办法,一开始我只是针对自己的平台做的小框架,名字也乱起的,后来也懒得改了,将错就错吧,哈。

最后推荐个QQ群:85318032 (博友加入的时候,请注明自己的技术特长)

原文地址:https://www.cnblogs.com/inday/p/weichat-quick-framework-v3.html