Spring Cloud整合微信框架.docx

PAGE7

SpringCloudWechat组件

前言

由于公司业务有相当一部分业务是微信公众号,或者是微信小程序;随之陈泽搭建的SpringCloud框架目前试用在互联碗项目当中;微服务是以后主流的业务之一;有比较强大的处理并发.以及服务(模块)管理能力其他优点将不再此文档中累赘.;

公司目前现状是开发微信或者是开发小程序都使用的是Jfinal框架;于鹿老师(鹿传明),陈老师(陈国星)提出以后技术部门技术规范一系列.为了大家保持以前开发效率;本文阐述了Jfinal的底层实现原理;以及接入思想;有一部分涉及到了Cloud的知识点;如果不明白的同学可联系文档产出人;

愿景:不在关注接口口径对接而耽误时间;只需要关注业务;实现功能;后续文档会一点一点补齐;因为自身也有任务在身上;此框架后续会整合支付;等等整合进来之后只需要关注业务即可;

文档产出人:胡斐

2017年11月14日

目录

TOC\o1-3\h\z\uSpringCloudWechat组件 1

前言 1

1 部门Wechat 2

2 接入Wechat实例 3

部门Wechat

严格来说Cloud的核心是SpringBoot；我们部门的Wechat框架中；实际意义上就是一个SpringBoot项目；用maven进行一个关联；注入到业务系统中；当做一个jar包来使用；当然这个项目是可以单独运行的。

我们有自己的关键类:在此最主要介绍4个类；

1:WechatMsgController:

该类是改写JFinalMsgController消息控制类;用于控制微信转发到我们自己服务器特定的接口最后跳转到相对应接口里面处理相对应不同的业务;

2:WechatInterceptor:

该拦截器是在做Wechat服务器对接时反映服务器登入时做的服务器校验;并且返回校验数据给服务器;会在案例中展示如何配置;

3:IwechatService:

该类为微信接口返回类;返回方法与jfinal雷同.将会在案例中展示如何返回涉及到了哪个点;

4:WechatConfig:

微信Config基类.该写与ApiConfig由于架构不同;所以实现方式会有所改变;但是功能点雷同;

以上就是比较关键的4个类;

接入Wechat实例

接入思想:简单了解一下Cloud的开发模式;Cloud的开发模式对于接入Wechat组件来说是一件比较重要的一个过程;

Cloud架构中我们一般项目

主要会包含以下几个项目:

这里有关于Cloud的服务知识将不在累赘;我们所要关注的是Zuul路由;在框架服务启动起来的时候.‘

Zuul路由器首先要在里面配置一个路由指向Wechat服务端;

服务端其他API服务端口配置无异;

备注:(微信服务器访问我们的时候.必须要是80端口;请注意:80端口可以使用ngrok来设置定向转向我们本地服务;ngrok服务推荐下载地址:/该站长是我朋友;假设服务器不稳定的情况下可以联系我.一般来说,该服务是非常稳定的.)

建立maven项目:在pom.xml文件中加入

加入wechat组件;

1:写入Controller.继承WechatMsgController;实现一个方法来作为路由器微信传递的总入口.我的方法我写的方法Mapping命名为index:因为在拦截器中会拦截index的请求;来做为微信总入口.这里特别注意:URL跳转的问题;首先微信过来的请求一定会经过路由器;再由路由器转发过来.此时转发过来的路径已经改变.不在是页面请求过来的链接.请务必注意这一点;

2:注入接口实现类到Controller子类中;

该子类要实现一个接口:IwechatService;

该接口的是实现微信应答后跳转的方法;没一个微信应答有独立的一个方法.当中要注意的是render回应应答;因为考虑到公司一直使用jfinal就此使用jfinal的render基类来实现应答.本文档中介绍一种简单应答原理:在微信请求我们服务器后我们服务器会转成相对应方法;跳入方法中.在super.index()方法中.传递据实现类中实现类必须要返回一个render或者是render的子类出来.在index方法中会再次注入request与response去初始化整个类需要的请求数据.进行响应微信服务器从而完成交互

一定要将子类注入到父类中;一定要调用父类index方法进行微信请求的转发;

3:写拦截器栈

WeChatConfigurer要注入wec