javax.activation
Class CommandMap
java.lang.Object
javax.activation.CommandMap
public abstract class CommandMap
extends java.lang.Object
Registry of command objects available to the system.
createDataContentHandler
public abstract DataContentHandler createDataContentHandler(String mimeType)
Returns a DataContentHandler corresponding to 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.
mimeType
- the MIME typeds
- a DataSource for the data
- the DataContentHandler for the MIME type
getAllCommands
public abstract CommandInfo[] getAllCommands(String mimeType)
Returns the complete list of commands for a 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.
mimeType
- the MIME typeds
- a DataSource for the data
- the CommandInfo objects representing all the commands.
getCommand
public abstract CommandInfo getCommand(String mimeType,
String cmdName)
Returns the command corresponding to the specified MIME type and
command name.
mimeType
- the MIME typecmdName
- 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.
mimeType
- the MIME typecmdName
- the command nameds
- a DataSource for the data
- the CommandInfo corresponding to the command.
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.
- array of MIME types as strings, or null if not supported
getPreferredCommands
public abstract CommandInfo[] getPreferredCommands(String mimeType)
Returns the list of preferred commands for a 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.
mimeType
- the MIME typeds
- a DataSource for the data
- the CommandInfo classes that represent the command Beans.
setDefaultCommandMap
public static void setDefaultCommandMap(CommandMap commandMap)
Sets the default command map.
commandMap
- the new default command map