javax.mail.internet
クラス MimeBodyPart

java.lang.Object
  |
  +--javax.mail.BodyPart
        |
        +--javax.mail.internet.MimeBodyPart

すべての実装インタフェース:

MimePart, Part

public class MimeBodyPart

extends BodyPart

implements MimePart

このクラスは MIME 本文部分を表します。これは BodyPart 抽象クラスと MimePart インタフェースを実装します。MimeBodyParts は MimeMultipart オブジェクトに含まれます。

MimeBodyPart は InternetHeaders クラスを使用し、本文部分のヘッダを構文解析し、格納します。

RFC822 および MIME ヘッダに関するメモ

RFC822 ヘッダフィールドは US-ASCII 文字だけを含まなければなりません。MIME では ASCII 以外の文字をエンコーディングすることにより、特定のヘッダの特定の部分に設定可能です。RFC 2047 はこの処理の規則を指定します。このパッケージで提供される MimeUtility クラスを用いて、この処理を行うことができます。setHeader、addHeader、および addHeaderLine メソッドの呼び出し側は指定されたヘッダが MIME 要件に従うことを保証しなければなりません。また、これらのヘッダフィールドが転送における行の長さ制限 (SMTP の場合は 1000バイト) を超える場合は、送信の前に折りたたむ (ラップする) 必要があります。受信ヘッダは折りたたまれている可能性があります。アプリケーションはヘッダを適切に折りたたみ、展開する責任があります。

関連項目:

Part, MimePart, MimeUtility

フィールドの概要

protected byte[]	content この Part の内容のバイトを保持するバイト配列です。
protected java.io.InputStream	contentStream この本文部分のデータが SharedInputStream インタフェースを実装する InputStream により供給された場合、contentStream がこの本文部分の内容を表すもう 1 つのストリームです。
protected DataHandler	dh この Part の内容を表す DataHandler オブジェクトです。
protected InternetHeaders	headers この本文部分のすべてのヘッダを格納する InternetHeaders オブジェクトです。

クラス javax.mail.BodyPart から継承したフィールド

parent

インタフェース javax.mail.Part から継承したフィールド

ATTACHMENT, INLINE

コンストラクタの概要

MimeBodyPart()
空の MimeBodyPart オブジェクトが作成されます。

MimeBodyPart(java.io.InputStream is)
指定された入力ストリームからのデータを読み取り、構文解析することにより、MimeBodyPart を構築します。

MimeBodyPart(InternetHeaders headers, byte[] content)
指定されたヘッダと内容バイトを使用して MimeBodyPart を構築します。

メソッドの概要

void	addHeader(java.lang.String name, java.lang.String value) この値をこの header_name の既存値に追加します。
void	addHeaderLine(java.lang.String line) ヘッダ行をこの本文部分に追加します。
java.util.Enumeration	getAllHeaderLines() すべてのヘッダ行を String の Enumeration として取得します。
java.util.Enumeration	getAllHeaders() この Message のすべてのヘッダを Header オブジェクトの Enumeration として返します。
java.lang.Object	getContent() 内容を java オブジェクトとして返します。
java.lang.String	getContentID() 「Content-ID」ヘッダフィールドの値を返します。
java.lang.String[]	getContentLanguage() この MimePart の Content-Language ヘッダで指定される言語を取得します。
java.lang.String	getContentMD5() 「Content-MD5」ヘッダフィールドの値を返します。
protected java.io.InputStream	getContentStream() 内容の raw バイトを生成します。
java.lang.String	getContentType() RFC 822「Content-Type」ヘッダフィールドの値を返します。
DataHandler	getDataHandler() この本文部分の内容の DataHandler を返します。
java.lang.String	getDescription() この本文部分の「Content-Description」ヘッダフィールドを返します。
java.lang.String	getDisposition() 「Content-Disposition」ヘッダフィールドの値を返します。
java.lang.String	getEncoding() 「Content-Transfer-Encoding」ヘッダフィールドからの内容転送エンコーディングを返します。
java.lang.String	getFileName() この本文部分に関連付けられたファイル名を取得します。
java.lang.String[]	getHeader(java.lang.String name) この header_name のすべてのヘッダを取得します。
java.lang.String	getHeader(java.lang.String name, java.lang.String delimiter) このヘッダ名のすべてのヘッダを取得し、区切り文字で区切られたヘッダが単一の String として返されます、区切り文字が null の場合は、最初のヘッダだけが返されます。
java.io.InputStream	getInputStream() この本文部分の「content」に対するデコードされた入力ストリームを返します。
int	getLineCount() この Part の内容の行数を返します。
java.util.Enumeration	getMatchingHeaderLines(java.lang.String[] names) 一致するヘッダ行を String の Enumeration として取得します。
java.util.Enumeration	getMatchingHeaders(java.lang.String[] names) この Message の一致するヘッダを Header オブジェクトの Enumeration として返します。
java.util.Enumeration	getNonMatchingHeaderLines(java.lang.String[] names) 一致しないヘッダ行を String の Enumeration として取得します。
java.util.Enumeration	getNonMatchingHeaders(java.lang.String[] names) この Message の一致しないヘッダを Header オブジェクトの Enumeration として返します。
java.io.InputStream	getRawInputStream() 任意の Content-Transfer-Encoding をそのままにして、raw データへの InputStream を返します。
int	getSize() この本文部分の内容サイズをバイト単位で返します。
boolean	isMimeType(java.lang.String mimeType) 指定された MIME タイプの Part かどうかを識別します。
void	removeHeader(java.lang.String name) この名前を持つすべてのヘッダを削除します。
void	setContent(Multipart mp) このメソッドは本文部分の内容を Multipart オブジェクトに設定します。
void	setContent(java.lang.Object o, java.lang.String type) この本文部分の内容を設定するための簡易メソッドです。
void	setContentLanguage(java.lang.String[] languages) この MimePart の Content-Language ヘッダを設定します。
void	setContentMD5(java.lang.String md5) この本文部分の「Content-MD5」ヘッダフィールドを設定します。
void	setDataHandler(DataHandler dh) このメソッドは、この本文部分の内容を設定するための仕組みを提供します。
void	setDescription(java.lang.String description) この本文部分の「Content-Description」ヘッダフィールドを設定します。
void	setDescription(java.lang.String description, java.lang.String charset) この本文部分の「Content-Description」ヘッダを設定します。
void	setDisposition(java.lang.String disposition) この本文部分の「Content-Disposition」ヘッダフィールドを設定します。
void	setFileName(java.lang.String filename) 可能であれば、この本文部分に関連付けられたファイル名を設定します。
void	setHeader(java.lang.String name, java.lang.String value) この header_name の値を設定します。
void	setText(java.lang.String text) 指定された String をこの部分のコンテンツとして、「text/plain」の MIME タイプで設定する簡易メソッドです。
void	setText(java.lang.String text, java.lang.String charset) 「text/plain」の MIME タイプおよび指定された文字セットを使用し、指定された String をこの部分のコンテンツとして設定する簡易メソッドです。
protected void	updateHeaders() この本文部分の内容を検査し、適切な MIME ヘッダを更新します。
void	writeTo(java.io.OutputStream os) 本文部分を RFC 822 形式のストリームとして出力します。

クラス javax.mail.BodyPart から継承したメソッド

getParent

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

dh

protected DataHandler dh

この Part の内容を表す DataHandler オブジェクトです。

content

protected byte[] content

この Part の内容のバイトを保持するバイト配列です。

contentStream

protected java.io.InputStream contentStream

この本文部分のデータが SharedInputStream インタフェースを実装する InputStream により供給された場合、contentStream がこの本文部分の内容を表すもう 1 つのストリームです。この場合、content は null です。

導入されたバージョン:

JavaMail 1.2

headers

protected InternetHeaders headers

この本文部分のすべてのヘッダを格納する InternetHeaders オブジェクトです。

コンストラクタの詳細

MimeBodyPart

public MimeBodyPart()

空の MimeBodyPart オブジェクトが作成されます。この本文部分は multipart メッセージを構築するクライアントにより記入される場合があります。

MimeBodyPart

public MimeBodyPart(java.io.InputStream is)
             throws MessagingException

指定された入力ストリームからのデータを読み取り、構文解析することにより、MimeBodyPart を構築します。パーサは、指定された入力ストリームの終わりまでデータを消費します。入力ストリームは有効な MIME 本文部分の先頭から始まり、その本文部分の終わりで終了しなければなりません。

本文部分を区切る「境界」文字列は入力ストリームに含まれていてはなりません。MimeMultipart パーサは maultipart ストリームから各本文部分のバイトを抽出し、区切り文字列なしでこのコンストラクタに与えます。

パラメータ:

is - 本文部分の Input Stream

MimeBodyPart

public MimeBodyPart(InternetHeaders headers,
                    byte[] content)
             throws MessagingException

指定されたヘッダと内容バイトを使用して MimeBodyPart を構築します。

プロバイダが使用します。

パラメータ:

headers - この部分のヘッダ

content - この部分の本文を表すバイト

メソッドの詳細

getSize

public int getSize()
            throws MessagingException

この本文部分の内容サイズをバイト単位で返します。サイズが識別できない場合は -1 を返します。

この数値は内容サイズの正確な測定値でない可能性があり、内容の転送エンコーディングを示すこともそうでないこともある点に注意してください。

この実装は、content 配列 のサイズ (null でない場合)、または contentStream が null でなく、available メソッドが正の数を返す場合、その数をサイズとして返します。それ以外の場合は -1 を返します。

定義:

インタフェース Part 内の getSize

戻り値:

バイト単位のサイズ、または不明の場合 -1

getLineCount

public int getLineCount()
                 throws MessagingException

この Part の内容の行数を返します。この数値が識別できない場合は -1 を返します。

この数値は内容の長さの正確な測定値でない可能性があり、内容の転送エンコーディングを示すこともそうでないこともある点に注意してください。

この実装は -1 を返します。

定義:

インタフェース Part 内の getLineCount

戻り値:

行数、または不明の場合 -1

getContentType

public java.lang.String getContentType()
                                throws MessagingException

RFC 822「Content-Type」ヘッダフィールドの値を返します。これは、この本文部分の内容のコンテンツ形式を表します。この値は null であってはなりません。このフィールドが使用可能でない場合、「text/plain」が返されます。

この実装は getHeader(name) を使用し、必要なヘッダフィールドを取得します。

定義:

インタフェース Part 内の getContentType

戻り値:

この本文部分の Content-Type

isMimeType

public boolean isMimeType(java.lang.String mimeType)
                   throws MessagingException

指定された MIME タイプの Part かどうかを識別します。このメソッドは、primaryType と subType のみを比較します。コンテンツ形式のパラメータは無視されます。

たとえば、コンテンツ形式 「text/plain」 と 「text/plain; charset=foobar」 の Part を比較すると、このメソッドは true を返します。

mimeType の subType が特殊文字「*」の場合、比較時にサブタイプは無視されます。

定義:

インタフェース Part 内の isMimeType

getDisposition

public java.lang.String getDisposition()
                                throws MessagingException

「Content-Disposition」ヘッダフィールドの値を返します。これはこの部分の処置を表します。この部分がどのようにユーザに提示されるかを示します。

Content-Disposition フィールドが使用できない場合は null が返されます。

この実装は getHeader(name) を使用し、必要なヘッダフィールドを取得します。

定義:

インタフェース Part 内の getDisposition

関連項目:

headers

setDisposition

public void setDisposition(java.lang.String disposition)
                    throws MessagingException

この本文部分の「Content-Disposition」ヘッダフィールドを設定します。処置が null の場合は、既存のすべての「Content-Disposition」ヘッダフィールドが削除されます。

定義:

インタフェース Part 内の setDisposition

例外:

IllegalWriteException - 実装が変更をサポートしない場合

java.lang.IllegalStateException - この本文部分が READ_ONLY フォルダから取得された場合

getEncoding

public java.lang.String getEncoding()
                             throws MessagingException

「Content-Transfer-Encoding」ヘッダフィールドからの内容転送エンコーディングを返します。ヘッダが使用できない場合、またはその値が存在しない場合は null を返します。

この実装は getHeader(name) を使用し、必要なヘッダフィールドを取得します。

定義:

インタフェース MimePart 内の getEncoding

関連項目:

headers

getContentID

public java.lang.String getContentID()
                              throws MessagingException

「Content-ID」ヘッダフィールドの値を返します。フィールドが使用できない場合、またはその値が存在しない場合は null を返します。

この実装は getHeader(name) を使用し、必要なヘッダフィールドを取得します。

定義:

インタフェース MimePart 内の getContentID

インタフェース javax.mail.internet.MimePart からコピーされたタグ:

戻り値:

コンテンツ ID

getContentMD5

public java.lang.String getContentMD5()
                               throws MessagingException

「Content-MD5」ヘッダフィールドの値を返します。フィールドが使用できない場合、またはその値が存在しない場合は null を返します。

この実装は getHeader(name) を使用し、必要なヘッダフィールドを取得します。

定義:

インタフェース MimePart 内の getContentMD5

インタフェース javax.mail.internet.MimePart からコピーされたタグ:

戻り値:

コンテンツ MD5

setContentMD5

public void setContentMD5(java.lang.String md5)
                   throws MessagingException

この本文部分の「Content-MD5」ヘッダフィールドを設定します。

定義:

インタフェース MimePart 内の setContentMD5

例外:

IllegalWriteException - 実装が変更をサポートしない場合

java.lang.IllegalStateException - この本文部分が READ_ONLY フォルダから取得された場合

getContentLanguage

public java.lang.String[] getContentLanguage()
                                      throws MessagingException

この MimePart の Content-Language ヘッダで指定される言語を取得します。Content-Language ヘッダは RFC 1766 により定義されます。ヘッダが使用できない場合、またはその値が存在しない場合は null を返します。

この実装は getHeader(name) を使用し、必要なヘッダフィールドを取得します。

定義:

インタフェース MimePart 内の getContentLanguage

setContentLanguage

public void setContentLanguage(java.lang.String[] languages)
                        throws MessagingException

この MimePart の Content-Language ヘッダを設定します。Content-Language ヘッダは RFC 1766 により定義されます。

定義:

インタフェース MimePart 内の setContentLanguage

パラメータ:

languages - 言語タグの配列

getDescription

public java.lang.String getDescription()
                                throws MessagingException

この本文部分の「Content-Description」ヘッダフィールドを返します。これは通常一部の情報をこの部分に関連付けます。このフィールドが使用できない場合、またはその値が存在しない場合は null を返します。

Content-Description フィールドが RFC 2047 に従ってエンコーディングされている場合、デコードされ、Unicode に変換されます。デコーディングまたは変換が失敗した場合、raw データがそのまま返されます。

この実装は getHeader(name) を使用し、必要なヘッダフィールドを取得します。

定義:

インタフェース Part 内の getDescription

戻り値:

内容の説明

setDescription

public void setDescription(java.lang.String description)
                    throws MessagingException

この本文部分の「Content-Description」ヘッダフィールドを設定します。description パラメータが null の場合は既存のすべての「Content-Description」フィールドが削除されます。

description に US-ASCII 以外の文字が含まれる場合は、プラットフォームのデフォルト文字セットを使用してエンコードされます。description に US-ASCII 文字だけが含まれる場合は、エンコーディングは行われず、そのまま使用されます。

文字セットエンコーディング処理が失敗する場合、MessagingException がスローされ、UnsupportedEncodingException が MessagingException 内の入れ子にされた例外のチェーンに含まれることに注意してください。

定義:

インタフェース Part 内の setDescription

パラメータ:

description - 内容の説明

例外:

IllegalWriteException - 実装が変更をサポートしない場合

java.lang.IllegalStateException - この本文部分が READ_ONLY フォルダから取得された場合

MessagingException - 文字セット変換が失敗すると、UnsupportedEncodingException が例外チェーンに含まれる場合がある

setDescription

public void setDescription(java.lang.String description,
                           java.lang.String charset)
                    throws MessagingException

この本文部分の「Content-Description」ヘッダを設定します。description パラメータが null の場合は既存のすべての「Content-Description」フィールドが削除されます。

description に US-ASCII 以外の文字が含まれる場合は、指定された文字セットを使用してエンコードされます。description に US-ASCII 文字だけが含まれる場合は、エンコーディングは行われず、そのまま使用されます。

文字セットエンコーディング処理が失敗する場合、MessagingException がスローされ、UnsupportedEncodingException が MessagingException 内の入れ子にされた例外のチェーンに含まれることに注意してください。

パラメータ:

description - 説明

charset - エンコーディングのための文字セット

例外:

IllegalWriteException - 実装が変更をサポートしない場合

java.lang.IllegalStateException - この本文部分が READ_ONLY フォルダから取得された場合

MessagingException - 文字セット変換が失敗すると、UnsupportedEncodingException が例外チェーンに含まれる場合がある

getFileName

public java.lang.String getFileName()
                             throws MessagingException

この本文部分に関連付けられたファイル名を取得します。

この本文部分の「Content-Disposition」ヘッダフィールドにおける「filename」パラメータの値を返します。このパラメータが使用できない場合は、この本文部分の「Content-Type」ヘッダフィールドにおける「name」パラメータの値を返します。両方とも存在しない場合は null を返します。

定義:

インタフェース Part 内の getFileName

戻り値:

ファイル名

setFileName

public void setFileName(java.lang.String filename)
                 throws MessagingException

可能であれば、この本文部分に関連付けられたファイル名を設定します。

この本文部分の「Content-Disposition」ヘッダフィールドにおける「filename」パラメータを設定します。

定義:

インタフェース Part 内の setFileName

例外:

IllegalWriteException - 実装が変更をサポートしない場合

java.lang.IllegalStateException - この本文部分が READ_ONLY フォルダから取得された場合

getInputStream

public java.io.InputStream getInputStream()
                                   throws java.io.IOException,
                                          MessagingException

この本文部分の「content」に対するデコードされた入力ストリームを返します。

この実装は DataHandler から入力ストリームを取得します。つまり、getDataHandler().getInputStream(); を呼び出します。

定義:

インタフェース Part 内の getInputStream

戻り値:

InputStream

例外:

MessagingException -

java.io.IOException - これは通常 DataHandler によりスローされる。詳細については javax.activation.DataHandler のマニュアルを参照

関連項目:

getContentStream(), DataHandler.getInputStream()

getContentStream

protected java.io.InputStream getContentStream()
                                        throws MessagingException

内容の raw バイトを生成します。このメソッドは内容の DataHandler オブジェクトを作成するときに使用されます。Part 内容だけの別個の入力ストリームを提供可能なサブクラスはこのメソッドをオーバーライドする場合があります。

関連項目:

content, MimeMessage.getContentStream()

getRawInputStream

public java.io.InputStream getRawInputStream()
                                      throws MessagingException

任意の Content-Transfer-Encoding をそのままにして、raw データへの InputStream を返します。このメソッドは「Content-Transfer-Encoding」ヘッダが正しくなかったり壊れていたりする場合に役立ちます。この場合、getInputStream メソッドまたは getContent メソッドは、正しいデータを返すことができません。アプリケーションはこのメソッドを使用し、raw データそのもののデコードを試みることができます。

この実装は単に getContentStream メソッドを呼び出します。

導入されたバージョン:

JavaMail 1.2

関連項目:

getInputStream(), getContentStream()

getDataHandler

public DataHandler getDataHandler()
                           throws MessagingException

この本文部分の内容の DataHandler を返します。

ここで提供される実装は、ちょうど MimeMessage の実装のように機能します。

定義:

インタフェース Part 内の getDataHandler

関連項目:

MimeMessage.getDataHandler()

getContent

public java.lang.Object getContent()
                            throws java.io.IOException,
                                   MessagingException

内容を java オブジェクトとして返します。返されるオブジェクトのタイプはもちろん内容そのものに依存します。たとえば、text/plain コンテンツの固有形式は普通 String オブジェクトです。「multipart」コンテンツの固有形式は常に Multipart サブクラスです。DataHandler システムに不明なコンテンツ型の場合、入力ストリームがコンテンツとして返されます。

この実装は DataHandler からコンテンツを取得します。つまり、getDataHandler().getContent(); を呼び出します。

定義:

インタフェース Part 内の getContent

戻り値:

オブジェクト

例外:

MessagingException -

java.io.IOException - これは通常 DataHandler によりスローされる。詳細については javax.activation.DataHandler のマニュアルを参照

setDataHandler

public void setDataHandler(DataHandler dh)
                    throws MessagingException

このメソッドは、この本文部分の内容を設定するための仕組みを提供します。指定された DataHandler オブジェクトは、実際の内容をラップしなければなりません。

定義:

インタフェース Part 内の setDataHandler

パラメータ:

dh - コンテンツの DataHandler

例外:

IllegalWriteException - 実装が変更をサポートしない場合

java.lang.IllegalStateException - この本文部分が READ_ONLY フォルダから取得される場合

setContent

public void setContent(java.lang.Object o,
                       java.lang.String type)
                throws MessagingException

この本文部分の内容を設定するための簡易メソッドです。

コンテンツは DataHandler オブジェクト内にラップされます。これが正しく機能するために、指定されたタイプの DataContentHandler クラスが JavaMail 実装に対して使用可能でなければならないことに注意してください。つまり、setContent(foobar, "application/x-foobar") を実行するために、「application/x-foobar」の DataContentHandler がインストールされている必要があります。詳細については Java Activation Framework を参照してください。

定義:

インタフェース Part 内の setContent

パラメータ:

o - コンテンツオブジェクト

type - オブジェクトの MIME タイプ

例外:

IllegalWriteException - 実装が既存値の変更をサポートしない場合

java.lang.IllegalStateException - この本文部分が READ_ONLY フォルダから取得された場合

setText

public void setText(java.lang.String text)
             throws MessagingException

指定された String をこの部分のコンテンツとして、「text/plain」の MIME タイプで設定する簡易メソッドです。文字列に US-ASCII 以外の文字が含まれる場合、プラットフォームのデフォルトの文字セットを使用してエンコードされます。この文字セットは「charset」パラメータを設定するためにも使用されます。

このメソッドは使用する文字セットを決めるためにすべての文字を走査しなければならない場合があるので、text が大きい場合は、性能が低下する可能性があることに注意してください。

文字セットが既知の場合、文字セットパラメータを受け取る setText() バージョンを使用してください。

定義:

インタフェース MimePart 内の setText

関連項目:

setText(String text, String charset)

setText

public void setText(java.lang.String text,
                    java.lang.String charset)
             throws MessagingException

「text/plain」の MIME タイプおよび指定された文字セットを使用し、指定された String をこの部分のコンテンツとして設定する簡易メソッドです。指定された Unicode 文字列は、指定された文字セットを使用して文字セットエンコードされます。この文字セットは「charset」パラメータを設定するためにも使用されます。

定義:

インタフェース MimePart 内の setText

setContent

public void setContent(Multipart mp)
                throws MessagingException

このメソッドは本文部分の内容を Multipart オブジェクトに設定します。

定義:

インタフェース Part 内の setContent

パラメータ:

mp - Message のコンテンツである multipart オブジェクト

例外:

IllegalWriteException - 実装が既存値の変更をサポートしない場合

java.lang.IllegalStateException - この本文部分が READ_ONLY フォルダから取得された場合

writeTo

public void writeTo(java.io.OutputStream os)
             throws java.io.IOException,
                    MessagingException

本文部分を RFC 822 形式のストリームとして出力します。

定義:

インタフェース Part 内の writeTo

例外:

MessagingException -

java.io.IOException - ストリームへの書き込み中にエラーが発生する場合、または javax.activation レイヤによりエラーが生成される場合

関連項目:

DataHandler.writeTo(java.io.OutputStream)

getHeader

public java.lang.String[] getHeader(java.lang.String name)
                             throws MessagingException

この header_name のすべてのヘッダを取得します。ヘッダが US-ASCII 以外の文字を含む場合、RFC 2047 に基づきエンコードされることがあり、デコードが必要となることに注意してください。

定義:

インタフェース Part 内の getHeader

パラメータ:

name - ヘッダの名前

戻り値:

ヘッダの配列

関連項目:

MimeUtility

getHeader

public java.lang.String getHeader(java.lang.String name,
                                  java.lang.String delimiter)
                           throws MessagingException

このヘッダ名のすべてのヘッダを取得し、区切り文字で区切られたヘッダが単一の String として返されます、区切り文字が null の場合は、最初のヘッダだけが返されます。

定義:

インタフェース MimePart 内の getHeader

パラメータ:

name - このヘッダの名前

戻り値:

この名前を持つすべてのヘッダに対する値フィールド

例外:

MessagingException -

setHeader

public void setHeader(java.lang.String name,
                      java.lang.String value)
               throws MessagingException

この header_name の値を設定します。既存のすべてのヘッダ値をこの新しい値で置き換えます。RFC 822 ヘッダは US-ASCII 文字のみを含まなければならないため、US-ASCII 以外の文字を含むヘッダは RFC 2047 の規則に従ってエンコードされなければならないことに注意してください。

定義:

インタフェース Part 内の setHeader

パラメータ:

name - ヘッダ名

value - ヘッダ値

関連項目:

MimeUtility

addHeader

public void addHeader(java.lang.String name,
                      java.lang.String value)
               throws MessagingException

この値をこの header_name の既存値に追加します。RFC 822 ヘッダは US-ASCII 文字のみを含まなければならないため、US-ASCII 以外の文字を含むヘッダは RFC 2047 の規則に従ってエンコードされなければならないことに注意してください。

定義:

インタフェース Part 内の addHeader

パラメータ:

name - ヘッダ名

value - ヘッダ値

関連項目:

MimeUtility

removeHeader

public void removeHeader(java.lang.String name)
                  throws MessagingException

この名前を持つすべてのヘッダを削除します。

定義:

インタフェース Part 内の removeHeader

インタフェース javax.mail.Part からコピーされたタグ:

パラメータ:

header_name - このヘッダの名前

例外:

MessagingException -

IllegalWriteException - 実装が既存値の変更をサポートしない場合

java.lang.IllegalStateException - この Part が READ_ONLY フォルダから取得された場合

getAllHeaders

public java.util.Enumeration getAllHeaders()
                                    throws MessagingException

この Message のすべてのヘッダを Header オブジェクトの Enumeration として返します。

定義:

インタフェース Part 内の getAllHeaders

インタフェース javax.mail.Part からコピーされたタグ:

戻り値:

Header オブジェクトの配列

例外:

MessagingException -

getMatchingHeaders

public java.util.Enumeration getMatchingHeaders(java.lang.String[] names)
                                         throws MessagingException

この Message の一致するヘッダを Header オブジェクトの Enumeration として返します。

定義:

インタフェース Part 内の getMatchingHeaders

インタフェース javax.mail.Part からコピーされたタグ:

戻り値:

Header オブジェクトの配列

例外:

MessagingException -

getNonMatchingHeaders

public java.util.Enumeration getNonMatchingHeaders(java.lang.String[] names)
                                            throws MessagingException

この Message の一致しないヘッダを Header オブジェクトの Enumeration として返します。

定義:

インタフェース Part 内の getNonMatchingHeaders

インタフェース javax.mail.Part からコピーされたタグ:

戻り値:

Header オブジェクトの配列

例外:

MessagingException -

addHeaderLine

public void addHeaderLine(java.lang.String line)
                   throws MessagingException

ヘッダ行をこの本文部分に追加します。

定義:

インタフェース MimePart 内の addHeaderLine

インタフェース javax.mail.internet.MimePart からコピーされたタグ:

例外:

IllegalWriteException - 実装が変更をサポートしない場合

java.lang.IllegalStateException - この Part が READ_ONLY フォルダから取得された場合

getAllHeaderLines

public java.util.Enumeration getAllHeaderLines()
                                        throws MessagingException

すべてのヘッダ行を String の Enumeration として取得します。Header 行は raw RFC 822 ヘッダ行であり、「name」および「value」の両フィールドを含みます。

定義:

インタフェース MimePart 内の getAllHeaderLines

getMatchingHeaderLines

public java.util.Enumeration getMatchingHeaderLines(java.lang.String[] names)
                                             throws MessagingException

一致するヘッダ行を String の Enumeration として取得します。Header 行は raw RFC 822 ヘッダ行であり、「name」および「value」の両フィールドを含みます。

定義:

インタフェース MimePart 内の getMatchingHeaderLines

getNonMatchingHeaderLines

public java.util.Enumeration getNonMatchingHeaderLines(java.lang.String[] names)
                                                throws MessagingException

一致しないヘッダ行を String の Enumeration として取得します。Header 行は raw RFC 822 ヘッダ行であり、「name」および「value」の両フィールドを含みます。

定義:

インタフェース MimePart 内の getNonMatchingHeaderLines

updateHeaders

protected void updateHeaders()
                      throws MessagingException

この本文部分の内容を検査し、適切な MIME ヘッダを更新します。ここで設定される一般的なヘッダは Content-Type と Content-Transfer-Encoding です。ヘッダの更新は次の 2 つの場合に必要になります。
- メールアプリケーションにより作成されるメッセージは、内部ヘッダを満たすために、ある時点でこのメソッドをアクティブにする必要がある。
- Store から読み込まれるメッセージはすべてのヘッダを格納場所から取得するので、これは必要ではない。ただし、メッセージが編集可能で内容またはメッセージ構造に編集が行われた場合、ヘッダの再同期が必要となる場合がある。
どちらの場合も、このメソッドは通常 Message.saveChanges メソッドにより呼び出されます。