企业微信api发送消息 java

原创

mob64ca12ef217e 2024-09-21 07:05:17 ©著作权

©著作权归作者所有：来自51CTO博客作者mob64ca12ef217e的原创作品，请联系作者获取转载授权，否则将追究法律责任

使用Java实现企业微信API发送消息

随着企业内部通讯的多样化，企业微信（WeChat Work）成为很多公司沟通的首选工具之一。通过它的API，开发者可以非常方便地在应用程序中实现消息的发送功能。本篇文章将带领你了解如何使用Java实现企业微信API发送消息的过程。

整体流程

在开始编码之前，我们首先明确整个实现过程的步骤。下面是一个简单的流程表：

步骤	详细描述
1	创建企业微信应用
2	获取Access Token
3	构建消息内容
4	发送消息到指定用户
5	处理响应和错误

为了更直观地理解，我们还将通过Mermaid语法绘制流程图：

flowchart TD
    A[创建企业微信应用] --> B[获取Access Token]
    B --> C[构建消息内容]
    C --> D[发送消息到指定用户]
    D --> E[处理响应和错误]

接下来，我们逐步深入每个步骤。

步骤1：创建企业微信应用

在使用企业微信API之前，你需要在[企业微信管理后台](

步骤2：获取Access Token

Access Token是企业微信API的访问凭证。它有一定的有效期，通常为两个小时。因此，我们需要定期获取并缓存它。下面是获取Access Token的代码示例。

import java.io.InputStreamReader;
import java.io.BufferedReader;
import java.net.HttpURLConnection;
import java.net.URL;
import org.json.JSONObject;

public class AccessTokenUtil {
    private static final String CORP_ID = "你的CorpID";
    private static final String SECRET = "你的Secret";

    public static String getAccessToken() {
        String accessToken = "";
        
        try {
            String url = " + CORP_ID + "&corpsecret=" + SECRET;
            HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
            conn.setRequestMethod("GET");
            BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()));
            String inputLine;
            StringBuilder responseBuilder = new StringBuilder();
            while ((inputLine = in.readLine()) != null) {
                responseBuilder.append(inputLine);
            }
            in.close();

            // 解析响应获取 access_token
            JSONObject jsonResponse = new JSONObject(responseBuilder.toString());
            accessToken = jsonResponse.getString("access_token");
        } catch (Exception e) {
            e.printStackTrace();
        }
        
        return accessToken;
    }
}

上述代码中，getAccessToken()方法用于向企业微信API请求Access Token，并通过JSON解析获取返回值中的access_token。

步骤3：构建消息内容

接下来，我们需要构建发送给特定用户的消息内容。企业微信支持多种类型的消息，比如文本、图片等。这里我们以文本消息为例。

public class Message {
    private String touser;
    private String msgtype;
    private String content;

    public Message(String touser, String content) {
        this.touser = touser;
        this.msgtype = "text";
        this.content = content;
    }

    public String toJson() {
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("touser", touser);
        jsonObject.put("msgtype", msgtype);
        jsonObject.put("text", new JSONObject().put("content", content));
        return jsonObject.toString();
    }
}

这个Message类用于构建消息对象，并提供将其转换为JSON格式的方法。

步骤4：发送消息到指定用户

发送消息的API为` Token与消息内容传入，下面是发送消息的代码。

public class WeChatMessageSender {
    public static void sendMessage(String accessToken, Message message) {
        try {
            String url = " + accessToken;
            HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
            conn.setRequestMethod("POST");
            conn.setRequestProperty("Content-Type", "application/json");
            conn.setDoOutput(true);

            // 将消息转化为JSON发送
            conn.getOutputStream().write(message.toJson().getBytes("UTF-8"));
            conn.connect();

            // 获取响应
            BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()));
            String inputLine;
            StringBuilder responseBuilder = new StringBuilder();
            while ((inputLine = in.readLine()) != null) {
                responseBuilder.append(inputLine);
            }
            in.close();

            System.out.println("Response: " + responseBuilder.toString());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

上述代码中，sendMessage()方法实现了向企业微信发送消息的功能。

步骤5：处理响应和错误

最后，我们需要处理发送消息后的响应。如果发送成功，API会返回相应的状态码和内容，开发者可以根据需求对这些数据进行处理。

public class Main {
    public static void main(String[] args) {
        String accessToken = AccessTokenUtil.getAccessToken();
        Message message = new Message("USER_ID", "你好，这是来自Java的消息！");
        WeChatMessageSender.sendMessage(accessToken, message);
    }
}

在Main类中，我们调用先前定义的方法，获取Access Token并发送消息。

类图

为了让你对结构有一个更清晰的了解，我们将应用中的主要类绘制为类图：

classDiagram
    class AccessTokenUtil {
        +String getAccessToken()
    }
    class Message {
        -String touser
        -String msgtype
        -String content
        +String toJson()
    }
    class WeChatMessageSender {
        +void sendMessage(String accessToken, Message message)
    }
    class Main {
        +void main(String[] args)
    }