|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
public interface MimePart
MimePart インタフェースは、MIME (RFC2045, Section 2.4) で定義される Entity をモデル化します。
MimePart は Part インタフェースを拡張し、補足的な RFC822 及び MIME 固有のセマンティクスと属性を追加します。 これは MimeMessage 及び MimeBodyPart クラスの基本インタフェースを提供します。
RFC822 及び MIME ヘッダフィールドは US-ASCII 文字だけを含まなければなりません。
ヘッダが US-ASCII 以外の文字を含む場合、RFC 2047 の規則に従ってエンコードされなければなりません。
このパッケージで提供される MimeUtility クラスを用いてこれを行う事ができます。
setHeader
、addHeader
、及び addHeaderLine
メソッドの呼び出し側は、
指定されたヘッダが MIME 要件に従う事を保証する必要があります。
又、これらのヘッダフィールドが転送における行の長さ制限 (SMTP の場合は 1000バイト) を超える場合は、
送信の前に折りたたむ (ラップする) 必要があります。
受信ヘッダは折りたたまれている可能性があります。
アプリケーションはヘッダを適切に折りたたみ、展開する責任があります。
MimeUtility
,
Part
フィールドの概要 |
---|
インタフェース javax.mail.Part から継承されたフィールド |
---|
ATTACHMENT, INLINE |
メソッドの概要 | |
---|---|
void |
addHeaderLine(String line)
生の RFC822 ヘッダ行を追加します。 |
Enumeration |
getAllHeaderLines()
全てのヘッダ行を String の列挙型として取得します。 |
String |
getContentID()
この部分の Content-ID を取得します。 |
String[] |
getContentLanguage()
この MimePart の Content-Language ヘッダで指定される言語タグを取得します。 |
String |
getContentMD5()
この部分の Content-MD5 ダイジェストを取得します。 |
String |
getEncoding()
この部分の転送エンコーディングを取得します。 |
String |
getHeader(String name,
String delimiter)
このヘッダについて使用可能な全てのヘッダフィールドの値を取得し、 区切り文字で区切られた値が単一の String として返されます、 区切り文字が null の場合は、最初の値だけが返されます。 |
Enumeration |
getMatchingHeaderLines(String[] names)
一致するヘッダ行を String の列挙型として取得します。 |
Enumeration |
getNonMatchingHeaderLines(String[] names)
一致しないヘッダ行を String の列挙型として取得します。 |
void |
setContentLanguage(String[] languages)
この MimePart の Content-Language ヘッダを設定します。 |
void |
setContentMD5(String md5)
この部分の Content-MD5 を設定します。 |
void |
setText(String text)
指定された String をこの部分のコンテンツとして、 "text/plain" の MIME タイプで設定する簡易メソッドです。 |
void |
setText(String text,
String charset)
"text/plain" の MIME タイプ及び指定された文字セットを使用し、 指定された String をこの部分のコンテンツとして設定する簡易メソッドです。 |
インタフェース javax.mail.Part から継承されたメソッド |
---|
addHeader, getAllHeaders, getContent, getContentType, getDataHandler, getDescription, getDisposition, getFileName, getHeader, getInputStream, getLineCount, getMatchingHeaders, getNonMatchingHeaders, getSize, isMimeType, removeHeader, setContent, setContent, setDataHandler, setDescription, setDisposition, setFileName, setHeader, writeTo |
メソッドの詳細 |
---|
String getHeader(String name, String delimiter) throws MessagingException
null
の場合は、最初の値だけが返されます。
name
- このヘッダの名前delimiter
- delimiter between fields in returned string
MessagingException
void addHeaderLine(String line) throws MessagingException
IllegalWriteException
- 実装が変更をサポートしない場合
IllegalStateException
- この Part が READ_ONLY フォルダから取得された場合
MessagingException
Enumeration getAllHeaderLines() throws MessagingException
MessagingException
Enumeration getMatchingHeaderLines(String[] names) throws MessagingException
MessagingException
Enumeration getNonMatchingHeaderLines(String[] names) throws MessagingException
MessagingException
String getEncoding() throws MessagingException
MessagingException
String getContentID() throws MessagingException
MessagingException
String getContentMD5() throws MessagingException
MessagingException
void setContentMD5(String md5) throws MessagingException
md5
- コンテンツ ID
IllegalWriteException
- 実装が変更をサポートしない場合
IllegalStateException
- この Part が READ_ONLY フォルダから取得された場合
MessagingException
String[] getContentLanguage() throws MessagingException
null
を返します。
MessagingException
void setContentLanguage(String[] languages) throws MessagingException
languages
- 言語タグの配列
IllegalWriteException
- 実装が変更をサポートしない場合
IllegalStateException
- この Part が READ_ONLY フォルダから取得された場合
MessagingException
void setText(String text) throws MessagingException
このメソッドは使用する文字セットを決める為に全ての文字を走査しなければならない場合があるので、 text が大きい場合は、性能が低下する可能性がある事に注意して下さい。
文字セットが既知の場合、文字セットパラメータを受け取る setText() バージョンを使用して下さい。
Part
内の setText
text
- Message のコンテンツであるテキスト
IllegalWriteException
- 実装がこのヘッダの変更をサポートしない場合
MessagingException
setText(String text, String charset)
void setText(String text, String charset) throws MessagingException
MessagingException
|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |