インターフェース JavaMailSender
- すべてのスーパーインターフェース:
MailSender
- すべての既知の実装クラス:
JavaMailSenderImpl
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
メソッドのモック実装で渡されたメッセージをチェックするだけです。
- 導入:
- 07.10.2003
- 作成者:
- Juergen Hoeller
- 関連事項:
方法の概要
修飾子と型メソッド説明この送信者の基になる JavaMail セッション用の新しい JavaMail MimeMessage を作成します。createMimeMessage
(InputStreamSE contentStream) 指定された入力ストリームをメッセージソースとして使用して、この送信者の基になる JavaMail セッションの新しい JavaMail MimeMessage を作成します。default void
send
(MimeMessageEE mimeMessage) 指定された JavaMail MIME メッセージを送信します。void
send
(MimeMessageEE... mimeMessages) JavaMail MIME メッセージの指定された配列をバッチで送信します。default void
send
(MimeMessagePreparator mimeMessagePreparator) 指定された MimeMessagePreparator によって準備された JavaMail MIME メッセージを送信します。default void
send
(MimeMessagePreparator... mimeMessagePreparators) 指定された MimeMessagePreparators によって準備された JavaMail MIME メッセージを送信します。インターフェース org.springframework.mail.MailSender から継承されたメソッド
send, send
メソッドの詳細
createMimeMessage
MimeMessageEE createMimeMessage()この送信者の基になる JavaMail セッション用の新しい JavaMail MimeMessage を作成します。クライアントが準備して send(MimeMessage)に渡すことができる MimeMessage インスタンスを作成するために呼び出す必要があります。- 戻り値:
- 新しい MimeMessage インスタンス
- 関連事項:
createMimeMessage
指定された入力ストリームをメッセージソースとして使用して、この送信者の基になる JavaMail セッションの新しい JavaMail MimeMessage を作成します。- パラメーター:
contentStream
- メッセージの生の MIME 入力ストリーム- 戻り値:
- 新しい MimeMessage インスタンス
- 例外:
MailParseException
- メッセージ作成の失敗の場合MailException
send
指定された JavaMail MIME メッセージを送信します。メッセージはcreateMimeMessage()
で作成されている必要があります。- パラメーター:
mimeMessage
- 送信するメッセージ- 例外:
MailAuthenticationException
- 認証に失敗した場合MailSendException
- メッセージ送信時に失敗した場合MailException
- 関連事項:
send
JavaMail MIME メッセージの指定された配列をバッチで送信します。メッセージはcreateMimeMessage()
で作成されている必要があります。- パラメーター:
mimeMessages
- 送信するメッセージ- 例外:
MailAuthenticationException
- 認証に失敗した場合MailSendException
- メッセージ送信時に失敗した場合MailException
- 関連事項:
send
指定された MimeMessagePreparator によって準備された JavaMail MIME メッセージを送信します。createMimeMessage()
およびsend(MimeMessage)
呼び出しの代わりに、MimeMessage インスタンスを準備する代替方法。適切な例外変換を処理します。- パラメーター:
mimeMessagePreparator
- 使用する準備- 例外:
MailPreparationException
- メッセージの準備中に障害が発生した場合MailParseException
- メッセージの解析中に障害が発生した場合MailAuthenticationException
- 認証に失敗した場合MailSendException
- メッセージ送信時に失敗した場合MailException
send
指定された MimeMessagePreparators によって準備された JavaMail MIME メッセージを送信します。createMimeMessage()
およびsend(MimeMessage[])
呼び出しの代わりに、MimeMessage インスタンスを準備する代替方法。適切な例外変換を処理します。- パラメーター:
mimeMessagePreparators
- 使用する準備- 例外:
MailPreparationException
- メッセージの準備中にエラーが発生した場合MailParseException
- メッセージの解析中にエラーが発生した場合MailAuthenticationException
- 認証に失敗した場合MailSendException
- メッセージ送信時に失敗した場合MailException