MailcapCommandMap (Java Platform SE 8 )

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. 文件< java.home > /lib/mailcap 。
4. 该文件或资源名为META-INF/mailcap 。
5. 名称为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使用此签名来查找包含在其注册表中的命令条目。与形式参数名x-java-<name>通过时，MailcapCommandMap作为识别与所述名称名称的命令读出。当名称为content-handler ，MailcapCommandMap将此参数表示的类识别为DataContentHandler 。无论命令名称如何，一般处理所有其他命令。命令实现由JavaBean（tm）组件的完全限定类名指定。例如; 用于查看某些数据的命令可以指定为： x-java-view=com.foo.ViewBean 。

当命令名为fallback-entry时，命令的值可能为true或false 。包含x-java-fallback-entry=true参数的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
从以下版本开始：

1.6

构造方法摘要

构造方法
Constructor and Description
`MailcapCommandMap()` 默认构造函数。
`MailcapCommandMap(InputStream is)` 构造函数允许调用者指定一个包含mailcap文件的 InputStream 。
`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)` 获取此MIME类型的MailcapCommandMap的此实例已知的所有mailcap文件中的所有可用命令。
`CommandInfo`	`getCommand(String mimeType, String cmdName)` 获取对应于 `cmdName`的MIME类型的命令。
`String[]`	`getMimeTypes()` 获取此命令映射已知的所有MIME类型。
`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

- 构造方法详细信息
  - MailcapCommandMap
```
public MailcapCommandMap()
```
    默认构造函数。
  - MailcapCommandMap
```
public MailcapCommandMap(String fileName)
                  throws IOException
```
    构造函数允许调用者指定 mailcap文件的路径。
    
    参数
    
    fileName - 要打开的 mailcap文件的名称
    
    异常
    
    IOException - 如果文件无法访问
  - MailcapCommandMap
```
public MailcapCommandMap(InputStream is)
```
    构造函数允许调用者指定一个包含mailcap文件的 InputStream 。
    
    参数
    
    is - 要打开的 mailcap文件的InputStream
- 方法详细信息
  - getPreferredCommands
```
public CommandInfo[] getPreferredCommands(String mimeType)
```
    获取MIME类型的首选命令列表。 MailcapCommandMap按照上述Mailcap文件搜索顺序搜索mailcap文件。
    搜索结果是MailcapCommandMap此实例已知的所有mailcap文件中可用命令的一个适当子集。特定命令的第一个条目被认为是首选命令。
    
    Specified by:
    
    getPreferredCommands在 CommandMap
    
    参数
    
    mimeType - MIME类型
    
    结果
    
    表示首选命令的CommandInfo对象。
  - getAllCommands
```
public CommandInfo[] getAllCommands(String mimeType)
```
    获取此MIME类型的MailcapCommandMap的此实例已知的所有mailcap文件中的所有可用命令。
    
    Specified by:
    
    getAllCommands在类别 CommandMap
    
    参数
    
    mimeType - MIME类型
    
    结果
    
    表示所有命令的CommandInfo对象。
  - getCommand
```
public CommandInfo getCommand(String mimeType,
                              String cmdName)
```
    获取 cmdName于MIME类型的 cmdName对应的命令。
    
    Specified by:
    
    getCommand在类别 CommandMap
    
    参数
    
    mimeType - MIME类型
    
    cmdName - 命令名
    
    结果
    
    CommandInfo对象对应的命令。
  - addMailcap
```
public void addMailcap(String mail_cap)
```
    将条目添加到注册表。在其他条目之前，以编程方式添加条目。
    传入的字符串应该是mailcap格式。
    
    参数
    
    mail_cap - 一个正确格式化的邮件字符串
  - createDataContentHandler
```
public DataContentHandler createDataContentHandler(String mimeType)
```
    返回指定MIME类型的DataContentHandler。
    
    Specified by:
    
    createDataContentHandler在类别 CommandMap
    
    参数
    
    mimeType - MIME类型
    
    结果
    
    DataContentHandler
  - getMimeTypes
```
public String[] getMimeTypes()
```
    获取此命令映射已知的所有MIME类型。
    
    重写：
    
    getMimeTypes在 CommandMap
    
    结果
    
    MIME类型数组作为字符串
    
    从以下版本开始：
    
    JAF 1.1
  - getNativeCommands
```
public String[] getNativeCommands(String mimeType)
```
    获取给定MIME类型的本机命令。返回一个字符串数组，每个字符串是整个mailcap文件条目。应用程序将需要解析该条目以提取实际的命令以及它需要的任何属性。有关mailcap条目语法的详细信息，请参阅RFC 1524 。仅返回指定MIME类型的视图命令的mailcap条目。
    
    结果
    
    本地命令条目数组
    
    从以下版本开始：
    
    JAF 1.1

Class MailcapCommandMap

构造方法摘要

方法摘要

Methods inherited from class javax.activation.CommandMap

Methods inherited from class java.lang.Object

构造方法详细信息

MailcapCommandMap

MailcapCommandMap

MailcapCommandMap

方法详细信息

getPreferredCommands

getAllCommands

getCommand

addMailcap

createDataContentHandler

getMimeTypes

getNativeCommands