程序包 cn.taketoday.context.support.mail.javamail

接口 JavaMailSender

所有超级接口:
MailSender
所有已知实现类:
JavaMailSenderImpl
public interface JavaMailSender extends MailSender
Extended MailSender interface for JavaMail, supporting MIME messages both as direct arguments and through preparation callbacks. Typically used in conjunction with the MimeMessageHelper class for convenient creation of JavaMail MimeMessages, including attachments etc.

Clients should talk to the mail sender through this interface if they need mail functionality beyond SimpleMailMessage. The production implementation is JavaMailSenderImpl; for testing, mocks can be created based on this interface. Clients will typically receive the JavaMailSender reference through dependency injection.

The recommended way of using this interface is the MimeMessagePreparator mechanism, possibly using a MimeMessageHelper for populating the message. See MimeMessageHelper's javadoc for an example.

The entire JavaMail Session management is abstracted by the JavaMailSender. Client code should not deal with a Session in any way, rather leave the entire JavaMail configuration and resource handling to the JavaMailSender implementation. This also increases testability.

A JavaMailSender client is not as easy to test as a plain MailSender client, but still straightforward compared to traditional JavaMail code: Just let createMimeMessage() return a plain MimeMessage created with a Session.getInstance(new Properties()) call, and check the passed-in messages in your mock implementations of the various send methods.

从以下版本开始:
4.0
作者:
Juergen Hoeller, Harry Yang
另请参阅:

  • 方法概要

    修饰符和类型
    方法
    说明
    jakarta.mail.internet.MimeMessage
    createMimeMessage()
    Create a new JavaMail MimeMessage for the underlying JavaMail Session of this sender.
    jakarta.mail.internet.MimeMessage
    createMimeMessage(InputStream contentStream)
    Create a new JavaMail MimeMessage for the underlying JavaMail Session of this sender, using the given input stream as the message source.
    void
    send(MimeMessagePreparator mimeMessagePreparator)
    Send the JavaMail MIME message prepared by the given MimeMessagePreparator.
    void
    send(MimeMessagePreparator... mimeMessagePreparators)
    Send the JavaMail MIME messages prepared by the given MimeMessagePreparators.
    void
    send(jakarta.mail.internet.MimeMessage mimeMessage)
    Send the given JavaMail MIME message.
    void
    send(jakarta.mail.internet.MimeMessage... mimeMessages)
    Send the given array of JavaMail MIME messages in batch.

    从接口继承的方法 cn.taketoday.context.support.mail.MailSender

    send, send