javax.activation

Class CommandMap

public abstract class CommandMap extends Object

Registry of command objects available to the system.
Method Summary
abstract DataContentHandlercreateDataContentHandler(String mimeType)
Returns a DataContentHandler corresponding to the MIME type.
DataContentHandlercreateDataContentHandler(String mimeType, DataSource ds)
Locate a DataContentHandler that corresponds to the MIME type.
abstract CommandInfo[]getAllCommands(String mimeType)
Returns the complete list of commands for a MIME type.
CommandInfo[]getAllCommands(String mimeType, DataSource ds)
Get all the available commands for this type.
abstract CommandInfogetCommand(String mimeType, String cmdName)
Returns the command corresponding to the specified MIME type and command name.
CommandInfogetCommand(String mimeType, String cmdName, DataSource ds)
Get the default command corresponding to the MIME type.
static CommandMapgetDefaultCommandMap()
Returns the default command map.
String[]getMimeTypes()
Get all the MIME types known to this command map.
abstract CommandInfo[]getPreferredCommands(String mimeType)
Returns the list of preferred commands for a MIME type.
CommandInfo[]getPreferredCommands(String mimeType, DataSource ds)
Get the preferred command list from a MIME Type.
static voidsetDefaultCommandMap(CommandMap commandMap)
Sets the default command map.

Method Detail

createDataContentHandler

public abstract DataContentHandler createDataContentHandler(String mimeType)
Returns a DataContentHandler corresponding to the MIME type.

Parameters: mimeType the MIME type

createDataContentHandler

public DataContentHandler createDataContentHandler(String mimeType, DataSource ds)
Locate a DataContentHandler that corresponds to the MIME type. The mechanism and semantics for determining this are determined by the implementation of the particular CommandMap.

The DataSource provides extra information, such as the file name, that a CommandMap implementation may use to further refine the choice of DataContentHandler. The implementation in this class simply calls the createDataContentHandler method that ignores this argument.

Parameters: mimeType the MIME type ds a DataSource for the data

Returns: the DataContentHandler for the MIME type

Since: JAF 1.1

getAllCommands

public abstract CommandInfo[] getAllCommands(String mimeType)
Returns the complete list of commands for a MIME type.

Parameters: mimeType the MIME type

getAllCommands

public CommandInfo[] getAllCommands(String mimeType, DataSource ds)
Get all the available commands for this type. This method should return all the possible commands for this MIME type.

The DataSource provides extra information, such as the file name, that a CommandMap implementation may use to further refine the list of commands that are returned. The implementation in this class simply calls the getAllCommands method that ignores this argument.

Parameters: mimeType the MIME type ds a DataSource for the data

Returns: the CommandInfo objects representing all the commands.

Since: JAF 1.1

getCommand

public abstract CommandInfo getCommand(String mimeType, String cmdName)
Returns the command corresponding to the specified MIME type and command name.

Parameters: mimeType the MIME type cmdName the command name

getCommand

public CommandInfo getCommand(String mimeType, String cmdName, DataSource ds)
Get the default command corresponding to the MIME type.

The DataSource provides extra information, such as the file name, that a CommandMap implementation may use to further refine the command that is chosen. The implementation in this class simply calls the getCommand method that ignores this argument.

Parameters: mimeType the MIME type cmdName the command name ds a DataSource for the data

Returns: the CommandInfo corresponding to the command.

Since: JAF 1.1

getDefaultCommandMap

public static CommandMap getDefaultCommandMap()
Returns the default command map. This returns a MailcapCommandMap if no value has been set using setDefaultCommandMap.

getMimeTypes

public String[] getMimeTypes()
Get all the MIME types known to this command map. If the command map doesn't support this operation, null is returned.

Returns: array of MIME types as strings, or null if not supported

Since: JAF 1.1

getPreferredCommands

public abstract CommandInfo[] getPreferredCommands(String mimeType)
Returns the list of preferred commands for a MIME type.

Parameters: mimeType the MIME type

getPreferredCommands

public CommandInfo[] getPreferredCommands(String mimeType, DataSource ds)
Get the preferred command list from a MIME Type. The actual semantics are determined by the implementation of the CommandMap.

The DataSource provides extra information, such as the file name, that a CommandMap implementation may use to further refine the list of commands that are returned. The implementation in this class simply calls the getPreferredCommands method that ignores this argument.

Parameters: mimeType the MIME type ds a DataSource for the data

Returns: the CommandInfo classes that represent the command Beans.

Since: JAF 1.1

setDefaultCommandMap

public static void setDefaultCommandMap(CommandMap commandMap)
Sets the default command map.

Parameters: commandMap the new default command map