oracle.webservices.attachments

Interface AttachmentFault

public interface AttachmentFault

This class is used to manage MIME attachments in a SOAP Fault

Since:

release specific (what release of product did this appear in)

Version:

$Header: $

Method Summary

Methods

Modifier and Type	Method and Description
void	addAttachment(javax.xml.soap.AttachmentPart attachmentPart) Adds an attachment to be associated with this fault.
void	addAttachment(javax.activation.DataHandler dh) Adds an attachment to be associated with this fault using a DataHandler.
void	addAttachment(java.lang.Object content, java.lang.String contentType) Adds an attachment to be associated with this fault.
java.util.Iterator	getAttachments() Get a list of all attachments for this fault.
boolean	hasAttachments() Checks if the fault has any MIME attachments.

Method Detail

addAttachment

void addAttachment(javax.activation.DataHandler dh)
                   throws javax.xml.soap.SOAPException

Adds an attachment to be associated with this fault using a DataHandler. This is a convenience method that creates a new javax.xml.soap.AttachmentPart and adds it to the list of attachments.

Parameters:

dh - A DataHandler object containing the attachment.

Throws:

javax.xml.soap.SOAPException - If the DataHandler is null or an exception is thrown while adding the attachment.

See Also:

addAttachment(javax.xml.soap.AttachmentPart)

addAttachment

void addAttachment(java.lang.Object content,
                 java.lang.String contentType)
                   throws javax.xml.soap.SOAPException

Adds an attachment to be associated with this fault. This is a convenience method that creates a DataHandler with the content and contentType specified and adds the DataHandler as an attachment.

Parameters:

content - The object to be attached

contentType - The mime type of the object. Ex. "image/jpeg", "application/xml", etc.

Throws:

javax.xml.soap.SOAPException

addAttachment

void addAttachment(javax.xml.soap.AttachmentPart attachmentPart)

Adds an attachment to be associated with this fault. Each attachment is added to the SOAP message with a content-id that is constructed according to the content-id part encoding specified in R2933 of the WS-I Attachments Profile 1.0 For example: For a fault part "foo" each attachment will have a content-id mime header similar to <foo=uniquenumber@oracle.com>

Parameters:

attachmentPart - An attachment to be added to the SOAP message.

getAttachments

java.util.Iterator getAttachments()

Get a list of all attachments for this fault. A fault can have attachments if and only if the ouput message of the operation in the binding of the corresponding wsdl specifies a mime:multipartRelated as a child element. See R2920 of the WS-I Attachments Profile 1.0 for more information.

Returns:

An iterator of javax.xml.soap.AttachmentPart objects. Each object represents an attachment mapped to this fault.

hasAttachments

boolean hasAttachments()

Checks if the fault has any MIME attachments.

Returns:

true if there are MIME attachments with this fault.