mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-04 15:52:45 +08:00
217 lines
12 KiB
HTML
217 lines
12 KiB
HTML
<div class="header">
|
||
<div class="subTitle">
|
||
javax.xml.bind.attachment
|
||
</div>
|
||
<h2 class="title" title="Class AttachmentUnmarshaller">Class AttachmentUnmarshaller</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>javax.xml.bind.attachment.AttachmentUnmarshaller</li>
|
||
</ul> </li>
|
||
</ul>
|
||
<div class="description">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">AttachmentUnmarshaller</span>
|
||
extends <a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a></pre>
|
||
<div class="block">
|
||
<p> <span>使JAXB解组合包含优化的二进制数据格式的根文档。</span> </p>
|
||
<p> <span>该API可实现JAXB 2.0实现和基于MIME的包处理器（MTOM / XOP和WS-I AP 1.0）之间的优化二进制数据格式的高效协作处理。</span> <span>JAXB解包一个包的正文，将对所使用的打包格式的理解委托给实现此抽象类的基于MIME的包处理器。</span> </p>
|
||
<p> <span>该抽象类标识一个包是否需要XOP处理， <a href="../../../../javax/xml/bind/attachment/AttachmentUnmarshaller.html#isXOPPackage--"><code>isXOPPackage()</code></a>并提供通过content-id存储为附件的二进制内容的检索。</span> </p>
|
||
<h2> <span>识别content-id，cid，传递给<code>getAttachment*(String cid)</code></span> </h2>
|
||
<ul>
|
||
<li> <span>对于XOP处理，cid的信息集表示在Section 3.2 Interpreting XOP Packages中的步骤2a中<a href="http://www.w3.org/TR/2005/REC-xop10-20050125/#interpreting_xop_packages">描述</a></span> </li>
|
||
<li> <span>对于WS-I AP 1.0，cid被标识为Section 4.4 Referencing Attachments from the SOAP Envelope中指定的类型<code>ref:swaRef</code>的元素或<a href="http://www.ws-i.org/Profiles/AttachmentsProfile-1.0-2004-08-24.html#Referencing_Attachments_from_the_SOAP_Envelope">属性</a></span> </li>
|
||
</ul>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始：</span>
|
||
</dt>
|
||
<dd>
|
||
JAXB 2.0
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../../javax/xml/bind/Unmarshaller.html#setAttachmentUnmarshaller-javax.xml.bind.attachment.AttachmentUnmarshaller-"><code>Unmarshaller.setAttachmentUnmarshaller(AttachmentUnmarshaller)</code></a> ，
|
||
<a href="http://www.w3.org/TR/2005/REC-xop10-20050125/">XML-binary Optimized Packaging</a> ，
|
||
<a href="http://www.ws-i.org/Profiles/AttachmentsProfile-1.0-2004-08-24.html">WS-I Attachments Profile Version 1.0.</a> ，
|
||
<a href="http://www.w3.org/TR/xml-media-types/">Describing Media Content of Binary Data in XML</a>
|
||
</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/xml/bind/attachment/AttachmentUnmarshaller.html#AttachmentUnmarshaller--">AttachmentUnmarshaller</a></span>()</code> </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="t3"><span><a href="javascript:show(4);">抽象方法</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>abstract byte[]</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/bind/attachment/AttachmentUnmarshaller.html#getAttachmentAsByteArray-java.lang.String-">getAttachmentAsByteArray</a></span>(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> cid)</code>
|
||
<div class="block">
|
||
检索由content-id标识的
|
||
<code>cid</code> ，
|
||
<code>cid</code> ，作为
|
||
<tt>byte[]</tt>
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i1">
|
||
<td class="colFirst"><code>abstract <a href="../../../../javax/activation/DataHandler.html" title="class in javax.activation">DataHandler</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/bind/attachment/AttachmentUnmarshaller.html#getAttachmentAsDataHandler-java.lang.String-">getAttachmentAsDataHandler</a></span>(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> cid)</code>
|
||
<div class="block">
|
||
<span>根据content-id查找MIME内容， <code>cid</code> ，并作为<a href="../../../../javax/activation/DataHandler.html" title="javax.activation中的类"><code>DataHandler</code></a>返回。</span>
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i2">
|
||
<td class="colFirst"><code>boolean</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/bind/attachment/AttachmentUnmarshaller.html#isXOPPackage--">isXOPPackage</a></span>()</code>
|
||
<div class="block">
|
||
只读属性，如果JAXB解组器需要执行XOP处理，则返回true。
|
||
</div> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<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="AttachmentUnmarshaller--">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>AttachmentUnmarshaller</h4> <pre>public AttachmentUnmarshaller()</pre> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
<!-- ============ METHOD DETAIL ========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="method.detail">
|
||
<!-- --> </a> <h3>方法详细信息</h3> <a name="getAttachmentAsDataHandler-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getAttachmentAsDataHandler</h4> <pre>public abstract <a href="../../../../javax/activation/DataHandler.html" title="class in javax.activation">DataHandler</a> getAttachmentAsDataHandler(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> cid)</pre>
|
||
<div class="block">
|
||
<p> <span>根据content-id查找MIME内容， <code>cid</code> ，并作为<a href="../../../../javax/activation/DataHandler.html" title="javax.activation中的类"><code>DataHandler</code></a>返回。</span> </p>
|
||
<p> <span>返回的<code>DataHandler</code>实例必须配置为满足以下所需的映射constaint。</span> </p>
|
||
<span> Required Mappings between MIME and Java Types MIME Type Java Type <code>DataHandler.getContentType()</code> <code>instanceof DataHandler.getContent()</code> image/gif java.awt.Image image/jpeg java.awt.Image text/xml or application/xml javax.xml.transform.Source </span>
|
||
<table border="2" cellpadding="4" rules="all">
|
||
</table>
|
||
<span>请注意，允许支持其他映射。</span>
|
||
<p></p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>cid</code> - 预期是XML Schema <code>xs:anyURI</code>数据类型的有效词汇表。</span>
|
||
<span>如果<code><a href="../../../../javax/xml/bind/attachment/AttachmentUnmarshaller.html#isXOPPackage--"><code>isXOPPackage()</code></a> ==true</code> ，它必须是<code>cid:</code> URI方案的有效URI（参见<a href="http://www.ietf.org/rfc/rfc2387.txt">RFC 2387</a> ）</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span>一个<a href="../../../../javax/activation/DataHandler.html" title="javax.activation中的类">代表</a> MIME附件的<code>DataHandler</code>。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果找不到给定cid的附件。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getAttachmentAsByteArray-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getAttachmentAsByteArray</h4> <pre>public abstract byte[] getAttachmentAsByteArray(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> cid)</pre>
|
||
<div class="block">
|
||
<p> <span>检索由content-id标识的<code>cid</code> ， <code>cid</code> ，作为<tt>byte[]</tt></span> </p>
|
||
<span>。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>cid</code> - 预计是XML Schema <code>xs:anyURI</code>数据类型的有效词汇表。</span>
|
||
<span>如果<code><a href="../../../../javax/xml/bind/attachment/AttachmentUnmarshaller.html#isXOPPackage--"><code>isXOPPackage()</code></a> ==true</code> ，它必须是<code>cid:</code> URI方案的有效URI（见<a href="http://www.ietf.org/rfc/rfc2387.txt">RFC 2387</a> ）</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
由cid标识的附件的byte []表示。
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果找不到给定cid的附件。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="isXOPPackage--">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>isXOPPackage</h4> <pre>public boolean isXOPPackage()</pre>
|
||
<div class="block">
|
||
<p> <span>只读属性，如果JAXB解组器需要执行XOP处理，则返回true。</span> </p>
|
||
<p> <span>当满足Identifying XOP Documents中<a href="http://www.w3.org/TR/2005/REC-xop10-20050125/#identifying_xop_documents">指定的</a> <code>true</code>时，此方法返回<code>true</code> 。</span> <span>在解组过程中，此值不能更改。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
当MIME上下文是XOP文档时为真。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
</div> |