微信服务号订阅通知 Java 实现教程

微信服务号订阅通知是一种向用户推送信息的方式，适用于一些需要与用户频繁互动的场景。本文将详细介绍如何使用 Java 完成微信服务号订阅通知的实现，包括整个过程的步骤、代码示例以及状态图解析。

流程概述

在开始之前，我们先理清整个实现过程的步骤。以下是实现微信服务号订阅通知的基本步骤：

步骤 描述
1. 创建服务号 在微信公众平台上创建服务号，并获取 AppID 和 AppSecret
2. 获取 Access Token 使用 AppID 和 AppSecret 获取 Access Token
3. 创建模板 在微信公众平台上创建消息模板，并获取模板 ID
4. 发送订阅通知 调用发送接口，发送订阅消息给用户

步骤解析

步骤 1：创建服务号

首先，你需要在微信公众平台注册一个服务号。完成后，你将获得 AppID 和 AppSecret，这在后续的过程里是必不可少的。

步骤 2：获取 Access Token

紧接着，你需要使用 AppID 和 AppSecret 获取 Access Token，因为这个 Token 是调用其他微信 API 的基础。

以下是获取 Access Token 的 Java 代码：

import java.net.HttpURLConnection;
import java.net.URL;
import java.io.BufferedReader;
import java.io.InputStreamReader;

public class WeChatUtil {
    public static String getAccessToken(String appId, String appSecret) throws Exception {
        String url = String.format(" appId, appSecret);
        URL obj = new URL(url);
        HttpURLConnection con = (HttpURLConnection) obj.openConnection();
        con.setRequestMethod("GET");

        BufferedReader in = new BufferedReader(new InputStreamReader(con.getInputStream()));
        StringBuffer response = new StringBuffer();
        String inputLine;

        while ((inputLine = in.readLine()) != null) {
            response.append(inputLine);
        }
        in.close();
        
        // 返回 Access Token
        return response.toString(); // 需要解析 JSON
    }
}
  • HttpURLConnection 用于发送 HTTP 请求
  • 你需要根据你的 AppID 和 AppSecret 请求 Access Token
  • 返回的内容需要解析成 JSON 格式，提取 Access Token

步骤 3：创建模板

在微信公众平台创建消息模板时，你需要给模板取一个名称并获得 template_id。你将使用这个 template_id 来发送消息。

步骤 4：发送订阅通知

你可以通过调用相应的 API 发送订阅消息。以下是发送订阅消息的 Java 代码示例：

import java.io.OutputStream;
import com.google.gson.JsonObject;

public class WeChatUtil {
    // 省略其他代码...

    public static void sendTemplateMessage(String accessToken, String templateId, String openId) throws Exception {
        String url = " + accessToken;
        URL obj = new URL(url);
        HttpURLConnection con = (HttpURLConnection) obj.openConnection();
        con.setRequestMethod("POST");
        con.setDoOutput(true);
        con.setRequestProperty("Content-Type", "application/json");

        JsonObject json = new JsonObject();
        json.addProperty("touser", openId);
        json.addProperty("template_id", templateId);
        json.addProperty("url", " // 可选链接
        json.add("data", new JsonObject()); // 根据模板格式构建数据

        OutputStream os = con.getOutputStream();
        os.write(json.toString().getBytes("UTF-8"));
        os.flush();
        os.close();

        // 处理返回值
        BufferedReader in = new BufferedReader(new InputStreamReader(con.getInputStream()));
        String inputLine;
        StringBuffer response = new StringBuffer();
        while ((inputLine = in.readLine()) != null) {
            response.append(inputLine);
        }
        in.close();
        
        // 返回结果
        System.out.println(response.toString());
    }
}
  • sendTemplateMessage 方法用于发送消息
  • 采用 POST 请求，必须设置参数以 JSON 格式发送
  • 需要构建一个 JSON 消息体，包括 touser（接收者 OpenID）、template_id、url 和 data

状态图

下面是整个过程的状态图，以便更好地理解各个步骤的状态变化。

stateDiagram
    [*] --> 创建服务号
    创建服务号 --> 获取 Access Token
    获取 Access Token --> 创建模板
    创建模板 --> 发送订阅通知
    发送订阅通知 --> [*]

结尾

通过上述步骤和代码示例，我们已经完成了微信服务号订阅通知的 Java 实现。可以看到，这个过程虽然分成几个步骤，但总体上还是较为简单。重要的是每一步都需要谨慎处理，尤其是获取 Access Token 和发送消息时的参数设置。

希望这篇文章能帮助你在实现微信服务号订阅通知时有所收获！如果有任何问题，欢迎随时提问。