study/uTools-Manuals
1
0
Fork 0
mirror of https://github.com/fofolee/uTools-Manuals.git synced 2025-07-05 16:22:43 +08:00
Code Issues Packages Projects Releases Wiki Activity
uTools-Manuals/docs/java/javax/activation/MailcapCommandMap.html

425 lines
22 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
javax.activation
</div>
<h2 class="title" title="Class MailcapCommandMap">Class MailcapCommandMap</h2>
</div><div class="contentContainer">
<ul class="inheritance">
<li><a href="../../java/lang/Object.html" title="class in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li><a href="../../javax/activation/CommandMap.html" title="class in javax.activation">javax.activation.CommandMap</a></li>
<li>
<ul class="inheritance">
<li>javax.activation.MailcapCommandMap</li>
</ul> </li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public class <span class="typeNameLabel">MailcapCommandMap</span>
extends <a href="../../javax/activation/CommandMap.html" title="class in javax.activation">CommandMap</a></pre>
<div class="block">
<span>MailcapCommandMap扩展了CommandMap抽象类。</span>
<span>它实现了一个CommandMap，其配置基于mailcap文件（ <a href="http://www.ietf.org/rfc/rfc1524.txt">RFC 1524</a> ）。</span>
<span>MailcapCommandMap可以通过编程方式和配置文件进行配置。</span>
<p> <span><b>Mailcap文件搜索顺序：</b></span> </p>
<p> <span>MailcapCommandMap在用户系统的各个地方查看mailcap文件条目。</span> <span>当请求在MailcapCommandMap中搜索命令时，它将按以下顺序搜索mailcap文件：</span> </p>
<p></p>
<ol>
<li> <span>向MailcapCommandMap实例编程添加条目。</span> </li>
<li> <span>文件<code>.mailcap</code>在用户的主目录中。</span> </li>
<li> <span>文件&lt; <i>java.home</i> &gt; <code>/lib/mailcap</code> 。</span> </li>
<li> <span>该文件或资源名为<code>META-INF/mailcap</code> 。</span> </li>
<li> <span>名称为<code>META-INF/mailcap.default</code>的文件或资源（通常仅在<code>activation.jar</code>文件中找到）。</span> </li>
</ol>
<p> <span><b>Mailcap文件格式：</b></span> </p>
<p> <span>Mailcap文件必须符合mailcap文件规范（RFC 1524， <i>A User Agent Configuration Mechanism For Multimedia Mail Format Information</i> ）。</span> <span>文件格式由与特定MIME类型相对应的条目组成。</span> <span>一般来说，规范<i>指定</i>了客户端在他们自己不能在指定的MIME类型上运行时使用的应用程序。</span> <span>MailcapCommandMap通过在mailcap文件中使用参数机制来扩展此规范，允许将JavaBeans（tm）组件指定为MIME类型的特定命令。</span> </p>
<p> <span>当一个mailcap文件进行解析，时，MailcapCommandMap识别出某些参数签名，特别是与那些开头的参数名称<code>x-java-</code> 。</span> <span>MailcapCommandMap使用此签名来查找包含在其注册表中的命令条目。</span> <span>与形式参数名<code>x-java-&lt;name&gt;</code>通过时，MailcapCommandMap作为识别与所述名称<i>名称</i>的命令读出。</span> <span>当<i>名称</i>为<code>content-handler</code> ，MailcapCommandMap将此参数表示的类识别为<i>DataContentHandler</i> 。</span> <span>无论命令名称如何，一般处理所有其他命令。</span> <span>命令实现由JavaBean（tm）组件的完全限定类名指定。</span> <span>例如;</span> <span>用于查看某些数据的命令可以指定为： <code>x-java-view=com.foo.ViewBean</code> 。</span> </p>
<p> <span>当命令名为<code>fallback-entry</code>时，命令的值可能为<code>true</code>或<code>false</code> 。</span> <span>包含x-java-fallback-entry=true参数的MIME类型的<code>x-java-fallback-entry=true</code>定义了该MIME类型的回退命令，只有在没有找到非回退条目的情况下才会使用。</span> <span>例如，表单<code>text/*; ; x-java-fallback-entry=true; x-java-view=com.sun.TextViewer</code>的条目指定了用于任何文本MIME类型的视图命令。</span> <span>仅当无法找到MIME类型的非后备视图命令时，才能使用此视图命令。</span> </p>
<p> <span>MailcapCommandMap感知mailcap文件具有以下一般形式：</span> </p>
<p> <code># Comments begin with a '#' and continue to the end of the line.<br/> &lt;mime type&gt;; ; &lt;parameter list&gt;<br/> # Where a parameter list consists of one or more parameters,<br/> # where parameters look like: x-java-view=com.sun.TextViewer<br/> # and a parameter list looks like: <br/> text/plain; ; x-java-view=com.sun.TextViewer; x-java-edit=com.sun.TextEdit <br/> # Note that mailcap entries that do not contain 'x-java' parameters<br/> # and comply to RFC 1524 are simply ignored:<br/> image/gif; /usr/dt/bin/sdtimage %s<br/></code> </p>
<p></p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
1.6
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- --> </a> <h3>构造方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Constructor Summary table, listing constructors, and an explanation">
<caption>
<span>构造方法</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../javax/activation/MailcapCommandMap.html#MailcapCommandMap--">MailcapCommandMap</a></span>()</code>
<div class="block">
默认构造函数。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../javax/activation/MailcapCommandMap.html#MailcapCommandMap-java.io.InputStream-">MailcapCommandMap</a></span>(<a href="../../java/io/InputStream.html" title="class in java.io">InputStream</a> is)</code>
<div class="block">
构造函数允许调用者指定一个包含mailcap文件的
<i>InputStream</i> 。
</div> </td>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../javax/activation/MailcapCommandMap.html#MailcapCommandMap-java.lang.String-">MailcapCommandMap</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> fileName)</code>
<div class="block">
构造函数允许调用者指定
<i>mailcap</i>文件的路径。
</div> </td>
</tr>
</tbody>
</table> </li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t4"><span><a href="javascript:show(8);">具体的方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/activation/MailcapCommandMap.html#addMailcap-java.lang.String-">addMailcap</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> mail_cap)</code>
<div class="block">
将条目添加到注册表。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../javax/activation/DataContentHandler.html" title="interface in javax.activation">DataContentHandler</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/activation/MailcapCommandMap.html#createDataContentHandler-java.lang.String-">createDataContentHandler</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> mimeType)</code>
<div class="block">
返回指定MIME类型的DataContentHandler。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../javax/activation/CommandInfo.html" title="class in javax.activation">CommandInfo</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/activation/MailcapCommandMap.html#getAllCommands-java.lang.String-">getAllCommands</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> mimeType)</code>
<div class="block">
获取此MIME类型的MailcapCommandMap的此实例已知的所有mailcap文件中的所有可用命令。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../javax/activation/CommandInfo.html" title="class in javax.activation">CommandInfo</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/activation/MailcapCommandMap.html#getCommand-java.lang.String-java.lang.String-">getCommand</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> mimeType, <a href="../../java/lang/String.html" title="class in java.lang">String</a> cmdName)</code>
<div class="block">
获取对应于
<code>cmdName</code>的MIME类型的命令。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../java/lang/String.html" title="class in java.lang">String</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/activation/MailcapCommandMap.html#getMimeTypes--">getMimeTypes</a></span>()</code>
<div class="block">
获取此命令映射已知的所有MIME类型。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code><a href="../../java/lang/String.html" title="class in java.lang">String</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/activation/MailcapCommandMap.html#getNativeCommands-java.lang.String-">getNativeCommands</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> mimeType)</code>
<div class="block">
获取给定MIME类型的本机命令。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code><a href="../../javax/activation/CommandInfo.html" title="class in javax.activation">CommandInfo</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/activation/MailcapCommandMap.html#getPreferredCommands-java.lang.String-">getPreferredCommands</a></span>(<a href="../../java/lang/String.html" title="class in java.lang">String</a> mimeType)</code>
<div class="block">
获取MIME类型的首选命令列表。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.activation.CommandMap">
<!-- --> </a> <h3>Methods inherited from class javax.activation.<a href="../../javax/activation/CommandMap.html" title="class in javax.activation">CommandMap</a></h3> <code><a href="../../javax/activation/CommandMap.html#createDataContentHandler-java.lang.String-javax.activation.DataSource-">createDataContentHandler</a>, <a href="../../javax/activation/CommandMap.html#getAllCommands-java.lang.String-javax.activation.DataSource-">getAllCommands</a>, <a href="../../javax/activation/CommandMap.html#getCommand-java.lang.String-java.lang.String-javax.activation.DataSource-">getCommand</a>, <a href="../../javax/activation/CommandMap.html#getDefaultCommandMap--">getDefaultCommandMap</a>, <a href="../../javax/activation/CommandMap.html#getPreferredCommands-java.lang.String-javax.activation.DataSource-">getPreferredCommands</a>, <a href="../../javax/activation/CommandMap.html#setDefaultCommandMap-javax.activation.CommandMap-">setDefaultCommandMap</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../java/lang/Object.html" title="class in java.lang">Object</a></h3> <code><a href="../../java/lang/Object.html#clone--">clone</a>, <a href="../../java/lang/Object.html#equals-java.lang.Object-">equals</a>, <a href="../../java/lang/Object.html#finalize--">finalize</a>, <a href="../../java/lang/Object.html#getClass--">getClass</a>, <a href="../../java/lang/Object.html#hashCode--">hashCode</a>, <a href="../../java/lang/Object.html#notify--">notify</a>, <a href="../../java/lang/Object.html#notifyAll--">notifyAll</a>, <a href="../../java/lang/Object.html#toString--">toString</a>, <a href="../../java/lang/Object.html#wait--">wait</a>, <a href="../../java/lang/Object.html#wait-long-">wait</a>, <a href="../../java/lang/Object.html#wait-long-int-">wait</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="MailcapCommandMap--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>MailcapCommandMap</h4> <pre>public MailcapCommandMap()</pre>
<div class="block">
默认构造函数。
</div> </li>
</ul> <a name="MailcapCommandMap-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>MailcapCommandMap</h4> <pre>public MailcapCommandMap(<a href="../../java/lang/String.html" title="class in java.lang">String</a> fileName)
throws <a href="../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
构造函数允许调用者指定
<i>mailcap</i>文件的路径。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>fileName</code> - 要打开的
<i>mailcap</i>文件的名称
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果文件无法访问
</dd>
</dl> </li>
</ul> <a name="MailcapCommandMap-java.io.InputStream-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>MailcapCommandMap</h4> <pre>public MailcapCommandMap(<a href="../../java/io/InputStream.html" title="class in java.io">InputStream</a> is)</pre>
<div class="block">
构造函数允许调用者指定一个包含mailcap文件的
<i>InputStream</i> 。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>is</code> - 要打开的
<i>mailcap</i>文件的InputStream
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getPreferredCommands-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPreferredCommands</h4> <pre>public <a href="../../javax/activation/CommandInfo.html" title="class in javax.activation">CommandInfo</a>[] getPreferredCommands(<a href="../../java/lang/String.html" title="class in java.lang">String</a> mimeType)</pre>
<div class="block">
<span>获取MIME类型的首选命令列表。</span>
<span>MailcapCommandMap按照上述<i>Mailcap文件搜索顺序</i>搜索mailcap文件。</span>
<p> <span>搜索结果是MailcapCommandMap此实例已知的所有mailcap文件中可用命令的一个适当子集。</span> <span>特定命令的第一个条目被认为是首选命令。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/activation/CommandMap.html#getPreferredCommands-java.lang.String-">getPreferredCommands</a></code>在
<code><a href="../../javax/activation/CommandMap.html" title="class in javax.activation">CommandMap</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>mimeType</code> - MIME类型
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
表示首选命令的CommandInfo对象。
</dd>
</dl> </li>
</ul> <a name="getAllCommands-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAllCommands</h4> <pre>public <a href="../../javax/activation/CommandInfo.html" title="class in javax.activation">CommandInfo</a>[] getAllCommands(<a href="../../java/lang/String.html" title="class in java.lang">String</a> mimeType)</pre>
<div class="block">
获取此MIME类型的MailcapCommandMap的此实例已知的所有mailcap文件中的所有可用命令。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/activation/CommandMap.html#getAllCommands-java.lang.String-">getAllCommands</a></code>在类别
<code><a href="../../javax/activation/CommandMap.html" title="class in javax.activation">CommandMap</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>mimeType</code> - MIME类型
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
表示所有命令的CommandInfo对象。
</dd>
</dl> </li>
</ul> <a name="getCommand-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCommand</h4> <pre>public <a href="../../javax/activation/CommandInfo.html" title="class in javax.activation">CommandInfo</a> getCommand(<a href="../../java/lang/String.html" title="class in java.lang">String</a> mimeType,
<a href="../../java/lang/String.html" title="class in java.lang">String</a> cmdName)</pre>
<div class="block">
获取
<code>cmdName</code>于MIME类型的
<code>cmdName</code>对应的命令。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/activation/CommandMap.html#getCommand-java.lang.String-java.lang.String-">getCommand</a></code>在类别
<code><a href="../../javax/activation/CommandMap.html" title="class in javax.activation">CommandMap</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>mimeType</code> - MIME类型
</dd>
<dd>
<code>cmdName</code> - 命令名
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
CommandInfo对象对应的命令。
</dd>
</dl> </li>
</ul> <a name="addMailcap-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addMailcap</h4> <pre>public void addMailcap(<a href="../../java/lang/String.html" title="class in java.lang">String</a> mail_cap)</pre>
<div class="block">
<span>将条目添加到注册表。</span>
<span>在其他条目之前，以编程方式添加条目。</span>
<p> <span>传入的字符串应该是mailcap格式。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>mail_cap</code> - 一个正确格式化的邮件字符串
</dd>
</dl> </li>
</ul> <a name="createDataContentHandler-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createDataContentHandler</h4> <pre>public <a href="../../javax/activation/DataContentHandler.html" title="interface in javax.activation">DataContentHandler</a> createDataContentHandler(<a href="../../java/lang/String.html" title="class in java.lang">String</a> mimeType)</pre>
<div class="block">
返回指定MIME类型的DataContentHandler。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../javax/activation/CommandMap.html#createDataContentHandler-java.lang.String-">createDataContentHandler</a></code>在类别
<code><a href="../../javax/activation/CommandMap.html" title="class in javax.activation">CommandMap</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>mimeType</code> - MIME类型
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
DataContentHandler
</dd>
</dl> </li>
</ul> <a name="getMimeTypes--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getMimeTypes</h4> <pre>public <a href="../../java/lang/String.html" title="class in java.lang">String</a>[] getMimeTypes()</pre>
<div class="block">
获取此命令映射已知的所有MIME类型。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">重写：</span>
</dt>
<dd>
<code><a href="../../javax/activation/CommandMap.html#getMimeTypes--">getMimeTypes</a></code>在
<code><a href="../../javax/activation/CommandMap.html" title="class in javax.activation">CommandMap</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
MIME类型数组作为字符串
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
JAF 1.1
</dd>
</dl> </li>
</ul> <a name="getNativeCommands-java.lang.String-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getNativeCommands</h4> <pre>public <a href="../../java/lang/String.html" title="class in java.lang">String</a>[] getNativeCommands(<a href="../../java/lang/String.html" title="class in java.lang">String</a> mimeType)</pre>
<div class="block">
<span>获取给定MIME类型的本机命令。</span>
<span>返回一个字符串数组，每个字符串是整个mailcap文件条目。</span>
<span>应用程序将需要解析该条目以提取实际的命令以及它需要的任何属性。</span>
<span>有关mailcap条目语法的详细信息，请参阅<a href="http://www.ietf.org/rfc/rfc1524.txt">RFC 1524</a> 。</span>
<span>仅返回指定MIME类型的视图命令的mailcap条目。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
本地命令条目数组
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
JAF 1.1
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>
Reference in New Issue View Git Blame Copy Permalink