public interface JavaMailSender extends MailSender
MailSender
インターフェース。直接の引数として、および準備コールバックを介して MIME メッセージをサポートします。通常、JavaMail MimeMessages
EE の便利な作成のために MimeMessageHelper
クラスと組み合わせて使用され、添付ファイルなどを含みます。 クライアントは、SimpleMailMessage
を超えるメール機能が必要な場合、このインターフェースを介してメール送信者と通信する必要があります。実動実装は JavaMailSenderImpl
です。テスト用に、このインターフェースに基づいてモックを作成できます。クライアントは通常、依存性注入を通じて JavaMailSender 参照を受け取ります。
このインターフェースの推奨される使用方法は MimeMessagePreparator
メカニズムであり、おそらくメッセージの取り込みに MimeMessageHelper
を使用します。例については、MimeMessageHelper's javadoc
を参照してください。
JavaMail 全体の Session
EE 管理は、JavaMailSender によって抽象化されます。クライアントコードは、セッションを何らかの方法で処理するのではなく、JavaMail 構成とリソース処理全体を JavaMailSender 実装に任せる必要があります。これにより、テスト性も向上します。
JavaMailSender クライアントは、プレーンな MailSender
クライアントほどテストが簡単ではありませんが、従来の JavaMail コードに比べれば、まだ簡単です。Session.getInstance(new Properties())
呼び出しで作成したプレーンな MimeMessage
EE を createMimeMessage()
が返すようにし、さまざまな send
メソッドのモック実装で渡されたメッセージをチェックするだけです。
MimeMessage
EE, Session
EE, JavaMailSenderImpl
, MimeMessagePreparator
, MimeMessageHelper
修飾子と型 | メソッドと説明 |
---|---|
MimeMessageEE | createMimeMessage() この送信者の基になる JavaMail セッション用の新しい JavaMail MimeMessage を作成します。 |
MimeMessageEE | createMimeMessage(InputStreamSE contentStream) 指定された入力ストリームをメッセージソースとして使用して、この送信者の基になる JavaMail セッションの新しい JavaMail MimeMessage を作成します。 |
void | send(MimeMessageEE... mimeMessages) JavaMail MIME メッセージの指定された配列をバッチで送信します。 |
void | send(MimeMessageEE mimeMessage) 指定された JavaMail MIME メッセージを送信します。 |
void | send(MimeMessagePreparator... mimeMessagePreparators) 指定された MimeMessagePreparators によって準備された JavaMail MIME メッセージを送信します。 |
void | send(MimeMessagePreparator mimeMessagePreparator) 指定された MimeMessagePreparator によって準備された JavaMail MIME メッセージを送信します。 |
send, send
MimeMessageEE createMimeMessage()
send(MimeMessage)
, send(MimeMessage[])
MimeMessageEE createMimeMessage(InputStreamSE contentStream) throws MailException
contentStream
- メッセージの生の MIME 入力ストリーム MailParseException
- メッセージ作成の失敗の場合 MailException
void send(MimeMessageEE mimeMessage) throws MailException
createMimeMessage()
で作成されている必要があります。mimeMessage
- 送信するメッセージ MailAuthenticationException
- 認証に失敗した場合 MailSendException
- メッセージ送信時に失敗した場合 MailException
createMimeMessage()
void send(MimeMessageEE... mimeMessages) throws MailException
createMimeMessage()
で作成されている必要があります。mimeMessages
- 送信するメッセージ MailAuthenticationException
- 認証に失敗した場合 MailSendException
- メッセージ送信時に失敗した場合 MailException
createMimeMessage()
void send(MimeMessagePreparator mimeMessagePreparator) throws MailException
createMimeMessage()
および send(MimeMessage)
呼び出しの代わりに、MimeMessage インスタンスを準備する代替方法。適切な例外変換を処理します。
mimeMessagePreparator
- 使用する準備 MailPreparationException
- メッセージの準備中に障害が発生した場合 MailParseException
- メッセージの解析中に障害が発生した場合 MailAuthenticationException
- 認証に失敗した場合 MailSendException
- メッセージ送信時に失敗した場合 MailException
void send(MimeMessagePreparator... mimeMessagePreparators) throws MailException
createMimeMessage()
および send(MimeMessage[])
呼び出しの代わりに、MimeMessage インスタンスを準備する代替方法。適切な例外変換を処理します。
mimeMessagePreparators
- 使用する準備 MailPreparationException
- メッセージの準備中にエラーが発生した場合 MailParseException
- メッセージの解析中にエラーが発生した場合 MailAuthenticationException
- 認証に失敗した場合 MailSendException
- メッセージ送信時に失敗した場合 MailException