Spring Boot 开发微信公众号

速读摘要文章源自JAVA秀-https://www.javaxiu.com/4114.html

订阅号和服务号每月推送消息次数不同，订阅号每天可以推送一次，服务号每月可以推送四次。置为星标后公众号会显示在所有订阅号的最顶部，同时收到消息后会有黄色五角星星标提醒。/这里需要调用微信提供的素材接口，将图片上传至素材库。也许不是最好的选择，如果想试着开发微信公众号，可以在github上找一下开发包。文章源自JAVA秀-https://www.javaxiu.com/4114.html

原文约 2512 字 | 图片 11 张 | 建议阅读 6 分钟 | 评价反馈文章源自JAVA秀-https://www.javaxiu.com/4114.html

Spring Boot 开发微信公众号

程序IT圈 文章源自JAVA秀-https://www.javaxiu.com/4114.html

以下文章来源于Java旅途，作者周明尧文章源自JAVA秀-https://www.javaxiu.com/4114.html

文章源自JAVA秀-https://www.javaxiu.com/4114.html

文章源自JAVA秀-https://www.javaxiu.com/4114.html

Java旅途文章源自JAVA秀-https://www.javaxiu.com/4114.html

『Java旅途』专注于Java技术分享，包含但不局限于Spring Boot、Spring Cloud、消息队列、redis、JVM、Mysql、面经等，欢迎关注，一起学习、一起成长！文章源自JAVA秀-https://www.javaxiu.com/4114.html

文章源自JAVA秀-https://www.javaxiu.com/4114.html

点击上方蓝色“程序IT圈”，选择“设为星标”回复“666”获取独家整理的学习资料！

在讲微信公众号开发之前，先来大概了解一下微信公众号。微信公众号大体上可以分为服务号和订阅号，订阅号和服务号的区别如下：文章源自JAVA秀-https://www.javaxiu.com/4114.html

1. 服务号可以申请微信支付功能。文章源自JAVA秀-https://www.javaxiu.com/4114.html

2. 服务号只能由企业申请，订阅号可以由企业或个人申请。文章源自JAVA秀-https://www.javaxiu.com/4114.html

3. 订阅号和服务号每月推送消息次数不同，订阅号每天可以推送一次，服务号每月可以推送四次。文章源自JAVA秀-https://www.javaxiu.com/4114.html

4. 服务号推送的消息会出现在用户的聊天列表中，而订阅号推送的消息显示在订阅号文件夹中。文章源自JAVA秀-https://www.javaxiu.com/4114.html

5. 还有一些其他接口功能的区别和限制，总的来说服务号支持更高级的功能开发。文章源自JAVA秀-https://www.javaxiu.com/4114.html

订阅号更加偏向于向用户传递咨询，一般各种技术类公众号都属于订阅号，订阅号的消息推送并不会有太显眼的提醒，如果你想让某个公众号的推送内容更加显眼，可以选择将公众号置为星标。置为星标后公众号会显示在所有订阅号的最顶部，同时收到消息后会有黄色五角星星标提醒。文章源自JAVA秀-https://www.javaxiu.com/4114.html

一 公众号配置服务器文章源自JAVA秀-https://www.javaxiu.com/4114.html

微信官方提供了非常完善的接入文档，如果想了解文档的具体内容，直接浏览器搜索微信开发文档就可以了。但是为了方便开发，一般不会直接去根据微信开发文档进行开发，github上有许多开源项目对微信开发文档进行了封装，这里我使用mica-weixin开发包进行演示，mica-weixin是jfinal-weixin的boot版本。文章源自JAVA秀-https://www.javaxiu.com/4114.html

配置服务器信息很简单，具体流程就是微信服务发送请求一个请求给业务服务器，业务服务器验证请求后给微信服务一个响应。文章源自JAVA秀-https://www.javaxiu.com/4114.html

1.1 搭建业务服务

本地搭建一个spring-boot-weixin的项目，使用内网穿透工具进行穿透，使其可以与外网进行通信。文章源自JAVA秀-https://www.javaxiu.com/4114.html

1.1.1 引入mica-weixin依赖

<dependency>    <groupId>net.dreamlu</groupId>    <artifactId>mica-weixin</artifactId>    <version>2.0.1</version></dependency>

1.1.2 配置公众号信息

mica-weixin通过配置文件进行公众号信息的配置，如果你想通过数据库配置公众号信息，可以参考我以前写过的一篇文章jfinal-weixin自定义配置支持多公众号。文章源自JAVA秀-https://www.javaxiu.com/4114.html

dream:  weixin:    wx-configs:    - appId: xxxxxx      appSecret: xxxxxx      token: javatrip      encodingAesKey: xxxxxx

appId和appSecret可在公众号后台进行查看，具体位置在菜单开发—>基本配置中，其中appSecret要妥善保管，现在公众号已经不支持查看appSecret了，如果你忘了appSecret，只能进行重置。文章源自JAVA秀-https://www.javaxiu.com/4114.html

1.1.3 开发消息校验接口

mica-weixin已经为我们提供好了消息校验接口，只需要继承DreamMsgControllerAdapter就可以了。文章源自JAVA秀-https://www.javaxiu.com/4114.html

@WxMsgController("/weixin/wx")public class WeiXinMsgController extends DreamMsgControllerAdapter {    @Override    protected void processInFollowEvent(InFollowEvent inFollowEvent) {    }    @Override    protected void processInTextMsg(InTextMsg inTextMsg) {    }    @Override    protected void processInMenuEvent(InMenuEvent inMenuEvent) {    }}

同时，需要开启缓存，由于mica-weixin的将access_token等信息放在了缓存中。在启动类上加@EnableCaching就开启了。文章源自JAVA秀-https://www.javaxiu.com/4114.html

@SpringBootApplication@EnableCachingpublic class WeixinApplication {    public static void main(String[] args) {        SpringApplication.run(WeixinApplication.class, args);    }}

1.1.4 公众号后台配置服务器信息文章源自JAVA秀-https://www.javaxiu.com/4114.html

使用内网穿透工具穿透内网地址，然后在公众号后台菜单开发—>基本配置中填写服务器配置信息。文章源自JAVA秀-https://www.javaxiu.com/4114.html

文章源自JAVA秀-https://www.javaxiu.com/4114.html

填写完成后点击启用，这样就完成了微信服务器和业务服务器的关系配置。开启开发者配置后，自动回复、自定义菜单等功能都不能正常使用了。这时候就需要去调用对应的接口实现这些功能。文章源自JAVA秀-https://www.javaxiu.com/4114.html

二 实现各种消息接口文章源自JAVA秀-https://www.javaxiu.com/4114.html

2.1 关注消息

在一步中，自定义类WeiXinMsgController中需要重写三个父类中的方法，其中processInFollowEvent()就是关注和取消关注的方法，取消关注后用户虽然不能收到消息，但是后台可以接收到用户取消关注的事件。文章源自JAVA秀-https://www.javaxiu.com/4114.html

@Overrideprotected void processInFollowEvent(InFollowEvent inFollowEvent) {    OutTextMsg defaultMsg = new OutTextMsg(inFollowEvent);    // 关注    if(InFollowEvent.EVENT_INFOLLOW_SUBSCRIBE.equals(inFollowEvent.getEvent())){        // 可将关注用户录入db，此处可以获取到用户openid        String openId = inFollowEvent.getFromUserName();        // 查询db，根据响应消息类型封装消息体        if("文本消息"){            OutTextMsg otm = new OutTextMsg(inFollowEvent);            otm.setContent("消息内容");            render(otm);            return;        }else if("图片消息"){            OutImageMsg oim = new OutImageMsg(inFollowEvent);            // 这里需要调用微信提供的素材接口，将图片上传至素材库。            oim.setMediaId("图片素材id");            render(oim);            return;        }else if("图文消息"){            OutNewsMsg onm = new OutNewsMsg(inFollowEvent);            onm.addNews("标题","简介","图片地址","图文链接");            render(onm);            return;        }else if("视频消息"){            OutVideoMsg ovm = new OutVideoMsg(inFollowEvent);            ovm.setTitle("标题");            ovm.setDescription("简介");            ovm.setMediaId("视频素材id");            render(ovm);            return;        }else{            defaultMsg.setContent("感谢关注");        }    }    // 取消关注    if(InFollowEvent.EVENT_INFOLLOW_UNSUBSCRIBE.equals(inFollowEvent.getEvent())){        log.info("用户取消关注了");        // 此处可以将取消关注的用户更新db    }}

2.2 关键词消息文章源自JAVA秀-https://www.javaxiu.com/4114.html

响应内容跟关注消息一样，查询db去匹配关键词，然会根据消息内容封装对应的消息体进行返回，如果没匹配到关键词则回复统一的消息内容。processInTextMsg()方法就是用来回复关键词消息的。文章源自JAVA秀-https://www.javaxiu.com/4114.html

@Overrideprotected void processInTextMsg(InTextMsg inTextMsg) {    String content = inTextMsg.getContent();    // 根据用户发送的content去查询db中的响应内容    if("文本消息"){        OutTextMsg otm = new OutTextMsg(inTextMsg);        otm.setContent("消息内容");        render(otm);        return;    }else if("图片消息"){        OutImageMsg oim = new OutImageMsg(inTextMsg);        // 这里需要调用微信提供的素材接口，将图片上传至素材库。        oim.setMediaId("图片素材id");        render(oim);        return;    }else if("图文消息"){        OutNewsMsg onm = new OutNewsMsg(inTextMsg);        onm.addNews("标题","简介","图片地址","图文链接");        render(onm);        return;    }else if("视频消息"){        OutVideoMsg ovm = new OutVideoMsg(inTextMsg);        ovm.setTitle("标题");        ovm.setDescription("简介");        ovm.setMediaId("视频素材id");        render(ovm);        return;    }else{        OutTextMsg otm = new OutTextMsg(inTextMsg);        otm.setContent("暂未查到关键词...");    }}

2.3 菜单消息文章源自JAVA秀-https://www.javaxiu.com/4114.html

点击菜单后也是一样，通过processInMenuEvent()方法进行响应内容的回复。文章源自JAVA秀-https://www.javaxiu.com/4114.html

@Overrideprotected void processInMenuEvent(InMenuEvent inMenuEvent) {    String eventKey = inMenuEvent.getEventKey();    // 根据用户发送的content去查询db中的响应内容    if("文本消息"){        OutTextMsg otm = new OutTextMsg(inMenuEvent);        otm.setContent("消息内容");        render(otm);        return;    }else if("图片消息"){        OutImageMsg oim = new OutImageMsg(inMenuEvent);        // 这里需要调用微信提供的素材接口，将图片上传至素材库。        oim.setMediaId("图片素材id");        render(oim);        return;    }else if("图文消息"){        OutNewsMsg onm = new OutNewsMsg(inMenuEvent);        onm.addNews("标题","简介","图片地址","图文链接");        render(onm);        return;    }else if("视频消息"){        OutVideoMsg ovm = new OutVideoMsg(inMenuEvent);        ovm.setTitle("标题");        ovm.setDescription("简介");        ovm.setMediaId("视频素材id");        render(ovm);        return;    }else{        OutTextMsg otm = new OutTextMsg(inMenuEvent);        otm.setContent("无效链接，请重试...");    }}

三 接口API调用文章源自JAVA秀-https://www.javaxiu.com/4114.html

目前，微信提供的接口对订阅号的限制比较大，未认证的订阅号基本上只有接收消息的几个功能接口。文章源自JAVA秀-https://www.javaxiu.com/4114.html

调用接口的时候需要传递token，获取token需要在微信后台中配置业务服务器的白名单。如下：文章源自JAVA秀-https://www.javaxiu.com/4114.html

文章源自JAVA秀-https://www.javaxiu.com/4114.html

如果需要配置多个白名单ip，使用回车键将多个ip分隔开。文章源自JAVA秀-https://www.javaxiu.com/4114.html

mica-weixin提供了所有的接口封装，具体可参考它的官方文档，如果要获取微信菜单，可以这样写：文章源自JAVA秀-https://www.javaxiu.com/4114.html

@WxApi("weixin/api")public class WeiXinApiController {    @GetMapping("menu")    @ResponseBody    public String getMenu(){        ApiResult menu = MenuApi.getMenu();        return menu.getJson();    }}

@WxApi这个是它的自定义注解，其实就是包含了@RequestMapping和@Controller。文章源自JAVA秀-https://www.javaxiu.com/4114.html

四 其他事项文章源自JAVA秀-https://www.javaxiu.com/4114.html

4.1 多公众号配置文章源自JAVA秀-https://www.javaxiu.com/4114.html

mica-weixin提供了多公众号配置的功能，使用ThreadLocal和appid进行绑定。只需要简单配置即可实现多公众号配置。文章源自JAVA秀-https://www.javaxiu.com/4114.html

dream:  weixin:    wx-configs:      - appId: xxxxxx        appSecret: xxxxxx        token: javatrip        encodingAesKey: xxxxxx      - appId: xxxxxx        appSecret: xxxxxx        token: javatrip        encodingAesKey: xxxxxx

4.2 redis配置文章源自JAVA秀-https://www.javaxiu.com/4114.html

access_token的有效期是2小时，并且该接口有调用次数限制，mica-weixin将access_token存储在redis中，避免每次调用接口都去获取access-token，因此项目需要配置redis。文章源自JAVA秀-https://www.javaxiu.com/4114.html

spring:  redis:    host: localhost    port: 6379

4.3 手动选择ThreadLocal文章源自JAVA秀-https://www.javaxiu.com/4114.html

如果想要开发微信公众号的后台管理功能，多公众号的时候就需要手动去指定当前线程使用哪个公众号信息。如下：文章源自JAVA秀-https://www.javaxiu.com/4114.html

ApiConfigKit.setThreadLocalAppId(appid);

至此，SpringBoot开发微信公众号就算完成了，由于订阅号开放的接口太少了，好多功能不能正常演示。还有mica-weixin也许不是最好的选择，如果想试着开发微信公众号，可以在github上找一下开发包。至于我为什么会使用mica-weixin，是因为我曾用过一段时间的jfinal框架，与之配套的微信开发包就是jfinal-weixin，也就是jfinal版的mica-weixin。文章源自JAVA秀-https://www.javaxiu.com/4114.html

关于算法刷题的困惑和疑问也经常听朋友们提及。这份笔记里面共包含作者刷LeetCode算法题后整理的数百道题，每道题均附有详细题解过程。很多人表示刷数据结构和算法题效率不高，甚是痛苦。有了这个笔记的总结，对校招和社招的算法刷题帮助之大不言而喻，果断收藏了。需要刷题笔记PDF文档的小伙伴可以直接长按扫码关注下方二维码，回复 「算法」 四个字自取：关注下方公众号???回复关键字「算法」，即可下载