クラス MimeMessageHelper
MimeMessage
EE を生成するためのヘルパークラス。SimpleMailMessage
の単純な setter をミラーリングし、値を基礎となる MimeMessage に直接適用します。このヘルパークラスのすべてのメソッドによって自動的に適用される、メッセージ全体の文字エンコードを定義できます。
HTML テキストコンテンツ、イメージなどのインライン要素、一般的なメール添付ファイルのサポートを提供します。メールアドレスに付随する個人名もサポートします。基になる MimeMessage オブジェクトに詳細設定を直接適用できることに注意してください!
通常、MimeMessagePreparator
実装または JavaMailSender
クライアントコードで使用されます。MimeMessage ラッパーとしてインスタンス化するだけで、ラッパーで setter を呼び出し、基礎となる MimeMessage をメール送信に使用します。JavaMailSenderImpl
によって内部的にも使用されます。
インラインイメージと PDF 添付ファイル付きの HTML メールのサンプルコード:
mailSender.send(new MimeMessagePreparator() { public void prepare(MimeMessage mimeMessage) throws MessagingException { MimeMessageHelper message = new MimeMessageHelper(mimeMessage, true, "UTF-8"); message.setFrom("[email protected]"); message.setTo("[email protected]"); message.setSubject("my subject"); message.setText("my text <img src='cid:myLogo'>", true); message.addInline("myLogo", new ClassPathResource("img/mylogo.gif")); message.addAttachment("myDocument.pdf", new ClassPathResource("doc/myDocument.pdf")); } });共通インターフェースを介して単純なメッセージまたは MIME メッセージとメッセージ入力コードをやり取りできるようにするために、このヘルパーの上で
MimeMailMessage
(SimpleMailMessage
と同様に共通の MailMessage
インターフェースを実装する)の使用を検討してください。マルチパートメールに関する警告 : HTML テキストのみを含み、インライン要素または添付ファイルを含まない単純な MIME メッセージは、HTML レンダリングが可能なメールクライアントで多かれ少なかれ機能します。ただし、インライン要素と添付ファイルは、依然としてメールクライアント間の主要な互換性の課題です。: インライン要素と添付ファイルを Microsoft Outlook、Lotus Notes、Mac Mail で機能させることは事実上不可能です。ニーズに合わせて特定のマルチパートモードを選択することを検討してください: MULTIPART_MODE 定数の javadoc には、より詳細な情報が含まれています。
- 導入:
- 19.01.2004
- 作成者:
- Juergen Hoeller, Sam Brannen
- 関連事項:
フィールドサマリー
フィールド修飾子と型フィールド説明static final int
型が "mixed" の単一ルートのマルチパート要素を持つマルチパートメッセージを示す定数。static final int
ルートのマルチパート要素が「混合」され、さらに「関連」型のネストされたマルチパート要素を持つマルチパートメッセージを示す定数。static final int
非マルチパートメッセージを示す定数。static final int
「関連」型の単一ルートのマルチパート要素を持つマルチパートメッセージを示す定数。コンストラクターのサマリー
コンストラクターコンストラクター説明MimeMessageHelper
(MimeMessageEE mimeMessage) 単純なテキストメッセージ(マルチパートコンテンツなし、つまり、メッセージを想定)を想定して、指定された MimeMessage の新しい MimeMessageHelper を作成します。MimeMessageHelper
(MimeMessageEE mimeMessage, boolean multipart) リクエストされた場合、マルチパートモード(代替テキスト、インライン要素、添付ファイルをサポート)で、指定された MimeMessage の新しい MimeMessageHelper を作成します。MimeMessageHelper
(MimeMessageEE mimeMessage, boolean multipart, StringSE encoding) リクエストされた場合、マルチパートモード(代替テキスト、インライン要素、添付ファイルをサポート)で、指定された MimeMessage の新しい MimeMessageHelper を作成します。MimeMessageHelper
(MimeMessageEE mimeMessage, int multipartMode) リクエストされた場合、マルチパートモード(代替テキスト、インライン要素、添付ファイルをサポート)で、指定された MimeMessage の新しい MimeMessageHelper を作成します。MimeMessageHelper
(MimeMessageEE mimeMessage, int multipartMode, StringSE encoding) リクエストされた場合、マルチパートモード(代替テキスト、インライン要素、添付ファイルをサポート)で、指定された MimeMessage の新しい MimeMessageHelper を作成します。MimeMessageHelper
(MimeMessageEE mimeMessage, StringSE encoding) 単純なテキストメッセージ(マルチパートコンテンツなし、つまり、メッセージを想定)を想定して、指定された MimeMessage の新しい MimeMessageHelper を作成します。メソッドのサマリー
修飾子と型メソッド説明void
addAttachment
(StringSE attachmentFilename, DataSourceEE dataSource) jakarta.activation.DataSource
からコンテンツを取得して、MimeMessage に添付ファイルを追加します。void
addAttachment
(StringSE attachmentFilename, FileSE file) java.io.File
からコンテンツを取得して、MimeMessage に添付ファイルを追加します。void
addAttachment
(StringSE attachmentFilename, InputStreamSource inputStreamSource) org.springframework.core.io.InputStreamResource
からコンテンツを取得して、MimeMessage に添付ファイルを追加します。void
addAttachment
(StringSE attachmentFilename, InputStreamSource inputStreamSource, StringSE contentType) org.springframework.core.io.InputStreamResource
からコンテンツを取得して、MimeMessage に添付ファイルを追加します。void
addBcc
(InternetAddressEE bcc) void
void
void
void
void
void
addInline
(StringSE contentId, DataSourceEE dataSource) MimeMessage にインライン要素を追加し、jakarta.activation.DataSource
からコンテンツを取得します。void
MimeMessage にインライン要素を追加し、java.io.File
からコンテンツを取得します。void
addInline
(StringSE contentId, InputStreamSource inputStreamSource, StringSE contentType) MimeMessage にインライン要素を追加し、org.springframework.core.InputStreamResource
からコンテンツを取得し、コンテンツ型を明示的に指定します。void
MimeMessage にインライン要素を追加し、org.springframework.core.io.Resource
からコンテンツを取得します。void
void
void
protected DataSourceEE
createDataSource
(InputStreamSource inputStreamSource, StringSE contentType, StringSE name) 指定された InputStreamSource のアクティベーションフレームワーク DataSource を作成します。protected void
createMimeMultiparts
(MimeMessageEE mimeMessage, int multipartMode) 使用する MimeMultipart オブジェクトを決定します。これは、一方で添付ファイルを保存し、他方でテキストおよびインライン要素を保存するために使用されます。protected StringSE
getDefaultEncoding
(MimeMessageEE mimeMessage) 指定された MimeMessage のデフォルトエンコーディングを決定します。protected FileTypeMapEE
getDefaultFileTypeMap
(MimeMessageEE mimeMessage) 指定された MimeMessage のデフォルトの Java Activation FileTypeMap を決定します。このメッセージに使用されている特定の文字エンコードがあれば、それを返します。この MimeMessageHelper が使用するFileTypeMap
を返します。final MimeMessageEE
基になる MimeMessage オブジェクトを返します。final MimeMultipartEE
基になる MIME "multipart/related" オブジェクトがある場合は、それを返します。final MimeMultipartEE
ルート MIME "multipart/mixed" オブジェクトがある場合は、それを返します。boolean
このヘルパーの#addAttachment
メソッドに渡された添付ファイル名をエンコードするかどうかを返します。final boolean
このヘルパーがマルチパートモードかどうか、つまりboolean
このヘルパーが渡されたすべてのアドレスを検証するかどうかを返します。void
setBcc
(InternetAddressEE bcc) void
setBcc
(InternetAddressEE[] bcc) void
void
void
void
setCc
(InternetAddressEE[] cc) void
void
void
setEncodeFilenames
(boolean encodeFilenames) このヘルパーの#addAttachment
メソッドに渡される添付ファイル名をエンコードするかどうかを設定します。void
setFileTypeMap
(FileTypeMapEE fileTypeMap) Java Activation フレームワークFileTypeMap
を設定して、メッセージに追加されるインラインコンテンツおよび添付ファイルのコンテンツ型を決定するために使用します。void
setFrom
(InternetAddressEE from) void
void
protected final void
setMimeMultiparts
(MimeMultipartEE root, MimeMultipartEE main) この MimeMessageHelper で使用するために、指定された MimeMultipart オブジェクトを設定します。void
setPriority
(int priority) メッセージの優先度( "X-Priority" ヘッダー)を設定します。void
setReplyTo
(InternetAddressEE replyTo) void
setReplyTo
(StringSE replyTo) void
setReplyTo
(StringSE replyTo, StringSE personal) void
setSentDate
(DateSE sentDate) メッセージの送信日を設定します。void
setSubject
(StringSE subject) 正しいエンコードを使用して、メッセージの件名を設定します。void
指定されたテキストを非マルチパートモードのコンテンツとして直接設定するか、マルチパートモードのデフォルトのボディパーツとして設定します。void
指定されたテキストを非マルチパートモードのコンテンツとして直接設定するか、マルチパートモードのデフォルトのボディパーツとして設定します。void
与えられたプレーンテキストと HTML テキストを代替として設定し、両方のオプションをメールクライアントに提供します。void
void
setTo
(InternetAddressEE[] to) void
void
void
setValidateAddresses
(boolean validateAddresses) このヘルパーに渡されるすべてのアドレスを検証するかどうかを設定します。protected void
validateAddress
(InternetAddressEE address) 指定されたメールアドレスを検証します。protected void
validateAddresses
(InternetAddressEE[] addresses) 指定されたすべてのメールアドレスを検証します。
フィールドの詳細
MULTIPART_MODE_NO
public static final int MULTIPART_MODE_NO非マルチパートメッセージを示す定数。- 関連事項:
MULTIPART_MODE_MIXED
public static final int MULTIPART_MODE_MIXED型が "mixed" の単一ルートのマルチパート要素を持つマルチパートメッセージを示す定数。テキスト、インライン要素、添付ファイルはすべて、そのルート要素に追加されます。これは Spring 1.0 のデフォルトの動作です。Outlook では正常に動作することがわかっています。ただし、他のメールクライアントは、インライン要素を添付ファイルとして誤って解釈したり、添付ファイルをインラインで表示したりする傾向があります。
- 関連事項:
MULTIPART_MODE_RELATED
public static final int MULTIPART_MODE_RELATED「関連」型の単一ルートのマルチパート要素を持つマルチパートメッセージを示す定数。テキスト、インライン要素、添付ファイルはすべて、そのルート要素に追加されます。これは、Spring 1.1 から 1.2 final までのデフォルトの動作でした。これは、Outlook からネイティブに送信される「Microsoft マルチパートモード」です。Outlook、Outlook Express、Yahoo Mail、Mac Mail(inline 要素もインラインで表示されているにもかかわらず、inline 要素に追加の添付ファイルがリストされている)で大部分が正常に動作することがわかっています。Lotus Notes では正しく機能しません(添付ファイルはここには表示されません)。
- 関連事項:
MULTIPART_MODE_MIXED_RELATED
public static final int MULTIPART_MODE_MIXED_RELATEDルートのマルチパート要素が「混合」され、さらに「関連」型のネストされたマルチパート要素を持つマルチパートメッセージを示す定数。テキストとインライン要素はネストされた "related" 要素に追加され、添付ファイルは「混合」ルート要素に追加されます。これは、Spring 1.2.1 以降のデフォルトです。MIME 仕様によると、これは間違いなく最も正しい MIME 構造です。Outlook、Outlook Express、Yahoo Mail、Lotus Notes で正しく動作することが知られています。Mac メールでは正しく動作しません。Mac メールを対象とする場合、または Outlook の特定のメールで問題が発生する場合は、代わりに MULTIPART_MODE_RELATED の使用を検討してください。
- 関連事項:
コンストラクターの詳細
MimeMessageHelper
単純なテキストメッセージ(マルチパートコンテンツ、つまり代替テキストやインライン要素や添付ファイルがない)を想定して、指定された MimeMessage の新しい MimeMessageHelper を作成します。メッセージの文字エンコードは、渡された場合、渡された MimeMessage オブジェクトから取得されます。そうでない場合、JavaMail のデフォルトのエンコードが使用されます。
MimeMessageHelper
単純なテキストメッセージ(マルチパートコンテンツ、つまり代替テキストやインライン要素や添付ファイルがない)を想定して、指定された MimeMessage の新しい MimeMessageHelper を作成します。- パラメーター:
mimeMessage
- 作業する MIME メッセージencoding
- メッセージに使用する文字エンコード- 関連事項:
MimeMessageHelper
リクエストされた場合、マルチパートモード(代替テキスト、インライン要素、添付ファイルをサポート)で、指定された MimeMessage の新しい MimeMessageHelper を作成します。MULTIPART_MODE_MIXED_RELATED 以外の特定のマルチパートモードを選択するには、multipartMode 引数を受け取る MimeMessageHelper コンストラクターの使用を検討してください。
メッセージの文字エンコードは、渡された場合、渡された MimeMessage オブジェクトから取得されます。そうでない場合、JavaMail のデフォルトのエンコードが使用されます。
- パラメーター:
mimeMessage
- 作業する MIME メッセージmultipart
- 代替テキスト、インライン要素、添付ファイルをサポートするマルチパートメッセージを作成するかどうか (MULTIPART_MODE_MIXED_RELATED に対応)- 例外:
MessagingExceptionEE
- マルチパート作成が失敗した場合- 関連事項:
MimeMessageHelper
public MimeMessageHelper(MimeMessageEE mimeMessage, boolean multipart, @Nullable StringSE encoding) throws MessagingExceptionEE リクエストされた場合、マルチパートモード(代替テキスト、インライン要素、添付ファイルをサポート)で、指定された MimeMessage の新しい MimeMessageHelper を作成します。MULTIPART_MODE_MIXED_RELATED 以外の特定のマルチパートモードを選択するには、multipartMode 引数を受け取る MimeMessageHelper コンストラクターの使用を検討してください。
- パラメーター:
mimeMessage
- 作業する MIME メッセージmultipart
- 代替テキスト、インライン要素、添付ファイルをサポートするマルチパートメッセージを作成するかどうか (MULTIPART_MODE_MIXED_RELATED に対応)encoding
- メッセージに使用する文字エンコード- 例外:
MessagingExceptionEE
- マルチパート作成が失敗した場合- 関連事項:
MimeMessageHelper
リクエストされた場合、マルチパートモード(代替テキスト、インライン要素、添付ファイルをサポート)で、指定された MimeMessage の新しい MimeMessageHelper を作成します。メッセージの文字エンコードは、渡された場合、渡された MimeMessage オブジェクトから取得されます。そうでない場合、JavaMail のデフォルトのエンコードが使用されます。
- パラメーター:
mimeMessage
- 作業する MIME メッセージmultipartMode
- 作成するマルチパートメッセージの種類 (MIXED、RELATED、MIXED_RELATED、NO)- 例外:
MessagingExceptionEE
- マルチパート作成が失敗した場合- 関連事項:
MimeMessageHelper
public MimeMessageHelper(MimeMessageEE mimeMessage, int multipartMode, @Nullable StringSE encoding) throws MessagingExceptionEE リクエストされた場合、マルチパートモード(代替テキスト、インライン要素、添付ファイルをサポート)で、指定された MimeMessage の新しい MimeMessageHelper を作成します。- パラメーター:
mimeMessage
- 作業する MIME メッセージmultipartMode
- 作成するマルチパートメッセージの種類 (MIXED、RELATED、MIXED_RELATED、NO)encoding
- メッセージに使用する文字エンコード- 例外:
MessagingExceptionEE
- マルチパート作成が失敗した場合- 関連事項:
メソッドの詳細
getMimeMessage
基になる MimeMessage オブジェクトを返します。createMimeMultiparts
protected void createMimeMultiparts(MimeMessageEE mimeMessage, int multipartMode) throws MessagingExceptionEE 使用する MimeMultipart オブジェクトを決定します。これは、一方で添付ファイルを保存し、他方でテキストおよびインライン要素を保存するために使用されます。テキストおよびインライン要素は、ルート要素自体(MULTIPART_MODE_MIXED、MULTIPART_MODE_RELATED)に格納するか、ルート要素ではなくネストした要素に直接格納する(MULTIPART_MODE_MIXED_RELATED)ことができます。
デフォルトでは、ルート MimeMultipart 要素の型は "mixed" (MULTIPART_MODE_MIXED)または "related" (MULTIPART_MODE_RELATED)です。メインのマルチパート要素は、「関連」型のネストされた要素(MULTIPART_MODE_MIXED_RELATED)として追加されるか、ルート要素自体(MULTIPART_MODE_MIXED、MULTIPART_MODE_RELATED)と同一になります。
- パラメーター:
mimeMessage
- ルート MimeMultipart オブジェクトを追加する MimeMessage オブジェクトmultipartMode
- コンストラクターに渡されるマルチパートモード (MIXED、RELATED、MIXED_RELATED、NO)- 例外:
MessagingExceptionEE
- マルチパート作成が失敗した場合- 関連事項:
setMimeMultiparts
protected final void setMimeMultiparts(@Nullable MimeMultipartEE root, @Nullable MimeMultipartEE main) この MimeMessageHelper で使用するために、指定された MimeMultipart オブジェクトを設定します。- パラメーター:
root
- 添付ファイルが追加されるルート MimeMultipart オブジェクト。またはnull
は、マルチパートがまったくないことを示しますmain
- メインの MimeMultipart オブジェクト。テキストとインライン要素が追加されます (ルートマルチパートオブジェクト、またはルートマルチパート要素にネストされた要素と同じにすることができます)
isMultipart
public final boolean isMultipart()このヘルパーがマルチパートモードかどうか、つまりマルチパートメッセージを保持しているかどうかを返します。getRootMimeMultipart
ルート MIME "multipart/mixed" オブジェクトがある場合は、それを返します。手動で添付ファイルを追加するために使用できます。これは、マルチパートメールの場合、MimeMessage の直接コンテンツになります。
- 例外:
IllegalStateExceptionSE
- このヘルパーがマルチパートモードでない場合- 関連事項:
getMimeMultipart
基になる MIME "multipart/related" オブジェクトがある場合は、それを返します。ボディパーツ、インライン要素などを手動で追加するために使用できます。これは、マルチパートメールの場合、ルート MimeMultipart 内にネストされます。
- 例外:
IllegalStateExceptionSE
- このヘルパーがマルチパートモードでない場合- 関連事項:
getDefaultEncoding
指定された MimeMessage のデフォルトエンコーディングを決定します。- パラメーター:
mimeMessage
- 渡された MimeMessage- 戻り値:
- MimeMessage に関連付けられたデフォルトのエンコーディング。見つからない場合は
null
getEncoding
このメッセージに使用されている特定の文字エンコードがあれば、それを返します。getDefaultFileTypeMap
指定された MimeMessage のデフォルトの Java Activation FileTypeMap を決定します。- パラメーター:
mimeMessage
- 渡された MimeMessage- 戻り値:
- MimeMessage に関連付けられたデフォルト FileTypeMap、またはメッセージに何も見つからない場合はデフォルト ConfigurableMimeFileTypeMap
- 関連事項:
setFileTypeMap
Java Activation フレームワークFileTypeMap
を設定して、メッセージに追加されるインラインコンテンツおよび添付ファイルのコンテンツ型を決定するために使用します。デフォルトは、基礎となる MimeMessage が持っている
FileTypeMap
(存在する場合)、またはアクティベーションフレームワークのデフォルトのFileTypeMap
インスタンス(それ以外の場合)です。- 関連事項:
addInline(java.lang.String, jakarta.activation.DataSource)
addAttachment(java.lang.String, jakarta.activation.DataSource)
getDefaultFileTypeMap(jakarta.mail.internet.MimeMessage)
JavaMailSenderImpl.setDefaultFileTypeMap(jakarta.activation.FileTypeMap)
FileTypeMap.getDefaultFileTypeMap()
EEConfigurableMimeFileTypeMap
getFileTypeMap
この MimeMessageHelper が使用するFileTypeMap
を返します。setEncodeFilenames
public void setEncodeFilenames(boolean encodeFilenames) このヘルパーの#addAttachment
メソッドに渡される添付ファイル名をエンコードするかどうかを設定します。標準の MIME 動作のデフォルトは
false
です。古いメールクライアントとの互換性のために、これをtrue
に変えてください。関連する注記については、JavaMail のmail.mime.encodefilename
システムプロパティを確認してください。注意 : JavaMail の標準
mail.mime.encodefilename
システムプロパティを優先して、デフォルトが 5.3 のfalse
に変更されました。isEncodeFilenames
public boolean isEncodeFilenames()このヘルパーの#addAttachment
メソッドに渡された添付ファイル名をエンコードするかどうかを返します。- 導入:
- 5.2.9
- 関連事項:
setValidateAddresses
public void setValidateAddresses(boolean validateAddresses) このヘルパーに渡されるすべてのアドレスを検証するかどうかを設定します。デフォルトは
false
です。isValidateAddresses
public boolean isValidateAddresses()このヘルパーが渡されたすべてのアドレスを検証するかどうかを返します。validateAddress
指定されたメールアドレスを検証します。MimeMessageHelper のすべてのアドレス setter および加算器によって呼び出されます。デフォルトの実装では、ヘルパーインスタンスのアドレス検証がアクティブになっている場合に
InternetAddress.validate()
EE を呼び出します。- パラメーター:
address
- 検証するアドレス- 例外:
AddressExceptionEE
- 検証に失敗した場合- 関連事項:
validateAddresses
指定されたすべてのメールアドレスを検証します。デフォルトの実装では、アドレスごとに
validateAddress(jakarta.mail.internet.InternetAddress)
に委譲するだけです。- パラメーター:
addresses
- 検証するアドレス- 例外:
AddressExceptionEE
- 検証に失敗した場合- 関連事項:
setFrom
setFrom
setFrom
public void setFrom(StringSE from, StringSE personal) throws MessagingExceptionEE, UnsupportedEncodingExceptionSE setReplyTo
setReplyTo
setReplyTo
public void setReplyTo(StringSE replyTo, StringSE personal) throws MessagingExceptionEE, UnsupportedEncodingExceptionSE setTo
setTo
setTo
setTo
addTo
addTo
addTo
public void addTo(StringSE to, StringSE personal) throws MessagingExceptionEE, UnsupportedEncodingExceptionSE setCc
setCc
setCc
setCc
addCc
addCc
addCc
public void addCc(StringSE cc, StringSE personal) throws MessagingExceptionEE, UnsupportedEncodingExceptionSE setBcc
setBcc
setBcc
setBcc
addBcc
addBcc
addBcc
public void addBcc(StringSE bcc, StringSE personal) throws MessagingExceptionEE, UnsupportedEncodingExceptionSE setPriority
メッセージの優先度( "X-Priority" ヘッダー)を設定します。- パラメーター:
priority
- 優先度値。通常、1(最高)から 5 の間 (下位)- 例外:
MessagingExceptionEE
- エラーの場合
setSentDate
メッセージの送信日を設定します。- パラメーター:
sentDate
- 設定する日付 (非null
)- 例外:
MessagingExceptionEE
- エラーの場合
setSubject
正しいエンコードを使用して、メッセージの件名を設定します。- パラメーター:
subject
- 件名テキスト- 例外:
MessagingExceptionEE
- エラーの場合
setText
指定されたテキストを、非マルチパートモードのコンテンツとして、またはマルチパートモードのデフォルトの本文パーツとして直接設定します。常にデフォルトのコンテンツ型 "text/plain" を適用します。注 :
setText
の後にaddInline(java.lang.String, jakarta.activation.DataSource)
を呼び出します。そうしないと、メールリーダーがインライン参照を正しく解決できない可能性があります。- パラメーター:
text
- メッセージのテキスト- 例外:
MessagingExceptionEE
- エラーの場合
setText
指定されたテキストを非マルチパートモードのコンテンツとして直接設定するか、マルチパートモードのデフォルトのボディパーツとして設定します。"html" フラグは、適用するコンテンツ型を決定します。注 :
setText
の後にaddInline(java.lang.String, jakarta.activation.DataSource)
を呼び出します。そうしないと、メールリーダーがインライン参照を正しく解決できない可能性があります。- パラメーター:
text
- メッセージのテキストhtml
- デフォルトのコンテンツ型("text/plain")を使用して、HTML メールにコンテンツ型 "text/html" を適用するかどうか- 例外:
MessagingExceptionEE
- エラーの場合
setText
与えられたプレーンテキストと HTML テキストを代替として設定し、両方のオプションをメールクライアントに提供します。マルチパートモードが必要です。注 :
setText
の後にaddInline(java.lang.String, jakarta.activation.DataSource)
を呼び出します。そうしないと、メールリーダーがインライン参照を正しく解決できない可能性があります。- パラメーター:
plainText
- メッセージのプレーンテキストhtmlText
- メッセージの HTML テキスト- 例外:
MessagingExceptionEE
- エラーの場合
addInline
MimeMessage にインライン要素を追加し、jakarta.activation.DataSource
からコンテンツを取得します。JavaMail は
getInputStream()
を複数回呼び出すため、DataSource 実装によって返される InputStream は各呼び出しで新しいものである必要があることに注意してください。注 :
setText(java.lang.String)
の後にaddInline
を呼び出します。そうしないと、メールリーダーがインライン参照を正しく解決できない可能性があります。- パラメーター:
contentId
- 使用するコンテンツ ID。本文部分の "Content-ID" ヘッダーとして、山括弧 括弧 で囲まれます。例: "myId" → "<myId>"。HTML ソースでは src="cid:myId" 式を使用して参照できます。dataSource
- コンテンツを取得するjakarta.activation.DataSource
、InputStream およびコンテンツ型を決定- 例外:
MessagingExceptionEE
- エラーの場合- 関連事項:
addInline
MimeMessage にインライン要素を追加し、java.io.File
からコンテンツを取得します。コンテンツ型は、指定されたコンテンツファイルの名前によって決定されます。任意のファイル名( ".tmp" などで終わる可能性がある)を持つ一時ファイルにはこれを使用しないでください!
注 :
setText(java.lang.String)
の後にaddInline
を呼び出します。そうしないと、メールリーダーがインライン参照を正しく解決できない可能性があります。- パラメーター:
contentId
- 使用するコンテンツ ID。本文部分の "Content-ID" ヘッダーとして、山括弧 括弧 で囲まれます。例: "myId" → "<myId>"。HTML ソースでは src="cid:myId" 式を使用して参照できます。file
- コンテンツを取得する File リソース- 例外:
MessagingExceptionEE
- エラーの場合- 関連事項:
addInline
MimeMessage にインライン要素を追加し、org.springframework.core.io.Resource
からコンテンツを取得します。コンテンツ型は、指定されたコンテンツファイルの名前によって決定されます。任意のファイル名( ".tmp" などで終わる可能性がある)を持つ一時ファイルにはこれを使用しないでください!
JavaMail は
getInputStream()
を複数回呼び出すため、リソース実装によって返される InputStream は各呼び出しで新しいものである必要があることに注意してください。注 :
setText(java.lang.String)
の後にaddInline
を呼び出します。そうしないと、メールリーダーがインライン参照を正しく解決できない可能性があります。- パラメーター:
contentId
- 使用するコンテンツ ID。本文部分の "Content-ID" ヘッダーとして、山括弧 括弧 で囲まれます。例: "myId" → "<myId>"。HTML ソースでは src="cid:myId" 式を使用して参照できます。resource
- コンテンツを取得するリソース- 例外:
MessagingExceptionEE
- エラーの場合- 関連事項:
addInline
public void addInline(StringSE contentId, InputStreamSource inputStreamSource, StringSE contentType) throws MessagingExceptionEE MimeMessage にインライン要素を追加し、org.springframework.core.InputStreamResource
からコンテンツを取得し、コンテンツ型を明示的に指定します。Java アクティベーションフレームワークの FileTypeMap(このヘルパーが保持するものなど)を介して、任意のファイル名のコンテンツ型を判別できます。
JavaMail は
getInputStream()
を複数回呼び出すため、InputStreamSource 実装によって返される InputStream は各呼び出しで新しいものである必要があることに注意してください。注 :
setText
の後にaddInline
を呼び出します。そうしないと、メールリーダーがインライン参照を正しく解決できない可能性があります。- パラメーター:
contentId
- 使用するコンテンツ ID。本文部分の "Content-ID" ヘッダーとして、山括弧 括弧 で囲まれます。例: "myId" → "<myId>"。HTML ソースでは src="cid:myId" 式を使用して参照できます。inputStreamSource
- コンテンツを取得するリソースcontentType
- 要素に使用するコンテンツ型- 例外:
MessagingExceptionEE
- エラーの場合- 関連事項:
addAttachment
public void addAttachment(StringSE attachmentFilename, DataSourceEE dataSource) throws MessagingExceptionEE jakarta.activation.DataSource
からコンテンツを取得して、MimeMessage に添付ファイルを追加します。JavaMail は
getInputStream()
を複数回呼び出すため、DataSource 実装によって返される InputStream は各呼び出しで新しいものである必要があることに注意してください。- パラメーター:
attachmentFilename
- メールに表示される添付ファイルの名前 (コンテンツ型はこれによって決定されます)dataSource
- コンテンツを取得するjakarta.activation.DataSource
、InputStream およびコンテンツ型を決定- 例外:
MessagingExceptionEE
- エラーの場合- 関連事項:
addAttachment
java.io.File
からコンテンツを取得して、MimeMessage に添付ファイルを追加します。コンテンツ型は、指定されたコンテンツファイルの名前によって決定されます。任意のファイル名( ".tmp" などで終わる可能性がある)を持つ一時ファイルにはこれを使用しないでください!
- パラメーター:
attachmentFilename
- メールに表示される添付ファイルの名前file
- コンテンツを取得する File リソース- 例外:
MessagingExceptionEE
- エラーの場合- 関連事項:
addAttachment
public void addAttachment(StringSE attachmentFilename, InputStreamSource inputStreamSource) throws MessagingExceptionEE org.springframework.core.io.InputStreamResource
からコンテンツを取得して、MimeMessage に添付ファイルを追加します。コンテンツ型は、添付ファイルのファイル名によって決まります。任意のファイル名の一時ファイルを含め、どのコンテンツソースでも問題ありません。
JavaMail は
getInputStream()
を複数回呼び出すため、InputStreamSource 実装によって返される InputStream は各呼び出しで新しいものである必要があることに注意してください。- パラメーター:
attachmentFilename
- メールに表示される添付ファイルの名前inputStreamSource
- コンテンツを取得するリソース (Spring のすべての Resource 実装をここに渡すことができます)- 例外:
MessagingExceptionEE
- エラーの場合- 関連事項:
addAttachment
public void addAttachment(StringSE attachmentFilename, InputStreamSource inputStreamSource, StringSE contentType) throws MessagingExceptionEE org.springframework.core.io.InputStreamResource
からコンテンツを取得して、MimeMessage に添付ファイルを追加します。JavaMail は
getInputStream()
を複数回呼び出すため、InputStreamSource 実装によって返される InputStream は各呼び出しで新しいものである必要があることに注意してください。- パラメーター:
attachmentFilename
- メールに表示される添付ファイルの名前inputStreamSource
- コンテンツを取得するリソース (Spring のすべての Resource 実装をここに渡すことができます)contentType
- 要素に使用するコンテンツ型- 例外:
MessagingExceptionEE
- エラーの場合- 関連事項:
createDataSource
protected DataSourceEE createDataSource(InputStreamSource inputStreamSource, StringSE contentType, StringSE name) 指定された InputStreamSource のアクティベーションフレームワーク DataSource を作成します。- パラメーター:
inputStreamSource
- InputStreamSource (通常は Spring リソース)contentType
- コンテンツ型name
- DataSource の名前- 戻り値:
- アクティベーションフレームワーク DataSource