com.sun.xml.ws.api.message
Interface Attachment

All Known Subinterfaces:

AttachmentEx

All Known Implementing Classes:

ByteArrayAttachment, DataHandlerAttachment, JAXBAttachment, StreamAttachment

public interface Attachment

Attachment.

Method Summary

byte[]	asByteArray() Gets the attachment as an exact-length byte array.
javax.activation.DataHandler	asDataHandler() Gets the attachment as a DataHandler.
java.io.InputStream	asInputStream() Obtains this attachment as an InputStream.
javax.xml.transform.Source	asSource() Gets the attachment as a Source.
java.lang.String	getContentId() Content ID of the attachment.
java.lang.String	getContentType() Gets the MIME content-type of this attachment.
void	writeTo(java.io.OutputStream os) Writes the contents of the attachment into the given stream.
void	writeTo(javax.xml.soap.SOAPMessage saaj) Writes this attachment to the given SOAPMessage.

Method Detail

getContentId

@NotNull
java.lang.String getContentId()

Content ID of the attachment. Uniquely identifies an attachment. http://www.ietf.org/rfc/rfc2392.txt (which is referred by the ws-i attachment profile http://www.ws-i.org/Profiles/AttachmentsProfile-1.0.html) content-id = url-addr-spec url-addr-spec = addr-spec ; URL encoding of RFC 822 addr-spec cid-url = "cid" ":" content-id A "cid" URL is converted to the corresponding Content-ID message header [MIME] by removing the "cid:" prefix, converting the % encoded character to their equivalent US-ASCII characters, and enclosing the remaining parts with an angle bracket pair, "<" and ">". For example, "cid:foo4%[email protected]" corresponds to Content-ID:

Returns:

The content ID like "[email protected]", without surrounding '<' and '>' used as the transfer syntax.

getContentType

java.lang.String getContentType()

Gets the MIME content-type of this attachment.

asByteArray

byte[] asByteArray()

Gets the attachment as an exact-length byte array.

asDataHandler

javax.activation.DataHandler asDataHandler()

Gets the attachment as a DataHandler.

asSource

javax.xml.transform.Source asSource()

Gets the attachment as a Source. Note that there's no guarantee that the attachment is actually an XML.

asInputStream

java.io.InputStream asInputStream()

Obtains this attachment as an InputStream.

writeTo

void writeTo(java.io.OutputStream os)
             throws java.io.IOException

Writes the contents of the attachment into the given stream.

Throws:

java.io.IOException

writeTo

void writeTo(javax.xml.soap.SOAPMessage saaj)
             throws javax.xml.soap.SOAPException

Writes this attachment to the given SOAPMessage.

Throws:

javax.xml.soap.SOAPException