如何结合MS Graph API使用javax.mail/jakarta.mail并兼容遗留代码？

一、可以保留javax.mail/jakarta.mail抽象 #

核心思路是用适配器模式封装Graph API的调用逻辑，让遗留代码继续依赖javax.mail的抽象接口，底层由基于Graph API的实现类提供服务：

• 实现javax.mail.Store（或jakarta.mail.Store）的自定义子类：
  • 重写connect()方法，内部完成Graph API的OAuth2.0令牌获取（替代传统的IMAP/SMTP协议连接）
  • 实现getFolder()等方法，将文件夹操作映射到Graph API的/me/mailFolders等端点
• 实现javax.mail.Message的自定义子类：
  • 内部持有Graph的邮件模型（或直接解析REST返回的JSON数据）
  • 重写getSubject()、getContent()、getRecipients()等方法，将Graph模型的属性映射到javax.mail接口的要求
• 同理适配Folder、Session等其他核心类，遗留代码无需修改，直接调用原有抽象接口即可。

示例伪代码：

public class GraphMailStore extends javax.mail.Store {
    private CloseableHttpClient httpClient; // 用HTTP客户端直接调用REST接口

    @Override
    public void connect(String host, String user, String password) throws MessagingException {
        // 这里实现OAuth2.0令牌获取逻辑，初始化HTTP客户端
    }

    @Override
    public Folder getFolder(String name) throws MessagingException {
        return new GraphMailFolder(httpClient, name);
    }
}

public class GraphMailMessage extends javax.mail.Message {
    private JsonObject graphMessageJson; // 解析REST返回的JSON数据

    public GraphMailMessage(JsonObject graphMessageJson) {
        this.graphMessageJson = graphMessageJson;
    }

    @Override
    public String getSubject() throws MessagingException {
        return graphMessageJson.getString("subject");
    }

    @Override
    public Object getContent() throws MessagingException, IOException {
        return graphMessageJson.getJsonObject("body").getString("content");
    }
}

二、可以不依赖MS Java Graph SDK实现 #

Graph API本质是RESTful接口，完全可以直接用HTTP客户端（如OkHttp、Apache HttpClient）发送请求、解析JSON响应，再通过适配器转换为javax.mail抽象类型：

• 自行处理OAuth2.0授权流程，获取访问令牌
• 直接调用Graph API的REST端点，比如：
  • 获取邮件：GET https://graph.microsoft.com/v1.0/me/messages
  • 获取文件夹：GET https://graph.microsoft.com/v1.0/me/mailFolders
• 将返回的JSON数据解析为自定义POJO或直接操作JSON对象，再映射到javax.mail的接口实现中

这种方式避免了引入MS Graph SDK的依赖，同时保持对javax.mail抽象的兼容，但需要自行处理HTTP请求、JSON解析和错误处理逻辑。

注意事项 #

• 权限适配：Graph API使用OAuth2.0授权，需要替换原有用户名密码的认证逻辑，申请对应的邮件权限（如Mail.Read、Mail.Send等）
• 功能映射：部分javax.mail的高级功能（如复杂邮件搜索条件）需要对应到Graph API的查询参数或组合多个接口调用实现
• 版本兼容：如果迁移到jakarta.mail，只需将适配器实现的接口包名从javax.mail替换为jakarta.mail，逻辑完全一致

内容的提问来源于stack exchange，提问作者Eugene S