©
Dieses Dokument verwendet PHP-Handbuch für chinesische Websites Freigeben
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
java.lang.Objectjavax.activation.CommandMap
public class MailcapCommandMap
MailcapCommandMap 扩展 CommandMap 抽象类。它实现配置基于 mailcap 文件 (RFC 1524) 的 CommandMap。可以以编程方式和通过配置文件的方式来配置 MailcapCommandMap。
mailcap 文件搜索顺序：
MailcapCommandMap 在用户系统的各个位置查找 mailcap 文件条目。当发出请求以搜索 MailcapCommandMap 中的命令时，它以下面的顺序搜索 mailcap 文件：
.mailcap 文件。
/lib/mailcap 文件。
META-INF/mailcap 的文件或资源。
META-INF/mailcap.default 的文件或资源（通常只存在于 activation.jar 文件中）。
mailcap 文件格式：
mailcap 文件必须符合 mailcap 文件规范 (RFC 1524, A User Agent Configuration Mechanism For Multimedia Mail Format Information)。文件格式由与特定 MIME 类型对应的条目组成。一般情况下，当客户机本身不能对指定的 MIME 类型进行操作时，该规范为其指定使用的应用程序。MailcapCommandMap 扩展了此规范，它在 mailcap 文件中使用一个参数机制，该机制允许指定 JavaBeans(tm) 组件对应于 MIME 类型的特定命令。
解析一个 mailcap 文件时，MailcapCommandMap 识别出某些参数签名，特别是以 x-java- 开头的参数名称。MailcapCommandMap 使用此签名查找命令条目，以将其包含到注册表。用名称 name 标识一个命令时，MailcapCommandMap 读取 x-java-<name> 形式的参数名称。当 name 为 content-handler 时，MailcapCommandMap 将此参数所表示的类视为 DataContentHandler。所有其他命令的处理通常忽略其命令名。命令实现由 JavaBean(tm) 组件的一个完全限定类名指定。例如，查看某些数据的命令可以被指定为：x-java-view=com.foo.ViewBean。
当命令名是 fallback-entry 时，命令的值可以为 true 或 false。包含 x-java-fallback-entry=true 参数的 MIME 类型的条目定义了该 MIME 类型的回退 (fallback) 命令，只在找不到非回退条目的情况下才使用该命令。例如，形式为 text/*; ; x-java-fallback-entry=true; x-java-view=com.sun.TextViewer 的条目指定了用于任何文本 MIME 类型的查看命令。此查看命令只在找不到 MIME 类型的非回退查看命令的情况下使用。
支持 MailcapCommandMap 的 mailcap 文件的一般形式如下：
# 注释以 '#' 开头并延续到行的末尾。
<mime type>; ; <parameter list>
# 其中参数列表由一个或多个参数组成，
# 其中参数类似于：x-java-view=com.sun.TextViewer
# 参数列表类似于：
纯文本; ; x-java-view=com.sun.TextViewer; x-java-edit=com.sun.TextEdit
# 注意，不包含 'x-java' 参数的 mailcap 条目
# 和遵守 RFC 1524 的条目将被忽略：
image/gif; /usr/dt/bin/sdtimage %s
| 构造方法摘要 | |
|---|---|
MailcapCommandMap()
默认的构造方法。 |
|
MailcapCommandMap(InputStream is)
允许调用者指定一个包含 mailcap 文件的 InputStream 的构造方法。 |
|
MailcapCommandMap(String fileName)
允许调用者指定 mailcap 文件路径的构造方法。 |
|
| 方法摘要 | |
|---|---|
void |
addMailcap(String mail_cap)
将条目添加到注册表。 |
DataContentHandler |
createDataContentHandler(String mimeType)
返回指定 MIME 类型的 DataContentHandler。 |
CommandInfo[] |
getAllCommands(String mimeType)
针对此 MIME 类型获取此 MailcapCommandMap 实例已知的所有 mailcap 文件中的所有可用命令。 |
CommandInfo |
getCommand(String mimeType,
String cmdName)
针对 MIME 类型获取与 cmdName 对应的命令。 |
String[] |
getMimeTypes()
获取此命令映射已知的所有 MIME 类型。 |
String[] |
getNativeCommands(String mimeType)
获取给定 MIME 类型的本地命令。 |
CommandInfo[] |
getPreferredCommands(String mimeType)
获取 MIME 类型的首选命令列表。 |
| 从类 javax.activation.CommandMap 继承的方法 |
|---|
createDataContentHandler, getAllCommands, getCommand, getDefaultCommandMap, getPreferredCommands, setDefaultCommandMap |
| 从类 java.lang.Object 继承的方法 |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| 构造方法详细信息 |
|---|
public MailcapCommandMap()
public MailcapCommandMap(String fileName)
throws IOException
fileName - 要打开的 mailcap 文件的名称
IOException - 如果不能访问该文件public MailcapCommandMap(InputStream is)
is - 要打开的 mailcap 文件的 InputStream| 方法详细信息 |
|---|
public CommandInfo[] getPreferredCommands(String mimeType)
搜索的结果是此 MailcapCommandMap 实例已知的所有 mailmap 文件中可用命令的适当子集。特定命令的第一个条目被视为首选命令。
CommandMap 中的 getPreferredCommands
mimeType - MIME 类型
public CommandInfo[] getAllCommands(String mimeType)
CommandMap 中的 getAllCommands
mimeType - MIME 类型
public CommandInfo getCommand(String mimeType,
String cmdName)
cmdName 对应的命令。
CommandMap 中的 getCommand
mimeType - MIME 类型cmdName - 命令名
public void addMailcap(String mail_cap)
传入的字符串应该是 mailcap 格式。
mail_cap - 已正确格式化的 mailcap 字符串public DataContentHandler createDataContentHandler(String mimeType)
CommandMap 中的 createDataContentHandler
mimeType - MIME 类型
public String[] getMimeTypes()
CommandMap 中的 getMimeTypes
public String[] getNativeCommands(String mimeType)
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。