パッケージ jakarta.mail.internet

インターフェース MimePart

  • すべてのスーパーインターフェース:
    Part
    すべての既知の実装クラス:
    MimeBodyPartMimeMessagePreencodedMimeBodyPart

    public interface MimePart
    extends Part
    MimePart インターフェースは、MIME(RFC2045、セクション 2.4)で定義されたエンティティをモデル化します。

    MimePart は Part インターフェースを継承して、RFC822 および MIME 固有のセマンティクスと属性を追加します。MimeMessage および MimeBodyPart クラスの基本インターフェースを提供します


    RFC822 および MIME ヘッダーに関する注意

    RFC822 および MIME ヘッダーフィールドに は、US-ASCII 文字のみを含める必要があります。ヘッダーに US-ASCII 以外の文字が含まれている場合は、RFC 2047 の規則に従ってエンコードする必要があります。このパッケージで提供されている MimeUtility クラスを使用して、これを実現できます。setHeaderaddHeaderaddHeaderLine メソッドの呼び出し元は、指定されたヘッダーの MIME 要件を適用する責任があります。さらに、これらのヘッダーフィールドは、トランスポートの行長制限(SMTP の場合は 1000 バイト)を超える場合は、送信する前に折りたたむ(折り返す)必要があります。受信したヘッダーが折りたたまれている可能性があります。アプリケーションは、必要に応じてヘッダーを折りたたんだり展開したりする責任があります。

    作成者:
    John Mani
    関連事項:
    MimeUtility, Part
    • メソッドの詳細

      • getHeader

        StringSE getHeader​(StringSE name,
                         StringSE delimiter)
                  throws MessagingException
        このヘッダーで使用可能なすべてのヘッダーフィールドの値を取得します。値は区切り文字で区切られた単一の文字列として返されます。区切り文字が null の場合、最初の値のみが返されます。
        パラメーター:
        name - このヘッダーの名前
        delimiter - 返された文字列のフィールド間の区切り文字
        戻り値:
        この名前のすべてのヘッダーの値フィールド
        例外:
        MessagingException - 失敗
      • getAllHeaderLines

        EnumerationSE<StringSE> getAllHeaderLines()
                                       throws MessagingException
        すべてのヘッダー行を文字列の列挙として取得します。ヘッダー行は生の RFC822 ヘッダー行であり、「名前」フィールドと「値」フィールドの両方が含まれています。
        戻り値:
        文字列の列挙
        例外:
        MessagingException - 失敗
      • getMatchingHeaderLines

        EnumerationSE<StringSE> getMatchingHeaderLines​(StringSE[] names)
                                            throws MessagingException
        一致するヘッダー行を文字列の列挙として取得します。ヘッダー行は生の RFC822 ヘッダー行であり、「名前」フィールドと「値」フィールドの両方が含まれています。
        パラメーター:
        names - 返すヘッダー
        戻り値:
        文字列の列挙
        例外:
        MessagingException - 失敗
      • getNonMatchingHeaderLines

        EnumerationSE<StringSE> getNonMatchingHeaderLines​(StringSE[] names)
                                               throws MessagingException
        一致しないヘッダー行を文字列の列挙として取得します。ヘッダー行は生の RFC822 ヘッダー行であり、「名前」フィールドと「値」フィールドの両方が含まれています。
        パラメーター:
        names - 返さないヘッダー
        戻り値:
        文字列の列挙
        例外:
        MessagingException - 失敗
      • getContentID

        StringSE getContentID()
                     throws MessagingException
        このパーツのコンテンツ ID を取得します。存在しない場合は null を返します。
        戻り値:
        コンテンツ ID
        例外:
        MessagingException - 失敗
      • getContentMD5

        StringSE getContentMD5()
                      throws MessagingException
        このパートの Content-MD5 ダイジェストを取得します。存在しない場合は null を返します。
        戻り値:
        content-MD5
        例外:
        MessagingException - 失敗
      • getContentLanguage

        StringSE[] getContentLanguage()
                             throws MessagingException
        この MimePart の Content-Language ヘッダーで指定されている言語タグを取得します。Content-Language ヘッダーは RFC 1766 で定義されています。このヘッダーが使用できない場合、null を返します。
        戻り値:
        コンテンツ言語文字列の配列
        例外:
        MessagingException - 失敗
      • setContentLanguage

        void setContentLanguage​(StringSE[] languages)
                         throws MessagingException
        この MimePart の Content-Language ヘッダーを設定します。Content-Language ヘッダーは RFC1766 で定義されています。
        パラメーター:
        languages - 言語タグの配列
        例外:
        IllegalWriteException - 基本となる実装が変更をサポートしていない場合
        IllegalStateExceptionSE - このパーツが READ_ONLY フォルダーから取得された場合
        MessagingException
      • setText

        void setText​(StringSE text)
              throws MessagingException
        指定された文字列をこのパーツのコンテンツとして設定する便利なメソッド。MIME 型は "text/plain" です。文字列に US-ASCII 以外の文字が含まれている場合。プラットフォームのデフォルトの文字セットを使用してエンコードされます。文字セットは、"charset" パラメーターの設定にも使用されます。

        text が大きい場合、このメソッドはすべての文字をスキャンして、使用する文字セットを決定する必要があるため、パフォーマンスが低下する可能性があることに注意してください。

        文字セットが既知の場合は、文字セットパラメーターを受け取る setText メソッドを使用します。

        次で指定:
        インターフェース PartsetText 
        パラメーター:
        text - 設定するテキストコンテンツ
        例外:
        MessagingException - エラーが発生した場合
        関連事項:
        setText(String text, String charset)
      • setText

        void setText​(StringSE text,
                     StringSE charset)
              throws MessagingException
        指定された文字列をこのパーツのコンテンツとして設定する便利なメソッド。MIME 型は "text/plain" で、指定された文字セットを使用します。指定された Unicode 文字列は、指定された文字セットを使用して文字セットエンコードされます。文字セットは、"charset" パラメーターの設定にも使用されます。
        パラメーター:
        text - 設定するテキストコンテンツ
        charset - テキストに使用する文字セット
        例外:
        MessagingException - エラーが発生した場合
      • setText

        void setText​(StringSE text,
                     StringSE charset,
                     StringSE subtype)
              throws MessagingException
        指定された文字列をこのパーツのコンテンツとして設定し、プライマリ MIME 型が "text" で指定された MIME サブ型を使用する便利なメソッド。指定された Unicode 文字列は、指定された文字セットを使用して文字セットエンコードされます。文字セットは、"charset" パラメーターの設定にも使用されます。
        パラメーター:
        text - 設定するテキストコンテンツ
        charset - テキストに使用する文字セット
        subtype - 使用する MIME サブ型 (例: "html" )
        例外:
        MessagingException - エラーが発生した場合
        導入:
        JavaMail 1.4