如何借助Spring Integration访问已读历史邮件并按需获取附件？

我正在开发一个动态多IMAP通道监听应用。为提升效率，我不会自动下载邮件附件，仅获取邮件文本内容。同时我正在开发一个端点，用于访问已接收的历史邮件并下载返回附件，实现仅在有需求时才下载附件的功能。

我在集成流中使用ImapIdleChannelAdapter监听邮件，以下是我的流代码：

public ImapIdleChannelAdapter mailAdapter(ImapMailReceiver receiver) {
        ImapIdleChannelAdapter imapAdapter = new ImapIdleChannelAdapter(receiver);
        imapAdapter.setAutoStartup(true);
        return imapAdapter;
    }

public IntegrationFlow createMailFlow(GmailRecieverRequirements requirements, String clientID) {
        return IntegrationFlow.from(
                mailAdapter(gmailMailReceiver(requirements)))
                .handle(getMailHandler())
                .get();
    }

我的问题是：如何在不同时间访问这些已读取的邮件？我了解Java Mail有Folder-UID结构可通过UID访问邮件，但我不想在流中使用Java Mail来保存UID。能否在Spring Integration的流中获取邮件的UID？我也接受其他解决方案。

1. 从Spring Integration消息头直接提取UID #

Spring Integration的ImapMailReceiver会自动把邮件UID注入到消息头中，对应的头常量是ImapHeaders.UID（实际值为"imap_uid"），无需直接操作Java Mail的UIDFolder就能获取：

在你的getMailHandler()处理逻辑中，可以这样获取并保存UID：

public class MailHandler implements MessageHandler {
    @Override
    public void handleMessage(Message<?> message) throws MessagingException {
        // 从消息头获取邮件UID
        Long mailUid = (Long) message.getHeaders().get(ImapHeaders.UID);
        // 同时可获取邮件所在文件夹名
        String folderName = (String) message.getHeaders().get(ImapHeaders.FOLDER);
        // 将UID、clientID、邮件文本等元数据存入数据库/缓存，供后续端点查询使用
        persistMailMetadata(mailUid, folderName, clientID, message.getPayload());
    }
}

2. 通过UID后续下载附件 #

当用户触发附件下载请求时，利用保存的UID和文件夹信息，可通过封装的工具类（基于Java Mail或Spring Integration）获取指定邮件并解析附件：

public List<Attachment> fetchAttachments(Long uid, String folder, GmailRecieverRequirements requirements) throws MessagingException {
    ImapMailReceiver receiver = gmailMailReceiver(requirements);
    receiver.setFolder(folder);
    Folder mailFolder = receiver.getFolder();
    mailFolder.open(Folder.READ_ONLY);
    
    if (mailFolder instanceof UIDFolder) {
        UIDFolder uidFolder = (UIDFolder) mailFolder;
        Message targetMail = uidFolder.getMessageByUID(uid);
        // 解析邮件中的附件并返回
        return parseAttachmentsFromMail(targetMail);
    }
    
    mailFolder.close(false);
    return Collections.emptyList();
}

3. 替代方案：持久化元数据管理 #

如果不想手动处理UID存储，可将邮件元数据（UID、clientID、接收时间、文件夹等）持久化到数据库，后续端点通过条件查询（如clientID、时间范围）获取对应UID，再执行附件下载逻辑。这种方式更灵活，适配多IMAP通道的动态场景。

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