public abstract class SOAPFactory extends Object
SOAPFactory
фабрика для того, чтобы создать различные объекты, которые существуют в дереве XML SOAP. SOAPFactory
может использоваться, чтобы создать фрагменты XML, которые в конечном счете закончатся части SOAP. Эти фрагменты могут быть вставлены как дочерние элементы SOAPHeaderElement
или SOAPBodyElement
или SOAPEnvelope
или другой SOAPElement
объекты. SOAPFactory
также имеет методы, чтобы создать javax.xml.soap.Detail
объекты так же как java.xml.soap.Name
объекты.Конструктор и Описание |
---|
SOAPFactory() |
Модификатор и Тип | Метод и Описание |
---|---|
abstract Detail |
createDetail()
Создает новое
Detail объект, который служит контейнером для DetailEntry объекты. |
SOAPElement |
createElement(Element domElement)
Создает a
SOAPElement объект от существующего ДОМА Element . |
abstract SOAPElement |
createElement(Name name)
Создает a
SOAPElement объект инициализируется с данным Name объект. |
SOAPElement |
createElement(QName qname)
Создает a
SOAPElement объект инициализируется с данным QName объект. |
abstract SOAPElement |
createElement(String localName)
Создает a
SOAPElement объект инициализируется с данным локальным именем. |
abstract SOAPElement |
createElement(String localName, String prefix, String uri)
Создает новое
SOAPElement объект с данным локальным именем, префиксом и турами. |
abstract SOAPFault |
createFault()
Создает новое значение по умолчанию
SOAPFault объект |
abstract SOAPFault |
createFault(String reasonText, QName faultCode)
Создает новое
SOAPFault объект инициализируется с данным reasonText и faultCode |
abstract Name |
createName(String localName)
Создает новое
Name объект инициализируется с данным локальным именем. |
abstract Name |
createName(String localName, String prefix, String uri)
Создает новое
Name объект, инициализированный с данным локальным именем, префиксом пространства имен, и URI пространства имен. |
static SOAPFactory |
newInstance()
Создает новое
SOAPFactory объект, который является экземпляром реализации по умолчанию (SOAP 1.1), Этот метод, использует следующую упорядоченную процедуру поиска, чтобы определить реализацию SOAPFactory class, чтобы загрузиться: Используйте javax.xml.soap. Системное свойство SOAPFactory. |
static SOAPFactory |
newInstance(String protocol)
Создает новое
SOAPFactory объект, который является экземпляром указанной реализации, этот метод, использует SAAJMetaFactory, чтобы определить местоположение реализации class и создать экземпляр SOAPFactory. |
public SOAPElement createElement(Element domElement) throws SOAPException
SOAPElement
объект от существующего ДОМА Element
. Если ДОМ Element
это передают в том, как параметр уже a SOAPElement
тогда этот метод должен возвратить неизмененное без дальнейшей работы. Иначе, новое SOAPElement
создается и глубокая копия делается из domElement
параметр. Конкретный тип возвращаемого значения будет зависеть от имени domElement
параметр. Если какая-либо часть дерева базировалась в domElement
нарушает правила SOAP, a SOAPException
будет брошен.domElement
- Element
быть скопированным.SOAPElement
это - копия domElement
.SOAPException
- если есть ошибка в создании SOAPElement
объектpublic abstract SOAPElement createElement(Name name) throws SOAPException
SOAPElement
объект инициализируется с данным Name
объект. Конкретный тип возвращаемого значения будет зависеть от имени, данного новому SOAPElement
. Например, новое SOAPElement
с именем" {http://www.w3.org/2003/05/soap-envelope} Конверт" вызвал бы a SOAPEnvelope
это поддерживает SOAP 1.2 поведения, которые будут создаваться.name
- a Name
объект с XML называет для нового элементаSOAPElement
объект, который создавалсяSOAPException
- если есть ошибка в создании SOAPElement
объектcreateElement(javax.xml.namespace.QName)
public SOAPElement createElement(QName qname) throws SOAPException
SOAPElement
объект инициализируется с данным QName
объект. Конкретный тип возвращаемого значения будет зависеть от имени, данного новому SOAPElement
. Например, новое SOAPElement
с именем" {http://www.w3.org/2003/05/soap-envelope} Конверт" вызвал бы a SOAPEnvelope
это поддерживает SOAP 1.2 поведения, которые будут создаваться.qname
- a QName
объект с XML называет для нового элементаSOAPElement
объект, который создавалсяSOAPException
- если есть ошибка в создании SOAPElement
объектcreateElement(Name)
public abstract SOAPElement createElement(String localName) throws SOAPException
SOAPElement
объект инициализируется с данным локальным именем.localName
- a String
предоставление локального имени для нового элементаSOAPElement
объект, который создавалсяSOAPException
- если есть ошибка в создании SOAPElement
объектpublic abstract SOAPElement createElement(String localName, String prefix, String uri) throws SOAPException
SOAPElement
объект с данным локальным именем, префиксом и турами. Конкретный тип возвращаемого значения будет зависеть от имени, данного новому SOAPElement
. Например, новое SOAPElement
с именем" {http://www.w3.org/2003/05/soap-envelope} Конверт" вызвал бы a SOAPEnvelope
это поддерживает SOAP 1.2 поведения, которые будут создаваться.localName
- a String
предоставление локального имени для нового элементаprefix
- префикс для этого SOAPElement
uri
- a String
предоставление URI пространства имен, которому принадлежит новый элементSOAPException
- если есть ошибка в создании SOAPElement
объектpublic abstract Detail createDetail() throws SOAPException
Detail
объект, который служит контейнером для DetailEntry
объекты. Этот метод фабрики создает Detail
объекты для использования в ситуациях, где это не практично, чтобы использовать SOAPFault
абстракция.
Detail
объектSOAPException
- если есть ошибка SOAPUnsupportedOperationException
- если протокол, определенный для SOAPFactory, был DYNAMIC_SOAP_PROTOCOL
public abstract SOAPFault createFault(String reasonText, QName faultCode) throws SOAPException
SOAPFault
объект инициализируется с данным reasonText
и faultCode
reasonText
- ReasonText/FaultString для отказаfaultCode
- FaultCode для отказаSOAPFault
объектSOAPException
- если есть ошибка SOAPpublic abstract SOAPFault createFault() throws SOAPException
SOAPFault
объектSOAPFault
объектSOAPException
- если есть ошибка SOAPpublic abstract Name createName(String localName, String prefix, String uri) throws SOAPException
Name
объект, инициализированный с данным локальным именем, префиксом пространства имен, и URI пространства имен. Этот метод фабрики создает Name
объекты для использования в ситуациях, где это не практично, чтобы использовать SOAPEnvelope
абстракция.
localName
- a String
предоставление локального имениprefix
- a String
предоставление префикса пространства именuri
- a String
предоставление URI пространства именName
объект, инициализированный с данным локальным именем, префиксом пространства имен, и URI пространства именSOAPException
- если есть ошибка SOAPpublic abstract Name createName(String localName) throws SOAPException
Name
объект инициализируется с данным локальным именем. Этот метод фабрики создает Name
объекты для использования в ситуациях, где это не практично, чтобы использовать SOAPEnvelope
абстракция.
localName
- a String
предоставление локального имениName
объект инициализируется с данным локальным именемSOAPException
- если есть ошибка SOAPpublic static SOAPFactory newInstance() throws SOAPException
SOAPFactory
объект, который является экземпляром реализации по умолчанию (SOAP 1.1), Этот метод, использует следующую упорядоченную процедуру поиска, чтобы определить реализацию SOAPFactory class, чтобы загрузиться: SOAPFactory
SOAPException
- если была ошибка, создавая значение по умолчанию SOAPFactory
SAAJMetaFactory
public static SOAPFactory newInstance(String protocol) throws SOAPException
SOAPFactory
объект, который является экземпляром указанной реализации, этот метод, использует SAAJMetaFactory, чтобы определить местоположение реализации class и создать экземпляр SOAPFactory.protocol
- строковая константа, представляющая протокол указанной реализации фабрики SOAP. Может быть также DYNAMIC_SOAP_PROTOCOL
, DEFAULT_SOAP_PROTOCOL
(который является тем же самым как), SOAP_1_1_PROTOCOL
, или SOAP_1_2_PROTOCOL
.SOAPFactory
SOAPException
- если была ошибка, создавая указанное SOAPFactory
SAAJMetaFactory
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92