3.10.2.1. 发送方法

要发送电子邮件,在中间件上应使用 EmailerAPI bean,在客户端层使用 EmailService 服务。

这些组件的基本方法如下所述:

  • sendEmail() – 同步发送消息。调用代码在消息发送到 SMTP 服务器前一直等待。

    消息内容由一组参数(逗号分隔的收件人列表,主题,内容,附件数组)组成,并以 EmailInfo 对象的形式传输,该对象封装了所有这些信息并允许显式设置发件人的地址并使用 FreeMarker 模板构造邮件正文。

    同步发送时可能会抛出 EmailException,其中包含投递失败的收件人地址的信息,以及相应的错误消息。

    执行该方法期间,在数据库中为每个收件人创建一个 SendingMessage 实例。发送状态初始值为 SendingStatus.SENDING,成功发送后状态变为 SendingStatus.SENT。如果消息发送错误,消息状态将更改为 SendingStatus.NOTSENT

  • sendEmailAsync() - 异步发送消息。此方法返回在数据库中创建的 SendingStatus.QUEUE 状态的 SendingMessage 实例的列表(列表数量按收件人数)。实际发送是通过随后调用 EmailerAPI.processQueuedEmails() 方法执行的,需要为 计划任务设置符合期望的发送邮件频率来调用此方法。