setDefaultCommandMap.
*/
public static CommandMap getDefaultCommandMap()
{
if (defaultCommandMap == null)
{
defaultCommandMap = new MailcapCommandMap();
}
return defaultCommandMap;
}
/**
* Sets the default command map.
* @param commandMap the new default command map
*/
public static void setDefaultCommandMap(CommandMap commandMap)
{
SecurityManager security = System.getSecurityManager();
if (security != null)
{
try
{
security.checkSetFactory();
}
catch (SecurityException e)
{
if (commandMap != null && CommandMap.class.getClassLoader() !=
commandMap.getClass().getClassLoader())
{
throw e;
}
}
}
defaultCommandMap = commandMap;
}
/* Instance scope */
/**
* Returns the list of preferred commands for a MIME type.
* @param mimeType the MIME type
*/
public abstract CommandInfo[] getPreferredCommands(String mimeType);
/**
* Returns the complete list of commands for a MIME type.
* @param mimeType the MIME type
*/
public abstract CommandInfo[] getAllCommands(String mimeType);
/**
* Returns the command corresponding to the specified MIME type and
* command name.
* @param mimeType the MIME type
* @param cmdName the command name
*/
public abstract CommandInfo getCommand(String mimeType, String cmdName);
/**
* Returns a DataContentHandler corresponding to the MIME type.
* @param mimeType the MIME type
*/
public abstract DataContentHandler createDataContentHandler(String mimeType);
/**
* Get all the MIME types known to this command map.
* If the command map doesn't support this operation, null is returned.
* @return array of MIME types as strings, or null if not supported
* @since JAF 1.1
*/
public String[] getMimeTypes()
{
return null;
}
/**
* 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.
* @param mimeType the MIME type
* @param ds a DataSource for the data
* @return the CommandInfo classes that represent the command Beans.
* @since JAF 1.1
*/
public CommandInfo[] getPreferredCommands(String mimeType,
DataSource ds)
{
return getPreferredCommands(mimeType);
}
/**
* 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.
* @param mimeType the MIME type
* @param ds a DataSource for the data
* @return the CommandInfo objects representing all the commands.
* @since JAF 1.1
*/
public CommandInfo[] getAllCommands(String mimeType, DataSource ds)
{
return getAllCommands(mimeType);
}
/**
* 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.
* @param mimeType the MIME type
* @param cmdName the command name
* @param ds a DataSource for the data
* @return the CommandInfo corresponding to the command.
* @since JAF 1.1
*/
public CommandInfo getCommand(String mimeType, String cmdName,
DataSource ds)
{
return getCommand(mimeType, cmdName);
}
/**
* 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.
* @param mimeType the MIME type
* @param ds a DataSource for the data
* @return the DataContentHandler for the MIME type
* @since JAF 1.1
*/
public DataContentHandler createDataContentHandler(String mimeType,
DataSource ds)
{
return createDataContentHandler(mimeType);
}
}