uTools-Manuals/docs/java/javax/xml/soap/AttachmentPart.html

1019 lines
49 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.xml.soap
</div>
<h2 class="title" title="Class AttachmentPart">Class AttachmentPart</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.soap.AttachmentPart</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">AttachmentPart</span>
extends <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></pre>
<div class="block">
<span>一个附件到一个<code>SOAPMessage</code>对象。</span>
<span><code>SOAPMessage</code>对象可能包含零个,一个或多个<code>AttachmentPart</code>对象。</span>
<span>每个<code>AttachmentPart</code>对象由两部分组成即应用程序特定的内容和相关的MIME标头。</span>
<span>MIME标头由可用于标识和描述内容的名称/值对组成。</span>
<p> <span><code>AttachmentPart</code>对象必须符合某些标准。</span> </p>
<ol>
<li> <span>它必须符合<a href="http://www.ietf.org/rfc/rfc2045.txt">MIME [RFC2045] standards</a></span> </li>
<li> <span>它必须包含内容</span> </li>
<li> <span>标题部分必须包括以下标题:</span>
<ul>
<li> <code>Content-Type</code> <br/> <span>此标头标识<code>AttachmentPart</code>对象的内容中的数据类型,并且必须符合[RFC2045]。</span> <span>以下是Content-Type标题的示例</span> <pre> <span>Content-Type: application/xml</span> </pre> <span>以下代码行(其中<code>ap</code>是一个<code>AttachmentPart</code>对象)设置前一示例中显示的标题。</span> <pre> <span>ap.setMimeHeader("Content-Type", "application/xml");</span> </pre><p></p></li>
</ul></li>
</ol>
<p> <span><code>AttachmentPart</code>对象的内容部分没有限制。</span> <span>内容可以是从简单的纯文本对象到复杂的XML文档或图像文件的任何内容。</span> </p>
<p> <span>使用方法<code>SOAPMessage.createAttachmentPart</code>创建一个<code>AttachmentPart</code>对象。</span> <span>设置其MIME头后 <code>AttachmentPart</code>对象将添加到使用方法<code>SOAPMessage.addAttachmentPart</code>创建的消息。</span> </p>
<p> <span>下面的代码片段,其中<code>m</code><code>SOAPMessage</code>对象和<code>contentStringl</code><code>String</code> ,创建的实例<code>AttachmentPart</code> ,设置<code>AttachmentPart</code>与一些内容和报头信息对象,并将该<code>AttachmentPart</code>对象到<code>SOAPMessage</code>对象。</span> </p>
<pre> <span>AttachmentPart ap1 = m.createAttachmentPart();
ap1.setContent(contentString1, "text/plain");
m.addAttachmentPart(ap1);</span> </pre>
<p> <span>以下代码段创建并将第二个<code>AttachmentPart</code>实例添加到同一消息。</span> <span><code>jpegData</code>是表示jpeg文件的二进制字节缓冲区。</span> </p>
<pre> <span>AttachmentPart ap2 = m.createAttachmentPart();
byte[] jpegData = ...;
ap2.setContent(new ByteArrayInputStream(jpegData), "image/jpeg");
m.addAttachmentPart(ap2);</span> </pre>
<p> <span><code>getContent</code>方法从<code>AttachmentPart</code>对象检索内容和标题。</span> <span>根据存在的<code>DataContentHandler</code>对象,返回的<code>Object</code>可以是对应于MIME类型的类型化的Java对象或包含内容为字节的<code>InputStream</code>对象。</span> </p>
<pre> <span>String content1 = ap1.getContent();
java.io.InputStream content2 = ap2.getContent();</span> </pre>
<span>方法<code>clearContent</code><code>AttachmentPart</code>对象中删除所有内容,但不影响其头信息。</span>
<pre> <span>ap1.clearContent();</span> </pre>
</div> </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/soap/AttachmentPart.html#AttachmentPart--">AttachmentPart</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 void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/AttachmentPart.html#addMimeHeader-java.lang.String-java.lang.String-">addMimeHeader</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> value)</code>
<div class="block">
向此
<code>AttachmentPart</code>对象添加具有指定名称和值的MIME标头。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>abstract void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/AttachmentPart.html#clearContent--">clearContent</a></span>()</code>
<div class="block">
清除此
<code>AttachmentPart</code>对象的内容。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>abstract <a href="../../../java/util/Iterator.html" title="interface in java.util">Iterator</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/AttachmentPart.html#getAllMimeHeaders--">getAllMimeHeaders</a></span>()</code>
<div class="block">
检索这一切的头
<code>AttachmentPart</code>对象为在一个迭代
<code>MimeHeader</code>对象。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>abstract <a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/AttachmentPart.html#getBase64Content--">getBase64Content</a></span>()</code>
<div class="block">
返回一个
<code>InputStream</code> 可以用来获取作为Base64编码字符数据的
<code>AttachmentPart</code>的内容此方法将base64编码附件的原始字节并返回。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>abstract <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/AttachmentPart.html#getContent--">getContent</a></span>()</code>
<div class="block">
获取此
<code>AttachmentPart</code>对象的内容作为Java对象。
</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/xml/soap/AttachmentPart.html#getContentId--">getContentId</a></span>()</code>
<div class="block">
获取名称为“Content-ID”的MIME标头的值。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<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/xml/soap/AttachmentPart.html#getContentLocation--">getContentLocation</a></span>()</code>
<div class="block">
获取名称为“Content-Location”的MIME标头的值。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<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/xml/soap/AttachmentPart.html#getContentType--">getContentType</a></span>()</code>
<div class="block">
获取名称为“Content-Type”的MIME标头的值。
</div> </td>
</tr>
<tr class="altColor" id="i8">
<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/soap/AttachmentPart.html#getDataHandler--">getDataHandler</a></span>()</code>
<div class="block">
获取此
<code>DataHandler</code>对象的
<code>AttachmentPart</code>对象。
</div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code>abstract <a href="../../../java/util/Iterator.html" title="interface in java.util">Iterator</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/AttachmentPart.html#getMatchingMimeHeaders-java.lang.String:A-">getMatchingMimeHeaders</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] names)</code>
<div class="block">
检索与给定数组中的名称相匹配的所有
<code>MimeHeader</code>对象。
</div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code>abstract <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/xml/soap/AttachmentPart.html#getMimeHeader-java.lang.String-">getMimeHeader</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</code>
<div class="block">
获取由给定的
<code>String</code>的头部的所有值。
</div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code>abstract <a href="../../../java/util/Iterator.html" title="interface in java.util">Iterator</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/AttachmentPart.html#getNonMatchingMimeHeaders-java.lang.String:A-">getNonMatchingMimeHeaders</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] names)</code>
<div class="block">
检索名称与给定数组中的名称不匹配的所有
<code>MimeHeader</code>对象。
</div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code>abstract <a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/AttachmentPart.html#getRawContent--">getRawContent</a></span>()</code>
<div class="block">
将该
<code>AttachmentPart</code>对象的内容作为InputStream获取就像已经做出了
<code>getContent</code> ,并且没有
<code>DataContentHandler</code> AttachmentPart的
<code>content-type</code>
<code>AttachmentPart</code>
</div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code>abstract byte[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/AttachmentPart.html#getRawContentBytes--">getRawContentBytes</a></span>()</code>
<div class="block">
将该
<code>AttachmentPart</code>对象的内容作为byte []数组获取,就像已对
<code>getContent</code>进行了调用,并且没有
<code>DataContentHandler</code> AttachmentPart的
<code>content-type</code>
<code>AttachmentPart</code>
</div> </td>
</tr>
<tr class="altColor" id="i14">
<td class="colFirst"><code>abstract int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/AttachmentPart.html#getSize--">getSize</a></span>()</code>
<div class="block">
返回此
<code>AttachmentPart</code>对象中的字节数。
</div> </td>
</tr>
<tr class="rowColor" id="i15">
<td class="colFirst"><code>abstract void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/AttachmentPart.html#removeAllMimeHeaders--">removeAllMimeHeaders</a></span>()</code>
<div class="block">
删除所有的MIME标题条目。
</div> </td>
</tr>
<tr class="altColor" id="i16">
<td class="colFirst"><code>abstract void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/AttachmentPart.html#removeMimeHeader-java.lang.String-">removeMimeHeader</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> header)</code>
<div class="block">
删除与给定名称相匹配的所有MIME标头。
</div> </td>
</tr>
<tr class="rowColor" id="i17">
<td class="colFirst"><code>abstract void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/AttachmentPart.html#setBase64Content-java.io.InputStream-java.lang.String-">setBase64Content</a></span>(<a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a> content, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> contentType)</code>
<div class="block">
从Base64源
<code>InputStream</code>设置此附件部分的内容,并将
<code>Content-Type</code>标头的值设置为contentType中
<code>contentType</code>的值。此方法首先解码base64输入并将生成的原始字节写入附件。
</div> </td>
</tr>
<tr class="altColor" id="i18">
<td class="colFirst"><code>abstract void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/AttachmentPart.html#setContent-java.lang.Object-java.lang.String-">setContent</a></span>(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> object, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> contentType)</code>
<div class="block">
将此附件部分的内容设置为给定的
<code>Object</code> ,并将
<code>Content-Type</code>标头的值设置为给定类型。
</div> </td>
</tr>
<tr class="rowColor" id="i19">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/AttachmentPart.html#setContentId-java.lang.String-">setContentId</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> contentId)</code>
<div class="block">
使用给定值设置名称为“Content-ID”的MIME标头。
</div> </td>
</tr>
<tr class="altColor" id="i20">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/AttachmentPart.html#setContentLocation-java.lang.String-">setContentLocation</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> contentLocation)</code>
<div class="block">
使用给定值设置名称为“Content-Location”的MIME头。
</div> </td>
</tr>
<tr class="rowColor" id="i21">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/AttachmentPart.html#setContentType-java.lang.String-">setContentType</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> contentType)</code>
<div class="block">
使用给定值设置名称为“Content-Type”的MIME头。
</div> </td>
</tr>
<tr class="altColor" id="i22">
<td class="colFirst"><code>abstract void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/AttachmentPart.html#setDataHandler-javax.activation.DataHandler-">setDataHandler</a></span>(<a href="../../../javax/activation/DataHandler.html" title="class in javax.activation">DataHandler</a> dataHandler)</code>
<div class="block">
将给定
<code>DataHandler</code>对象作为此数据处理程序
<code>AttachmentPart</code>对象。
</div> </td>
</tr>
<tr class="rowColor" id="i23">
<td class="colFirst"><code>abstract void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/AttachmentPart.html#setMimeHeader-java.lang.String-java.lang.String-">setMimeHeader</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> value)</code>
<div class="block">
将与给定名称匹配的第一个标题条目更改为给定值,如果没有现有标题匹配,则添加一个新标题。
</div> </td>
</tr>
<tr class="altColor" id="i24">
<td class="colFirst"><code>abstract void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/AttachmentPart.html#setRawContent-java.io.InputStream-java.lang.String-">setRawContent</a></span>(<a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a> content, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> contentType)</code>
<div class="block">
将此附件部分的内容设置为InputStream content所
<code>InputStream</code>
<code>content</code> ,并将
<code>Content-Type</code>标头的值设置为contentType中
<code>contentType</code>的值。
</div> </td>
</tr>
<tr class="rowColor" id="i25">
<td class="colFirst"><code>abstract void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/AttachmentPart.html#setRawContentBytes-byte:A-int-int-java.lang.String-">setRawContentBytes</a></span>(byte[] content, int offset, int len, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> contentType)</code>
<div class="block">
将此附件部分的内容设置为
<code>byte[]</code>数组
<code>content</code>所包含的
<code>content</code> ,并将
<code>Content-Type</code>标头的值设置为contentType中
<code>contentType</code>的值。
</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="AttachmentPart--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>AttachmentPart</h4> <pre>public AttachmentPart()</pre> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getSize--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSize</h4> <pre>public abstract int getSize()
throws <a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></pre>
<div class="block">
返回此
<code>AttachmentPart</code>对象中的字节数。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
这个
<code>AttachmentPart</code>对象的大小以字节为单位,如果大小不能确定,则为-1
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></code> - 如果此附件的内容在尝试确定大小时有异常而损坏。
</dd>
</dl> </li>
</ul> <a name="clearContent--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>clearContent</h4> <pre>public abstract void clearContent()</pre>
<div class="block">
<span>清除此<code>AttachmentPart</code>对象的内容。</span>
<span>MIME标题部分保持不变。</span>
</div> </li>
</ul> <a name="getContent--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getContent</h4> <pre>public abstract <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> getContent()
throws <a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></pre>
<div class="block">
<span>获取此<code>AttachmentPart</code>对象的内容作为Java对象。</span>
<span>返回的Java对象的类型取决于1用于解释字节的<code>DataContentHandler</code>对象2 <code>Content-Type</code>给出的<code>Content-Type</code></span>
<p> <span>对于MIME内容类型“text / plain”“text / html”和“text / xml” <code>DataContentHandler</code>对象执行与MIME类型对应的Java类型的转换。</span> <span>对于其他MIME类型 <code>DataContentHandler</code>对象可以返回包含内容数据的<code>InputStream</code>对象作为原始字节。</span> </p>
<p> <span>柔顺SAAJ-实现必须,作为最低限度,返回<code>java.lang.String</code>对应于任何内容流对象与<code>Content-Type</code>的值<code>text/plain</code> ,一个<code>javax.xml.transform.stream.StreamSource</code>对应于内容流对象与<code>Content-Type</code>的值<code>text/xml</code> ,一个<code>java.awt.Image</code>对应于一个内容的流对象其中<code>Content-Type</code>价值为<code>image/gif</code><code>image/jpeg</code></span> <span>对于安装的<code>DataContentHandler</code>对象不明白的内容类型, <code>DataContentHandler</code>对象需要返回一个<code>java.io.InputStream</code>对象与原始字节。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个Java对象与这个
<code>AttachmentPart</code>对象的内容
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></code> - 如果没有内容设置到此
<code>AttachmentPart</code>对象中,或者是否存在数据转换错误
</dd>
</dl> </li>
</ul> <a name="getRawContent--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getRawContent</h4> <pre>public abstract <a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a> getRawContent()
throws <a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></pre>
<div class="block">
<span>获取此内容<code>AttachmentPart</code>对象作为InputStream仿佛调用了到<code>getContent</code> ,没有<code>DataContentHandler</code>已经登记为<code>content-type</code>这一点<code>AttachmentPart</code></span>
<p> <span>请注意从返回的InputStream读取将导致消息流中的数据。</span> <span>调用后续API之前调用方有责任重新设置InputStream。</span> <span>如果需要原始附件内容的副本,则应使用<a href="../../../javax/xml/soap/AttachmentPart.html#getRawContentBytes--"><code>getRawContentBytes()</code></a> API。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>InputStream</code>从其中由包含在所述原始数据
<code>AttachmentPart</code>可被访问。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></code> - 如果没有内容设置到此
<code>AttachmentPart</code>对象中,或者是否存在数据转换错误。
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
SAAJ 1.3
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/xml/soap/AttachmentPart.html#getRawContentBytes--"><code>getRawContentBytes()</code></a>
</dd>
</dl> </li>
</ul> <a name="getRawContentBytes--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getRawContentBytes</h4> <pre>public abstract byte[] getRawContentBytes()
throws <a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></pre>
<div class="block">
将该
<code>AttachmentPart</code>对象的内容作为byte []数组获取,就像已对
<code>getContent</code>进行了调用,并且没有
<code>DataContentHandler</code> AttachmentPart的
<code>content-type</code>
<code>AttachmentPart</code>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>byte[]</code>数组包含原始数据的
<code>AttachmentPart</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></code> - 如果没有内容设置到此
<code>AttachmentPart</code>对象中,或者是否存在数据转换错误。
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
SAAJ 1.3
</dd>
</dl> </li>
</ul> <a name="getBase64Content--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getBase64Content</h4> <pre>public abstract <a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a> getBase64Content()
throws <a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></pre>
<div class="block">
返回一个
<code>InputStream</code> 可以用来获取作为Base64编码字符数据的
<code>AttachmentPart</code>的内容这个方法将base64编码附件的原始字节并返回。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>InputStream</code>可以读取Base64编码的
<code>AttachmentPart</code>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></code> - 如果没有内容设置到此
<code>AttachmentPart</code>对象中,或者是否存在数据转换错误。
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
SAAJ 1.3
</dd>
</dl> </li>
</ul> <a name="setContent-java.lang.Object-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setContent</h4> <pre>public abstract void setContent(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> object,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> contentType)</pre>
<div class="block">
<span>将此附件部分的内容设置为给定的<code>Object</code> ,并将<code>Content-Type</code>标头的值设置为给定类型。</span>
<span>的类型的<code>Object</code>应该对应于用于给定的值<code>Content-Type</code></span>
<span>这取决于正在使用的<code>DataContentHandler</code>对象的特定集合。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>object</code> - 构成此附件部分内容的Java对象
</dd>
<dd>
<code>contentType</code> - 指定内容类型的MIME字符串
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果contentType与内容对象的类型不匹配或者如果此内容对象没有
<code>DataContentHandler</code>对象,则可能会抛出
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/xml/soap/AttachmentPart.html#getContent--"><code>getContent()</code></a>
</dd>
</dl> </li>
</ul> <a name="setRawContent-java.io.InputStream-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setRawContent</h4> <pre>public abstract void setRawContent(<a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a> content,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> contentType)
throws <a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></pre>
<div class="block">
<span>将此附件部分的内容设置为InputStream content所<code>InputStream</code> <code>content</code> ,并将<code>Content-Type</code>标头的值设置为contentType中<code>contentType</code>的值。</span>
<p> <span>对getSize的后续调用可能不是内容大小的精确度量。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>content</code> - 要添加到附件部分的原始数据
</dd>
<dd>
<code>contentType</code> - 要设置为
<code>Content-Type</code>头的值
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></code> - 如果设置内容有错误
</dd>
<dd>
<code><a href="../../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - 如果
<code>content</code>为空
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
SAAJ 1.3
</dd>
</dl> </li>
</ul> <a name="setRawContentBytes-byte:A-int-int-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setRawContentBytes</h4> <pre>public abstract void setRawContentBytes(byte[] content,
int offset,
int len,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> contentType)
throws <a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></pre>
<div class="block">
将此附件部分的内容设置为
<code>byte[]</code>阵列
<code>content</code>所包含的
<code>content</code> ,并将
<code>Content-Type</code>标头的值设置为contentType中
<code>contentType</code>的值。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>content</code> - 添加到附件部分的原始数据
</dd>
<dd>
<code>contentType</code> - 设置为
<code>Content-Type</code>标题的值
</dd>
<dd>
<code>offset</code> - 内容的字节数组中的偏移量
</dd>
<dd>
<code>len</code> - 形成内容的字节数
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></code> - 如果内容设置错误或内容为空
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
SAAJ 1.3
</dd>
</dl> </li>
</ul> <a name="setBase64Content-java.io.InputStream-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setBase64Content</h4> <pre>public abstract void setBase64Content(<a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a> content,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> contentType)
throws <a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></pre>
<div class="block">
<span>从Base64源<code>InputStream</code>设置此附件部分的内容,并将<code>Content-Type</code>标头的值设置为contentType中<code>contentType</code>的值。此方法首先解码base64输入并将生成的原始字节写入附件。</span>
<p> <span>对getSize的后续调用可能不是内容大小的精确度量。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>content</code> - 要添加到附件部分的base64编码数据
</dd>
<dd>
<code>contentType</code> - 设置为
<code>Content-Type</code>标题的值
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></code> - 如果设置内容有错误
</dd>
<dd>
<code><a href="../../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - 如果
<code>content</code>为空
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
SAAJ 1.3
</dd>
</dl> </li>
</ul> <a name="getDataHandler--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getDataHandler</h4> <pre>public abstract <a href="../../../javax/activation/DataHandler.html" title="class in javax.activation">DataHandler</a> getDataHandler()
throws <a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></pre>
<div class="block">
获取此
<code>DataHandler</code>对象的
<code>AttachmentPart</code>对象。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
与该
<code>DataHandler</code>对象相关联的
<code>AttachmentPart</code>对象
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></code> - 如果此
<code>AttachmentPart</code>对象中没有数据
</dd>
</dl> </li>
</ul> <a name="setDataHandler-javax.activation.DataHandler-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setDataHandler</h4> <pre>public abstract void setDataHandler(<a href="../../../javax/activation/DataHandler.html" title="class in javax.activation">DataHandler</a> dataHandler)</pre>
<div class="block">
<span>将给定<code>DataHandler</code>对象作为此数据处理程序<code>AttachmentPart</code>对象。</span>
<span>通常,在传入消息中,数据处理程序将自动设置。</span>
<span>当使用内容创建和填充消息时, <code>setDataHandler</code>方法可用于从各种数据源获取数据到消息中。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>dataHandler</code> - 要设置的
<code>DataHandler</code>对象
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果指定的
<code>DataHandler</code>对象有问题
</dd>
</dl> </li>
</ul> <a name="getContentId--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getContentId</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a> getContentId()</pre>
<div class="block">
获取名称为“Content-ID”的MIME标头的值。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>String</code>给出“Content-ID”头或
<code>null</code>的值,如果没有
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/xml/soap/AttachmentPart.html#setContentId-java.lang.String-"><code>setContentId(java.lang.String)</code></a>
</dd>
</dl> </li>
</ul> <a name="getContentLocation--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getContentLocation</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a> getContentLocation()</pre>
<div class="block">
获取名称为“Content-Location”的MIME标头的值。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>String</code>给出“内容位置”标题的值或
<code>null</code>如果没有
</dd>
</dl> </li>
</ul> <a name="getContentType--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getContentType</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a> getContentType()</pre>
<div class="block">
获取名称为“Content-Type”的MIME标头的值。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>String</code>给出了“Content-Type”头或
<code>null</code>的值,如果没有
</dd>
</dl> </li>
</ul> <a name="setContentId-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setContentId</h4> <pre>public void setContentId(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> contentId)</pre>
<div class="block">
使用给定值设置名称为“Content-ID”的MIME标头。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>contentId</code> - 一个
<code>String</code>给出“Content-ID”头的值
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果指定的
<code>contentId</code>值有问题
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/xml/soap/AttachmentPart.html#getContentId--"><code>getContentId()</code></a>
</dd>
</dl> </li>
</ul> <a name="setContentLocation-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setContentLocation</h4> <pre>public void setContentLocation(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> contentLocation)</pre>
<div class="block">
使用给定值设置名称为“Content-Location”的MIME头。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>contentLocation</code> - 一个
<code>String</code>给出了“内容位置”标题的值
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果指定的内容位置有问题
</dd>
</dl> </li>
</ul> <a name="setContentType-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setContentType</h4> <pre>public void setContentType(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> contentType)</pre>
<div class="block">
使用给定值设置名称为“Content-Type”的MIME头。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>contentType</code> - 一个
<code>String</code>给出了“Content-Type”头的值
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果指定的内容类型有问题
</dd>
</dl> </li>
</ul> <a name="removeMimeHeader-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeMimeHeader</h4> <pre>public abstract void removeMimeHeader(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> header)</pre>
<div class="block">
删除与给定名称相匹配的所有MIME标头。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>header</code> - 要删除的MIME标题的字符串名称
</dd>
</dl> </li>
</ul> <a name="removeAllMimeHeaders--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>removeAllMimeHeaders</h4> <pre>public abstract void removeAllMimeHeaders()</pre>
<div class="block">
删除所有的MIME标题条目。
</div> </li>
</ul> <a name="getMimeHeader-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getMimeHeader</h4> <pre>public abstract <a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] getMimeHeader(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</pre>
<div class="block">
获取由给定的
<code>String</code>的头的所有值。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>name</code> - 标题的名称;</span>
<span>示例“Content-Type”</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>String</code>数组给出指定头的值
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/xml/soap/AttachmentPart.html#setMimeHeader-java.lang.String-java.lang.String-"><code>setMimeHeader(java.lang.String, java.lang.String)</code></a>
</dd>
</dl> </li>
</ul> <a name="setMimeHeader-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setMimeHeader</h4> <pre>public abstract void setMimeHeader(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> value)</pre>
<div class="block">
<span>将与给定名称匹配的第一个标题条目更改为给定值,如果没有现有标题匹配,则添加一个新标题。</span>
<span>此方法也会删除所有匹配的头文件,但第一个。</span>
<p> <span>请注意RFC822头文件只能包含US-ASCII字符。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 一个
<code>String</code>给出要搜索的标题的名称
</dd>
<dd>
<code>value</code> - 一个
<code>String</code>给出为其名称与给定名称匹配的标题设置的值
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果指定的MIME名称或值有问题
</dd>
</dl> </li>
</ul> <a name="addMimeHeader-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addMimeHeader</h4> <pre>public abstract void addMimeHeader(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> value)</pre>
<div class="block">
<span>向此<code>AttachmentPart</code>对象添加具有指定名称和值的MIME标头。</span>
<p> <span>请注意RFC822头文件只能包含US-ASCII字符。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> -
<code>String</code>给出要添加的标题的名称
</dd>
<dd>
<code>value</code> -
<code>String</code>给出要添加的标题的值
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果指定的mime头名称或值有问题
</dd>
</dl> </li>
</ul> <a name="getAllMimeHeaders--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAllMimeHeaders</h4> <pre>public abstract <a href="../../../java/util/Iterator.html" title="interface in java.util">Iterator</a> getAllMimeHeaders()</pre>
<div class="block">
检索这一切的头
<code>AttachmentPart</code>对象为在一个迭代
<code>MimeHeader</code>对象。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>Iterator</code>对象所有MIME头的这个
<code>AttachmentPart</code>对象
</dd>
</dl> </li>
</ul> <a name="getMatchingMimeHeaders-java.lang.String:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getMatchingMimeHeaders</h4> <pre>public abstract <a href="../../../java/util/Iterator.html" title="interface in java.util">Iterator</a> getMatchingMimeHeaders(<a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] names)</pre>
<div class="block">
检索与给定数组中的名称相匹配的所有
<code>MimeHeader</code>对象。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>names</code> - 要返回的MIME标题的名称的
<code>String</code>数组
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
所有MIME头匹配给定数组中的一个名称作为一个
<code>Iterator</code>对象
</dd>
</dl> </li>
</ul> <a name="getNonMatchingMimeHeaders-java.lang.String:A-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getNonMatchingMimeHeaders</h4> <pre>public abstract <a href="../../../java/util/Iterator.html" title="interface in java.util">Iterator</a> getNonMatchingMimeHeaders(<a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] names)</pre>
<div class="block">
检索名称与给定数组中的名称不匹配的所有
<code>MimeHeader</code>对象。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>names</code> - 具有MIME标题名称的
<code>String</code>数组不被返回
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span><code>AttachmentPart</code>对象中的所有MIME标头除了与给定数组中的一个名称相匹配的对象。</span>
<span>不匹配的MIME标题作为<code>Iterator</code>对象返回。</span>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>