javax.activation

接口
异常
java.lang.Object
  继承者 javax.activation.CommandMap
直接已知子类:
MailcapCommandMap

public abstract class CommandMap
     
extends Object

CommandMap 类为系统中可用的命令对象注册表提供接口。期望开发人员使用此包 (MailcapCommandMap) 所包含的 CommandMap 实现,或者开发他们自己的实现。注意,此类中有些方法是抽象的。

从以下版本开始:
1.6

构造方法摘要
CommandMap()
           
 
方法摘要
abstract  DataContentHandler createDataContentHandler(String mimeType)
          查找与 MIME 类型对应的 DataContentHandler。
 DataContentHandler createDataContentHandler(String mimeType, DataSource ds)
          查找与 MIME 类型对应的 DataContentHandler。
abstract  CommandInfo[] getAllCommands(String mimeType)
          获取此类型的所有可用命令。
 CommandInfo[] getAllCommands(String mimeType, DataSource ds)
          获取此类型的所有可用命令。
abstract  CommandInfo getCommand(String mimeType, String cmdName)
          获取与 MIME 类型对应的默认命令。
 CommandInfo getCommand(String mimeType, String cmdName, DataSource ds)
          获取与 MIME 类型对应的默认命令。
static CommandMap getDefaultCommandMap()
          获取默认的 CommandMap。
 String[] getMimeTypes()
          获取此命令映射已知的所有 MIME 类型。
abstract  CommandInfo[] getPreferredCommands(String mimeType)
          从 MIME 类型获取首选命令表。
 CommandInfo[] getPreferredCommands(String mimeType, DataSource ds)
          从 MIME 类型获取首选命令表。
static void setDefaultCommandMap(CommandMap commandMap)
          设置默认的 CommandMap。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

CommandMap

public CommandMap()
方法详细信息

getDefaultCommandMap

public static CommandMap getDefaultCommandMap()
获取默认的 CommandMap。

  • 在 CommandMap 实例已经被设置为某值(通过setDefaultCommandMap)的情况下,返回该 CommandMap。
  • 在没有设置任何 CommandMap 的情况下,CommandMap 创建一个 MailcapCommandMap 的实例并将其设置为默认值,返回它的值。

返回:
CommandMap

setDefaultCommandMap

public static void setDefaultCommandMap(CommandMap commandMap)
设置默认的 CommandMap。通过用 null 调用此方法将 CommandMap 重置为默认值。

参数:
commandMap - 新的默认 CommandMap。
抛出:
SecurityException - 如果调用者不具有更改默认的权限

getPreferredCommands

public abstract CommandInfo[] getPreferredCommands(String mimeType)
从 MIME 类型获取首选命令表。实际语义由 CommandMap 的实现来确定。

参数:
mimeType - MIME 类型
返回:
表示命令 Bean 的 CommandInfo 类

getPreferredCommands

public CommandInfo[] getPreferredCommands(String mimeType,
                                          DataSource ds)
从 MIME 类型获取首选命令表。实际语义由 CommandMap 的实现来确定。

DataSource 提供额外信息,比如文件名,CommandMap 实现可以使用它进一步改进返回的命令表。此类中的实现调用 getPreferredCommands 方法,忽略此参数。

参数:
mimeType - MIME 类型
ds - 数据的 DataSource
返回:
表示命令 Bean 的 CommandInfo 类
从以下版本开始:
JAF 1.1

getAllCommands

public abstract CommandInfo[] getAllCommands(String mimeType)
获取此类型的所有可用命令。此方法应该返回此 MIME 类型的所有可能命令。

参数:
mimeType - MIME 类型
返回:
表示所有命令的 CommandInfo 对象

getAllCommands

public CommandInfo[] getAllCommands(String mimeType,
                                    DataSource ds)
获取此类型的所有可用命令。此方法应该返回此 MIME 类型的所有可能命令。

DataSource 提供额外信息,比如文件名,CommandMap 实现可以使用它进一步改进返回的命令表。此类中的实现调用 getAllCommands 方法,忽略此参数。

参数:
mimeType - MIME 类型
ds - 数据的 DataSource
返回:
表示所有命令的 CommandInfo 对象。
从以下版本开始:
JAF 1.1

getCommand

public abstract CommandInfo getCommand(String mimeType,
                                       String cmdName)
获取与 MIME 类型对应的默认命令。

参数:
mimeType - MIME 类型
cmdName - 命令名
返回:
与命令对应的 CommandInfo

getCommand

public CommandInfo getCommand(String mimeType,
                              String cmdName,
                              DataSource ds)
获取与 MIME 类型对应的默认命令。

DataSource 提供额外信息,比如文件名,CommandMap 实现可以使用它进一步改进选择的命令。此类中的实现调用 getCommand 方法,忽略此参数。

参数:
mimeType - MIME 类型
cmdName - 命令名
ds - 数据的 DataSource
返回:
与命令对应的 CommandInfo
从以下版本开始:
JAF 1.1

createDataContentHandler

public abstract DataContentHandler createDataContentHandler(String mimeType)
查找与 MIME 类型对应的 DataContentHandler。确定它的机制和语义由特定 CommandMap 的实现确定。

参数:
mimeType - MIME 类型
返回:
MIME 类型的 DataContentHandler

createDataContentHandler

public DataContentHandler createDataContentHandler(String mimeType,
                                                   DataSource ds)
查找与 MIME 类型对应的 DataContentHandler。确定它的机制和语义由特定 CommandMap 的实现确定。

DataSource 提供额外信息,比如文件名称,CommandMap 实现可以使用它进一步改进 DataContentHandler 的选择。此类中的实现调用 createDataContentHandler 方法,忽略此参数。

参数:
mimeType - MIME 类型
ds - 数据的 DataSource
返回:
MIME 类型的 DataContentHandler
从以下版本开始:
JAF 1.1

getMimeTypes

public String[] getMimeTypes()
获取此命令映射已知的所有 MIME 类型。如果命令映射不支持此操作,则返回 null。

返回:
以字符串形式返回 MIME 类型数组;如果不支持,则返回 null
从以下版本开始:
JAF 1.1