SOAPFactory (Платформа Java SE 7)

java.lang. Объект
- javax.xml.soap. SOAPFactory

```
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()

Конструкторы
Конструктор и Описание
`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 загрузки: Используйте javax.xml.soap. Системное свойство SOAPFactory.
`static SOAPFactory`	`newInstance(String protocol)` Создает новое `SOAPFactory` объект, который является экземпляром указанной реализации, этот метод, использует SAAJMetaFactory, чтобы определить местоположение класса реализации и создать экземпляр SOAPFactory.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - SOAPFactory
```
public SOAPFactory()
```
- Деталь метода
  - createElement
```
public SOAPElement createElement(Element domElement)
                          throws SOAPException
```
    Создает a SOAPElement объект от существующего ДОМА Element. Если ДОМ Element это передают в том, как параметр уже a SOAPElement тогда этот метод должен возвратить неизмененное без дальнейшей работы. Иначе, новое SOAPElement создается и глубокая копия делается из domElement параметр. Конкретный тип возвращаемого значения будет зависеть от имени domElement параметр. Если какая-либо часть дерева базировалась в domElement нарушает правила SOAP, a SOAPException будет брошен.
    
    Параметры:
    domElement - Element быть скопированным.
    
    Возвраты:
    новое SOAPElement это - копия domElement.
    
    Броски:
    
    SOAPException - если есть ошибка в создании SOAPElement объект
    С тех пор:
    
    SAAJ 1.3
  - createElement
```
public abstract SOAPElement createElement(Name name)
                                   throws SOAPException
```
    Создает a 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)
  - createElement
```
public SOAPElement createElement(QName qname)
                          throws SOAPException
```
    Создает a SOAPElement объект инициализируется с данным QName объект. Конкретный тип возвращаемого значения будет зависеть от имени, данного новому SOAPElement. Например, новое SOAPElement с именем" {http://www.w3.org/2003/05/soap-envelope} Конверт" вызвал бы a SOAPEnvelope это поддерживает SOAP 1.2 поведения, которые будут создаваться.
    
    Параметры:
    qname - a QName объект с XML называет для нового элемента
    
    Возвраты:
    новое SOAPElement объект, который создавался
    
    Броски:
    
    SOAPException - если есть ошибка в создании SOAPElement объект
    С тех пор:
    
    SAAJ 1.3
    
    См. Также:
    createElement(Name)
  - createElement
```
public abstract SOAPElement createElement(String localName)
                                   throws SOAPException
```
    Создает a SOAPElement объект инициализируется с данным локальным именем.
    
    Параметры:
    localName - a String предоставление локального имени для нового элемента
    
    Возвраты:
    новое SOAPElement объект, который создавался
    
    Броски:
    
    SOAPException - если есть ошибка в создании SOAPElement объект
  - createElement
```
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 объект
  - createDetail
```
public abstract Detail createDetail()
                             throws SOAPException
```
    Создает новое Detail объект, который служит контейнером для DetailEntry объекты.
    Этот метод фабрики создает Detail объекты для использования в ситуациях, где это не практично, чтобы использовать SOAPFault абстракция.
    
    Возвраты:
    a 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 для отказа
    
    Возвраты:
    a SOAPFault объект
    
    Броски:
    
    SOAPException - если есть ошибка SOAP
    С тех пор:
    
    SAAJ 1.3
  - createFault
```
public abstract SOAPFault createFault()
                               throws SOAPException
```
    Создает новое значение по умолчанию SOAPFault объект
    
    Возвраты:
    a SOAPFault объект
    
    Броски:
    
    SOAPException - если есть ошибка SOAP
    С тех пор:
    
    SAAJ 1.3
  - createName
```
public 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 пространства имен
    
    Возвраты:
    a Name объект, инициализированный с данным локальным именем, префиксом пространства имен, и URI пространства имен
    
    Броски:
    
    SOAPException - если есть ошибка SOAP
  - createName
```
public abstract Name createName(String localName)
                         throws SOAPException
```
    Создает новое Name объект инициализируется с данным локальным именем.
    Этот метод фабрики создает Name объекты для использования в ситуациях, где это не практично, чтобы использовать SOAPEnvelope абстракция.
    
    Параметры:
    localName - a String предоставление локального имени
    
    Возвраты:
    a 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. Свойства форматируют, и содержит полностью определенное имя класса реализации с ключом, являющимся системным свойством, определенным выше.
    - Используйте API Служб (как детализировано в спецификации JAR), при наличии, чтобы определить имя класса. API Служб будет искать имя класса в файле META-INF/services/javax.xml.soap.SOAPFactory во флягах, доступных времени выполнения.
    - Используйте экземпляр SAAJMetaFactory, чтобы определить местоположение класса реализации SOAPFactory.
    Возвраты:
    новый экземпляр a 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.
    
    Возвраты:
    новый экземпляр a SOAPFactory
    
    Броски:
    
    SOAPException - если была ошибка, создавая указанное SOAPFactory
    С тех пор:
    
    SAAJ 1.3
    
    См. Также:
    SAAJMetaFactory

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс SOAPFactory

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Деталь конструктора

SOAPFactory

Деталь метода

createElement

createElement

createElement

createElement

createElement

createDetail

createFault

createFault

createName

createName

newInstance

newInstance