基于 Spring Boot 的快速开发微信公众平台的框架-FastBootWeixin框架

FastBootWeixin 是一个基于 Spring Boot 的快速开发微信公众平台的框架。它提供了便捷的工具和封装，帮助开发者快速构建微信公众平台的应用，例如处理微信消息、事件、菜单、用户管理等常见功能。

以下是使用 FastBootWeixin 框架的基本步骤：

目录

1. 添加 Maven 依赖

2. 配置微信公众平台信息

3. 编写控制器处理微信消息

4. 启动应用并测试

5. 更多功能

6. 文档和资源

---

1. 添加 Maven 依赖

首先，需要在你的 Spring Boot 项目的 pom.xml 文件中添加 FastBootWeixin 的依赖：

<dependency>
    <groupId>com.github.binarywang</groupId>
    <artifactId>weixin-java-mp-spring-boot-starter</artifactId>
    <version>最新版本号</version>
</dependency>

确保将 最新版本号 替换为实际的最新版本号，你可以在 Maven Central 上查找。

2. 配置微信公众平台信息

在 src/main/resources/application.properties 或 application.yml 中配置微信公众平台的相关信息：

wx.mp.appId=你的AppID
wx.mp.secret=你的AppSecret
wx.mp.token=你的Token
wx.mp.aesKey=你的EncodingAESKey

或者使用 application.yml 格式：

wx:
  mp:
    appId: "你的AppID"
    secret: "你的AppSecret"
    token: "你的Token"
    aesKey: "你的EncodingAESKey"

3. 编写控制器处理微信消息

创建一个 Spring Boot 控制器类，用于处理微信服务器推送的消息和事件。

package com.example.demo.controller;

import me.chanjar.weixin.common.error.WxErrorException;
import me.chanjar.weixin.mp.api.WxMpService;
import me.chanjar.weixin.mp.bean.message.WxMpXmlMessage;
import me.chanjar.weixin.mp.bean.message.WxMpXmlOutMessage;
import me.chanjar.weixin.mp.builder.out.TextBuilder;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/wx/portal")
public class WeixinController {

    @Autowired
    private WxMpService wxMpService;

    @PostMapping(produces = "application/xml; charset=UTF-8")
    public String handleWeixinMessage(@RequestBody String requestBody) {
        WxMpXmlMessage inMessage = WxMpXmlMessage.fromXml(requestBody);
        WxMpXmlOutMessage outMessage = handleMessage(inMessage);
        return outMessage == null ? "" : outMessage.toXml();
    }

    private WxMpXmlOutMessage handleMessage(WxMpXmlMessage inMessage) {
        // 根据消息类型处理不同的消息
        if ("text".equals(inMessage.getMsgType())) {
            return new TextBuilder().content("收到你的消息：" + inMessage.getContent()).fromUser(inMessage.getToUser()).toUser(inMessage.getFromUser()).build();
        }
        // 添加其他消息类型处理（如事件、图片、语音等）
        return null;
    }
}

在这个例子中，WeixinController 是一个 Spring Boot 控制器，用于接收和处理来自微信服务器的请求。它将文本消息内容返回给用户。

4. 启动应用并测试

启动 Spring Boot 应用程序。确保你的服务器可以通过公网访问（如果是本地开发，可以使用类似 ngrok 的工具来进行内网穿透），然后将微信公众平台的服务器配置指向 http://your-domain/wx/portal，微信服务器会将消息推送到这个地址。

5. 更多功能

FastBootWeixin 提供了很多扩展功能，涵盖了微信公众平台 API 的各个方面，如菜单管理、用户管理、素材管理等。你可以通过 WxMpService 接口及其实现类来调用这些 API。例如：

// 获取微信用户信息
public WxMpUser getUserInfo(String openId) throws WxErrorException {
    return wxMpService.getUserService().userInfo(openId);
}

6. 文档和资源

• 官方文档和更多使用示例可以参考 FastBootWeixin 的 GitHub 仓库。
• 如果你有更复杂的需求，例如需要与企业微信、微信小程序等其他平台进行集成，FastBootWeixin 也有对应的解决方案。