|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
javax.activation Class CommandMap
java.lang.Object javax.activation.CommandMap
- Direct Known Subclasses:
- MailcapCommandMap
public abstract class CommandMap
- extends Object
CommandMap 类为系统中可用的命令对象注册表提供接口。期望开发人员使用此包 (MailcapCommandMap) 所包含的 CommandMap 实现,或者开发他们自己的实现。注意,此类中有些方法是抽象的。
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.
Constructor Summary | |
---|---|
CommandMap()
|
Method Summary | |
---|---|
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. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public
CommandMap()
英文文档:
CommandMap
public CommandMap()
Method Detail |
---|
public static CommandMap
getDefaultCommandMap()
获取默认的 CommandMap。
- 在 CommandMap 实例已经被设置为某值(通过setDefaultCommandMap)的情况下,返回该 CommandMap。
-
在没有设置任何 CommandMap 的情况下,CommandMap 创建一个
MailcapCommandMap
的实例并将其设置为默认值,返回它的值。
return | CommandMap |
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
public static void
setDefaultCommandMap(CommandMap commandMap)
设置默认的 CommandMap。通过用 null
调用此方法将 CommandMap 重置为默认值。
commandMap | 新的默认 CommandMap。 |
Throws | SecurityException: 如果调用者不具有更改默认的权限 |
setDefaultCommandMap
public static void setDefaultCommandMap(CommandMap commandMap)
- Set the default CommandMap. Reset the CommandMap to the default by
calling this method with
null
. - Parameters:
commandMap
- The new default CommandMap.- Throws:
SecurityException
- if the caller doesn't have permission to change the default
abstract public CommandInfo[]
getPreferredCommands(String mimeType)
从 MIME 类型获取首选命令表。实际语义由 CommandMap 的实现来确定。
mimeType | MIME 类型 |
return | 表示命令 Bean 的 CommandInfo 类 |
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.
public CommandInfo[]
getPreferredCommands(String mimeType, DataSource ds)
从 MIME 类型获取首选命令表。实际语义由 CommandMap 的实现来确定。
DataSource
提供额外信息,比如文件名,CommandMap 实现可以使用它进一步改进返回的命令表。此类中的实现调用 getPreferredCommands
方法,忽略此参数。
mimeType | MIME 类型 |
ds | 数据的 DataSource |
return | 表示命令 Bean 的 CommandInfo 类 |
since | JAF 1.1 |
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
abstract public CommandInfo[]
getAllCommands(String mimeType)
获取此类型的所有可用命令。此方法应该返回此 MIME 类型的所有可能命令。
mimeType | MIME 类型 |
return | 表示所有命令的 CommandInfo 对象 |
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.
public CommandInfo[]
getAllCommands(String mimeType, DataSource ds)
获取此类型的所有可用命令。此方法应该返回此 MIME 类型的所有可能命令。
DataSource
提供额外信息,比如文件名,CommandMap 实现可以使用它进一步改进返回的命令表。此类中的实现调用 getAllCommands
方法,忽略此参数。
mimeType | MIME 类型 |
ds | 数据的 DataSource |
return | 表示所有命令的 CommandInfo 对象 |
since | JAF 1.1 |
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
abstract public CommandInfo
getCommand(String mimeType, String cmdName)
获取与 MIME 类型对应的默认命令。
mimeType | MIME 类型 |
cmdName | 命令名 |
return | 与命令对应的 CommandInfo |
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.
public CommandInfo
getCommand(String mimeType, String cmdName, DataSource ds)
获取与 MIME 类型对应的默认命令。
DataSource
提供额外信息,比如文件名,CommandMap 实现可以使用它进一步改进选择的命令。此类中的实现调用 getCommand
方法,忽略此参数。
mimeType | MIME 类型 |
cmdName | 命令名 |
ds | 数据的 DataSource |
return | 与命令对应的 CommandInfo |
since | JAF 1.1 |
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
abstract public DataContentHandler
createDataContentHandler(String mimeType)
查找与 MIME 类型对应的 DataContentHandler。确定它的机制和语义由特定 CommandMap 的实现确定。
mimeType | MIME 类型 |
return | MIME 类型的 DataContentHandler |
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
public DataContentHandler
createDataContentHandler(String mimeType, DataSource ds)
查找与 MIME 类型对应的 DataContentHandler。确定它的机制和语义由特定 CommandMap 的实现确定。
DataSource
提供额外信息,比如文件名称,CommandMap 实现可以使用它进一步改进 DataContentHandler 的选择。此类中的实现调用 createDataContentHandler
方法,忽略此参数。
mimeType | MIME 类型 |
ds | 数据的 DataSource |
return | MIME 类型的 DataContentHandler |
since | JAF 1.1 |
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
public String[]
getMimeTypes()
获取此命令映射已知的所有 MIME 类型。如果命令映射不支持此操作,则返回 null。
return | 以字符串形式返回 MIME 类型数组;如果不支持,则返回 null |
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
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Submit a bug or feature
Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.
PS : 未经我党受权你也可自由散发此文档。 如有任何错误请自行修正;若因此而造成任何损失请直接找人民主席,请勿与本人联系。谢谢!