public abstract class CommandMap extends Object
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.
public CommandMap()
public static CommandMap getDefaultCommandMap()
Get the default CommandMap.
MailcapCommandMap
and set that to the default, returning its value. public static void setDefaultCommandMap(CommandMap commandMap)
Set the default CommandMap. Reset the CommandMap to the default by calling this method with null
.
commandMap
- The new default CommandMap.SecurityException
- if the caller doesn't have permission to change the defaultpublic 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.
mimeType
- the MIME typepublic 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 datapublic 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.
mimeType
- the MIME typepublic 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 datapublic abstract CommandInfo getCommand(String mimeType, String cmdName)
Get the default command corresponding to the MIME type.
mimeType
- the MIME typecmdName
- the command namepublic 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 datapublic 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.
mimeType
- the MIME typepublic 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 datapublic String[] getMimeTypes()
Get all the MIME types known to this command map. If the command map doesn't support this operation, null is returned.
© 1993–2017, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.