javax.activation

Class MailcapCommandMap

java.lang.Object

javax.activation.CommandMap

javax.activation.MailcapCommandMap

public class MailcapCommandMap
extends CommandMap

mailcapcommandmap延伸commandmap抽象类。它实现了一个commandmap的配置是基于mailcap文件（ RFC 1524）。的mailcapcommandmap可以编程方式和通过配置文件配置。

mailcap文件搜索顺序：

的mailcapcommandmap看起来在mailcap文件项在用户的系统不同的地方。当请求是搜索在mailcapcommandmap命令，搜索mailcap文件按以下顺序：

1. 通过程序添加的条目的mailcapcommandmap实例。
2. 在用户主目录的文件.mailcap。
3. 文件 <家> /lib/mailcap java。
4. 文件或资源命名META-INF/mailcap。
5. 文件或资源命名META-INF/mailcap.default（通常只有在activation.jar文件）。

mailcap文件格式：

mailcap文件必须符合mailcap文件规范（RFC 1524，一种用于多媒体邮件格式信息的用户代理配置机制）。文件格式包括对应于特定MIME类型的条目。在一般情况下，本规范规定应用供客户端使用，当他们不能在指定的MIME类型操作。的mailcapcommandmap在mailcap文件允许使用参数机制扩展JavaBeans规范（TM）的组件被指定为对应于特定命令的MIME类型。

当一个mailcap文件解析，这mailcapcommandmap识别某些参数的签名，特别是那些参数名称的开头x-java-。使用这个签名的mailcapcommandmap纳入其登记命令查找条目。参数的名称和形式x-java-<name>由mailcapcommandmap名称为名称识别命令读取。当名称是 content-handler的mailcapcommandmap识别标志这类参数作为一个datacontenthandler。所有其它的命令通常不管命令名称的处理。命令执行的完全限定类名指定一个JavaBean组件（TM）。例如；用于查看一些数据命令可以指定为：x-java-view=com.foo.ViewBean。

当命令的名字是fallback-entry，命令的值可能true或false。一个MIME类型，包括x-java-fallback-entry=true参数定义的MIME类型，只会如果没有非回退条目可以发现使用回退命令输入。例如，表格的text/*; ; x-java-fallback-entry=true; x-java-view=com.sun.TextViewer条目指定一个视图命令可用于任何文本的MIME类型。这一观点命令只会如果MIME类型非回退视图命令不能被发现。

mailcapcommandmap知道mailcap文件有以下的一般形式：

# Comments begin with a '#' and continue to the end of the line.
<mime type>; ; <parameter list>
# Where a parameter list consists of one or more parameters,
# where parameters look like: x-java-view=com.sun.TextViewer
# and a parameter list looks like:
text/plain; ; x-java-view=com.sun.TextViewer; x-java-edit=com.sun.TextEdit
# Note that mailcap entries that do not contain 'x-java' parameters
# and comply to RFC 1524 are simply ignored:
image/gif; /usr/dt/bin/sdtimage %s


从以下版本开始：

一点六

构造方法摘要

构造方法

Constructor and Description
MailcapCommandMap() 默认构造函数。
MailcapCommandMap(InputStream is) 构造函数允许调用者指定一个InputStream含有mailcap文件。
MailcapCommandMap(String fileName) 构造函数允许调用者指定一个mailcap文件的路径。

方法摘要

Modifier and Type	Method and Description
void	addMailcap(String mail_cap) 向注册表添加条目。
DataContentHandler	createDataContentHandler(String mimeType) 返回指定的MIME类型的datacontenthandler。
CommandInfo[]	getAllCommands(String mimeType) 在所有的mailcap文件称此MailcapCommandMap的实例为MIME类型获取所有可用的命令。
CommandInfo	getCommand(String mimeType, String cmdName) 到 cmdName为MIME类型对应的命令。
String[]	getMimeTypes() 把所有的MIME类型称为该命令Map。
String[]	getNativeCommands(String mimeType) 获得给定的MIME类型的本地命令。
CommandInfo[]	getPreferredCommands(String mimeType) 得到一个MIME类型优先命令列表。

Methods inherited from class javax.activation.CommandMap

createDataContentHandler, getAllCommands, getCommand, getDefaultCommandMap, getPreferredCommands, setDefaultCommandMap

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MailcapCommandMap

public MailcapCommandMap()

默认构造函数。

MailcapCommandMap

public MailcapCommandMap(String fileName)
                  throws IOException

构造函数允许调用者指定一个mailcap文件的路径。

参数

fileName的mailcap文件名打开

异常

IOException如果文件无法访问

MailcapCommandMap

public MailcapCommandMap(InputStream is)

构造函数允许调用者指定一个InputStream含有mailcap文件。

参数

is - InputStream的mailcap文件打开

方法详细信息

getPreferredCommands

public CommandInfo[] getPreferredCommands(String mimeType)

得到一个MIME类型优先命令列表。搜索文件的mailcapcommandmap mailcap如上下mailcap文件搜索顺序。

搜索的结果是在所有mailcap文件称此实例的mailcapcommandmap可用命令的子集。一个特定命令的第一个条目被认为是首选的命令。

Specified by:

getPreferredCommands 方法重写，继承类 CommandMap

参数

mimeType的MIME类型

结果

代表优先命令commandinfo对象。

getAllCommands

public CommandInfo[] getAllCommands(String mimeType)

在所有的mailcap文件称此MailcapCommandMap的实例为MIME类型获取所有可用的命令。

Specified by:

getAllCommands 方法重写，继承类 CommandMap

参数

mimeType的MIME类型

结果

代表所有的命令commandinfo对象。

getCommand

public CommandInfo getCommand(String mimeType,
                              String cmdName)

得到相应的命令 cmdName的MIME类型。

Specified by:

getCommand 方法重写，继承类 CommandMap

参数

mimeType的MIME类型

cmdName的命令名

结果

对应于命令的commandinfo对象。

addMailcap

public void addMailcap(String mail_cap)

向注册表添加条目。以编程方式添加条目在其他条目搜索。

的字符串，通过应mailcap格式。

参数

mail_cap -一个格式正确的mailcap字符串

createDataContentHandler

public DataContentHandler createDataContentHandler(String mimeType)

返回指定的MIME类型的datacontenthandler。

Specified by:

createDataContentHandler 方法重写，继承类 CommandMap

参数

mimeType的MIME类型

结果

DataContentHandler

getMimeTypes

public String[] getMimeTypes()

把所有的MIME类型称为该命令Map。

重写：

getMimeTypes 方法重写，继承类 CommandMap

结果

MIME类型的数组作为字符串

从以下版本开始：

JAF 1.1

getNativeCommands

public String[] getNativeCommands(String mimeType)

获得给定的MIME类型的本地命令。返回字符串，每个字符串是一个完整的mailcap文件项的数组。应用程序将需要解析输入，以提取实际的命令以及它所需要的任何属性。看到了mailcap入门语法细节 RFC 1524。只返回mailcap条目指定为指定的MIME类型视图命令。

结果

本地命令项的数组

从以下版本开始：

JAF 1.1