Spring Boot 结合 WxJava 实现文章上传微信公众号草稿箱与群发

目录

• 一、项目环境准备
• 1.1 开发环境
• 1.2 微信公众号准备
• 二、Spring Boot 项目搭建
• 2.1 创建 Spring Boot 项目
• 2.2 添加 WxJava 依赖
• 三、配置微信公众号信息
• 四、实现文章上传到草稿箱
• 4.1 定义文章实体类
• 4.2 编写上传草稿箱代码
• 五、实现文章群发功能
• 七、总结与注意事项

Spring Boot 结合 WxJava 实现文章上传微信公众号草稿箱与群发

在数字化营销与内容传播日益重要的今天，微信公众号已成为企业和个人进行信息发布与推广的重要平台。对于开发者而言，通过代码实现自动化的文章管理操作，如上传文章到草稿箱、群发文章等，能够极大提高工作效率。本文将详细介绍如何使用 Spring Boot 框架结合 WxJava 开发工具包，实现文章上传到微信公众号草稿箱以及群发功能。

一、项目环境准备

1.1 开发环境

JDK：建议使用 JDK 1.8 及以上版本，以确保与 Spring Boot 和 WxJava 的兼容性。

IDE：推荐使用 IntelliJ IDEA 或 Eclipse，两者都对 Spring Boot 项目有良好的支持。

Maven：用于项目依赖管理和构建，版本建议在 3.6 以上。

1.2 微信公众号准备

在开始开发前，需要提前准备好微信公众号的相关信息：

公众号 AppID：用于唯一标识你的公众号，在微信公众平台后台的 “开发 - 基本配置” 中获取。

公众号 AppSecret：与 AppID 配合使用，用于获取接口调用凭证（Access_token），同样在 “开发 - 基本配置” 中查看。

IP 白名单设置：为保证接口调用的安全性，需要将服务器的 IP 地址添加到微信公众平台后台的 “开发 - 基本配置 - IP 白名单” 中。

二、Spring Boot 项目搭建

2.1 创建 Spring Boot 项目

可以通过 Spring Initializr（https://start.spring.io/）快速创建一个 Spring Boot 项目，在创建过程中选择以下依赖：

Spring Web：用于构建 Web 应用，方便后续编写接口进行功能测试。

Lombok：简化 Java 代码，通过注解自动生成 getter、setter、构造函数等。

2.2 添加 WxJava 依赖

在项目的pom.XML文件中添加 WxJava 相关依赖：

    <dependency>
        <groupId>com.github.binarywang</groupId>
        <artifactId>weixin-java-mp</artifactId>
        <version>4.7.0</version>
    </dependency>
    <dependency>
        <groupId>org.jsoup</groupId>
        <artifactId>jsoup</artifactId>
        <version>1.14.3</version> <!-- or latest version 编程客栈-->
    </dependency>

WxJava 是一个优秀的微信开发 Java 工具包，weixin-java-mp模块专门用于微信公众号开发。然后这里发现还引入了jsoup，这肯定是大有用处，可接着看后续的内容。

三、配置微信公众号信息

在 Spring Boot 项目中，创建一个配置类用于加载微信公众号的 AppID 和 AppSecret 等信息。例如，创建WeChatConfig.java：

import me.chanjar.weixin.mp.api.WxMpService;
import me.chanjar.weixin.mp.api.impl.WxMpServiceImpl;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
public class WeChatConfig {
    @Value("${wechat.mp.appId}")
    private String appId;
    @Value("${wechat.mp.appSecret}")
    private String appSecret;
    @Bean
    public WxMpService wxMpService() {
        WxMpService wxMpService = new WxMpServiceImpl();
        wxMpService.setWxMpConfigStorage(wxMpConfigStorage());
        return wxMpService;
    }
    @Bean
    public me.chanjar.weixin.mp.config.WxMpConfigStorage wxMpConfigStorage() {
        me.chanjar.weixin.mp.config.impl.WxMpDefaultConfigImpl wxMpConfigStorage = new me.chanjar.weixin.mp.config.impl.WxMpDefaultConfigImpl();
        wxMpConfigStorage.setAppId(appId);
        wxMpConfigStorage.setSecret(appSecret);
        return wxMpConfigStorage;
    }
}

同时，在application.properties或application.yml文件中添加微信公众号的配置信息：

wechat.mp.appId=your_ap编程客栈p_id
wechat.mp.appSecret=your_app_secret

将your_app_id和your_app_secret替换为实际获取到的公众号 AppID 和 AppSecret。

四、实现文章上传到草稿箱

4.1 定义文章实体类

创建一个 Java 类用于表示微信公众号文章，例如WeChatArticle.java：

import lombok.Data;

@Data
public class WeChatArticle {
    private String title;
    private String content;
    private String author;
    // 其他文章属性，如封面图片URL等可根据需求添加
}

该类定义了文章的基本属性，如标题、内容和作者，可根据实际需求扩展更多属性。

4.2 编写上传草稿箱代码

创建一个服务类，如WeChatArticleService.java，用于实现上传文章到草稿箱的逻辑：

这里要特别注意，由于微信有些html标签不支持，所以需要将文章内容复制到专门的微信markdown编辑器中格式化后，在从编辑器复制出html出来，然后在通过代码上传。

import me.chanjar.weixin.common.error.WxErrorException;
import me.chanjar.weixin.mp.api.WxMpService;
import me.chanjar.weixin.mp.bean.material.WxMpMassArticle;
import me.chanjar.weixin.mp.bean.material.WxMpMassArticleArticle;
import me.chanjar.weixin.mp.bean.material.WxMpMaterialArticleUploadResult;
import org.springframework.stereotype.Service;
import javax.annotation.Resource;
@Service
public class WeChatArticleService {
    @Resource
    private WxMpService wxMpService;
    public String addDraft(String title, String content, String thumbnailUrl) throws WxErrorException {
        // 提取图片URL并替换
        List<String> imageUrls = extractImageUrls(content);
        for (String imgUrl : imageUrls) {
            String wechatUrl = uploadImage(imgUrl);
            content = content.replace(imgUrl, wechatUrl);
        }
        WxMpDraftArticles article = new WxMpDraftArticles();
        article.setAuthor("拾壹");
        article.setContent(content);
        article.setTitle(title);
        article.setThumbMediaId(mediaUploadInImage(thumbnailUrl));
        // 可根据需求设置更多文章属性，如封面图片等
        WxMpAddDraft news = new WxMpAddDraft();
        news.setArticles(Collections.singletonList(article));
        return wxMpService.getDraftService().addDraft(news);
    }
      /**
     * 根据url上传永久素材
     * @param url 图片url
     * @return 微信素材ID
     */
    public String mediaUploadInImage(String url) throws IOException, WxErrorException {
        byte[] bytes = this.downloadImage(url);
        File file = convert(bytes);
        String mediaId = materialFileUpload("image",file);
        FileUtil.del(file);
        return mediaId;
    }
    /**
     * 根据文件上传永久素材
     * @param type 文件类型
     * @param file 文件
     * @return 微信素材ID
     */
    public String materialFileUpload(String type,File file) throws IOException, WxErrorException {
        WxMpMaterial wxMpMaterial = new WxMpMaterial();
        wxMpMaterial.setFile(file);
        WxMpMaterialUploadResult image = wxMpService.getMaterialService().materialFileUpload(type,wxMpMaterial);
        return image.getMediaId();
    }
      /**
     * 根据url上传图片
     * @param url 图片url
     * @return 微信可访问的url地址
     */
    public String uploadImage(String url) throws IOException, WxErrorException {
        byte[] bytes = this.downloadImage(url);
        //bytes转成file
        File file = convert(bytes);
        WxMediaImgUploadResult wxMediaImgUploadResult = wxMpService.getMaterialService().mediaImgUpload(file);
        FileUtil.del(file);
        return wxMediaImgUploadResult.getUrl();
    }
      /**
     * byte[] 转 File
     *
     * @param bytes
     * @return
     * @throws IOException
     */
    public static File convert(byte[] bytes) throws IOException {
        // 创建一个临时文件
        File tempFile = File.createTempFile("temp-", ".png");
        // 使用 FileOutputStream 将字节数组写入文件
        try (FileOutputStream fos = new FileOutputStream(tempFile)) {
            fos.write(bytes);
        }
        return tempFile;
    }
      /**
     * 下载图片
     *
     * @param url
     * @return
     */
    private byte[] downloadImage(String url) {
        return new RestTemplate().getForObject(url, byte[].class);
    }
      /**
     * 提取 HTML 中的图片 URL
 GJjqfUd    */
    private List<String> extractImageUrls(String html) {
        org.jsoup.nodes.Document doc = Jsoup.parse(html);
        return doc.select("img").stream()
                .map(img -> img.attr("src"))
                .collect(Collectors.toList());
    }
}

上述代码将WeChatArticle对象转换为 WxJava 中的文章对象格式，并调用WxMpService编程客栈的接口方法将文章上传到草稿箱，返回文章的 mediaId，后续群发文章时会用到该 mediaId。

然后就是因为公众号不能用其他外链的图片，然后我们的图片基本都是已经上传好了的外链地址，所以需要先将图片上传到公众号，然后再替换成返回的公众号图片url地址。

五、实现文章群发功能

在WeChatArticleService.java中继续添加文章群发的方法：

import me.chanjar.weixin.common.error.WxErrorException;
import me.chanjar.weixin.mp.api.WxMpService;
import me.chanjar.weixin.mp.bean.material.WxMpMassArticle;
import me.chanjar.weixin.mp.bean.material.WxMpMassArticleArticle;
import me.chanjar.weixin.mp.bean.material.WxMpMaterialArticleUploadResult;
import me.chanjar.weixin.mp.bean.message.WxMpMassMessage;
import me.chanjar.weixin.mp.bean.message.WxMpMassMessageResult;
import org.springframework.stereotype.Service;
import javax.annotation.Resource;
@Service
public class WeChatArticleService {
    public void wechatSendAll(String mediaId)www.devze.com {
        try {
            WxMpDraftInfo draft = wxMpService.getDraftService().getDraft(mediaId);
            if (draft == null || draft.getNewsItem() == null || draft.getNewsItem().isEmpty()) {
                throw new ServiceException("无效的mediaId: " + mediaId);
            }
            WxMpMassTagMessage wxMpMassTagMessage = new WxMpMassTagMessage();
            wxMpMassTagMessage.setMediaId(mediaId);
            wxMpMassTagMessage.setMsgType("mpnews");
            wxMpMassTagMessage.setSendAll(true);
            wxMpMassTagMessage.setSendIgnoreReprint(true);
            wxMpService.getMassMessageService().massGroupMessageSend(wxMpMassTagMessage);
        } catch (WxErrorException e) {
            log.error("微信群发失败", e);
            throw new RuntimeException(e);
        }
    }
}

该方法通过传入文章的 mediaId，构建群发消息对象，并调用WxMpService的群发接口将文章发送给公众号的关注用户。

七、总结与注意事项

通过上述步骤，我们成功实现了使用 Spring Boot 和 WxJava 将文章上传到微信公众号草稿箱以及群发的功能。在实际开发过程中，还需要注意以下几点：

接口调用频率限制：微信公众号接口对调用频率有一定限制，需合理控制接口调用次数，避免因频率过高导致调用失败。

错误处理：代码中对WxErrorException进行了简单抛出，实际应用中应根据具体错误码进行更详细的错误处理和日志记录。

内容审核：群发的文章内容需符合微信公众平台的相关规定，否则可能导致文章发送失败或公众号受到处罚。

希望本文能帮助你快速掌握使用 Spring Boot 和 WxJava 进行微信公众号文章管理开发的技能，进一步拓展公众号的自动化运营能力。

上述文章涵盖了完整的实现流程与要点。你可以说说对文章篇幅、某些技术细节讲解的看法，若有特殊需求，我可进一步修改。

到此这篇关于Spring Boot 结合 WxJava 实现文章上传微信公众号草稿箱与群发的文章就介绍到这了,更多相关Spring Boot WxJava上传微信公众号草稿箱与群发内容请搜索编程客栈(www.devze.com)以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程客栈(www.devze.com)！