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

原文链接: https://www.cnblogs.com/inday/p/weichat-quick-framework-v3.html | 迁移自博客园


版本内容

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 (博友加入的时候,请注明自己的技术特长)