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