javax.activation
クラス CommandMap

java.lang.Object
  javax.activation.CommandMap

直系の既知のサブクラス:

MailcapCommandMap

public abstract class CommandMap
extends Object

CommandMap クラスは、システムで利用できるコマンドオブジェクトのレジストリへのインタフェースを提供します。開発者は、このパッケージに含まれている CommandMap 実装 (MailcapCommandMap) を使用することも、独自の実装を開発することもできます。このクラスの一部のメソッドが abstract メソッドであることに注意してください。

導入されたバージョン:

1.6

コンストラクタの概要

CommandMap()

メソッドの概要

abstract DataContentHandler	createDataContentHandler(String mimeType) MIME タイプに対応する DataContentHandler を捜し出します。
DataContentHandler	createDataContentHandler(String mimeType, DataSource ds) MIME タイプに対応する DataContentHandler を捜し出します。
abstract CommandInfo[]	getAllCommands(String mimeType) このタイプの利用できるコマンドをすべて取得します。
CommandInfo[]	getAllCommands(String mimeType, DataSource ds) このタイプの利用できるコマンドをすべて取得します。
abstract CommandInfo	getCommand(String mimeType, String cmdName) MIME タイプに対応するデフォルトのコマンドを取得します。
CommandInfo	getCommand(String mimeType, String cmdName, DataSource ds) MIME タイプに対応するデフォルトのコマンドを取得します。
static CommandMap	getDefaultCommandMap() デフォルトの CommandMap を取得します。
String[]	getMimeTypes() このコマンドマップで認識されるすべての MIME タイプを取得します。
abstract CommandInfo[]	getPreferredCommands(String mimeType) MIME タイプから優先コマンドリストを取得します。
CommandInfo[]	getPreferredCommands(String mimeType, DataSource ds) MIME タイプから優先コマンドリストを取得します。
static void	setDefaultCommandMap(CommandMap commandMap) デフォルトの CommandMap を設定します。

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

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

コンストラクタの詳細

CommandMap

public CommandMap()

メソッドの詳細

getDefaultCommandMap

public static CommandMap getDefaultCommandMap()

デフォルトの CommandMap を取得します。

• CommandMap インスタンスが前もってなんらかの値に設定されている (setDefaultCommandMap を介して) 場合は、その CommandMap を返す
• CommandMap が設定されていない場合、CommandMap は MailcapCommandMap のインスタンスを作成し、それをデフォルトに設定して、その値を返す

戻り値:

CommandMap

setDefaultCommandMap

public static void setDefaultCommandMap(CommandMap commandMap)

デフォルトの CommandMap を設定します。CommandMap をデフォルトにリセットする場合は、null を使ってこのメソッドを呼び出します。

パラメータ:

commandMap - 新しいデフォルトの CommandMap

例外:

SecurityException - 呼び出し側にデフォルトを変更する権限がない場合

getPreferredCommands

public abstract CommandInfo[] getPreferredCommands(String mimeType)

MIME タイプから優先コマンドリストを取得します。実際のセマンティクスは、CommandMap の実装によって決まります。

パラメータ:

mimeType - MIME タイプ

戻り値:

コマンドの Bean を表す CommandInfo クラス

getPreferredCommands

public CommandInfo[] getPreferredCommands(String mimeType,
                                          DataSource ds)

MIME タイプから優先コマンドリストを取得します。実際のセマンティクスは、CommandMap の実装によって決まります。

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

パラメータ:

mimeType - MIME タイプ

ds - データの DataSource

戻り値:

コマンドの Bean を表す CommandInfo クラス

導入されたバージョン:

JAF 1.1

getAllCommands

public abstract CommandInfo[] getAllCommands(String mimeType)

このタイプの利用できるコマンドをすべて取得します。このメソッドは、この MIME タイプの考えられるコマンドをすべて返します。

パラメータ:

mimeType - MIME タイプ

戻り値:

すべてのコマンドを表す CommandInfo オブジェクト

getAllCommands

public CommandInfo[] getAllCommands(String mimeType,
                                    DataSource ds)

このタイプの利用できるコマンドをすべて取得します。このメソッドは、この MIME タイプの考えられるコマンドをすべて返します。

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

パラメータ:

mimeType - MIME タイプ

ds - データの DataSource

戻り値:

すべてのコマンドを表す CommandInfo オブジェクト

導入されたバージョン:

JAF 1.1

getCommand

public abstract CommandInfo getCommand(String mimeType,
                                       String cmdName)

MIME タイプに対応するデフォルトのコマンドを取得します。

パラメータ:

mimeType - MIME タイプ

cmdName - コマンド名

戻り値:

このコマンドに対応する CommandInfo

getCommand

public CommandInfo getCommand(String mimeType,
                              String cmdName,
                              DataSource ds)

MIME タイプに対応するデフォルトのコマンドを取得します。

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

パラメータ:

mimeType - MIME タイプ

cmdName - コマンド名

ds - データの DataSource

戻り値:

このコマンドに対応する CommandInfo

導入されたバージョン:

JAF 1.1

createDataContentHandler

public abstract DataContentHandler createDataContentHandler(String mimeType)

MIME タイプに対応する DataContentHandler を捜し出します。これを決めるための機構とセマンティクスは、特定の CommandMap の実装によって決まります。

パラメータ:

mimeType - MIME タイプ

戻り値:

MIME タイプに対応する DataContentHandler

createDataContentHandler

public DataContentHandler createDataContentHandler(String mimeType,
                                                   DataSource ds)

MIME タイプに対応する DataContentHandler を捜し出します。これを決めるための機構とセマンティクスは、特定の CommandMap の実装によって決まります。

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

パラメータ:

mimeType - MIME タイプ

ds - データの DataSource

戻り値:

MIME タイプに対応する DataContentHandler

導入されたバージョン:

JAF 1.1

getMimeTypes

public String[] getMimeTypes()

このコマンドマップで認識されるすべての MIME タイプを取得します。コマンドマップがこの操作をサポートしない場合、null が返されます。

戻り値:

文字列である MIME タイプの配列。サポートされない場合は null

導入されたバージョン:

JAF 1.1