微信公众号开发之基础框架搭建（基于SpringBoot）

最新推荐文章于 2024-07-24 16:29:50 发布
最新推荐文章于 2024-07-24 16:29:50 发布
阅读量1k 收藏 2
点赞数
分类专栏： # 微信 文章标签： 微信 spring boot 后端 java 微信公众平台
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qifu123/article/details/133775351
版权

文章目录

一、概述

1.1 开发者工具

  • 在开发者工具中可以找到“测试账号、接口调试工具、相关文档”等。
  • 官方地址：https://mp.weixin.qq.com/cgi-bin/frame?t=advanced/dev_tools_frame&nav=10049&token=705684025&lang=zh_CN

1.1 测试账号及接口

  • 测试账号是用于开发时测试的账号，里面可以找到测试 appID、appsecret 和微信支持的接口地址。还有测试二维码，通过扫描测试二维码关注测试账号进行测试。
  • 官方地址：https://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&t=sandbox/index

1.2 接口调试工具

  • 接口调试工具可以用来测试微信公众号支持的接口。
  • 官方地址：https://mp.weixin.qq.com/debug?token=705684025&lang=zh_CN

二、三方依赖

  • 引入微信 JAVA SDK，是微信平台（公众平台、开放平台、商户平台、服务商平台）接口服务的JAVA 实现，开发 严格按照官方技术文档，合理划分包名、定义字段及方法，能胜任任何微信相关的业务。这是一个开源的工具包，开源地址：https://github.com/liyiorg/weixin-popular
<dependency>
    <groupId>com.github.liyiorg</groupId>
    <artifactId>weixin-popular</artifactId>
    <version>2.8.32</version>
</dependency>

三、签名验证控制器

package top.yiqifu.weixin.offiaccount.controller;

import org.apache.commons.lang3.StringUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;
import top.yiqifu.weixin.offiaccount.WeixinConfig;
import weixin.popular.bean.message.EventMessage;
import weixin.popular.bean.xmlmessage.XMLImageMessage;
import weixin.popular.bean.xmlmessage.XMLMessage;
import weixin.popular.bean.xmlmessage.XMLTextMessage;
import weixin.popular.support.ExpireKey;
import weixin.popular.support.TokenManager;
import weixin.popular.support.expirekey.DefaultExpireKey;
import weixin.popular.util.SignatureUtil;
import weixin.popular.util.XMLConverUtil;

import javax.servlet.ServletInputStream;
import javax.servlet.ServletOutputStream;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;
import java.util.Map;

@Controller()
@RequestMapping("/weixin")
public class WeixinController {
    private static ExpireKey expireKey = new DefaultExpireKey();


    @Autowired
    WeixinConfig config;

    @RequestMapping("/signature")
    @ResponseBody
    public void checkSignature(@RequestParam Map<String, String> param ,
                               HttpServletRequest request, HttpServletResponse response){
        // 获取参数
        String signature = param.get("signature");
        String timestamp = param.get("timestamp");
        String nonce = param.get("nonce");
        String echostr = param.get("echostr");
        if (StringUtils.isEmpty(signature) || StringUtils.isEmpty(timestamp)) {
            responseContent(response, "非法请求，关键信息丢失");
            return;
        }
        if (StringUtils.isNotEmpty(echostr)) {
            responseContent(response, echostr);
            return;
        }

        // 验证请求签名
        String token = config.getToken();
        if (!signature.equals(SignatureUtil.generateEventMessageSignature(token, timestamp, nonce))) {
            responseContent(response, "非法请求，签名验证失败");
            return;
        }


        // 消息处理
        try {
            this.messageHandler(request, response);
        } catch (IOException e) {
            e.printStackTrace();
            responseContent(response, "处理消息失败");
        }
    }

    private void messageHandler(HttpServletRequest request, HttpServletResponse response) throws IOException {
        ServletInputStream inputStream = request.getInputStream();
        ServletOutputStream outputStream = response.getOutputStream();
        if (inputStream != null) {
            EventMessage eventMessage = XMLConverUtil.convertToObject(EventMessage.class, inputStream);
            String key = eventMessage.getFromUserName() + "__" + eventMessage.getToUserName() + "__" + eventMessage.getMsgId() + "__" + eventMessage.getCreateTime();

            if (expireKey.exists(key)) {
                // 重复通知不作处理
                //System.err.println("重复通知不作处理");
                responseContent(response, "重复通知不作处理");
                return;
            } else {
                expireKey.add(key);
            }

            //logger.info(TokenManager.getDefaultToken());
            String fromUserName = eventMessage.getFromUserName();
            String toUserName = eventMessage.getToUserName();
            String content = eventMessage.getContent();

            String text = "收到消息"+content+" <a href='https://www.baidu.com/?s="+content+"'>百度一下</a>";
            XMLTextMessage message1 = new XMLTextMessage(fromUserName, toUserName, text);
            this.responseMessage(message1, outputStream);

//            String mediaId = "zYNNuHMhJ0dstBmlXEiBHmo69BZnjFKp6J6MNP8i9ZtLrJFnZKBYE9qEn3Bu2Xp8";
//			XMLImageMessage message2 = new XMLImageMessage(fromUserName, toUserName , mediaId);
//            this.responseMessage(message2, outputStream);

        }
    }
    private void responseMessage(XMLMessage message, ServletOutputStream outputStream){
        message.outputStreamWrite(outputStream);
    }

    private void responseContent(HttpServletResponse response, String message){
        try {
            PrintWriter writer = response.getWriter();
            writer.print(message);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }


    @RequestMapping("test")
    @ResponseBody
    public String test(){
        return "111";
    }
}

四、应用参数配置

  • 在application.yaml中配置微信相关参数
weixin:
  offiaccount:
    appid: wx56b01298d347f42f
    appsecret: 1e6b4ed052c6897f4a4101af8ebb149f
    token: test-weixin-offiaccount
  • 参数读取类
package top.yiqifu.weixin.offiaccount;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;

@Component
public class WeixinConfig {

    @Value("${weixin.offiaccount.appid}")
    private String appID;
    @Value("${weixin.offiaccount.appsecret}")
    private String appsecret;
    @Value("${weixin.offiaccount.token}")
    private String token;


    public String getAppID() {
        return appID;
    }

    public String getAppsecret() {
        return appsecret;
    }

    public String getToken() {
        return token;
    }
}

五、测试公众号配置

  • 配置地址：https://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&t=sandbox/index
    在这里插入图片描述

六、会话保持

6.1 Ticket

package top.yiqifu.weixin.offiaccount.listener;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import top.yiqifu.weixin.offiaccount.config.WeixinConfig;
import weixin.popular.support.TicketManager;

import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;
import javax.servlet.annotation.WebListener;

@Component
@WebListener
public class TicketManagerListener implements ServletContextListener {

    private static final Logger logger = LoggerFactory.getLogger(TicketManagerListener.class);

    @Autowired
    WeixinConfig config;

    @Override
    public void contextInitialized(ServletContextEvent sce) {
        logger.info("------------------TicketManagerListener----contextInitialized---------------");
        TicketManager.init(config.getAppID(), 15, 60 * 119);
    }

    @Override
    public void contextDestroyed(ServletContextEvent sce) {
        logger.info("------------------TicketManagerListener----contextInitialized---------------");
        TicketManager.destroyed();
    }

}

6.2 Token

package top.yiqifu.weixin.offiaccount.listener;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import top.yiqifu.weixin.offiaccount.config.WeixinConfig;
import weixin.popular.support.TokenManager;

import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;
import javax.servlet.annotation.WebListener;

@Component
@WebListener
public class TokenManagerListener implements ServletContextListener {
    private static final Logger logger = LoggerFactory.getLogger(TokenManagerListener.class);

    @Autowired
    WeixinConfig config;

    @Override
    public void contextInitialized(ServletContextEvent sce) {
        logger.info("------------------TokenManagerListener----contextInitialized---------------");
        TokenManager.init(config.getAppID(), config.getAppsecret());
    }

    @Override
    public void contextDestroyed(ServletContextEvent sce) {
        logger.info("------------------TokenManagerListener----destroyed---------------");
        TokenManager.destroyed();
    }
}

七、消息处理

  • 消息处理的作用的是当你在公众号中发送消息时，服务器端可以根据消息内容做出相应的响应。
    private void messageHandler(HttpServletRequest request, HttpServletResponse response) throws IOException {
        ServletInputStream inputStream = request.getInputStream();
        ServletOutputStream outputStream = response.getOutputStream();
        if (inputStream != null) {
            EventMessage eventMessage = XMLConverUtil.convertToObject(EventMessage.class, inputStream);
            String key = eventMessage.getFromUserName() + "__" + eventMessage.getToUserName() + "__" + eventMessage.getMsgId() + "__" + eventMessage.getCreateTime();

            if (expireKey.exists(key)) {
                // 重复通知不作处理
                //System.err.println("重复通知不作处理");
                responseContent(response, "重复通知不作处理");
                return;
            } else {
                expireKey.add(key);
            }

            //logger.info(TokenManager.getDefaultToken());
            String fromUserName = eventMessage.getFromUserName();
            String toUserName = eventMessage.getToUserName();
            String content = eventMessage.getContent();

            String text = "收到消息"+content+" <a href='https://www.baidu.com/?s="+content+"'>百度一下</a>";
            XMLTextMessage message1 = new XMLTextMessage(fromUserName, toUserName, text);
            this.responseMessage(message1, outputStream);

//            String mediaId = "zYNNuHMhJ0dstBmlXEiBHmo69BZnjFKp6J6MNP8i9ZtLrJFnZKBYE9qEn3Bu2Xp8";
//			XMLImageMessage message2 = new XMLImageMessage(fromUserName, toUserName , mediaId);
//            this.responseMessage(message2, outputStream);

        }
    }
    private void responseMessage(XMLMessage message, ServletOutputStream outputStream){
        message.outputStreamWrite(outputStream);
    }

八、自定义菜单

  • 在公众号的底部添加菜单（下面是通过访问/weixin/test/menu地址来添加）
package top.yiqifu.weixin.offiaccount.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import weixin.popular.api.MenuAPI;
import weixin.popular.bean.BaseResult;
import weixin.popular.support.TokenManager;

@Controller()
@RequestMapping("/weixin/test")
public class TestController {

    @RequestMapping("menu")
    @ResponseBody
    public BaseResult test(){

        String menuText = "{\n" +
                "  \"button\": [\n" +
                "    {\n" +
                "      \"name\": \"扫码\",\n" +
                "      \"sub_button\": [\n" +
                "        {\n" +
                "          \"type\": \"scancode_waitmsg\",\n" +
                "          \"name\": \"扫码带提示\",\n" +
                "          \"key\": \"rselfmenu_0_0\",\n" +
                "          \"sub_button\": [ ]\n" +
                "        },\n" +
                "        {\n" +
                "          \"type\": \"scancode_push\",\n" +
                "          \"name\": \"扫码推事件\",\n" +
                "          \"key\": \"rselfmenu_0_1\",\n" +
                "          \"sub_button\": [ ]\n" +
                "        }\n" +
                "      ]\n" +
                "    },\n" +
                "    {\n" +
                "      \"name\": \"发图\",\n" +
                "      \"sub_button\": [\n" +
                "        {\n" +
                "          \"type\": \"pic_sysphoto\",\n" +
                "          \"name\": \"系统拍照发图\",\n" +
                "          \"key\": \"rselfmenu_1_0\",\n" +
                "          \"sub_button\": [ ]\n" +
                "        },\n" +
                "        {\n" +
                "          \"type\": \"pic_photo_or_album\",\n" +
                "          \"name\": \"拍照或者相册发图\",\n" +
                "          \"key\": \"rselfmenu_1_1\",\n" +
                "          \"sub_button\": [ ]\n" +
                "        },\n" +
                "        {\n" +
                "          \"type\": \"pic_weixin\",\n" +
                "          \"name\": \"微信相册发图\",\n" +
                "          \"key\": \"rselfmenu_1_2\",\n" +
                "          \"sub_button\": [ ]\n" +
                "        }\n" +
                "      ]\n" +
                "    },\n" +
                "    {\n" +
                "      \"name\": \"发送位置\",\n" +
                "      \"sub_button\": [\n" +
                "        {\n" +
                "          \"name\": \"发送位置\",\n" +
                "          \"type\": \"location_select\",\n" +
                "          \"key\": \"rselfmenu_2_0\"\n" +
                "        }\n" +
                "      ]\n" +
                "    }\n" +
                "\n" +
                "\n" +
                "  ]\n" +
                "}";

        BaseResult result = MenuAPI.menuCreate(TokenManager.getDefaultToken(), menuText);
        return result;
    }
}
QIFU
关注
  • 0
    点赞
  • 踩
  • 2
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
专栏目录
基于springboot的微信公众号管理系统
AI大模型应用之禅
06-11 648
1. 背景介绍 随着移动互联网的发展，微信已经成为了人们生活中不可或缺的一部分。微信公众号作为企业与用户之间的重要沟通渠道，越来越受到企业的重视。为了更好地管理微信公众号，提高公众号的运营效率，开发一款基于springboot的微信公众号管理系统是非常必要的。 2. 核心概念与联系
SpringBoot+Vue+ElementUI微信公众号平台
西里古里的博客
11-09 1612
一款 Java 语言基于 SpringBoot2.x、MybatisPlus、Vue、ElementUI、MySQL等框架精心打造的一款前后端分离框架，致力于实现模块化、组件化、可插拔的前后端分离架构敏捷开发框架，可用于快速搭建前后端分离后台管理系统，本着简化开发、提升开发效率的初衷，目前框架已集成了完整的RBAC权限架构和常规基础模块，前端Vue端支持多主题切换，实现了个性化的需求。
SpringBoot搭建微信公众号后台（零）：服务搭建与接口验证
charmerwang520的博客
11-08 1155
从零开始搭建功能完善的微信公众号后台，感兴趣就点个关注，持续更新中
微信公众号开发——项目搭建
热门推荐
JJiaper
09-10 3万+
一  前往微信公众平台（https://mp.weixin.qq.com/）获取开发权限和开发账号，公众号分为好几种，小程序，订阅号，服务号，企业号，个人只能用订阅号，权限比较少（api接口权限）； 二 想要自定义模块功能或者是回复信息啥的，就得有一个自己的后台来写接口，所以要配置自己的服务器 基本配置：服务器配置（首页-开发-基本配置-服务器配置） 进入修改配置，这里的服务器地址必...
微信公众号网页本地开发环境搭建
weixin_52258854的博客
05-19 1209
大家好，我是松柏。前两天公司要我配合前端同学开发微信公众号网页，需要我在本地提供开发环境，这个过程中也是踩了几个大坑，今天把这个过程整理出来分享给大家，希望对大家有所帮助。经过以上步骤，我们就能在本地愉快的开发微信公众号网页啦！
(2)公众号开发-基础框架搭建
JolyouLu的博客
05-27 1034
公众号开发-基础框架搭建 本项目为开源项目，大家可以通过GitHub或Gitee获取并且进行二次开发 GitHub仓库地址：https://github.com/JolyouLu/JL-Public-Platform.git Gitee仓库地址：https://gitee.com/smallpage/jl-public-platform.git 项目介绍 在开发之前我们需要搭建一个基础的框架 本项目是基于SpringBoot 2.X构建，按子模块拆分 项目结构 项目结构主要分为4大基础模块(觉得不
微信公众号开发-Java版学习笔记
qq_39348933的博客
03-21 737
微信公众号开发
基于springboot的微信公众号管理系统（支持多公众号接入）
知识极客
02-28 999
微信公众号管理系统，支持多公众号接入。提供公众号菜单、自动回复、公众号素材、模板消息、CMS等管理功能。
微信公众号开发——java后台开发（一）
weixin_38006754的博客
07-15 2085
微信公众号开发——java后台开发（一） 最近项目有一些微信公众号方面的需求，所以就去研究了一下公众号后台的开发，在这期间也请教了一些之前做过公众号开发的同事，也与一起进行开发的同事互相讨论，使得我们的开发工作有条不紊的进行下去，在此也将开发的过程和一些心得输出出来，方便后面的同事以及微信开发爱好者借鉴，如果有问题也请大家指正。 微信公众号申请 我们要进行微信公众号的开发，首先要申请一个微信公众号...
微信公众号极速开发实战项目源代码
03-13
TNW 微信公众号开发脚手架，支持任何 Node.js 的服务端框架 Android 微信、支付App支付SDK IJPay 让支付触手可及，实现微信、支付宝系列支付 博客 简易的微信公众号管理平台 搭建属于自己的网穿透工具 ...
VxPublic:springboot搭建微信公众号常用接口框架包括素材管理 消息处理与回复 账号管理二维码生成 更换微信APPID可直接使用
04-30
springboot搭建微信公众号常用接口框架包括菜单创建 素材更新 消息处理 账号管理 更换微信APPID可直接使用 该项目为一个web项目主要功能在于将微信公众号消息处理做了统一处理等，可在该项目上进行进一步的开发，...
（2023最新）基于springboot鲜花商城系统的毕业设计
03-20
后端采用Springboot框架,简化了项目的搭建和开发。系统分为前台、后台、微信三个子系统,通过权限控制和接口调用进行数据交互,实现了系统的良好扩展性。整个设计过程贯穿了系统分析、数据库设计、接口设计、前后端...
开源商城商品管理介绍：若依Springboot+vue+uniapp支持微信小程序/H5/微信支付/订单管理/会员管理
06-21
Spring Boot是基于Spring框架的一个快速开发工具，简化了Spring应用的初始搭建以及开发过程。在开源商城中，Spring Boot被用来构建后端服务，处理HTTP请求、数据库操作和业务逻辑。它的自动配置特性使得开发者可以...
公众号开发过程
04-18
基于weixin4j技术的微信开发，微信后台使用java语言，用springboot搭建平台框架
Android 更换applicationId 后 微信没有回调
最新发布
七夜的博客
07-24 401
android 微信没有回调
Spring boot 2.0 升级到 3.3.1 的相关问题 （六）
飞一站的博客
07-24 928
解决Spring boot 2.0 升级到3.3.1 版本的`BeanPostProcessor`警告问题。
Java面试八股之简述spring boot的目录结构
u012151345的博客
07-23 658
application.properties 或 application.yml：是 Spring Boot 的主要配置文件，可以有多个版本，例如 application-dev.yml 和 application-prod.yml，分别用于开发和生产环境。Spring Boot 项目遵循标准的 Maven 或 Gradle 项目布局，并且有一些约定的目录用于组织不同的项目组件。src/test/java 和 src/test/resources：包含测试相关的 Java 代码和资源文件。
Spring Boot 项目中使用事件发布和监听来实现消息推送和处理
servepeople的博客
07-23 709
首先，定义一个事件类，该类继承自import org} }} }
php微信公众号开发框架
01-14
PHP微信公众号开发框架是一种基于PHP语言开发的工具，用于快速、高效地开发微信公众号应用程序。它提供了丰富的功能和组件，简化了开发流程，帮助开发者快速构建出专业、稳定的微信公众号应用。 这个框架通常包括了微信公众号的各种功能模块，例如菜单管理、用户管理、消息管理、素材管理等，同时也提供了与微信服务端进行通信的接口和工具。开发者可以利用这些功能模块和工具，快速地实现公众号的各种功能，比如自定义菜单、发送模板消息、管理用户信息等。 PHP微信公众号开发框架还通常提供了丰富的文档和示例代码，帮助开发者快速上手并掌握框架的使用方法。同时，它也支持与其他PHP框架集成，比如Laravel、Yii等，使得开发者可以更加灵活地进行开发。 总之，PHP微信公众号开发框架是一个强大的工具，能够帮助开发者高效地实现各种微信公众号功能，并且具有丰富的文档和支持，适合于各种规模的项目开发使用。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

QIFU

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值