微信公众号开发Java版

已于 2023-04-09 10:56:46 修改
阅读量923 收藏 12
点赞数 2
文章标签： java 微信 微信公众平台 spring boot 个人开发
于 2023-04-09 10:38:47 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/idogbin/article/details/130039161
版权

源码地址：

一.申请微信开发者账号

  1. 注册账号
  2. 申请测试号
    • 这里接口配置信息暂时不填，后面再填

image-20230408212010357

二.开发平台与Java端绑定

  1. 基本开发环境
    • springboot 2.7.2
    • mysql 8.0
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>2.3.0</version>
        </dependency>
        <!-- https://hutool.cn/docs/index.html#/-->
        <dependency>
            <groupId>cn.hutool</groupId>
            <artifactId>hutool-all</artifactId>
            <version>5.8.8</version>
        </dependency>
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.5.2</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>
  1. 引入微信公众号开发依赖
<dependency>
    <groupId>com.github.binarywang</groupId>
    <artifactId>wx-java-mp-spring-boot-starter</artifactId>
    <version>4.4.0</version>
</dependency>
  1. 配置微信公众号测试号相关参数
    • app-id和secret为第一步中测试号提供的appid和appsecret
    • token为接口配置信息中的Token，自定义就好
wx:
  mp:
    app-id: your-app-id
    secret: your-appsecret
    token: your-token
    aes-key:

image-20230408212436363

  1. 配置类，配置WxMpService
/**
 * 常量类，读取配置文件application.properties中的配置
 */
@Component
public class ConstantPropertiesUtil implements InitializingBean {

    @Value("${wx.mp.app-id}")
    private String appid;

    @Value("${wx.mp.secret}")
    private String appsecret;

    @Value("${wx.mp.token}")
    private String token;

    @Value("${wx.mp.aes-key}")
    private String aes_key;

    public static String ACCESS_KEY_ID;
    public static String ACCESS_KEY_SECRET;
    public static String TOKEN;
    public static String AES_KEY;

    @Override
    public void afterPropertiesSet() throws Exception {
        ACCESS_KEY_ID = appid;
        ACCESS_KEY_SECRET = appsecret;
        TOKEN = token;
        AES_KEY = aes_key;
    }
}



/**
 * @author niumazlb
 */
@Configuration
@Data
public class WeChatMpConfig {

    @Autowired
    private ConstantPropertiesUtil constantPropertiesUtil;

    @Bean
    public WxMpService wxMpService(){
        WxMpService wxMpService = new WxMpServiceImpl();
        wxMpService.setWxMpConfigStorage(wxMpConfigStorage());
        return wxMpService;
    }
    @Bean
    public WxMpConfigStorage wxMpConfigStorage(){
        WxMpDefaultConfigImpl wxMpConfigStorage = new WxMpDefaultConfigImpl();
        wxMpConfigStorage.setAppId(ConstantPropertiesUtil.ACCESS_KEY_ID);
        wxMpConfigStorage.setSecret(ConstantPropertiesUtil.ACCESS_KEY_SECRET);
        wxMpConfigStorage.setToken(ConstantPropertiesUtil.TOKEN);
        wxMpConfigStorage.setAesKey(ConstantPropertiesUtil.AES_KEY);
        return wxMpConfigStorage;
    }
}

  1. 搭建微信公众号服务

/**
 * 微信公众号相关接口
 *
 * @author niumazlb
 */
@RestController
@RequestMapping("/")
@Slf4j
@CrossOrigin
public class WxMpController {
    @Resource
    private WxMpService wxMpService;

    @GetMapping
    public String check(String timestamp, String nonce, String signature, String echostr) {
        log.info("check,timestamp:{},nonce:{},signature:{},echostr:{}", timestamp, nonce, signature, echostr);
        if (wxMpService.checkSignature(timestamp, nonce, signature)) {
            log.info("check success,echostr:{}", echostr);
            return echostr;
        } else {
            return "";
        }
    }
}

三.配置内网穿透

什么是内网穿透？说白了就是让其他人能够在网上访问到你电脑本地的接口。

我使用的是natapp，网上有很多教程，遇到大问题可以去搜一搜。

NATAPP-内网穿透 基于ngrok的国内高速内网映射工具

配置完成后，可以在一些api工具中测试一下这个域名，看看请求能不能成功发送到本地

  • 在微信开发者平台填入相关信息
  • 能够成功配置，即表示接入成功！就可以开发后续功能了

image-20230408213436984

踩坑

如果这里内网穿透你使用的是自定义域名，并且域名在除了阿里云的其他厂商备案，那么你在发请求到该域名时，会被阿里云安全拦截！导致配置失败！

  • 要么在阿里云再备案一次，较麻烦
  • 花点小钱在natapp买一个二级域名就可以了，推荐

image-20230408213650546

四.设置公众号菜单

在公众号中我们常常能看到一些按钮，通过点击按钮能够满足不同的需求

image-20230409100719143

我们也能通过代码来更加个性化的定制我们的菜单（只有认证用户可使用接口定制菜单）

编写controller

  • 可以通过wxMenuButton.setSubButtons(List<WxMenuButton> subButtons);方法来设置某个菜单的子菜单
  • 可以通过wxMenuButton.setUrl(String url)方法来设置点击菜单跳转的url
    /**
     * 设置公众号菜单
     *
     * @return
     * @throws WxErrorException
     */
    @GetMapping("/setMenu")
    public String setMenu() throws WxErrorException {
        log.info("setMenu");
        WxMenu wxMenu = new WxMenu();
        // 菜单一
        WxMenuButton wxMenuButton1 = new WxMenuButton();
        wxMenuButton1.setType(MenuButtonType.CLICK);
        wxMenuButton1.setName("今日课程");
        wxMenuButton1.setKey(WxMpConstant.CLICK_COURSE_KEY);

        // 菜单二
        WxMenuButton wxMenuButton2 = new WxMenuButton();
        wxMenuButton2.setType(MenuButtonType.CLICK);
        wxMenuButton2.setName("作业");
        wxMenuButton2.setKey(WxMpConstant.CLICK_HOMEWORK_KEY);

        // 设置主菜单
        wxMenu.setButtons(Arrays.asList(wxMenuButton1, wxMenuButton2));
        wxMpService.getMenuService().menuCreate(wxMenu);
        return "ok";
    }

五.消息的接收与处理

流程图

  • 可以看出我们Java后端需要编写
    • 一个接口用来接收微信发给我们的消息，校验签名
    • 配置路由来路由不同类型的消息
    • 对于每种消息的处理器

image-20230408214940752

消息处理器编写接口

我们只需要实现WxMpMessageHandler就可以编写一个微信消息的处理器，下面给出几个示例：

/**
 * 事件处理器
 **/
@Component
public class EventHandler implements WxMpMessageHandler {
    @Override
    public WxMpXmlOutMessage handle(WxMpXmlMessage wxMpXmlMessage, Map<String, Object> map, WxMpService wxMpService,WxSessionManager wxSessionManager) throws WxErrorException {
        // 拿到点击的按钮的key
        String eventKey = wxMpXmlMessage.getEventKey();
        //返回的内容
        String content = "";
        switch (eventKey) {
            case 某个key:
				// 做些什么
                break;
        }
        // 调用接口，返回消息
        return WxMpXmlOutMessage.TEXT().content(content)
                .fromUser(wxMpXmlMessage.getToUser())
                .toUser(wxMpXmlMessage.getFromUser())
                .build();
    }
}


/**
 * 消息处理器
 **/
@Component
@Slf4j
public class MessageHandler implements WxMpMessageHandler {

    @Override
    public WxMpXmlOutMessage handle(WxMpXmlMessage wxMpXmlMessage, Map<String, Object> map,WxMpService wxMpService, WxSessionManager wxSessionManager) throws WxErrorException {
		// 拿到用户发的消息
        String content = wxMpXmlMessage.getContent();
		// 返回的消息
        String res = "我是复读机哇："+content;
        
		//...做些什么...
        return WxMpXmlOutMessage.TEXT().content(res)
                .fromUser(wxMpXmlMessage.getToUser())
                .toUser(wxMpXmlMessage.getFromUser())
                .build();
    }
}


/**
 * 关注处理器
 *
 * @author niumazlb
 */
@Component
public class SubscribeHandler implements WxMpMessageHandler {

    @Override
    public WxMpXmlOutMessage handle(WxMpXmlMessage wxMpXmlMessage, Map<String, Object> map, WxMpService wxMpService, WxSessionManager wxSessionManager) throws WxErrorException {
        final String content = "感谢关注";
        // 调用接口，返回验证码
        return WxMpXmlOutMessage.TEXT().content(content)
                .fromUser(wxMpXmlMessage.getToUser())
                .toUser(wxMpXmlMessage.getFromUser())
                .build();
    }
}

注册路由

将刚刚写的处理器注册到路由中

/**
 * 微信公众号路由
 */
@Configuration
public class WxMpMsgRouter {

    @Resource
    private WxMpService wxMpService;

    @Resource
    private EventHandler eventHandler;

    @Resource
    private MessageHandler messageHandler;

    @Resource
    private SubscribeHandler subscribeHandler;

    @Bean
    public WxMpMessageRouter getWxMsgRouter() {
        WxMpMessageRouter router = new WxMpMessageRouter(wxMpService);
        // 消息
        router.rule()
                .async(false)
                .msgType(XmlMsgType.TEXT) //文本消息
                .handler(messageHandler)
                .end();
        // 关注
        router.rule()
                .async(false)
                .msgType(XmlMsgType.EVENT) //事件消息
                .event(EventType.SUBSCRIBE) // 关注事件
                .handler(subscribeHandler)
                .end();
        // 点击"课程"按钮
        router.rule()
                .async(false)
                .msgType(XmlMsgType.EVENT) 
                .event(EventType.CLICK) //点击事件
                .eventKey(WxMpConstant.CLICK_COURSE_KEY) // 点击按钮的key
                .handler(eventHandler)
                .end();
        // 点击"作业"按钮
        router.rule()
                .async(false)
                .msgType(XmlMsgType.EVENT)
                .event(EventType.CLICK)
                .eventKey(WxMpConstant.CLICK_HOMEWORK_KEY)
                .handler(eventHandler)
                .end();

        return router;
    }
}

编写接口

  • 先校验参数的正确性
  • 判断加密类型
  • 路由消息
  • 返回信息
    @Resource
    private WxMpMessageRouter router;

    /**
     * 接收微信发来的消息
     * @param request
     * @param response
     * @param requestBody
     * @return
     */
    @PostMapping("/")
    public String receiveMessage(HttpServletRequest request, HttpServletResponse response, @RequestBody String requestBody) {
        response.setContentType("text/html;charset=utf-8");
        response.setStatus(HttpServletResponse.SC_OK);
        // 校验消息签名，判断是否为公众平台发的消息
        String signature = request.getParameter("signature");
        String nonce = request.getParameter("nonce");
        String timestamp = request.getParameter("timestamp");
        if (!wxMpService.checkSignature(timestamp, nonce, signature)) {
            throw new BusinessException(ErrorCode.FORBIDDEN_ERROR, "非法的请求！");
        }
        // 加密类型
        String encryptType = StringUtils.isBlank(request.getParameter("encrypt_type")) ? "raw" : request.getParameter("encrypt_type");
        String out = null;
        // 明文消息
        if ("raw".equals(encryptType)) {
            WxMpXmlMessage inMessage = WxMpXmlMessage.fromXml(requestBody);
            log.info("message content = {}", inMessage.getContent());
            // 路由消息并处理
            WxMpXmlOutMessage outMessage = router.route(inMessage);
            if (outMessage == null) {
                return "";
            } else {
                out = outMessage.toXml();
            }
        }
        // aes 加密消息
        if ("aes".equals(encryptType)) {
            // 解密消息
            String msgSignature = request.getParameter("msg_signature");
            WxMpXmlMessage inMessage = WxMpXmlMessage
                    .fromEncryptedXml(requestBody, wxMpService.getWxMpConfigStorage(), timestamp,
                            nonce,
                            msgSignature);
            log.info("message content = {}", inMessage.getContent());
            // 路由消息并处理
            WxMpXmlOutMessage outMessage = router.route(inMessage);
            if (outMessage == null) {
                return "";
            } else {
                out = outMessage.toXml();
            }
        }
        log.info("\n组装回复信息：{}", out);
        return out;
    }

测试

在测试号中发送消息，后端打好断点，可以看到发过来的消息

image-20230409100121963

消息也成功的路由到处理器中

image-20230409100323124

同样的，点击按钮也可以触发响应的处理器。

六.群发消息

一、前言 | 微信开放文档 (qq.com)

这里提供一个群发消息的方法,群发消息也需要微信认证才行

    public void sendAllMsg(String text) {
        String accessToken = this.getAccessToken();
        String reqUrl = "https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=" + accessToken;
        Map<String, Object> param = new HashMap<>();
        param.put("msgtype", "text");

        Map<String, Object> content = new HashMap<>();
        content.put("content", text);
        param.put("text", content);

        Map<String, Object> filter = new HashMap<>();
        filter.put("is_to_all", true);
        filter.put("tag_id", "");
        param.put("filter", filter);

        String json = JSONUtil.toJsonStr(param);
        String body = HttpRequest.post(reqUrl)
                .body(json)
                .execute()
                .body();

        log.info("群发消息返回：{}", body);

    }
dogbin丶
关注
  • 2
    点赞
  • 踩
  • 12
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
java实现微信公众号源码-weixin-java-mp-multi-demo:微信公众号demo，基于WxJava和SpringMVC框架实
06-05
java实现微信公众号源码 本项目为WxJava的Demo演示程序 已不建议使用本项目中展示的方式实现多公众号支持，可以参考 springboot的实现： ， 更多其他类型的Demo请查阅： 本Demo使用Spring MVC 框架实现微信公众号开发功能，支持多公众号。 如果想使用更多公众号，请复制相关配置文件，修改spring配置文件添加相应配置，同时还需要增加相应的controller和service，具体可以参考已有源码进行操作。 如果只是使用一个公众号，建议使用另外的项目： 或者 。 使用步骤： 配置: 复制/src/main/resources/wx-gzh1.properties.template 生成wx-gzh1.properties 文件，填写相关配置; 复制/src/main/resources/wx-gzh2.properties.template 生成wx-gzh2.properties 文件，填写相关配置。 使用maven运行demo程序: mvn jetty:run 或者自己打 war包发布到tomcat运行； 配置微信公众号中的接口地址： 或 （注意XXX
Java实现微信公众号模板消息管理群发和单发
weixin_47292529的博客
11-09 2666
Java实现微信公众号发布模板消息群发和单发
java开发微信公众号详细步骤
qq_42752478的博客
01-27 878
个人开发微信公众号步骤，没有域名的处理方法
微信开发工具包WxJava之微信公众号开发的常用API使用篇
积跬步，至千里。
06-07 3616
微信开发工具包WxJava是一个基于Java语言的微信公众号和小程序开发工具包，提供了丰富的API接口，可以根据自己的需求选择相应的接口。
Java微信公众号开发
热门推荐
baobao的博客
07-06 1万+
本文从本人博客搬运，原文格式更加美观，可以移步原文阅读。原文地址：https://www.baobao555.tech/posts/ee7236bb/ 微信公众号介绍 1.公众号的分类 我们平常在微信应用上会看到有很多的公众号，但是各自并不一样，公众号也分很多种类型，不过最常见的就是服务号和订阅号了。下面我们来看一下他们的区别： 订阅号：为媒体和个人提供一种信息传播方式，主要偏于为用户传达资讯（类似报纸杂志），主要的定位是阅读，每天可以群发1条消息 服务号：为企业，政府或组织提供对用户进行服务，主要偏于服
微信开发工具包WxJava之微信公众号开发的入门使用篇
积跬步，至千里。
06-05 6718
WxJava是一款基于Java语言的微信开发Java SDK，它提供了微信支付，开放平台，小程序，企业微信，公众号等多个平台的API接口，并将其封装为易于调用的Java方法，方便Java开发者快速开发与微信相关的应用。
使用JAVA开发微信公众平台（一）——环境搭建与开发接入
sinat_19755843的专栏
06-09 2005
微信公众平台，即我们平时所说的“公众号”，曾用名“官方平台”、“媒体平台”，但最终命名为“公众平台”。从微信的命名我可以发现，公众平台不只是官方、媒体使用的平台，而是对所有公众都开放的统一平台。喜欢本文，请点击下方喜欢按钮呗！❤️微信公众平台公分4大板块：订阅号、服务号、小程序、企业号。
JAVA微信公众号
Mr_Jin的博客
05-07 1019
自定义菜单文档自定义菜单最多包括3个一级菜单，每个一级菜单最多包含5个二级菜单。一级菜单最多4个汉字，二级菜单最多8个汉字，多出来的部分将会以“…”代替。创建自定义菜单后，菜单的刷新策略是，在用户进入公众号会话页或公众号profile页时，如果发现上一次拉取菜单的请求在5分钟以前，就会拉取一下菜单，如果菜单有更新，就会刷新客户端的菜单。测试时可以尝试取消关注公众账号后再次关注，则可以看到创建后的效果。
Java ~ 微信公众号开发。
lyfGeek的博客
06-13 713
Java～微信公众号开发。
深入探索微信公众号开发：Java代码实现与最佳实践
m0_49151953的博客
04-12 1206
本文将深入探讨微信公众号的开发流程、核心功能和Java代码实现，同时提供一些最佳实践，帮助你更好地应用微信公众号进行业务开发。实现消息和事件接收和处理逻辑 使用Java语言和微信公众号Java SDK，实现消息和事件接收和处理逻辑，包括文本消息、图片消息、语音消息、事件等。菜单管理 公众号可以创建不同类型的菜单，包括点击菜单、跳转URL、扫码等，用户可以通过菜单来快速了解公众号的功能和服务。消息收发 用户可以发送文本、图片、语音、视频、地理位置等消息给公众号，公众号可以根据消息类型进行不同的处理。
微信公众号JAVA接口源码
04-11
提供了用户接入企业微信的两个接口及如何使用这两个接口的示例。分别用于收到用户回复消息的解密以及开发者回复消息的加密过程。关于加解密协议请参考微信公众平台官方文档。
java版微信公众号开发之：自定义菜单的创建
05-12
微信公众号自定义菜单 使用的时候 替换自己的appid 和appsecret
java开发微信公众号源码-wechat:java微信公众号开发
05-19
java 开发微信公众号源码 wechat java微信公众号开发源码
java微信公众号开发.zip
07-19
微信公众号开发案例，使用的是SpringMVC+MyBatis框架。附带数据库。
微信公众号 java 开发 sdk
11-03
微信公众号 java 开发 sdk ,集合了微信公众号开发常用工具类，通用类，可以帮助开发者加快开发进度。
mybatisPlus使用MetaObjectHandler对字段进行更新
最新发布
m0_56356631的博客
04-23 427
都是符合我们的预期的。
string模拟实现
m0_73969414的博客
04-23 1516
c++中string的模拟实现，面试必会知识点
实现自定义注解、实现自定义幂等性注解
qq_44721738的博客
04-23 678
添加 Spring AOP 依赖。创建自定义注解。创建一个新的 Java 注解类，通过@interface关键字来定义，并可以添加元注解以及属性。@Target(ElementType.METHOD) //表示作用于方法上@Retention(RetentionPolicy.RUNTIME) // 表示这个注解在运行时是可见的，这样 AOP 代理才能在运行时读取到这个注解编写 AOP 拦截（自定义注解）的逻辑代码。@Aspect@Component// 方法执行前的处理。
微信公众号开发源码java
01-10
微信公众号开发源码Java是用Java语言编写的用于开发微信公众号的源代码。微信公众号开发是指通过开发者账号申请成为微信公众号的开发者，利用微信提供的开发接口和SDK来开发和管理公众号。 Java作为一种广泛应用于...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值