Top Description Fields Constructors Methods
jakarta.activation

public abstract Class CommandMap

extends Object
Class Inheritance
Known Direct Subclasses
jakarta.activation.MailcapCommandMap
Imports
java.util.Map, .WeakHashMap

The CommandMap class provides an interface to a registry of command objects available in the system. Developers are expected to either use the CommandMap implementation included with this package (MailcapCommandMap) or develop their own. Note that some of the methods in this class are abstract.

Field Summary

Modifier and TypeField and Description
private static CommandMap
private static Map<ClassLoader, CommandMap>

Constructor Summary

AccessConstructor and Description
protected
CommandMap()

Default (empty) constructor.

Method Summary

Modifier and TypeMethod and Description
public abstract DataContentHandler

Returns:

the DataContentHandler for the MIME type
createDataContentHandler
(String
the MIME type
mimeType
)

Locate a DataContentHandler that corresponds to the MIME type.

public DataContentHandler

Returns:

the DataContentHandler for the MIME type
createDataContentHandler
(String
the MIME type
mimeType
,
DataSource
a DataSource for the data
ds
)

Locate a DataContentHandler that corresponds to the MIME type.

public abstract CommandInfo[]

Returns:

the CommandInfo objects representing all the commands.
getAllCommands
(String
the MIME type
mimeType
)

Get all the available commands for this type.

public CommandInfo[]

Returns:

the CommandInfo objects representing all the commands.
getAllCommands
(String
the MIME type
mimeType
,
DataSource
a DataSource for the data
ds
)

Get all the available commands for this type.

public abstract CommandInfo

Returns:

the CommandInfo corresponding to the command.
getCommand
(String
the MIME type
mimeType
,
String
the command name
cmdName
)

Get the default command corresponding to the MIME type.

public CommandInfo

Returns:

the CommandInfo corresponding to the command.
getCommand
(String
the MIME type
mimeType
,
String
the command name
cmdName
,
DataSource
a DataSource for the data
ds
)

Get the default command corresponding to the MIME type.

public static synchronized CommandMap

Returns:

the CommandMap
getDefaultCommandMap
()

Get the default CommandMap.

public String[]

Returns:

array of MIME types as strings, or null if not supported
getMimeTypes
()

Get all the MIME types known to this command map.

public abstract CommandInfo[]

Returns:

the CommandInfo classes that represent the command Beans.
getPreferredCommands
(String
the MIME type
mimeType
)

Get the preferred command list from a MIME Type.

public CommandInfo[]

Returns:

the CommandInfo classes that represent the command Beans.
getPreferredCommands
(String
the MIME type
mimeType
,
DataSource
a DataSource for the data
ds
)

Get the preferred command list from a MIME Type.

public static synchronized void
setDefaultCommandMap(CommandMap
The new default CommandMap.
commandMap
)

Set the default CommandMap.

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

defaultCommandMapback to summary
private static CommandMap defaultCommandMap
mapback to summary
private static Map<ClassLoader, CommandMap> map

Constructor Detail

CommandMapback to summary
protected CommandMap()

Default (empty) constructor.

Method Detail

createDataContentHandlerback to summary
public abstract DataContentHandler createDataContentHandler(String mimeType)

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.

Parameters
mimeType:String

the MIME type

Returns:DataContentHandler

the DataContentHandler for the MIME type

createDataContentHandlerback to summary
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:String

the MIME type

ds:DataSource

a DataSource for the data

Returns:DataContentHandler

the DataContentHandler for the MIME type

Since
JAF 1.1
getAllCommandsback to summary
public abstract CommandInfo[] getAllCommands(String mimeType)

Get all the available commands for this type. This method should return all the possible commands for this MIME type.

Parameters
mimeType:String

the MIME type

Returns:CommandInfo[]

the CommandInfo objects representing all the commands.

getAllCommandsback to summary
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:String

the MIME type

ds:DataSource

a DataSource for the data

Returns:CommandInfo[]

the CommandInfo objects representing all the commands.

Since
JAF 1.1
getCommandback to summary
public abstract CommandInfo getCommand(String mimeType, String cmdName)

Get the default command corresponding to the MIME type.

Parameters
mimeType:String

the MIME type

cmdName:String

the command name

Returns:CommandInfo

the CommandInfo corresponding to the command.

getCommandback to summary
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:String

the MIME type

cmdName:String

the command name

ds:DataSource

a DataSource for the data

Returns:CommandInfo

the CommandInfo corresponding to the command.

Since
JAF 1.1
getDefaultCommandMapback to summary
public static synchronized CommandMap getDefaultCommandMap()

Get the default CommandMap.

  • In cases where a CommandMap instance has been previously set to some value (via setDefaultCommandMap) return the CommandMap.
  • In cases where no CommandMap has been set, the CommandMap creates an instance of MailcapCommandMap and set that to the default, returning its value.
Returns:CommandMap

the CommandMap

getMimeTypesback to summary
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:String[]

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

Since
JAF 1.1
getPreferredCommandsback to summary
public abstract CommandInfo[] getPreferredCommands(String mimeType)

Get the preferred command list from a MIME Type. The actual semantics are determined by the implementation of the CommandMap.

Parameters
mimeType:String

the MIME type

Returns:CommandInfo[]

the CommandInfo classes that represent the command Beans.

getPreferredCommandsback to summary
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:String

the MIME type

ds:DataSource

a DataSource for the data

Returns:CommandInfo[]

the CommandInfo classes that represent the command Beans.

Since
JAF 1.1
setDefaultCommandMapback to summary
public static synchronized void setDefaultCommandMap(CommandMap commandMap)

Set the default CommandMap. Reset the CommandMap to the default by calling this method with null.

Parameters
commandMap:CommandMap

The new default CommandMap.

Exceptions
SecurityException:
if the caller doesn't have permission to change the default