JAVA微信公众号开发 | 第一篇: 前期准备及实现自动回复(附源码)
本系列文章是记录自己微信公众号的开发过程，也希望能为感兴趣的其他人提供一些思路和帮助
欢迎转发，转发请在文前明显位置，注明本文地址
项目源码放到文末，需要自取
最终效果
前言
有一个特别坑的地方，需要提前说一下 个人订阅号 现在已经没有接口开发自定义菜单的权限了。
也就是说只能通过微信账号后台自定义菜单，而不能通过接口开发自定义菜单。
但是接口开发和后台自定义两者互斥
要想接口开发自定义菜单，就必须是认证公众号，但是
wt fk
鸡你太美 诶，，， 鸡你太美**
但是服务号申请也不难
虽然有这么多限制，我还是想去尝试一下，兴趣大于一切
1.申请公众号
- 登录地址：https://mp.weixin.qq.com/，注册-选择类型，
- 对类型不清楚的点击链接，账号类型区别http://kf.qq.com/faq/170815aUZjeQ170815mU7bI7.html
- 公众号申请流程：http://kf.qq.com/product/weixinmp.html#hid=99
申请服务号 还是比较麻烦的 但是服务号是直接展示在好友消息列表中 而订阅号是展示在订阅号消息
2.云服务器或者其他外网映射工具
我用的是腾讯云。其他外网映射工具在这里就不说了，搜一下很多
3.接口配置
进入配置页面：基本配置 > 修改配置
- URL：中的IP地址，如果是腾讯云则可以在云服务器界面找自己的公网IP地址
- Token ：可以自己随意填，但是要和后面服务器的保持一致
点击提交>确定
之后微信会自动向你的服务器发送GET请求并验证你的服务器，因此我们需要完成了对GET请求的处理(后面有代码讲解，先不用点确定)
4.验证消息的确来自微信服务器
开发者提交信息后，微信服务器将发送GET请求到填写的服务器地址URL上，GET请求携带参数如下表所示：
参数 描述 signature 微信加密签名，signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数 timestamp 时间戳 nonce 随机数 echostr 随机字符串
开发者通过检验signature对请求进行校验（下面有校验方式）。若确认此次GET请求来自微信服务器，请原样返回echostr参数内容，则> 接入生效，成为开发者成功，否则接入失败。
加密/校验流程如下：
1）将token、timestamp、nonce三个参数进行字典序排序
2）将三个参数字符串拼接成一个字符串进行sha1加密
3）开发者获得加密后的字符串可与signature对比，标识该请求来源于微信
以上是来源 微信文档，写的很清楚了，撸代码。
/**
* 处理微信服务器发来的get请求，进行签名的验证
* signature 微信端发来的签名 * timestamp 微信端发来的时间戳
* nonce 微信端发来的随机字符串
* echostr 微信端发来的验证字符串
*/
@GetMapping(value = "wechat")
public String validate(@RequestParam(value = "signature") String signature,
@RequestParam(value = "timestamp") String timestamp,
@RequestParam(value = "nonce") String nonce,
@RequestParam(value = "echostr") String echostr) {
return WeChatUtil.checkSignature(signature, timestamp, nonce) ? echostr : null;
}public static boolean checkSignature(String signature, String timestamp, String nonce) {
String[] arr = new String[] { WeChatContant.TOKEN, timestamp, nonce };
// 将token、timestamp、nonce三个参数进行字典序排序
sort(arr);
StringBuilder content = new StringBuilder();
for (int i = 0; i < arr.length; i++) {
content.append(arr[i]);
}
MessageDigest md = null;
String tmpStr = null;
try {
md = MessageDigest.getInstance("SHA-1");
// 将三个参数字符串拼接成一个字符串进行sha1加密
byte[] digest = md.digest(content.toString().getBytes());
tmpStr = byteToStr(digest);
} catch (NoSuchAlgorithmException e) {
e.printStackTrace();
}
content = null;
// 将sha1加密后的字符串可与signature对比，标识该请求来源于微信
return tmpStr != null ? tmpStr.equals(signature.toUpperCase()) : false;
}String[] arr = new String[] { WeChatContant.TOKEN, timestamp, nonce };
此处的WeChatContant.TOKEN是个常量 public static final String TOKEN = "lhx";
必须和上文基本配置中的 此处随便写 保持一致
完成之后 把项目打个JAR包 扔到服务器上面(别忘安装jdk，安装方法百度搜一下)
此处用到的工具软件：Xshell 6 和 Xftp 6
工具软件放到文末，需要自取
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<executions>
<execution>
<configuration>
<!--此处填写boot启动类-->
<mainClass>com.lhx.wechat.WechatApplication</mainClass>
</configuration>
<goals>
<goal>repackage</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>项目源码中添加了maven打包插件 可以直接maven clen package -> 可运行的jar包
项目源码放到文末，需要自取
然后再回到 配置页面：基本配置 > 修改配置 > 提交 >确定 网页顶端会显示提交成功
5.接收普通消息
当普通微信用户向公众账号发消息时，微信服务器将POST消息的XML数据包到开发者填写的URL上。
请注意：
1、关于重试的消息排重，推荐使用msgid排重。
2、微信服务器在五秒内收不到响应会断掉连接，并且重新发起请求，总共重试三次。假如服务器无法保证在五秒内处理并回复，可以直接 回复空串，微信服务器不会对此作任何处理，并且不会发起重试。详情请见“发送消息-被动回复消息”。
3、如果开发者需要对用户消息在5秒内立即做出回应，即使用“发送消息-被动回复消息”接口向用户被动回复消息时，可以在公众平台官网的开发者中心处设置消息加密。开启加密后，用户发来的消息和开发者回复的消息都会被加密（但开发者通过客服接口等API调用形式向用户发送消息，则不受影响）。关于消息加解密的详细说明，请见“发送消息-被动回复消息加解密说明”。各消息类型的推送XML数据包结构如下：
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1348831860</CreateTime>
<MsgType><![CDATA[text]]></MsgType>
<Content><![CDATA[this is a test]]></Content>
<MsgId>1234567890123456</MsgId>
</xml>
参数 描述 ToUserName 开发者微信号 FromUserName 发送方帐号（一个OpenID） CreateTime 消息创建时间 （整型） MsgType 消息类型，文本为text Content 文本消息内容 MsgId 消息id，64位整型
文末有源码
6.回复普通消息
当用户发送消息给公众号时（或某些特定的用户操作引发的事件推送时），会产生一个POST请求，开发者可以在响应包（Get）中返回特> 定XML结构，来对该消息进行响应（现支持回复文本、图片、图文、语音、视频、音乐）。严格来说，发送被动响应消息其实并不是一种> 接口，而是对微信服务器发过来消息的一次回复。需要的XML数据包结构如下：
回复文本消息
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>12345678</CreateTime>
<MsgType><![CDATA[text]]></MsgType>
<Content><![CDATA[你好]]></Content>
</xml>
参数 是否必须 描述 ToUserName 是 接收方帐号（收到的OpenID） FromUserName 是 开发者微信号 CreateTime 是 消息创建时间 （整型） MsgType 是 消息类型，文本为text Content 是 回复的消息内容（换行：在content中能够换行，微信客户端就支持换行显示） 文末有源码
完整代码
@PostMapping(value = "wechat")
public String textMessge(HttpServletRequest request) {
logger.info("wechat");
return javaMessageService.textMessage(request);
}@Service
public class JavaMessageServiceImpl implements JavaMessageService {
private static final Logger logger = LoggerFactory.getLogger(JavaMessageServiceImpl.class);
@Override
public String textMessage(HttpServletRequest request) {
logger.info("进来了");
// xml格式的消息数据
String respXml = null;
// 默认返回的文本消息内容
String respContent;
try {
// 调用parseXml方法解析请求消息
Map<String,String> requestMap = WeChatUtil.parseXml(request);
// 消息类型
String msgType = requestMap.get(WeChatContant.MsgType);
String mes = null;
// 文本消息
if (msgType.equals(WeChatContant.REQ_MESSAGE_TYPE_TEXT)) {
mes =requestMap.get(WeChatContant.Content);
if(mes != null){
String content = checkResources(mes);
if(!StringUtils.isBlank(content)) {
return WeChatUtil.sendTextMsg(requestMap, content);
}
}
}
// 图片消息
// ......
mes = mes == null ? "在吗" : mes;
return WeChatUtil.sendTextMsg(requestMap, mes);
} catch (DocumentException e) {
return null;
} catch (Exception e) {
e.printStackTrace();
return null;
}
return null;
}
private String checkResources(String message){
String returnMessage = null;
if("加油".equals(message)){
returnMessage = "你也是";
return returnMessage;
}
if("我爱你".equals(message)){
returnMessage = "一见面就说爱?";
return returnMessage;
}
return null;
}
}测试可以用postman 进行测试
项目源码和本文用到的所有工具我已经打包好放在了微信公众号中> "爪哇之父兄弟"，
关注后，回复"公众号源码"，即可获取
如果你对本文有不对的地方或者遇到难题了 欢迎评论或者扫码进群 一起讨论 免费帮助
如果本文对你有帮助，请小编喝咖啡啊
| 公众号 爪哇之父兄弟 | 微信 | 支付宝 | q群 |
|---|---|---|---|
 |
 |
 |
 |