XPages：使用Java代理发送邮件时的类型兼容问题

这个类型转换的坑我之前也踩过！你遇到的lotus.domino.local.Item incompatible with lotus.domino.RichTextItem错误，根源在于直接把document.getFirstItem("Body")强转为RichTextItem——但Domino邮件的Body字段确实可能是Text、RichTextItem或者MIMEEntity这几种类型，强转自然会触发类型不兼容异常。

下面给你一套分步处理的方案，确保兼容所有可能的Body类型：

1. 先获取原始Item对象，避免直接强转 #

首先不要上来就强转，先拿到基础的Item对象：

Item bodyItem = document.getFirstItem("Body");
RichTextItem bodyrt = memo.createRichTextItem("Body");
if (bodyItem != null) {
    // 下面根据Item实际类型做处理
}

2. 分类型处理不同的Body字段 #

针对三种可能的类型，分别做适配：

情况1：Body是RichTextItem类型 #

这是你原来的逻辑，但要先做类型校验再强转：

if (bodyItem instanceof RichTextItem) {
    RichTextItem body = (RichTextItem) bodyItem;
    bodyrt.appendRTItem(body);
}

情况2：Body是Text类型 #

如果是纯文本类型，取出文本内容追加到目标RichTextItem中：

else if (bodyItem instanceof Text) {
    Text bodyText = (Text) bodyItem;
    bodyrt.appendText(bodyText.getText());
    bodyrt.addNewLine(); // 可选：添加换行让格式更友好
}

情况3：Body是MIMEEntity类型 #

如果是MIME格式的邮件内容，有两种处理方式：

• 转成RichTextItem再追加：

else if (bodyItem instanceof MIMEEntity) {
    MIMEEntity mimeEntity = (MIMEEntity) bodyItem;
    // 将MIME内容转换为RichTextItem
    RichTextItem convertedRT = mimeEntity.convertToRichText();
    if (convertedRT != null) {
        bodyrt.appendRTItem(convertedRT);
        convertedRT.recycle(); // 记得回收Domino对象，避免内存泄漏
    }
}

• 如果你需要直接获取流（对应你代码里的stream = sessio...），可以直接从MIMEEntity取流：

else if (bodyItem instanceof MIMEEntity) {
    MIMEEntity mimeEntity = (MIMEEntity) bodyItem;
    stream = mimeEntity.getContentAsStream();
}

3. 重要提醒：回收Domino对象 #

Domino的本地对象（比如Item、RichTextItem、MIMEEntity）都需要手动调用recycle()方法释放资源，避免长期运行后出现内存泄漏问题。

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