|
Java EE 5 SDK 深圳电信培训中心.徐海蛟老师. |
||||||||
上一个类 下一个类 | 框架 无框架 | ||||||||
摘要: 嵌套 | 字段 | 构造器 | 方法 | 详细信息: 字段 | 构造器 | 方法 |
javax.xml.soap Interface SOAPBody
- 所有父接口:
- Element, Node, SOAPElement
public interface SOAPBody
- extends SOAPElement
An object that represents the contents of the SOAP body element in a SOAP message. A SOAP body element consists of XML data that affects the way the application-specific content is processed.
A SOAPBody
object contains SOAPBodyElement
objects, which have the content for the SOAP body.
A SOAPFault
object, which carries status and/or
error information, is an example of a SOAPBodyElement
object.
- 另请参见:
SOAPFault
字段摘要 |
---|
方法摘要 | |
---|---|
SOAPBodyElement |
addBodyElement(Name name)
Creates a new SOAPBodyElement object with the specified
name and adds it to this SOAPBody object. |
SOAPBodyElement |
addBodyElement(QName qname)
Creates a new SOAPBodyElement object with the specified
QName and adds it to this SOAPBody object. |
SOAPBodyElement |
addDocument(Document document)
Adds the root node of the DOM
Document
to this SOAPBody object. |
SOAPFault |
addFault()
Creates a new SOAPFault object and adds it to
this SOAPBody object. |
SOAPFault |
addFault(Name faultCode,
String faultString)
Creates a new SOAPFault object and adds it to this
SOAPBody object. |
SOAPFault |
addFault(Name faultCode,
String faultString,
Locale locale)
Creates a new SOAPFault object and adds it to
this SOAPBody object. |
SOAPFault |
addFault(QName faultCode,
String faultString)
Creates a new SOAPFault object and adds it to this SOAPBody
object. |
SOAPFault |
addFault(QName faultCode,
String faultString,
Locale locale)
Creates a new SOAPFault object and adds it to this
SOAPBody object. |
Document |
extractContentAsDocument()
Creates a new DOM
Document and sets
the first child of this SOAPBody as it's document
element. |
SOAPFault |
getFault()
Returns the SOAPFault object in this SOAPBody
object. |
boolean |
hasFault()
Indicates whether a SOAPFault object exists in this
SOAPBody object. |
Methods inherited from interface javax.xml.soap.Node |
---|
detachNode, getParentElement, getValue, recycleNode, setParentElement, setValue |
Methods inherited from interface org.w3c.dom.Node |
---|
appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData |
Methods inherited from interface org.w3c.dom.Element |
---|
getAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getElementsByTagName, getElementsByTagNameNS, getSchemaTypeInfo, getTagName, hasAttribute, hasAttributeNS, removeAttribute, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNode, setAttributeNodeNS, setAttributeNS, setIdAttribute, setIdAttributeNode, setIdAttributeNS |
Methods inherited from interface org.w3c.dom.Node |
---|
appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData |
方法详细信息 |
---|
addFault
SOAPFault addFault() throws SOAPException
- Creates a new
SOAPFault
object and adds it to thisSOAPBody
object. The newSOAPFault
will have default values set for the mandatory child elements. The type of theSOAPFault
will be a SOAP 1.1 or a SOAP 1.2SOAPFault
depending on theprotocol
specified while creating theMessageFactory
instance.A
SOAPBody
may contain at most oneSOAPFault
child element. - 返回:
- the new
SOAPFault
object - 抛出异常:
SOAPException
- if there is a SOAP error
addFault
SOAPFault addFault(Name faultCode, String faultString, Locale locale) throws SOAPException
- Creates a new
SOAPFault
object and adds it to thisSOAPBody
object. The type of theSOAPFault
will be a SOAP 1.1 or a SOAP 1.2SOAPFault
depending on theprotocol
specified while creating theMessageFactory
instance.For SOAP 1.2 the
faultCode
parameter is the value of the Fault/Code/Value element and thefaultString
parameter is the value of the Fault/Reason/Text element. For SOAP 1.1 thefaultCode
parameter is the value of thefaultcode
element and thefaultString
parameter is the value of thefaultstring
element.A
SOAPBody
may contain at most oneSOAPFault
child element. - 参数:
faultCode
- aName
object giving the fault code to be set; must be one of the fault codes defined in the Version of SOAP specification in usefaultString
- aString
giving an explanation of the faultlocale
- aLocale
object indicating the native language of thefaultString
- 返回:
- the new
SOAPFault
object - 抛出异常:
SOAPException
- if there is a SOAP error- 从以下版本开始:
- SAAJ 1.2
- 另请参见:
SOAPFault.setFaultCode(javax.xml.soap.Name)
,SOAPFault.setFaultString(java.lang.String)
addFault
SOAPFault addFault(QName faultCode, String faultString, Locale locale) throws SOAPException
- Creates a new
SOAPFault
object and adds it to thisSOAPBody
object. The type of theSOAPFault
will be a SOAP 1.1 or a SOAP 1.2SOAPFault
depending on theprotocol
specified while creating theMessageFactory
instance.For SOAP 1.2 the
faultCode
parameter is the value of the Fault/Code/Value element and thefaultString
parameter is the value of the Fault/Reason/Text element. For SOAP 1.1 thefaultCode
parameter is the value of thefaultcode
element and thefaultString
parameter is the value of thefaultstring
element.A
SOAPBody
may contain at most oneSOAPFault
child element. - 参数:
faultCode
- aQName
object giving the fault code to be set; must be one of the fault codes defined in the version of SOAP specification in use.faultString
- aString
giving an explanation of the faultlocale
- aLocale
object indicating the native language of thefaultString
- 返回:
- the new
SOAPFault
object - 抛出异常:
SOAPException
- if there is a SOAP error- 从以下版本开始:
- SAAJ 1.3
- 另请参见:
SOAPFault.setFaultCode(javax.xml.soap.Name)
,SOAPFault.setFaultString(java.lang.String)
,addFault(Name faultCode, String faultString, Locale locale)
addFault
SOAPFault addFault(Name faultCode, String faultString) throws SOAPException
- Creates a new
SOAPFault
object and adds it to thisSOAPBody
object. The type of theSOAPFault
will be a SOAP 1.1 or a SOAP 1.2SOAPFault
depending on theprotocol
specified while creating theMessageFactory
instance.For SOAP 1.2 the
faultCode
parameter is the value of the Fault/Code/Value element and thefaultString
parameter is the value of the Fault/Reason/Text element. For SOAP 1.1 thefaultCode
parameter is the value of the faultcode element and thefaultString
parameter is the value of the faultstring element.In case of a SOAP 1.2 fault, the default value for the mandatory
xml:lang
attribute on the Fault/Reason/Text element will be set tojava.util.Locale.getDefault()
A
SOAPBody
may contain at most oneSOAPFault
child element. - 参数:
faultCode
- aName
object giving the fault code to be set; must be one of the fault codes defined in the version of SOAP specification in usefaultString
- aString
giving an explanation of the fault- 返回:
- the new
SOAPFault
object - 抛出异常:
SOAPException
- if there is a SOAP error- 从以下版本开始:
- SAAJ 1.2
- 另请参见:
SOAPFault.setFaultCode(javax.xml.soap.Name)
,SOAPFault.setFaultString(java.lang.String)
addFault
SOAPFault addFault(QName faultCode, String faultString) throws SOAPException
- Creates a new
SOAPFault
object and adds it to thisSOAPBody
object. The type of theSOAPFault
will be a SOAP 1.1 or a SOAP 1.2SOAPFault
depending on theprotocol
specified while creating theMessageFactory
instance.For SOAP 1.2 the
faultCode
parameter is the value of the Fault/Code/Value element and thefaultString
parameter is the value of the Fault/Reason/Text element. For SOAP 1.1 thefaultCode
parameter is the value of the faultcode element and thefaultString
parameter is the value of the faultstring element.In case of a SOAP 1.2 fault, the default value for the mandatory
xml:lang
attribute on the Fault/Reason/Text element will be set tojava.util.Locale.getDefault()
A
SOAPBody
may contain at most oneSOAPFault
child element - 参数:
faultCode
- aQName
object giving the fault code to be set; must be one of the fault codes defined in the version of SOAP specification in usefaultString
- aString
giving an explanation of the fault- 返回:
- the new
SOAPFault
object - 抛出异常:
SOAPException
- if there is a SOAP error- 从以下版本开始:
- SAAJ 1.3
- 另请参见:
SOAPFault.setFaultCode(javax.xml.soap.Name)
,SOAPFault.setFaultString(java.lang.String)
,addFault(Name faultCode, String faultString)
hasFault
boolean hasFault()
- Indicates whether a
SOAPFault
object exists in thisSOAPBody
object. - 返回:
true
if aSOAPFault
object exists in thisSOAPBody
object;false
otherwise
getFault
SOAPFault getFault()
- Returns the
SOAPFault
object in thisSOAPBody
object. - 返回:
- the
SOAPFault
object in thisSOAPBody
object if present, null otherwise.
addBodyElement
SOAPBodyElement addBodyElement(Name name) throws SOAPException
- Creates a new
SOAPBodyElement
object with the specified name and adds it to thisSOAPBody
object. - 参数:
name
- aName
object with the name for the newSOAPBodyElement
object- 返回:
- the new
SOAPBodyElement
object - 抛出异常:
SOAPException
- if a SOAP error occurs- 另请参见:
addBodyElement(javax.xml.namespace.QName)
addBodyElement
SOAPBodyElement addBodyElement(QName qname) throws SOAPException
- Creates a new
SOAPBodyElement
object with the specified QName and adds it to thisSOAPBody
object. - 参数:
qname
- aQName
object with the qname for the newSOAPBodyElement
object- 返回:
- the new
SOAPBodyElement
object - 抛出异常:
SOAPException
- if a SOAP error occurs- 从以下版本开始:
- SAAJ 1.3
- 另请参见:
addBodyElement(Name)
addDocument
SOAPBodyElement addDocument(Document document) throws SOAPException
- Adds the root node of the DOM
Document
to thisSOAPBody
object.Calling this method invalidates the
document
parameter. The client application should discard all references to thisDocument
and its contents upon callingaddDocument
. The behavior of an application that continues to use such references is undefined. - 参数:
document
- theDocument
object whose root node will be added to thisSOAPBody
.- 返回:
- the
SOAPBodyElement
that represents the root node that was added. - 抛出异常:
SOAPException
- if theDocument
cannot be added- 从以下版本开始:
- SAAJ 1.2
extractContentAsDocument
Document extractContentAsDocument() throws SOAPException
- Creates a new DOM
Document
and sets the first child of thisSOAPBody
as it's document element. The childSOAPElement
is removed as part of the process. - 返回:
- the
Document
representation of theSOAPBody
content. - 抛出异常:
SOAPException
- if there is not exactly one childSOAPElement
of theSOAPBody
.- 从以下版本开始:
- SAAJ 1.3
|
Java EE 5 SDK 深圳电信培训中心.徐海蛟老师. |
||||||||
上一个类 下一个类 | 框架 无框架 | ||||||||
摘要: 嵌套 | 字段 | 构造器 | 方法 | 详细信息: 字段 | 构造器 | 方法 |
提交错误或意见
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。深圳电信培训中心.徐海蛟老师教学参考.