- java.lang.Object
-
- javax.activation.CommandMap
-
- Direct Known Subclasses:
- MailcapCommandMap
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.- Since:
- 1.6
-
-
Constructor Summary
Constructors Constructor and Description CommandMap()
-
Method Summary
Methods Modifier and Type Method and Description abstract DataContentHandler
createDataContentHandler(String mimeType)
Locate a DataContentHandler that corresponds to the MIME type.DataContentHandler
createDataContentHandler(String mimeType, DataSource ds)
Locate a DataContentHandler that corresponds to the MIME type.abstract CommandInfo[]
getAllCommands(String mimeType)
Get all the available commands for this type.CommandInfo[]
getAllCommands(String mimeType, DataSource ds)
Get all the available commands for this type.abstract CommandInfo
getCommand(String mimeType, String cmdName)
Get the default command corresponding to the MIME type.CommandInfo
getCommand(String mimeType, String cmdName, DataSource ds)
Get the default command corresponding to the MIME type.static CommandMap
getDefaultCommandMap()
Get the default CommandMap.String[]
getMimeTypes()
Get all the MIME types known to this command map.abstract CommandInfo[]
getPreferredCommands(String mimeType)
Get the preferred command list from a MIME Type.CommandInfo[]
getPreferredCommands(String mimeType, DataSource ds)
Get the preferred command list from a MIME Type.static void
setDefaultCommandMap(CommandMap commandMap)
Set the default CommandMap.
-
-
-
Method Detail
-
getDefaultCommandMap
public static 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:
- the CommandMap
-
setDefaultCommandMap
public static void setDefaultCommandMap(CommandMap commandMap)
Set the default CommandMap. Reset the CommandMap to the default by calling this method withnull
.- Parameters:
commandMap
- The new default CommandMap.- Throws:
SecurityException
- if the caller doesn't have permission to change the default
-
getPreferredCommands
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
- the MIME type- Returns:
- the CommandInfo classes that represent the command Beans.
-
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 thegetPreferredCommands
method that ignores this argument.- Parameters:
mimeType
- the MIME typeds
- a DataSource for the data- Returns:
- the CommandInfo classes that represent the command Beans.
- Since:
- JAF 1.1
-
getAllCommands
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
- the MIME type- Returns:
- the CommandInfo objects representing all the commands.
-
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 thegetAllCommands
method that ignores this argument.- Parameters:
mimeType
- the MIME typeds
- 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)
Get the default command corresponding to the MIME type.- Parameters:
mimeType
- the MIME typecmdName
- the command name- Returns:
- the CommandInfo corresponding to the command.
-
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 thegetCommand
method that ignores this argument.- Parameters:
mimeType
- the MIME typecmdName
- the command nameds
- a DataSource for the data- Returns:
- the CommandInfo corresponding to the command.
- Since:
- JAF 1.1
-
createDataContentHandler
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
- the MIME type- Returns:
- the DataContentHandler for 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 thecreateDataContentHandler
method that ignores this argument.- Parameters:
mimeType
- the MIME typeds
- a DataSource for the data- Returns:
- the DataContentHandler for the MIME type
- Since:
- JAF 1.1
-
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
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-javax/activation/CommandMap.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.