パッケージ jakarta.activation

クラス CommandMap

  • 既知の直属サブクラス
    MailcapCommandMap

    public abstract class CommandMap
    extends ObjectSE
    CommandMap クラスは、システムで使用可能なコマンドオブジェクトのレジストリへのインターフェースを提供します。開発者は、このパッケージに含まれている CommandMap 実装(MailcapCommandMap)を使用するか、独自に開発することが期待されています。このクラスのメソッドのいくつかは抽象的であることに注意してください。
    • コンストラクターの詳細

      • CommandMap

        protected CommandMap()
        デフォルト (空の) コンストラクター。
    • メソッドの詳細

      • getDefaultCommandMap

        public static CommandMap getDefaultCommandMap()
        デフォルトの CommandMap を取得します。
        • CommandMap インスタンスが以前に何らかの値に設定されていた場合 ( setDefaultCommandMap 経由)、CommandMap を返します。
        • CommandMap が設定されていない場合、CommandMap は MailcapCommandMap のインスタンスを作成し、それをデフォルトに設定して、その値を返します。
        戻り値:
        CommandMap
      • setDefaultCommandMap

        public static void setDefaultCommandMap​(CommandMap commandMap)
        デフォルトの CommandMap を設定します。null でこのメソッドを呼び出すことにより、CommandMap をデフォルトにリセットします。
        パラメーター:
        commandMap - 新しいデフォルトの CommandMap。
        例外:
        SecurityExceptionSE - 発信者にデフォルトを変更する権限がない場合
      • getPreferredCommands

        public abstract CommandInfo[] getPreferredCommands​(StringSE mimeType)
        MIME 型から優先コマンドリストを取得します。実際のセマンティクスは、CommandMap の実装によって決定されます。
        パラメーター:
        mimeType - MIME 型
        戻り値:
        コマンド Bean を表す CommandInfo クラス。
      • getPreferredCommands

        public CommandInfo[] getPreferredCommands​(StringSE mimeType,
                                                  DataSource ds)
        MIME 型から優先コマンドリストを取得します。実際のセマンティクスは、CommandMap の実装によって決定されます。

        DataSource は、ファイル名など、CommandMap 実装が返されるコマンドのリストをさらに絞り込むために使用できる追加情報を提供します。このクラスの実装は、この引数を無視する getPreferredCommands メソッドを呼び出すだけです。

        パラメーター:
        mimeType - MIME 型
        ds - データ用の DataSource
        戻り値:
        コマンド Bean を表す CommandInfo クラス。
        導入:
        JAF 1.1
      • getAllCommands

        public abstract CommandInfo[] getAllCommands​(StringSE mimeType)
        この型で使用可能なすべてのコマンドを取得します。このメソッドは、この MIME 型で可能なすべてのコマンドを返す必要があります。
        パラメーター:
        mimeType - MIME 型
        戻り値:
        すべてのコマンドを表す CommandInfo オブジェクト。
      • getAllCommands

        public CommandInfo[] getAllCommands​(StringSE mimeType,
                                            DataSource ds)
        この型で使用可能なすべてのコマンドを取得します。このメソッドは、この MIME 型で可能なすべてのコマンドを返す必要があります。

        DataSource は、ファイル名など、CommandMap 実装が返されるコマンドのリストをさらに絞り込むために使用できる追加情報を提供します。このクラスの実装は、この引数を無視する getAllCommands メソッドを呼び出すだけです。

        パラメーター:
        mimeType - MIME 型
        ds - データ用の DataSource
        戻り値:
        すべてのコマンドを表す CommandInfo オブジェクト。
        導入:
        JAF 1.1
      • getCommand

        public abstract CommandInfo getCommand​(StringSE mimeType,
                                               StringSE cmdName)
        MIME 型に対応するデフォルトのコマンドを取得します。
        パラメーター:
        mimeType - MIME 型
        cmdName - コマンド名
        戻り値:
        コマンドに対応する CommandInfo。
      • getCommand

        public CommandInfo getCommand​(StringSE mimeType,
                                      StringSE cmdName,
                                      DataSource ds)
        MIME 型に対応するデフォルトのコマンドを取得します。

        DataSource は、ファイル名など、CommandMap 実装が選択されたコマンドをさらに絞り込むために使用できる追加情報を提供します。このクラスの実装は、この引数を無視する getCommand メソッドを呼び出すだけです。

        パラメーター:
        mimeType - MIME 型
        cmdName - コマンド名
        ds - データ用の DataSource
        戻り値:
        コマンドに対応する CommandInfo。
        導入:
        JAF 1.1
      • createDataContentHandler

        public abstract DataContentHandler createDataContentHandler​(StringSE mimeType)
        MIME 型に対応する DataContentHandler を見つけます。これを決定するためのメカニズムとセマンティクスは、特定の CommandMap の実装によって決定されます。
        パラメーター:
        mimeType - MIME 型
        戻り値:
        MIME 型の DataContentHandler
      • createDataContentHandler

        public DataContentHandler createDataContentHandler​(StringSE mimeType,
                                                           DataSource ds)
        MIME 型に対応する DataContentHandler を見つけます。これを決定するためのメカニズムとセマンティクスは、特定の CommandMap の実装によって決定されます。

        DataSource は、ファイル名など、CommandMap 実装が DataContentHandler の選択をさらに絞り込むために使用できる追加情報を提供します。このクラスの実装は、この引数を無視する createDataContentHandler メソッドを呼び出すだけです。

        パラメーター:
        mimeType - MIME 型
        ds - データ用の DataSource
        戻り値:
        MIME 型の DataContentHandler
        導入:
        JAF 1.1
      • getMimeTypes

        public StringSE[] getMimeTypes()
        このコマンドマップで認識されているすべての MIME 型を取得します。コマンドマップがこの操作をサポートしていない場合、null が返されます。
        戻り値:
        文字列としての MIME 型の配列、またはサポートされていない場合は null
        導入:
        JAF 1.1