|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object javax.xml.soap.SOAPPart org.apache.axis.SOAPPart
The SOAPPart provides access to the root part of the Message which contains the envelope.
SOAPPart implements Part, providing common MIME operations.
SOAPPart also allows access to its envelope, as a string, byte[], InputStream, or SOAPEnvelope. (This functionality used to be in Message, and has been moved here more or less verbatim pending further cleanup.)
Field Summary | |
static java.lang.String |
ALLOW_FORM_OPTIMIZATION
property used to set SOAPEnvelope as default form |
static int |
FORM_BODYINSTREAM
|
static int |
FORM_BYTES
|
static int |
FORM_FAULT
|
static int |
FORM_INPUTSTREAM
|
static int |
FORM_OPTIMIZED
|
static int |
FORM_SOAPENVELOPE
|
static int |
FORM_STRING
|
Fields inherited from interface org.w3c.dom.Node |
ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE |
Constructor Summary | |
SOAPPart(Message parent,
java.lang.Object initialContents,
boolean isBodyStream)
Create a new SOAPPart. |
Method Summary | |
void |
addMimeHeader(java.lang.String header,
java.lang.String value)
Add the specified MIME header, as per JAXM. |
org.w3c.dom.Node |
adoptNode(org.w3c.dom.Node node)
|
org.w3c.dom.Node |
appendChild(org.w3c.dom.Node newChild)
|
org.w3c.dom.Node |
cloneNode(boolean deep)
|
org.w3c.dom.Attr |
createAttribute(java.lang.String name)
|
org.w3c.dom.Attr |
createAttributeNS(java.lang.String namespaceURI,
java.lang.String qualifiedName)
|
org.w3c.dom.CDATASection |
createCDATASection(java.lang.String data)
|
org.w3c.dom.Comment |
createComment(java.lang.String data)
|
org.w3c.dom.DocumentFragment |
createDocumentFragment()
|
org.w3c.dom.Element |
createElement(java.lang.String tagName)
|
org.w3c.dom.Element |
createElementNS(java.lang.String namespaceURI,
java.lang.String qualifiedName)
|
org.w3c.dom.EntityReference |
createEntityReference(java.lang.String name)
|
org.w3c.dom.ProcessingInstruction |
createProcessingInstruction(java.lang.String target,
java.lang.String data)
|
org.w3c.dom.Text |
createTextNode(java.lang.String data)
|
java.util.Iterator |
getAllMimeHeaders()
Retrieves all the headers for this SOAPPart
object as an iterator over the MimeHeader
objects. |
byte[] |
getAsBytes()
Get the contents of this Part (not the headers!), as a byte array. |
SOAPEnvelope |
getAsSOAPEnvelope()
Get the contents of this Part (not the MIME headers!), as a SOAPEnvelope. |
java.lang.String |
getAsString()
Get the contents of this Part (not the headers!), as a String. |
org.w3c.dom.NamedNodeMap |
getAttributes()
|
org.w3c.dom.NodeList |
getChildNodes()
|
javax.xml.transform.Source |
getContent()
Returns the content of the SOAPEnvelope as a JAXP
Source object. |
java.lang.String |
getContentId()
Content ID. |
java.lang.String |
getContentIdRef()
Content ID. |
long |
getContentLength()
Get the content length for this SOAPPart. |
java.lang.String |
getContentLocation()
Content location. |
java.lang.String |
getContentType()
Content type is always "text/xml" for SOAPParts. |
int |
getCurrentForm()
|
java.lang.Object |
getCurrentMessage()
Get the current message, in whatever form it happens to be right now. |
org.w3c.dom.DocumentType |
getDoctype()
|
org.w3c.dom.Element |
getDocumentElement()
|
org.w3c.dom.Element |
getElementById(java.lang.String elementId)
|
org.w3c.dom.NodeList |
getElementsByTagName(java.lang.String tagname)
|
org.w3c.dom.NodeList |
getElementsByTagNameNS(java.lang.String namespaceURI,
java.lang.String localName)
|
java.lang.String |
getEncoding()
|
SOAPEnvelope |
getEnvelope()
Gets the SOAPEnvelope object associated with
this SOAPPart object. |
org.w3c.dom.Node |
getFirstChild()
|
org.w3c.dom.DOMImplementation |
getImplementation()
|
org.w3c.dom.Node |
getLastChild()
|
java.lang.String |
getLocalName()
|
java.util.Iterator |
getMatchingMimeHeaders(java.lang.String[] match)
Get all headers that match. |
Message |
getMessage()
Get the Message for this Part . |
java.lang.String[] |
getMimeHeader(java.lang.String name)
Gets all the values of the MimeHeader object
in this SOAPPart object that is identified by
the given String . |
java.lang.String |
getNamespaceURI()
|
org.w3c.dom.Node |
getNextSibling()
|
java.lang.String |
getNodeName()
Node Implementation |
short |
getNodeType()
|
java.lang.String |
getNodeValue()
|
java.util.Iterator |
getNonMatchingMimeHeaders(java.lang.String[] match)
Get all headers that do not match. |
org.w3c.dom.Document |
getOwnerDocument()
|
org.w3c.dom.Node |
getParentNode()
|
java.lang.String |
getPrefix()
|
org.w3c.dom.Node |
getPreviousSibling()
|
org.w3c.dom.Document |
getSOAPDocument()
|
boolean |
getStandalone()
|
boolean |
getStrictErrorChecking()
|
java.lang.String |
getVersion()
|
boolean |
hasAttributes()
|
boolean |
hasChildNodes()
|
org.w3c.dom.Node |
importNode(org.w3c.dom.Node importedNode,
boolean deep)
|
org.w3c.dom.Node |
insertBefore(org.w3c.dom.Node newChild,
org.w3c.dom.Node refChild)
|
boolean |
isBodyStream()
|
boolean |
isSupported(java.lang.String feature,
java.lang.String version)
|
void |
normalize()
|
void |
removeAllMimeHeaders()
Removes all the MimeHeader objects for this
SOAPEnvelope object. |
org.w3c.dom.Node |
removeChild(org.w3c.dom.Node oldChild)
|
void |
removeMimeHeader(java.lang.String header)
Removes all MIME headers that match the given name. |
org.w3c.dom.Node |
replaceChild(org.w3c.dom.Node newChild,
org.w3c.dom.Node oldChild)
|
void |
saveChanges()
|
void |
setContent(javax.xml.transform.Source source)
Sets the content of the SOAPEnvelope object
with the data from the given Source object. |
void |
setContentId(java.lang.String newCid)
Sets Content-Id of this part. |
void |
setContentLocation(java.lang.String loc)
Set content location. |
void |
setCurrentMessage(java.lang.Object currMsg,
int form)
Set the current message |
void |
setEncoding(java.lang.String s)
|
void |
setMessage(Message msg)
Set the Message for this Part. |
void |
setMimeHeader(java.lang.String name,
java.lang.String value)
Changes the first header entry that matches the given header name so that its value is the given value, adding a new header with the given name and value if no existing header is a match. |
void |
setNodeValue(java.lang.String nodeValue)
|
void |
setPrefix(java.lang.String prefix)
|
void |
setSOAPEnvelope(SOAPEnvelope env)
This set the SOAP Envelope for this part. |
void |
setStandalone(boolean flag)
|
void |
setStrictErrorChecking(boolean flag)
|
void |
setVersion(java.lang.String s)
|
void |
writeTo(java.io.OutputStream os)
Write the contents to the specified stream. |
void |
writeTo(java.io.Writer writer)
Write the contents to the specified writer. |
Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public static final int FORM_STRING
public static final int FORM_INPUTSTREAM
public static final int FORM_SOAPENVELOPE
public static final int FORM_BYTES
public static final int FORM_BODYINSTREAM
public static final int FORM_FAULT
public static final int FORM_OPTIMIZED
public static final java.lang.String ALLOW_FORM_OPTIMIZATION
Constructor Detail |
public SOAPPart(Message parent, java.lang.Object initialContents, boolean isBodyStream)
Do not call this directly! Should only be called by Message.
parent
- the parent Message
initialContents
- the initial contens Object
isBodyStream
- if the body is in a streamMethod Detail |
public Message getMessage()
Message
for this Part
.
Message
for this Part
public void setMessage(Message msg)
msg
- the Message
for this partpublic java.lang.String getContentType()
getContentType
in interface Part
public long getContentLength() throws AxisFault
AxisFault
public void setSOAPEnvelope(SOAPEnvelope env)
Note: It breaks the chicken/egg created. I need a message to create an attachment... From the attachment I should be able to get a reference... I now want to edit elements in the envelope in order to place the attachment reference to it. How do I now update the SOAP envelope with what I've changed?
env
- the SOAPEnvelope
for this SOAPPart
public void writeTo(java.io.OutputStream os) throws java.io.IOException
os
- the java.io.OutputStream
to write to
java.io.IOException
public void writeTo(java.io.Writer writer) throws java.io.IOException
writer
- the Writer
to write to
java.io.IOException
public java.lang.Object getCurrentMessage()
The method name is historical. TODO: rename this for clarity; should be more like getContents.
public void setCurrentMessage(java.lang.Object currMsg, int form)
currMsg
- form
- public int getCurrentForm()
public byte[] getAsBytes() throws AxisFault
AxisFault
- if this Part can't be serialized to the byte arraypublic void saveChanges() throws AxisFault
AxisFault
public java.lang.String getAsString() throws AxisFault
String
containing the content of this message
AxisFault
- if there is an error serializing this partpublic SOAPEnvelope getAsSOAPEnvelope() throws AxisFault
SOAPEnvelope
containing the message content
AxisFault
- if the envelope could not be constructedpublic void addMimeHeader(java.lang.String header, java.lang.String value)
addMimeHeader
in interface Part
addMimeHeader
in class SOAPPart
header
- the header to addvalue
- the value of that headerpublic java.lang.String getContentLocation()
getContentLocation
in interface Part
getContentLocation
in class SOAPPart
setContentLocation(java.lang.String)
public void setContentLocation(java.lang.String loc)
setContentLocation
in interface Part
setContentLocation
in class SOAPPart
loc
- the content locationgetContentLocation()
public void setContentId(java.lang.String newCid)
setContentId
in interface Part
setContentId
in class SOAPPart
newCid
- new Content-IdgetContentId()
public java.lang.String getContentId()
getContentId
in interface Part
getContentId
in class SOAPPart
setContentId(java.lang.String)
public java.lang.String getContentIdRef()
getContentIdRef
in interface Part
public java.util.Iterator getMatchingMimeHeaders(java.lang.String[] match)
getMatchingMimeHeaders
in interface Part
getMatchingMimeHeaders
in class SOAPPart
match
- an array of String
s giving mime header names
Iterator
over all values matching these headerspublic java.util.Iterator getNonMatchingMimeHeaders(java.lang.String[] match)
getNonMatchingMimeHeaders
in interface Part
getNonMatchingMimeHeaders
in class SOAPPart
match
- an array of String
s giving mime header names
Iterator
over all values not matching these
headerspublic void setContent(javax.xml.transform.Source source) throws SOAPException
SOAPEnvelope
object
with the data from the given Source
object.
setContent
in class SOAPPart
source
- javax.xml.transform.Source object with the data to
be set
SOAPException
- if there is a problem in
setting the sourcegetContent()
public javax.xml.transform.Source getContent() throws SOAPException
Source
object.
getContent
in class SOAPPart
javax.xml.transform.Source
object
SOAPException
- if the implementation cannot
convert the specified Source
objectsetContent(javax.xml.transform.Source)
public java.util.Iterator getAllMimeHeaders()
SOAPPart
object as an iterator over the MimeHeader
objects.
getAllMimeHeaders
in class SOAPPart
Iterator
object with all of the Mime
headers for this SOAPPart
objectpublic void setMimeHeader(java.lang.String name, java.lang.String value)
Note that RFC822 headers can contain only US-ASCII characters.
setMimeHeader
in class SOAPPart
name
- a String
giving the
header name for which to searchvalue
- a String
giving the
value to be set. This value will be substituted for the
current value(s) of the first header that is a match if
there is one. If there is no match, this value will be
the value for a new MimeHeader
object.getMimeHeader(java.lang.String)
public java.lang.String[] getMimeHeader(java.lang.String name)
MimeHeader
object
in this SOAPPart
object that is identified by
the given String
.
getMimeHeader
in interface Part
getMimeHeader
in class SOAPPart
name
- the name of the header; example:
"Content-Type"
String
array giving all the values for
the specified headersetMimeHeader(java.lang.String, java.lang.String)
public void removeAllMimeHeaders()
MimeHeader
objects for this
SOAPEnvelope
object.
removeAllMimeHeaders
in class SOAPPart
public void removeMimeHeader(java.lang.String header)
removeMimeHeader
in class SOAPPart
header
- a String
giving
the name of the MIME header(s) to be removedpublic SOAPEnvelope getEnvelope() throws SOAPException
SOAPEnvelope
object associated with
this SOAPPart
object. Once the SOAP envelope is
obtained, it can be used to get its contents.
getEnvelope
in class SOAPPart
SOAPEnvelope
object for this
SOAPPart
object
SOAPException
- if there is a SOAP errorpublic org.w3c.dom.Document getSOAPDocument()
public org.w3c.dom.DocumentType getDoctype()
getDoctype
in interface org.w3c.dom.Document
public org.w3c.dom.DOMImplementation getImplementation()
getImplementation
in interface org.w3c.dom.Document
public org.w3c.dom.Element getDocumentElement()
getDocumentElement
in interface org.w3c.dom.Document
public org.w3c.dom.Element createElement(java.lang.String tagName) throws org.w3c.dom.DOMException
createElement
in interface org.w3c.dom.Document
tagName
-
org.w3c.dom.DOMException
public org.w3c.dom.DocumentFragment createDocumentFragment()
createDocumentFragment
in interface org.w3c.dom.Document
public org.w3c.dom.Text createTextNode(java.lang.String data)
createTextNode
in interface org.w3c.dom.Document
public org.w3c.dom.Comment createComment(java.lang.String data)
createComment
in interface org.w3c.dom.Document
public org.w3c.dom.CDATASection createCDATASection(java.lang.String data) throws org.w3c.dom.DOMException
createCDATASection
in interface org.w3c.dom.Document
org.w3c.dom.DOMException
public org.w3c.dom.ProcessingInstruction createProcessingInstruction(java.lang.String target, java.lang.String data) throws org.w3c.dom.DOMException
createProcessingInstruction
in interface org.w3c.dom.Document
org.w3c.dom.DOMException
public org.w3c.dom.Attr createAttribute(java.lang.String name) throws org.w3c.dom.DOMException
createAttribute
in interface org.w3c.dom.Document
org.w3c.dom.DOMException
public org.w3c.dom.EntityReference createEntityReference(java.lang.String name) throws org.w3c.dom.DOMException
createEntityReference
in interface org.w3c.dom.Document
org.w3c.dom.DOMException
public org.w3c.dom.NodeList getElementsByTagName(java.lang.String tagname)
getElementsByTagName
in interface org.w3c.dom.Document
public org.w3c.dom.Node importNode(org.w3c.dom.Node importedNode, boolean deep) throws org.w3c.dom.DOMException
importNode
in interface org.w3c.dom.Document
org.w3c.dom.DOMException
public org.w3c.dom.Element createElementNS(java.lang.String namespaceURI, java.lang.String qualifiedName) throws org.w3c.dom.DOMException
createElementNS
in interface org.w3c.dom.Document
org.w3c.dom.DOMException
public org.w3c.dom.Attr createAttributeNS(java.lang.String namespaceURI, java.lang.String qualifiedName) throws org.w3c.dom.DOMException
createAttributeNS
in interface org.w3c.dom.Document
org.w3c.dom.DOMException
public org.w3c.dom.NodeList getElementsByTagNameNS(java.lang.String namespaceURI, java.lang.String localName)
getElementsByTagNameNS
in interface org.w3c.dom.Document
public org.w3c.dom.Element getElementById(java.lang.String elementId)
getElementById
in interface org.w3c.dom.Document
public java.lang.String getEncoding()
public void setEncoding(java.lang.String s)
public boolean getStandalone()
public void setStandalone(boolean flag)
public boolean getStrictErrorChecking()
public void setStrictErrorChecking(boolean flag)
public java.lang.String getVersion()
public void setVersion(java.lang.String s)
public org.w3c.dom.Node adoptNode(org.w3c.dom.Node node) throws org.w3c.dom.DOMException
org.w3c.dom.DOMException
public java.lang.String getNodeName()
getNodeName
in interface org.w3c.dom.Node
public java.lang.String getNodeValue() throws org.w3c.dom.DOMException
getNodeValue
in interface org.w3c.dom.Node
org.w3c.dom.DOMException
public void setNodeValue(java.lang.String nodeValue) throws org.w3c.dom.DOMException
setNodeValue
in interface org.w3c.dom.Node
org.w3c.dom.DOMException
public short getNodeType()
getNodeType
in interface org.w3c.dom.Node
public org.w3c.dom.Node getParentNode()
getParentNode
in interface org.w3c.dom.Node
public org.w3c.dom.NodeList getChildNodes()
getChildNodes
in interface org.w3c.dom.Node
public org.w3c.dom.Node getFirstChild()
getFirstChild
in interface org.w3c.dom.Node
public org.w3c.dom.Node getLastChild()
getLastChild
in interface org.w3c.dom.Node
public org.w3c.dom.Node getPreviousSibling()
getPreviousSibling
in interface org.w3c.dom.Node
public org.w3c.dom.Node getNextSibling()
getNextSibling
in interface org.w3c.dom.Node
public org.w3c.dom.NamedNodeMap getAttributes()
getAttributes
in interface org.w3c.dom.Node
public org.w3c.dom.Document getOwnerDocument()
getOwnerDocument
in interface org.w3c.dom.Node
public org.w3c.dom.Node insertBefore(org.w3c.dom.Node newChild, org.w3c.dom.Node refChild) throws org.w3c.dom.DOMException
insertBefore
in interface org.w3c.dom.Node
org.w3c.dom.DOMException
public org.w3c.dom.Node replaceChild(org.w3c.dom.Node newChild, org.w3c.dom.Node oldChild) throws org.w3c.dom.DOMException
replaceChild
in interface org.w3c.dom.Node
org.w3c.dom.DOMException
public org.w3c.dom.Node removeChild(org.w3c.dom.Node oldChild) throws org.w3c.dom.DOMException
removeChild
in interface org.w3c.dom.Node
org.w3c.dom.DOMException
public org.w3c.dom.Node appendChild(org.w3c.dom.Node newChild) throws org.w3c.dom.DOMException
appendChild
in interface org.w3c.dom.Node
org.w3c.dom.DOMException
public boolean hasChildNodes()
hasChildNodes
in interface org.w3c.dom.Node
public org.w3c.dom.Node cloneNode(boolean deep)
cloneNode
in interface org.w3c.dom.Node
public void normalize()
normalize
in interface org.w3c.dom.Node
public boolean isSupported(java.lang.String feature, java.lang.String version)
isSupported
in interface org.w3c.dom.Node
public java.lang.String getNamespaceURI()
getNamespaceURI
in interface org.w3c.dom.Node
public java.lang.String getPrefix()
getPrefix
in interface org.w3c.dom.Node
public void setPrefix(java.lang.String prefix) throws org.w3c.dom.DOMException
setPrefix
in interface org.w3c.dom.Node
org.w3c.dom.DOMException
public java.lang.String getLocalName()
getLocalName
in interface org.w3c.dom.Node
public boolean hasAttributes()
hasAttributes
in interface org.w3c.dom.Node
public boolean isBodyStream()
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |