public interface SOAPElement extends Node, Element
Методы в этом интерфейсе, которые обязаны возвращать конкретные цели SAAJ, могут "тихо" заменить узлы в дереве как требуется, чтобы успешно возвратить объекты корректного типа. См. getChildElements()
и javax.xml.soap для деталей.
ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE
Модификатор и Тип | Метод и Описание |
---|---|
SOAPElement |
addAttribute(Name name, String value)
Добавляет атрибут с указанным именем и значением к этому
SOAPElement объект. |
SOAPElement |
addAttribute(QName qname, String value)
Добавляет атрибут с указанным именем и значением к этому
SOAPElement объект. |
SOAPElement |
addChildElement(Name name)
Создает новое
SOAPElement объект инициализируется с данным Name возразите и добавляет новый элемент к этому SOAPElement объект. |
SOAPElement |
addChildElement(QName qname)
Создает новое
SOAPElement объект инициализируется с данным QName возразите и добавляет новый элемент к этому SOAPElement объект. |
SOAPElement |
addChildElement(SOAPElement element)
Добавьте a
SOAPElement как дочерний элемент этого SOAPElement экземпляр. |
SOAPElement |
addChildElement(String localName)
Создает новое
SOAPElement объект, инициализированный с указанным локальным именем и, добавляет новый элемент к этому SOAPElement объект. |
SOAPElement |
addChildElement(String localName, String prefix)
Создает новое
SOAPElement объект, инициализированный с указанным локальным именем и префиксом и, добавляет новый элемент к этому SOAPElement объект. |
SOAPElement |
addChildElement(String localName, String prefix, String uri)
Создает новое
SOAPElement объект, инициализированный с указанным локальным именем, префиксом, и URI и, добавляет новый элемент к этому SOAPElement объект. |
SOAPElement |
addNamespaceDeclaration(String prefix, String uri)
Добавляет объявление пространства имен с указанным префиксом и URI к этому
SOAPElement объект. |
SOAPElement |
addTextNode(String text)
Создает новое
Text объект инициализируется с данным String и добавляет это к этому SOAPElement объект. |
QName |
createQName(String localName, String prefix)
Создает a
QName чей URI пространства имен является тем, связанным с параметром, prefix , в контексте этого SOAPElement . |
Iterator |
getAllAttributes()
Возвраты
Iterator по всему атрибуту Name объекты в этом SOAPElement объект. |
Iterator |
getAllAttributesAsQNames()
Возвраты
Iterator по всем атрибутам в этом SOAPElement как QName объекты. |
Строка |
getAttributeValue(Name name)
Возвращает значение атрибута с указанным именем.
|
Строка |
getAttributeValue(QName qname)
Возвращает значение атрибута с указанным qname.
|
Iterator |
getChildElements()
Возвраты
Iterator по всему непосредственному дочернему элементу Node s этого элемента. |
Iterator |
getChildElements(Name name)
Возвраты
Iterator по всему непосредственному дочернему элементу Node s этого элемента с указанным именем. |
Iterator |
getChildElements(QName qname)
Возвраты
Iterator по всему непосредственному дочернему элементу Node s этого элемента с указанным qname. |
Имя |
getElementName()
Возвращает имя этого
SOAPElement объект. |
QName |
getElementQName()
Возвращает qname этого
SOAPElement объект. |
Строка |
getEncodingStyle()
Возвращает стиль кодирования для этого
SOAPElement объект. |
Iterator |
getNamespacePrefixes()
Возвраты
Iterator по префиксу пространства имен String s объявленный этим элементом. |
Строка |
getNamespaceURI(String prefix)
Возвращает URI пространства имен, у которого есть данный префикс.
|
Iterator |
getVisibleNamespacePrefixes()
Возвраты
Iterator по префиксу пространства имен String s видимый к этому элементу. |
boolean |
removeAttribute(Name name)
Удаляет атрибут с указанным именем.
|
boolean |
removeAttribute(QName qname)
Удаляет атрибут с указанным qname.
|
void |
removeContents()
Отсоединения все дочерние элементы этого
SOAPElement . |
boolean |
removeNamespaceDeclaration(String prefix)
Удаляет объявление пространства имен, соответствующее данному префиксу.
|
SOAPElement |
setElementQName(QName newName)
Изменяет название этого
Element к newName если возможный. |
void |
setEncodingStyle(String encodingStyle)
Устанавливает стиль кодирования для этого
SOAPElement возразите против одного указанного. |
detachNode, getParentElement, getValue, recycleNode, setParentElement, setValue
getAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getElementsByTagName, getElementsByTagNameNS, getSchemaTypeInfo, getTagName, hasAttribute, hasAttributeNS, removeAttribute, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNode, setAttributeNodeNS, setAttributeNS, setIdAttribute, setIdAttributeNode, setIdAttributeNS
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
SOAPElement addChildElement(Name name) throws SOAPException
SOAPElement
объект инициализируется с данным Name
возразите и добавляет новый элемент к этому SOAPElement
объект. Этот метод может быть осужден в будущем выпуске SAAJ в пользу addChildElement (javax.xml.namespace. QName)
name
- a Name
объект с XML называет для нового элементаSOAPElement
объект, который создавалсяSOAPException
- если есть ошибка в создании SOAPElement
объектaddChildElement(javax.xml.namespace.QName)
SOAPElement addChildElement(QName qname) throws SOAPException
SOAPElement
объект инициализируется с данным QName
возразите и добавляет новый элемент к этому SOAPElement
объект. Пространство имен, localname и префикс нового SOAPElement
все берутся от qname
параметр.qname
- a QName
объект с XML называет для нового элементаSOAPElement
объект, который создавалсяSOAPException
- если есть ошибка в создании SOAPElement
объектaddChildElement(Name)
SOAPElement addChildElement(String localName) throws SOAPException
SOAPElement
объект, инициализированный с указанным локальным именем и, добавляет новый элемент к этому SOAPElement
объект. Новое SOAPElement
наследовал любое пространство имен по умолчанию в контексте.localName
- a String
предоставление локального имени для элементаSOAPElement
объект, который создавалсяSOAPException
- если есть ошибка в создании SOAPElement
объектSOAPElement addChildElement(String localName, String prefix) throws SOAPException
SOAPElement
объект, инициализированный с указанным локальным именем и префиксом и, добавляет новый элемент к этому SOAPElement
объект.localName
- a String
предоставление локального имени для нового элементаprefix
- a String
предоставление пространства имен снабжает префиксом для нового элементаSOAPElement
объект, который создавалсяSOAPException
- если prefix
не допустимо в контексте этого SOAPElement
или если есть ошибка в создании SOAPElement
объектSOAPElement addChildElement(String localName, String prefix, String uri) throws SOAPException
SOAPElement
объект, инициализированный с указанным локальным именем, префиксом, и URI и, добавляет новый элемент к этому SOAPElement
объект.localName
- a String
предоставление локального имени для нового элементаprefix
- a String
предоставление пространства имен снабжает префиксом для нового элементаuri
- a String
предоставление URI пространства имен, которому принадлежит новый элементSOAPElement
объект, который создавалсяSOAPException
- если есть ошибка в создании SOAPElement
объектSOAPElement addChildElement(SOAPElement element) throws SOAPException
SOAPElement
как дочерний элемент этого SOAPElement
экземпляр. SOAPElement
как ожидают, будет создан a SOAPFactory
. Вызывающие стороны не должны положиться на экземпляр элемента, добавляемый, как в дерево XML. Реализации могли закончить тем, что копировали контент SOAPElement
переданный в экземпляр различного SOAPElement
реализация. Например, если addChildElement()
обращается a SOAPHeader
, element
будет скопирован в экземпляр a SOAPHeaderElement
. Фрагмент базировался в element
или добавляется в целом или нисколько, если была ошибка.
Фрагмент базировался в element
не может содержать элементы под названием "Конверт", "Заголовок" или "Тело" и в пространстве имен SOAP. Любые префиксы пространства имен, существующие во фрагменте, должны быть полностью разрешены, используя соответствующие объявления пространства имен в пределах фрагмента непосредственно.
element
- SOAPElement
быть добавленным как новый дочерний элементSOAPException
- если была ошибка в добавлении этого элемента как дочерний элементvoid removeContents()
SOAPElement
. Этот метод полезен для отката конструкции частично завершенных SOAPHeaders
и SOAPBodys
в подготовке к отправке отказа, когда состояние ошибки обнаруживается. Это также полезно для рециркуляции частей документа в пределах сообщения SOAP.
SOAPElement addTextNode(String text) throws SOAPException
Text
объект инициализируется с данным String
и добавляет это к этому SOAPElement
объект.text
- a String
объект с текстовым контентом, который будет добавленSOAPElement
объект тот, в который новое Text
объект был вставленSOAPException
- если есть ошибка в создании нового Text
возразите или если не законно присоединить это как дочерний элемент к этому SOAPElement
SOAPElement addAttribute(Name name, String value) throws SOAPException
SOAPElement
объект.name
- a Name
объект с именем атрибутаvalue
- a String
предоставление значения атрибутаSOAPElement
объект, в который был вставлен атрибутSOAPException
- если есть ошибка в создании Атрибута, или это недопустимо, чтобы установить атрибут с Name
name
на этом SOAPElement.addAttribute(javax.xml.namespace.QName, String)
SOAPElement addAttribute(QName qname, String value) throws SOAPException
SOAPElement
объект.qname
- a QName
объект с именем атрибутаvalue
- a String
предоставление значения атрибутаSOAPElement
объект, в который был вставлен атрибутSOAPException
- если есть ошибка в создании Атрибута, или это недопустимо, чтобы установить атрибут с QName
qname
на этом SOAPElement.addAttribute(Name, String)
SOAPElement addNamespaceDeclaration(String prefix, String uri) throws SOAPException
SOAPElement
объект.prefix
- a String
предоставление префикса пространства именuri
- a String
предоставление туров пространства именSOAPElement
объект, в который было вставлено это объявление пространства имен.SOAPException
- если есть ошибка в создании пространства именString getAttributeValue(Name name)
name
- a Name
объект с именем атрибутаString
предоставление значения указанного атрибута, Нуль, если нет такого атрибутаgetAttributeValue(javax.xml.namespace.QName)
String getAttributeValue(QName qname)
qname
- a QName
объект с qname атрибутаString
предоставление значения указанного атрибута, Нуль, если нет такого атрибутаgetAttributeValue(Name)
Iterator getAllAttributes()
Iterator
по всему атрибуту Name
объекты в этом SOAPElement
объект. iterator может использоваться, чтобы получить названия атрибута, которые можно тогда передать к методу getAttributeValue
получать значение каждого атрибута.getAllAttributesAsQNames()
Iterator getAllAttributesAsQNames()
Iterator
по всем атрибутам в этом SOAPElement
как QName
объекты. iterator может использоваться, чтобы получить атрибут QName, который можно тогда передать к методу getAttributeValue
получать значение каждого атрибута.getAllAttributes()
String getNamespaceURI(String prefix)
prefix
- a String
предоставление префикса пространства имен, которое можно искатьString
с турами пространства имен, у которого есть данный префиксIterator getNamespacePrefixes()
Iterator
по префиксу пространства имен String
s объявленный этим элементом. Префиксы, возвращенные этим iterator, можно передать к методу getNamespaceURI
получать URI каждого пространства имен.SOAPElement
объектIterator getVisibleNamespacePrefixes()
Iterator
по префиксу пространства имен String
s видимый к этому элементу. Префиксы, возвращенные этим iterator, можно передать к методу getNamespaceURI
получать URI каждого пространства имен.SOAPElement
объектQName createQName(String localName, String prefix) throws SOAPException
QName
чей URI пространства имен является тем, связанным с параметром, prefix
, в контексте этого SOAPElement
. Остающиеся элементы нового QName
берутся непосредственно от параметров, localName
и prefix
.localName
- a String
содержа локальную часть имени.prefix
- a String
содержа префикс для имени.QName
с указанным localName
и prefix
, и с пространством имен, которое связывается с prefix
в контексте этого SOAPElement
. Это пространство имен будет тем же самым как тем, которое было бы возвращено getNamespaceURI(String)
если это было дано prefix
поскольку это - параметр.SOAPException
- если QName
не может быть создан.Name getElementName()
SOAPElement
объект.Name
объект с именем этого SOAPElement
объектQName getElementQName()
SOAPElement
объект.QName
объект с qname этого SOAPElement
объектgetElementName()
SOAPElement setElementQName(QName newName) throws SOAPException
Element
к newName
если возможный. SOAP Определенные элементы, такие как SOAPEnvelope, SOAPHeader, у SOAPBody и т.д. не может быть измененного использования их имен этого метода. Любая попытка сделать так приведет к SOAPException быть брошенным. Вызывающие стороны не должны положиться на экземпляр элемента, переименовываемый, как. Реализации могли закончить тем, что копировали контент SOAPElement
к переименованному экземпляру.
newName
- новое имя для Element
.SOAPException
- изменяя название этого Element
не позволяется.boolean removeAttribute(Name name)
name
- Name
объект с именем атрибута, который будет удаленtrue
если атрибут был удален успешно; false
если это не былоremoveAttribute(javax.xml.namespace.QName)
boolean removeAttribute(QName qname)
qname
- QName
объект с qname атрибута, который будет удаленtrue
если атрибут был удален успешно; false
если это не былоremoveAttribute(Name)
boolean removeNamespaceDeclaration(String prefix)
prefix
- a String
предоставление префикса, который можно искатьtrue
если объявление пространства имен было удалено успешно; false
если это не былоIterator getChildElements()
Iterator
по всему непосредственному дочернему элементу Node
s этого элемента. Это включает javax.xml.soap.Text
объекты так же как SOAPElement
объекты. Вызов этого метода может вызвать дочерний элемент Element
, SOAPElement
и org.w3c.dom.Text
узлы, которые будут заменены SOAPElement
, SOAPHeaderElement
, SOAPBodyElement
или javax.xml.soap.Text
узлы как соответствующий для типа этого родительского узла. В результате вызывающее приложение должно обработать любые существующие ссылки на эти дочерние узлы, которые были получены через API ДОМА как недопустимые и или отбрасывают их или обновляют их со значениями, возвращенными этим Iterator
. Этого поведения можно избежать, вызывая эквивалентные API ДОМА. См. javax.xml.soap для большего количества деталей.
SOAPElement
объектIterator getChildElements(Name name)
Iterator
по всему непосредственному дочернему элементу Node
s этого элемента с указанным именем. Все эти дочерние элементы будут SOAPElement
узлы. Вызов этого метода может вызвать дочерний элемент Element
, SOAPElement
и org.w3c.dom.Text
узлы, которые будут заменены SOAPElement
, SOAPHeaderElement
, SOAPBodyElement
или javax.xml.soap.Text
узлы как соответствующий для типа этого родительского узла. В результате вызывающее приложение должно обработать любые существующие ссылки на эти дочерние узлы, которые были получены через API ДОМА как недопустимые и или отбрасывают их или обновляют их со значениями, возвращенными этим Iterator
. Этого поведения можно избежать, вызывая эквивалентные API ДОМА. См. javax.xml.soap для большего количества деталей.
name
- a Name
объект с именем дочерних элементов, которые будут возвращеныIterator
возразите по всем элементам в этом SOAPElement
объект с указанным именемgetChildElements(javax.xml.namespace.QName)
Iterator getChildElements(QName qname)
Iterator
по всему непосредственному дочернему элементу Node
s этого элемента с указанным qname. Все эти дочерние элементы будут SOAPElement
узлы. Вызов этого метода может вызвать дочерний элемент Element
, SOAPElement
и org.w3c.dom.Text
узлы, которые будут заменены SOAPElement
, SOAPHeaderElement
, SOAPBodyElement
или javax.xml.soap.Text
узлы как соответствующий для типа этого родительского узла. В результате вызывающее приложение должно обработать любые существующие ссылки на эти дочерние узлы, которые были получены через API ДОМА как недопустимые и или отбрасывают их или обновляют их со значениями, возвращенными этим Iterator
. Этого поведения можно избежать, вызывая эквивалентные API ДОМА. См. javax.xml.soap для большего количества деталей.
qname
- a QName
объект с qname дочерних элементов, которые будут возвращеныIterator
возразите по всем элементам в этом SOAPElement
объект с указанным qnamegetChildElements(Name)
void setEncodingStyle(String encodingStyle) throws SOAPException
SOAPElement
возразите против одного указанного.encodingStyle
- a String
предоставление стиля кодированияIllegalArgumentException
- если была проблема в устанавливаемом стиле кодирования.SOAPException
- если установка encodingStyle недопустима для этого SOAPElement.getEncodingStyle()
String getEncodingStyle()
SOAPElement
объект.String
предоставление стиля кодированияsetEncodingStyle(java.lang.String)
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92