淘东电商项目（14） -公众号获取注册码功能

引言

在上一节《淘东电商项目（13） -项目整合WxJava》，主要讲解如何把WxJava框架整合到我们的电商项目，并完成了“鹦鹉学舌”的功能。

代码已提交至Github（版本号：ce86c77b326b8f0a7cc9504b989346aa5a293496），有兴趣的同学可以下载来看看：https://github.com/ylw-github/taodong-shop

本文主要实现「注册码功能」。在公众号里输入手机号码获取注册码的功能，验证注册码的功能。

本文目录结构：
l____引言
l____ 1. 开发前准备
l________ 1.1 注册码功能开发思路
l________ 1.2 Redis服务器搭建
l________ 1.3 开发前项目结构整理
l____ 2.注册功能开发
l________ 2.1 注册码功能开发
l____________ 2.1.1 Redis封装
l____________ 2.1.2 正则表达式工具类
l____________ 2.1.3 MsgHandler注册码处理
l________ 2.2 验证注册码
l____ 3.测试
l________ 3.1 获取注册码
l________ 3.2 校验注册码
l____总结

1.开发前准备

1.1 注册码功能开发思路

本文的开发流程主要如下：

1.2 Redis服务器搭建

之前在《分布式系列教程》里讲过Redis的安装教程，本文不再具体详述，大家可以参考：

「单机版」：《分布式系列教程（02） -分布式Redis缓存(简介&安装&基础)》
「集群」：《分布式系列教程（06） -分布式Redis缓存 (集群)》

本文不复杂化，使用单个Redis服务器。

redis服务器地址：192.168.162.136

命令：

## 启动命令
/usr/local/redis/bin/redis-server /usr/local/redis/etc/redis.conf ## 停止命令
/usr/local/redis/bin/redis-cli -h 127.0.0.1 -p 6379 -a "123"  shutdown## 连接Redis客户端
/usr/local/redis/bin/redis-cli -h 127.0.0.1 -p 6379 -a "123"

使用Medis连接，下面是连接成功的界面（如果不知道如何使用Medis可以参考我的博客《Mac下安装与使用Medis》）：

1.3 开发前项目结构整理

目前项目结构是这样的：

其实项目结构还可以优化的，有两点：

将服务接口层的实体类抽出到一个模块，专门用来管理实体类。
统一规定微服务接口状态码

整理后的结构如下：

BaseResponse代码如下：

import lombok.Data;/*** description: 微服务接口封装,T为返回接口data的数据类型* create by: YangLinWei* create time: 2020/2/20 11:49 上午*/
@Data
public class BaseResponse<T> {private Integer rtnCode;private String msg;private T data;public BaseResponse() {}public BaseResponse(Integer rtnCode, String msg, T data) {super();this.rtnCode = rtnCode;this.msg = msg;this.data = data;}}

BaseApiService代码如下：

/*** description: 统一返回code信息* create by: YangLinWei* create time: 2020/2/20 11:48 上午*/
@Data
@Component
public class BaseApiService<T> {public BaseResponse<T> setResultError(Integer code, String msg) {return setResult(code, msg, null);}// 返回错误，可以传msgpublic BaseResponse<T> setResultError(String msg) {return setResult(Constants.HTTP_RES_CODE_500, msg, null);}// 返回成功，可以传data值public BaseResponse<T> setResultSuccess(Object data) {return setResult(Constants.HTTP_RES_CODE_200, Constants.HTTP_RES_CODE_200_VALUE, data);}// 返回成功，沒有data值public BaseResponse<T> setResultSuccess() {return setResult(Constants.HTTP_RES_CODE_200, Constants.HTTP_RES_CODE_200_VALUE, null);}// 返回成功，沒有data值public BaseResponse<T> setResultSuccess(String msg) {return setResult(Constants.HTTP_RES_CODE_200, msg, null);}// 通用封装public BaseResponse<T> setResult(Integer code, String msg, Object data) {return new BaseResponse(code, msg, data);}}

2.注册功能开发

在上一节《淘东电商项目（13） -项目整合WxJava》，已经WxJava框架整合到我们的电商项目，并在MsgHandler类里面处理收到的信息，完成了“鹦鹉学舌”的功能，下面开始讲解如何实现注册码功能。

2.1 注册码功能开发

2.1.1 Redis封装

1.添加maven依赖（taodong-shop-common-core模块里添加）：

<!-- 集成redis -->
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>

2.在业务模块（taodong-shop-service-weixin）配置redis（也可以配置到Apollo配置中心）：

###服务名称(服务注册到eureka名称)
spring:application:name: taodong-shop-service-weixinredis:host: 192.168.162.136port: 6379jedis:pool:max-idle: 100min-idle: 1max-active: 1000max-wait: -1
### 公众号默认回复消息
taodong:weixin:registration:code:###微信注册码消息message:  您的注册码为:%s###默认提示消息default:registration:code:message: 我们已经收到您的消息,将有客服会及时回复您的!

3.定义RedisUtil工具类（taodong-shop-common-core模块里添加）：

/*** description: Redis工具类* create by: YangLinWei* create time: 2020/2/20 1:57 下午*/
@Component
public class RedisUtil {@Autowiredprivate StringRedisTemplate stringRedisTemplate;/*** 存放string类型* * @param key*            key* @param data*            数据* @param timeout*            超时间*/public void setString(String key, String data, Long timeout) {stringRedisTemplate.opsForValue().set(key, data);if (timeout != null) {stringRedisTemplate.expire(key, timeout, TimeUnit.SECONDS);}}/*** 存放string类型* * @param key*            key* @param data*            数据*/public void setString(String key, String data) {setString(key, data, null);}/*** 根据key查询string类型* * @param key* @return*/public String getString(String key) {String value = stringRedisTemplate.opsForValue().get(key);return value;}/*** 根据对应的key删除key* * @param key*/public void delKey(String key) {stringRedisTemplate.delete(key);}
}

2.1.2 正则表达式工具类

定义RegexUtil工具类（taodong-shop-common-core模块里添加）：

/*** description: 正则表达式工具类* create by: YangLinWei* create time: 2020/2/20 1:56 下午*/
public class RegexUtils {/*** 验证Email** @param email email地址，格式：zhangsan@zuidaima.com，zhangsan@xxx.com.cn，*              xxx代表邮件服务商* @return 验证成功返回true，验证失败返回false*/public static boolean checkEmail(String email) {String regex = "\\w+@\\w+\\.[a-z]+(\\.[a-z]+)?";return Pattern.matches(regex, email);}/*** 验证身份证号码** @param idCard 居民身份证号码15位或18位，最后一位可能是数字或字母* @return 验证成功返回true，验证失败返回false*/public static boolean checkIdCard(String idCard) {String regex = "[1-9]\\d{13,16}[a-zA-Z0-9]{1}";return Pattern.matches(regex, idCard);}/*** 验证手机号码（支持国际格式，+86135xxxx...（中国内地），+00852137xxxx...（中国香港））** @param mobile 移动、联通、电信运营商的号码段*               <p>*               移动的号段：134(0-8)、135、136、137、138、139、147（预计用于TD上网卡）*               、150、151、152、157（TD专用）、158、159、187（未启用）、188（TD专用） 177 170 166*               开头*               </p>*               <p>*               联通的号段：130、131、132、155、156（世界风专用）、185（未启用）、186（3g）*               </p>*               <p>*               电信的号段：133、153、180（未启用）、189*               </p>* @return 验证成功返回true，验证失败返回false*/public static boolean checkMobile(String mobile) {String regex = "^(13[0-9]|14[579]|15[0-3,5-9]|16[6]|17[0135678]|18[0-9]|19[89])\\d{8}$";return Pattern.matches(regex, mobile);}/*** 验证固定电话号码** @param phone 电话号码，格式：国家（地区）电话代码 + 区号（城市代码） + 电话号码，如：+8602085588447*              <p>*              <b>国家（地区） 代码 ：</b>标识电话号码的国家（地区）的标准国家（地区）代码。它包含从 0 到 9*              的一位或多位数字， 数字之后是空格分隔的国家（地区）代码。*              </p>*              <p>*              <b>区号（城市代码）：</b>这可能包含一个或多个从 0 到 9 的数字，地区或城市代码放在圆括号——*              对不使用地区或城市代码的国家（地区），则省略该组件。*              </p>*              <p>*              <b>电话号码：</b>这包含从 0 到 9 的一个或多个数字*              </p>* @return 验证成功返回true，验证失败返回false*/public static boolean checkPhone(String phone) {String regex = "(\\+\\d+)?(\\d{3,4}\\-?)?\\d{7,8}$";return Pattern.matches(regex, phone);}/*** 验证整数（正整数和负整数）** @param digit 一位或多位0-9之间的整数* @return 验证成功返回true，验证失败返回false*/public static boolean checkDigit(String digit) {String regex = "\\-?[1-9]\\d+";return Pattern.matches(regex, digit);}/*** 验证整数和浮点数（正负整数和正负浮点数）** @param decimals 一位或多位0-9之间的浮点数，如：1.23，233.30* @return 验证成功返回true，验证失败返回false*/public static boolean checkDecimals(String decimals) {String regex = "\\-?[1-9]\\d+(\\.\\d+)?";return Pattern.matches(regex, decimals);}/*** 验证空白字符** @param blankSpace 空白字符，包括：空格、\t、\n、\r、\f、\x0B* @return 验证成功返回true，验证失败返回false*/public static boolean checkBlankSpace(String blankSpace) {String regex = "\\s+";return Pattern.matches(regex, blankSpace);}/*** 验证中文** @param chinese 中文字符* @return 验证成功返回true，验证失败返回false*/public static boolean checkChinese(String chinese) {String regex = "^[\u4E00-\u9FA5]+$";return Pattern.matches(regex, chinese);}/*** 验证日期（年月日）** @param birthday 日期，格式：1992-09-03，或1992.09.03* @return 验证成功返回true，验证失败返回false*/public static boolean checkBirthday(String birthday) {String regex = "[1-9]{4}([-./])\\d{1,2}\\1\\d{1,2}";return Pattern.matches(regex, birthday);}/*** 验证URL地址** @param url 格式：http://blog.csdn.net:80/xyang81/article/details/7705960? 或*            http://www.csdn.net:80* @return 验证成功返回true，验证失败返回false*/public static boolean checkURL(String url) {String regex = "(https?://(w{3}\\.)?)?\\w+\\.\\w+(\\.[a-zA-Z]+)*(:\\d{1,5})?(/\\w*)*(\\??(.+=.*)?(&.+=.*)?)?";return Pattern.matches(regex, url);}/*** <pre>* 获取网址 URL 的一级域* </pre>** @param url* @return*/public static String getDomain(String url) {Pattern p = Pattern.compile("(?<=http://|\\.)[^.]*?\\.(com|cn|net|org|biz|info|cc|tv)",Pattern.CASE_INSENSITIVE);// 获取完整的域名// Pattern// p=Pattern.compile("[^//]*?\\.(com|cn|net|org|biz|info|cc|tv)",// Pattern.CASE_INSENSITIVE);Matcher matcher = p.matcher(url);matcher.find();return matcher.group();}/*** 匹配中国邮政编码** @param postcode 邮政编码* @return 验证成功返回true，验证失败返回false*/public static boolean checkPostcode(String postcode) {String regex = "[1-9]\\d{5}";return Pattern.matches(regex, postcode);}/*** 匹配IP地址(简单匹配，格式，如：192.168.1.1，127.0.0.1，没有匹配IP段的大小)** @param ipAddress IPv4标准地址* @return 验证成功返回true，验证失败返回false*/public static boolean checkIpAddress(String ipAddress) {String regex = "[1-9](\\d{1,2})?\\.(0|([1-9](\\d{1,2})?))\\.(0|([1-9](\\d{1,2})?))\\.(0|([1-9](\\d{1,2})?))";return Pattern.matches(regex, ipAddress);}}

2.1.3 MsgHandler验证码处理

1.在服务模块（taodong-shop-service）添加Maven依赖:

<dependency><groupId>com.ylw.taodong</groupId><artifactId>taodong-shop-common-core</artifactId><version>1.0-SNAPSHOT</version>
</dependency>

2.MsgHandler生成验证码，并把验证码保存到Redis服务器，完整代码如下：

@Component
public class MsgHandler extends AbstractHandler {/*** 发送验证码消息*/@Value("${taodong.weixin.registration.code.message}")private String registrationCodeMessage;/*** 默认回复消息*/@Value("${taodong.weixin.default.registration.code.message}")private String defaultRegistrationCodeMessage;@Autowiredprivate RedisUtil redisUtil;@Overridepublic WxMpXmlOutMessage handle(WxMpXmlMessage wxMessage,Map<String, Object> context, WxMpService weixinService,WxSessionManager sessionManager) {if (!wxMessage.getMsgType().equals(XmlMsgType.EVENT)) {// TODO 可以选择将消息保存到本地}// 当用户输入关键词如“你好”，“客服”等，并且有客服在线时，把消息转发给在线客服try {if (StringUtils.startsWithAny(wxMessage.getContent(), "你好", "客服")&& weixinService.getKefuService().kfOnlineList().getKfOnlineList().size() > 0) {return WxMpXmlOutMessage.TRANSFER_CUSTOMER_SERVICE().fromUser(wxMessage.getToUser()).toUser(wxMessage.getFromUser()).build();}} catch (WxErrorException e) {e.printStackTrace();}// 1.获取客户端发送的消息String fromContent = wxMessage.getContent();// 2.如果客户端发送消息为手机号码，则发送验证码if (RegexUtils.checkMobile(fromContent)) {// 3.生成随机四位注册码int registCode = registCode();String content = String.format(registrationCodeMessage, registCode);// 4.将验证码存放在Redis中redisUtil.setString(Constants.WEIXINCODE_KEY + fromContent, registCode + "", Constants.WEIXINCODE_TIMEOUT);return new TextBuilder().build(content, wxMessage, weixinService);}return new TextBuilder().build(defaultRegistrationCodeMessage, wxMessage, weixinService);}// 获取注册码private int registCode() {int registCode = (int) (Math.random() * 9000 + 1000);return registCode;}}

2.2 验证注册码

1.定义验证接口（微信服务接口层taodong-shop-service-api-weixin）：

/*** description: 微信验证服务接口* create by: YangLinWei* create time: 2020/2/20 2:22 下午*/
@Api(tags = "微信注册码验证码接口")
public interface VerificaCodeService {@ApiOperation(value = "根据手机号码验证码token是否正确")@GetMapping("/verificaWeixinCode")@ApiImplicitParams({// @ApiImplicitParam(paramType="header",name="name",dataType="String",required=true,value="用户的姓名",defaultValue="zhaojigang"),@ApiImplicitParam(paramType = "query", name = "phone", dataType = "String", required = true, value = "用户手机号码"),@ApiImplicitParam(paramType = "query", name = "weixinCode", dataType = "String", required = true, value = "微信注册码") })BaseResponse<JSONObject> verificaWeixinCode(String phone, String weixinCode);
}

2.实现接口（微信业务层taodong-shop-service-weixin）：

@RestController
public class VerificaCodeServiceImpl extends BaseApiService<JSONObject> implements VerificaCodeService {@Autowiredprivate RedisUtil redisUtil;@Overridepublic BaseResponse<JSONObject> verificaWeixinCode(String phone, String weixinCode) {if (StringUtils.isEmpty(phone)) {return setResultError("手机号码不能为空!");}if (StringUtils.isEmpty(weixinCode)) {return setResultError("注册码不能为空!");}String code = redisUtil.getString(Constants.WEIXINCODE_KEY + phone);if (StringUtils.isEmpty(code)) {return setResultError("注册码已经过期,请重新发送验证码");}if (!code.equals(weixinCode)) {return setResultError("注册码不正确");}return setResultSuccess("注册码验证码正确");}}

3.测试

启动微信服务：AppWeiXin

3.1 获取注册码

注意：代码里设置微信注册码超时时间为3分钟！

首先发送手机号，可以看到：

发送错误手机号	发送正确的手机号

3.2 校验注册码

我们在Redis可视化窗口里也可以看到：

浏览器输入：http://127.0.0.1:8200/verificaWeixinCode?phone=18688888888&weixinCode=4208

过了3分钟后，刷新Redis可视化窗口，可以看到没有内容了：

浏览器再次输入：http://127.0.0.1:8200/verificaWeixinCode?phone=18688888888&weixinCode=4208，提示注册码已过期

总结