Класс SOAPFactory

public abstract class SOAPFactory
extends Object

Конструкторы

SOAPFactory

public SOAPFactory()

Методы

createElement

public SOAPElement createElement(Element domElement)
                          throws SOAPException

Создаёт объект SOAPElement из существующего DOM Element. Если переданный в качестве аргумента DOM Element уже является SOAPElement, то этот метод должен вернуть его без изменений без каких-либо дополнительных действий. В противном случае создаётся новый SOAPElement и делается глубокая копия аргумента domElement. Конкретный тип возвращаемого значения будет зависеть от имени аргумента domElement. Если любая часть дерева, укоренённого в domElement, нарушает правила SOAP, будет выброшено исключение SOAPException.

Параметры:

domElement - - копируемый Element.

Возвращает:

новый SOAPElement , являющийся копией domElement.

Исключения:

SOAPException - если при создании объекта SOAPElement произошла ошибка

С тех пор как:

SAAJ 1.3

createElement

public abstract SOAPElement createElement(Name name)
                                   throws SOAPException

Создаёт объект SOAPElement , инициализированный заданным объектом Name . Конкретный тип возвращаемого значения будет зависеть от имени, присвоенного новому SOAPElement. Например, новый SOAPElement с именем "{http://www.w3.org/2003/05/soap-envelope}Envelope" приведёт к созданию SOAPEnvelope , поддерживающего поведение SOAP 1.2.

Параметры:

name - объект Name с XML-именем для нового элемента

Возвращает:

новый объект SOAPElement , который был создан

Исключения:

SOAPException - если при создании объекта SOAPElement произошла ошибка

См. также:

createElement(javax.xml.namespace.QName)

createElement

public SOAPElement createElement(QName qname)
                          throws SOAPException

Создаёт объект SOAPElement , инициализированный заданным объектом QName . Конкретный тип возвращаемого значения будет зависеть от имени, присвоенного новому SOAPElement. Например, новый SOAPElement с именем "{http://www.w3.org/2003/05/soap-envelope}Envelope" приведёт к созданию SOAPEnvelope , поддерживающего поведение SOAP 1.2.

Параметры:

qname - объект QName с XML-именем для нового элемента

Возвращает:

новый объект SOAPElement , который был создан

Исключения:

SOAPException - если при создании объекта SOAPElement произошла ошибка

С тех пор как:

SAAJ 1.3

См. также:

createElement(Name)

createElement

public abstract SOAPElement createElement(String localName)
                                   throws SOAPException

Создаёт объект SOAPElement , инициализированный заданным локальным именем.

Параметры:

localName - String , задающий локальное имя для нового элемента

Возвращает:

новый объект SOAPElement , который был создан

Исключения:

SOAPException - если при создании объекта SOAPElement произошла ошибка

createElement

public abstract SOAPElement createElement(String localName,
                                          String prefix,
                                          String uri)
                                   throws SOAPException

Создаёт новый объект SOAPElement с заданным локальным именем, префиксом и URI. Конкретный тип возвращаемого значения будет зависеть от имени, присвоенного новому элементу. Например, новый SOAPElement с именем "{http://www.w3.org/2003/05/soap-envelope}Envelope" приведёт к созданию SOAPEnvelope , поддерживающего поведение SOAP 1.2.

Параметры:

localName - String , задающий локальное имя для нового элемента

prefix - префикс для этого SOAPElement

uri - String , задающий URI пространства имён, к которому принадлежит новый элемент

Исключения:

SOAPException - если при создании объекта SOAPElement произошла ошибка

createDetail

public abstract Detail createDetail()
                             throws SOAPException

Возвращает:

объект Detail

Исключения:

SOAPException - если произошла ошибка SOAP

UnsupportedOperationException - если протокол, указанный для SOAPFactory, был DYNAMIC_SOAP_PROTOCOL

createFault

public abstract SOAPFault createFault(String reasonText,
                                      QName faultCode)
                               throws SOAPException

Создаёт новый объект SOAPFault , инициализированный заданными значениями reasonText и faultCode .

Параметры:

reasonText - ReasonText/FaultString для ошибки

faultCode - FaultCode для ошибки

Возвращает:

объект SOAPFault

Исключения:

SOAPException - если произошла ошибка SOAP

С тех пор как:

SAAJ 1.3

createFault

public abstract SOAPFault createFault()
                               throws SOAPException

Создаёт новый объект по умолчанию SOAPFault

Возвращает:

объект SOAPFault

Исключения:

SOAPException - если произошла ошибка SOAP

С тех пор как:

SAAJ 1.3

createName

public abstract Name createName(String localName,
                                String prefix,
                                String uri)
                         throws SOAPException

Параметры:

localName - String , задающее локальное имя

prefix - String , задающее префикс пространства имён

uri - String , задающее URI пространства имён

Возвращает:

объект Name , инициализированный заданным локальным именем, префиксом пространства имён и URI пространства имён

Исключения:

SOAPException - если произошла ошибка SOAP

createName

public abstract Name createName(String localName)
                         throws SOAPException

Параметры:

localName - String , задающее локальное имя

Возвращает:

объект Name , инициализированный заданным локальным именем

Исключения:

SOAPException - если произошла ошибка SOAP

newInstance

public static SOAPFactory newInstance()
                               throws SOAPException

Создаёт новый объект SOAPFactory , являющийся экземпляром реализации по умолчанию (SOAP 1.1). Этот метод использует следующий упорядоченный поиск для определения класса реализации SOAPFactory для загрузки:

• Использует системную переменную среды javax.xml.soap.SOAPFactory.
• Использует файл свойств "lib/jaxm.properties" в каталоге JRE. Этот файл конфигурации находится в стандартном формате java.util.Properties и содержит полное квалифицированное имя класса реализации с ключом, соответствующим вышеуказанной системной переменной.
• Использует API сервисов (как подробно описано в спецификации JAR), если оно доступно, для определения имени класса.
• Использует экземпляр SAAJMetaFactory для поиска класса реализации SOAPFactory.

Возвращает:

новый экземпляр SOAPFactory

Исключения:

SOAPException - если произошла ошибка при создании объекта SOAPFactory по умолчанию

См. также:

SAAJMetaFactory

newInstance

public static SOAPFactory newInstance(String protocol)
                               throws SOAPException

Создаёт новый объект SOAPFactory , являющийся экземпляром указанной реализации. Этот метод использует SAAJMetaFactory для поиска класса реализации и создания экземпляра SOAPFactory.

Параметры:

protocol - строковая константа, представляющая протокол указанной реализации SOAP-фабрики. Может быть DYNAMIC_SOAP_PROTOCOL, DEFAULT_SOAP_PROTOCOL (что эквивалентно) SOAP_1_1_PROTOCOL, или SOAP_1_2_PROTOCOL.

Возвращает:

новый экземпляр SOAPFactory

Исключения:

SOAPException - если произошла ошибка при создании указанного объекта SOAPFactory

С тех пор как:

SAAJ 1.3

См. также:

SAAJMetaFactory