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

java.lang. Объект
- javax.xml.parsers. SAXParserFactory

```
public abstract class SAXParserFactory
extends Object
```
Определяет API фабрики, который позволяет приложениям сконфигурировать и получить SAX базируемый синтаксический анализатор, чтобы проанализировать XML-документы.

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

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`SAXParserFactory()` Защищенный конструктор, чтобы вызвать использование `newInstance()`.

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

Методы
Модификатор и Тип	Метод и Описание
`abstract boolean`	`getFeature(String name)` Возвращает определенное свойство, которое требуют на в базовой реализации org.xml.sax. XMLReader.
`Схема`	`getSchema()` Добирается `Schema` объект, определенный через `setSchema(Schema schema)` метод.
`boolean`	`isNamespaceAware()` Указывает, конфигурируется ли фабрика, чтобы произвести синтаксические анализаторы, которые являются знающим пространством имен.
`boolean`	`isValidating()` Указывает, конфигурируется ли фабрика, чтобы произвести синтаксические анализаторы, которые проверяют контента XML во время синтаксического анализа.
`boolean`	`isXIncludeAware()` Получите состояние обработки XInclude.
`static SAXParserFactory`	`newInstance()` Получите новый экземпляр a `SAXParserFactory`.
`static SAXParserFactory`	`newInstance(String factoryClassName, ClassLoader classLoader)` Получите новый экземпляр a `SAXParserFactory` от имени класса.
`abstract SAXParser`	`newSAXParser()` Создает новый экземпляр SAXParser использование в настоящий момент сконфигурированных параметров фабрики.
`abstract void`	`setFeature(String name, boolean value)` Устанавливает определенную функцию в базовой реализации org.xml.sax. XMLReader.
`void`	`setNamespaceAware(boolean awareness)` Определяет, что синтаксический анализатор, произведенный этим кодом, окажет поддержку для пространств имен XML.
`void`	`setSchema(Schema schema)` Установите `Schema` использоваться синтаксическими анализаторами, создаваемыми из этой фабрики.
`void`	`setValidating(boolean validating)` Определяет, что синтаксический анализатор, произведенный этим кодом, проверит документов, поскольку они анализируются.
`void`	`setXIncludeAware(boolean state)` Состояние набора обработки XInclude.

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

- Деталь конструктора
  - SAXParserFactory
```
protected SAXParserFactory()
```
    Защищенный конструктор, чтобы вызвать использование newInstance().
- Деталь метода
  - newInstance
```
public static SAXParserFactory newInstance()
```
    Получите новый экземпляр a SAXParserFactory. Этот статический метод создает новый экземпляр фабрики, который Этот метод использует следующую упорядоченную процедуру поиска, чтобы определить SAXParserFactory класс реализации загрузки:
    - Используйте javax.xml.parsers.SAXParserFactory системное свойство.
    - Используйте файл свойств "lib/jaxp.properties" в каталоге JRE. Этот конфигурационный файл находится в стандарте java.util.Properties отформатируйте и содержит полностью определенное имя класса реализации с ключом, являющимся системным свойством, определенным выше. jaxp.properties файл только для чтения однажды реализацией JAXP, и это - значения, тогда кэшируются для будущего использования. Если файл не существует, когда первая попытка предпринимается, чтобы читать из него, никакие дальнейшие попытки не предпринимаются, чтобы проверить на ее существование. Не возможно изменить значение любого свойства в jaxp.properties после того, как это было считано впервые.
    - Используйте API Служб (как детализировано в спецификации JAR), при наличии, чтобы определить имя класса. API Служб будет искать имя класса в файле META-INF/services/javax.xml.parsers.SAXParserFactory во флягах, доступных времени выполнения.
    - Значение по умолчанию платформы SAXParserFactory экземпляр.
    Как только приложение получило ссылку на a SAXParserFactory это может использовать фабрику, чтобы сконфигурировать и получить экземпляры синтаксического анализатора.
    Подсказка для Поиска и устранения неисправностей
    
    Установка jaxp.debug системное свойство заставит этот метод печатать много сообщений отладки к System.err о каком это делает и где это смотрит на.
    
    Если у Вас есть проблемы, загружаясь DocumentBuilders, попробуйте:
```
 java -Djaxp.debug=1 YourProgram ....
 
```
    Возвраты:
    Новый экземпляр SAXParserFactory.
    
    Броски:
    
    FactoryConfigurationError - если реализация не доступна или не может быть инстанцирована.
  - newInstance
```
public static SAXParserFactory newInstance(String factoryClassName,
                           ClassLoader classLoader)
```
    Получите новый экземпляр a SAXParserFactory от имени класса. Эта функция полезна, когда есть многократные провайдеры в пути к классу. Это дает больше контроля к приложению, поскольку это может определить, какой провайдер должен быть загружен.
    
    Как только приложение получило ссылку на a SAXParserFactory это может использовать фабрику, чтобы сконфигурировать и получить экземпляры синтаксического анализатора.
    
    Подсказка для Поиска и устранения неисправностей
    
    Установка jaxp.debug системное свойство заставит этот метод печатать много сообщений отладки к System.err о каком это делает и где это смотрит на.
    
    Если у Вас есть проблемы, попробуйте:
```
 java -Djaxp.debug=1 YourProgram ....
 
```
    Параметры:
    factoryClassName - полностью определенное имя класса фабрики, которое обеспечивает реализацию javax.xml.parsers.SAXParserFactory.
    classLoader - ClassLoader используемый, чтобы загрузить класс фабрики. Если null ток Thread's контекст classLoader используется, чтобы загрузить класс фабрики.
    
    Возвраты:
    Новый экземпляр a SAXParserFactory
    
    Броски:
    
    FactoryConfigurationError - если factoryClassName null, или класс фабрики не может быть загружен, инстанцирован.
    С тех пор:
    
    1.6
    
    См. Также:
    newInstance()
  - newSAXParser
```
public abstract SAXParser newSAXParser()
                                throws ParserConfigurationException,
                                       SAXException
```
    Создает новый экземпляр SAXParser использование в настоящий момент сконфигурированных параметров фабрики.
    
    Возвраты:
    Новый экземпляр SAXParser.
    
    Броски:
    
    ParserConfigurationException - если синтаксический анализатор не может быть создан, который удовлетворяет требуемую конфигурацию.
    
    SAXException - для ошибок SAX.
  - setNamespaceAware
```
public void setNamespaceAware(boolean awareness)
```
    Определяет, что синтаксический анализатор, произведенный этим кодом, окажет поддержку для пространств имен XML. По умолчанию значение этого устанавливается в false.
    
    Параметры:
    awareness - истина, если синтаксический анализатор, произведенный этим кодом, окажет поддержку для пространств имен XML; ложь иначе.
  - setValidating
```
public void setValidating(boolean validating)
```
    Определяет, что синтаксический анализатор, произведенный этим кодом, проверит документов, поскольку они анализируются. По умолчанию значение этого устанавливается в false.
    Отметьте, что "проверка допустимости" здесь означает синтаксический анализатор проверки допустимости как определено в рекомендации XML. Другими словами это по существу только управляет проверкой допустимости DTD. (кроме наследства два свойства, определенные в JAXP 1.2.)
    
    Чтобы использовать современные языки схемы, такие как XML-схема W3C или ОСЛАБИТЬ НАНОГРАММ вместо DTD, можно сконфигурировать свой синтаксический анализатор, чтобы быть синтаксическим анализатором непроверки допустимости, уезжая setValidating(boolean) метод false, тогда используйте setSchema(Schema) метод, чтобы связать схему к синтаксическому анализатору.
    
    Параметры:
    validating - истина, если синтаксический анализатор, произведенный этим кодом, проверит документов, поскольку они анализируются; ложь иначе.
  - isNamespaceAware
```
public boolean isNamespaceAware()
```
    Указывает, конфигурируется ли фабрика, чтобы произвести синтаксические анализаторы, которые являются знающим пространством имен.
    
    Возвраты:
    истина, если фабрика конфигурируется, чтобы произвести синтаксические анализаторы, которые являются знающим пространством имен; ложь иначе.
  - isValidating
```
public boolean isValidating()
```
    Указывает, конфигурируется ли фабрика, чтобы произвести синтаксические анализаторы, которые проверяют контента XML во время синтаксического анализа.
    
    Возвраты:
    истина, если фабрика конфигурируется, чтобы произвести синтаксические анализаторы, которые проверяют контента XML во время синтаксического анализа; ложь иначе.
  - setFeature
```
public abstract void setFeature(String name,
              boolean value)
                         throws ParserConfigurationException,
                                SAXNotRecognizedException,
                                SAXNotSupportedException
```
    Устанавливает определенную функцию в базовой реализации org.xml.sax. XMLReader. Список базовых функций и свойств может быть найден в http://www.saxproject.org/
    
    Все реализации обязаны поддерживать XMLConstants.FEATURE_SECURE_PROCESSING функция. Когда функция
    - true: реализация ограничит обработку XML, чтобы соответствовать пределам реализации. Примеры включают enity пределы расширения и конструкции XML-схемы, которые использовали бы большое количество ресурсов. Если обработка XML будет ограничена для соображений безопасности, то о ней сообщат через звонок в зарегистрированный ErrorHandler.fatalError(SAXParseException exception). См. SAXParser parse методы для спецификации обработчика.
    - Когда функция false, реализация будет, обрабатывая XML согласно спецификациям XML без отношения к возможным пределам реализации.
    Параметры:
    name - Имя функции, которая будет установлена.
    value - Значение функции, которая будет установлена.
    
    Броски:
    
    ParserConfigurationException - если синтаксический анализатор не может быть создан, который удовлетворяет требуемую конфигурацию.
    
    SAXNotRecognizedException - Когда базовый XMLReader не распознает имя свойства.
    
    SAXNotSupportedException - Когда базовый XMLReader распознает, что свойство называет, но не поддерживает свойство.
    
    NullPointerException - Если name параметр является нулем.
    См. Также:
    XMLReader.setFeature(java.lang.String, boolean)
  - getFeature
```
public abstract boolean getFeature(String name)
                            throws ParserConfigurationException,
                                   SAXNotRecognizedException,
                                   SAXNotSupportedException
```
    Возвращает определенное свойство, которое требуют на в базовой реализации org.xml.sax. XMLReader.
    
    Параметры:
    name - Имя свойства, которое будет получено.
    
    Возвраты:
    Значение требуемого свойства.
    
    Броски:
    
    ParserConfigurationException - если синтаксический анализатор не может быть создан, который удовлетворяет требуемую конфигурацию.
    
    SAXNotRecognizedException - Когда базовый XMLReader не распознает имя свойства.
    
    SAXNotSupportedException - Когда базовый XMLReader распознает, что свойство называет, но не поддерживает свойство.
    См. Также:
    XMLReader.getProperty(java.lang.String)
  - getSchema
```
public Schema getSchema()
```
    Добирается Schema объект, определенный через setSchema(Schema schema) метод.
    
    Возвраты:
    Schema объект, который был последним набором через setSchema(Schema) метод, или нуль, если метод не был вызван с тех пор a SAXParserFactory создается.
    
    Броски:
    
    UnsupportedOperationException - Когда реализация не переопределяет этот метод
    С тех пор:
    
    1.5
  - setSchema
```
public void setSchema(Schema schema)
```
    Установите Schema использоваться синтаксическими анализаторами, создаваемыми из этой фабрики.
    
    Когда a Schema ненуль, синтаксический анализатор будет использовать блок проверки допустимости, создаваемый из него, чтобы проверить документов прежде, чем он передаст информацию к приложению.
    
    Когда предупреждения/ошибки/фатальные ошибки находятся блоком проверки допустимости, синтаксический анализатор должен обработать их, как будто те ошибки были найдены синтаксическим анализатором непосредственно. Другими словами, если определенный пользователем ErrorHandler устанавливается, это должно получить те ошибки, и в противном случае они должны быть обработаны согласно реализации определенные правила обработки ошибок по умолчанию.
    Блок проверки допустимости может изменить поток событий SAX (например, добавляя значения по умолчанию, которые отсутствовали в документах), и синтаксический анализатор ответственен, чтобы удостовериться, что приложение получит те измененный поток событий.
    
    Initialy, null устанавливается как Schema.
    
    Эта обработка вступит в силу даже если isValidating() возвраты метода false.
    Это - ошибка использовать http://java.sun.com/xml/jaxp/properties/schemaSource свойство и/или http://java.sun.com/xml/jaxp/properties/schemaLanguage свойство в соединении с ненулем Schema объект. Такая конфигурация вызовет a SAXException исключение, когда те свойства устанавливаются на a SAXParser.
    
    Отметьте implmentors
    
    Синтаксический анализатор должен быть в состоянии работать с любым Schema реализация. Однако, синтаксическим анализаторам и схемам позволяют использовать специфичные для реализации пользовательские механизмы, пока они приводят к результату, описанному в спецификации.
    
    Параметры:
    schema - Schema использовать, null удалить схему.
    
    Броски:
    
    UnsupportedOperationException - Когда реализация не переопределяет этот метод
    С тех пор:
    
    1.5
  - setXIncludeAware
```
public void setXIncludeAware(boolean state)
```
    Состояние набора обработки XInclude.
    
    Если разметка XInclude находится в экземпляре документа, должен это обрабатываться как определено во Включениях XML (XInclude) Версия 1.0.
    
    XInclude обработка значений по умолчанию к false.
    
    Параметры:
    state - Набор XInclude, обрабатывающий к true или false
    
    Броски:
    
    UnsupportedOperationException - Когда реализация не переопределяет этот метод
    С тех пор:
    
    1.5
  - isXIncludeAware
```
public boolean isXIncludeAware()
```
    Получите состояние обработки XInclude.
    
    Возвраты:
    текущее состояние обработки XInclude
    
    Броски:
    
    UnsupportedOperationException - Когда реализация не переопределяет этот метод
    С тех пор:
    
    1.5

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

Класс SAXParserFactory

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

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

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

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

SAXParserFactory

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

newInstance

Подсказка для Поиска и устранения неисправностей

newInstance

Подсказка для Поиска и устранения неисправностей

newSAXParser

setNamespaceAware

setValidating

isNamespaceAware

isValidating

setFeature

getFeature

getSchema

setSchema

Отметьте implmentors

setXIncludeAware

isXIncludeAware