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

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

```
public abstract class SAXParser
extends Object
```
Определяет API, который переносится XMLReader класс реализации. В JAXP 1.0, этот класс, обернутый Parser интерфейс, однако этот интерфейс был заменен XMLReader. Для простоты перехода этот класс продолжает поддерживать то же самое имя и интерфейс так же как поддержку новых методов. Экземпляр этого класса может быть получен из SAXParserFactory.newSAXParser() метод. Как только экземпляр этого класса получается, XML может быть проанализирован от множества входных источников. Этими входными источниками является InputStreams, Файлы, URL, и SAX InputSources.
Этот статический метод создает новый экземпляр фабрики, основанный на системной установке свойства, или использует значение по умолчанию платформы, если никакое свойство не было определено.
Системное свойство, которое управляет, какую реализацию Фабрики создать называют "javax.xml.parsers.SAXParserFactory". Это свойство называет класс, который является конкретным подклассом этого абстрактного класса. Если никакое свойство не будет определено, то значение по умолчанию платформы будет использоваться.
Поскольку контент анализируется базовым синтаксическим анализатором, методами данного HandlerBase или DefaultHandler вызываются.
Конструкторы этого класса, которые обертывают underlaying реализацию, могут рассмотреть использование ParserAdapter класс, чтобы первоначально адаптировать их реализацию SAX1, чтобы работать под этим пересмотренным классом.

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

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

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

Методы
Модификатор и Тип	Метод и Описание
`abstract Parser`	`getParser()` Возвращает синтаксический анализатор SAX, который является encapsultated реализацией этого класса.
`abstract Object`	`getProperty(String name)` Возвращает определенное свойство, которое требуют на в базовой реализации `XMLReader`.
`Схема`	`getSchema()` Получите ссылку на `Schema` будучи используемым процессором XML.
`abstract XMLReader`	`getXMLReader()` Возвраты `XMLReader` это инкапсулируется реализацией этого класса.
`abstract boolean`	`isNamespaceAware()` Указывает, конфигурируется ли этот синтаксический анализатор, чтобы понять пространства имен.
`abstract boolean`	`isValidating()` Указывает, конфигурируется ли этот синтаксический анализатор, чтобы проверить XML-документов.
`boolean`	`isXIncludeAware()` Получите XInclude обработка режима для этого синтаксического анализатора.
`void`	`parse(File f, DefaultHandler dh)` Проанализируйте контент файла, определенного как XML, используя указанное `DefaultHandler`.
`void`	`parse(File f, HandlerBase hb)` Проанализируйте контент файла, определенного как XML, используя указанное `HandlerBase`.
`void`	`parse(InputSource is, DefaultHandler dh)` Проанализируйте данный контент `InputSource` как XML, используя указанное `DefaultHandler`.
`void`	`parse(InputSource is, HandlerBase hb)` Проанализируйте данный контент `InputSource` как XML, используя указанное `HandlerBase`.
`void`	`parse(InputStream is, DefaultHandler dh)` Проанализируйте контент данного `InputStream` экземпляр как XML, используя указанное `DefaultHandler`.
`void`	`parse(InputStream is, DefaultHandler dh, String systemId)` Проанализируйте контент данного `InputStream` экземпляр как XML, используя указанное `DefaultHandler`.
`void`	`parse(InputStream is, HandlerBase hb)` Проанализируйте контент данного `InputStream` экземпляр как XML, используя указанное `HandlerBase`.
`void`	`parse(InputStream is, HandlerBase hb, String systemId)` Проанализируйте контент данного `InputStream` экземпляр как XML, используя указанное `HandlerBase`.
`void`	`parse(String uri, DefaultHandler dh)` Проанализируйте контент, описанный дающим Универсальным Идентификатором ресурса (URI) как XML, используя указанное `DefaultHandler`.
`void`	`parse(String uri, HandlerBase hb)` Проанализируйте контент, описанный дающим Универсальным Идентификатором ресурса (URI) как XML, используя указанное `HandlerBase`.
`void`	`reset()` Сбросьте это `SAXParser` к его исходной конфигурации.
`abstract void`	`setProperty(String name, Object value)` Устанавливает определенное свойство в базовой реализации `XMLReader`.

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

- Деталь конструктора
  - SAXParser
```
protected SAXParser()
```
    Защищенный конструктор, чтобы предотвратить instaniation. Использовать SAXParserFactory.newSAXParser().
- Деталь метода
  - сброс
```
public void reset()
```
    Сбросьте это SAXParser к его исходной конфигурации.
    
    SAXParser сбрасывается к тому же самому состоянию как тогда, когда оно создавалось с SAXParserFactory.newSAXParser(). reset() разрабатывается, чтобы позволить повторное использование существующих SAXParsers таким образом сохраняющий ресурсы, связанные с созданием новых SAXParsers.
    
    Сброс SAXParser как гарантируют, не будет иметь то же самое Schema Object, например. Object.equals(Object obj). Это, как гарантируют, будет иметь функционально равный Schema.
    
    Броски:
    
    UnsupportedOperationException - Когда Реализации не переопределяют этот метод
    С тех пор:
    
    1.5
  - синтаксический анализ
```
public void parse(InputStream is,
         HandlerBase hb)
           throws SAXException,
                  IOException
```
    Проанализируйте контент данного InputStream экземпляр как XML, используя указанное HandlerBase. Использование версии DefaultHandler этого метода рекомендуется, поскольку класс HandlerBase был осужден в SAX 2.0.
    
    Параметры:
    is - InputStream, содержащий контент, который будет проанализирован.
    hb - SAX HandlerBase, чтобы использовать.
    
    Броски:
    
    IllegalArgumentException - Если данный InputStream является нулем.
    
    SAXException - Если синтаксический анализ производит ошибку SAX.
    
    IOException - Если ошибка IO происходит, взаимодействуя InputStream.
    См. Также:
    DocumentHandler
  - синтаксический анализ
```
public void parse(InputStream is,
         HandlerBase hb,
         String systemId)
           throws SAXException,
                  IOException
```
    Проанализируйте контент данного InputStream экземпляр как XML, используя указанное HandlerBase. Использование версии DefaultHandler этого метода рекомендуется, поскольку класс HandlerBase был осужден в SAX 2.0.
    
    Параметры:
    is - InputStream, содержащий контент, который будет проанализирован.
    hb - SAX HandlerBase, чтобы использовать.
    systemId - systemId, который необходим для того, чтобы разрешить относительные URI.
    
    Броски:
    
    IllegalArgumentException - Если данный InputStream null.
    
    IOException - Если ошибка IO происходит, взаимодействуя InputStream.
    
    SAXException - Если какие-либо ошибки SAX происходят во время обработки.
    См. Также:
    version of this method instead.
  - синтаксический анализ
```
public void parse(InputStream is,
         DefaultHandler dh)
           throws SAXException,
                  IOException
```
    Проанализируйте контент данного InputStream экземпляр как XML, используя указанное DefaultHandler.
    
    Параметры:
    is - InputStream, содержащий контент, который будет проанализирован.
    dh - SAX DefaultHandler, чтобы использовать.
    
    Броски:
    
    IllegalArgumentException - Если данный InputStream является нулем.
    
    IOException - Если какие-либо ошибки IO происходят.
    
    SAXException - Если какие-либо ошибки SAX происходят во время обработки.
    См. Также:
    DocumentHandler
  - синтаксический анализ
```
public void parse(InputStream is,
         DefaultHandler dh,
         String systemId)
           throws SAXException,
                  IOException
```
    Проанализируйте контент данного InputStream экземпляр как XML, используя указанное DefaultHandler.
    
    Параметры:
    is - InputStream, содержащий контент, который будет проанализирован.
    dh - SAX DefaultHandler, чтобы использовать.
    systemId - systemId, который необходим для того, чтобы разрешить относительные URI.
    
    Броски:
    
    IllegalArgumentException - Если данный InputStream является нулем.
    
    IOException - Если какие-либо ошибки IO происходят.
    
    SAXException - Если какие-либо ошибки SAX происходят во время обработки.
    См. Также:
    version of this method instead.
  - синтаксический анализ
```
public void parse(String uri,
         HandlerBase hb)
           throws SAXException,
                  IOException
```
    Проанализируйте контент, описанный дающим Универсальным Идентификатором ресурса (URI) как XML, используя указанное HandlerBase. Использование версии DefaultHandler этого метода рекомендуется как HandlerBase класс был осужден в SAX 2.0
    
    Параметры:
    uri - Расположение контента, который будет проанализирован.
    hb - SAX HandlerBase, чтобы использовать.
    
    Броски:
    
    IllegalArgumentException - Если туры являются нулем.
    
    IOException - Если какие-либо ошибки IO происходят.
    
    SAXException - Если какие-либо ошибки SAX происходят во время обработки.
    См. Также:
    DocumentHandler
  - синтаксический анализ
```
public void parse(String uri,
         DefaultHandler dh)
           throws SAXException,
                  IOException
```
    Проанализируйте контент, описанный дающим Универсальным Идентификатором ресурса (URI) как XML, используя указанное DefaultHandler.
    
    Параметры:
    uri - Расположение контента, который будет проанализирован.
    dh - SAX DefaultHandler, чтобы использовать.
    
    Броски:
    
    IllegalArgumentException - Если туры являются нулем.
    
    IOException - Если какие-либо ошибки IO происходят.
    
    SAXException - Если какие-либо ошибки SAX происходят во время обработки.
    См. Также:
    DocumentHandler
  - синтаксический анализ
```
public void parse(File f,
         HandlerBase hb)
           throws SAXException,
                  IOException
```
    Проанализируйте контент файла, определенного как XML, используя указанное HandlerBase. Использование версии DefaultHandler этого метода рекомендуется, поскольку класс HandlerBase был осужден в SAX 2.0
    
    Параметры:
    f - Файл, содержащий XML, чтобы проанализировать
    hb - SAX HandlerBase, чтобы использовать.
    
    Броски:
    
    IllegalArgumentException - Если объект Файла является нулем.
    
    IOException - Если какие-либо ошибки IO происходят.
    
    SAXException - Если какие-либо ошибки SAX происходят во время обработки.
    См. Также:
    DocumentHandler
  - синтаксический анализ
```
public void parse(File f,
         DefaultHandler dh)
           throws SAXException,
                  IOException
```
    Проанализируйте контент файла, определенного как XML, используя указанное DefaultHandler.
    
    Параметры:
    f - Файл, содержащий XML, чтобы проанализировать
    dh - SAX DefaultHandler, чтобы использовать.
    
    Броски:
    
    IllegalArgumentException - Если объект Файла является нулем.
    
    IOException - Если какие-либо ошибки IO происходят.
    
    SAXException - Если какие-либо ошибки SAX происходят во время обработки.
    См. Также:
    DocumentHandler
  - синтаксический анализ
```
public void parse(InputSource is,
         HandlerBase hb)
           throws SAXException,
                  IOException
```
    Проанализируйте данный контент InputSource как XML, используя указанное HandlerBase. Использование версии DefaultHandler этого метода рекомендуется, поскольку класс HandlerBase был осужден в SAX 2.0
    
    Параметры:
    is - InputSource, содержащий контент, который будет проанализирован.
    hb - SAX HandlerBase, чтобы использовать.
    
    Броски:
    
    IllegalArgumentException - Если InputSource объект null.
    
    IOException - Если какие-либо ошибки IO происходят.
    
    SAXException - Если какие-либо ошибки SAX происходят во время обработки.
    См. Также:
    DocumentHandler
  - синтаксический анализ
```
public void parse(InputSource is,
         DefaultHandler dh)
           throws SAXException,
                  IOException
```
    Проанализируйте данный контент InputSource как XML, используя указанное DefaultHandler.
    
    Параметры:
    is - InputSource, содержащий контент, который будет проанализирован.
    dh - SAX DefaultHandler, чтобы использовать.
    
    Броски:
    
    IllegalArgumentException - Если InputSource объект null.
    
    IOException - Если какие-либо ошибки IO происходят.
    
    SAXException - Если какие-либо ошибки SAX происходят во время обработки.
    См. Также:
    DocumentHandler
  - getParser
```
public abstract Parser getParser()
                          throws SAXException
```
    Возвращает синтаксический анализатор SAX, который является encapsultated реализацией этого класса.
    
    Возвраты:
    Синтаксический анализатор SAX, который является encapsultated реализацией этого класса.
    
    Броски:
    
    SAXException - Если какие-либо ошибки SAX происходят во время обработки.
  - getXMLReader
```
public abstract XMLReader getXMLReader()
                                throws SAXException
```
    Возвраты XMLReader это инкапсулируется реализацией этого класса.
    
    Возвраты:
    XMLReader, который инкапсулируется реализацией этого класса.
    
    Броски:
    
    SAXException - Если какие-либо ошибки SAX происходят во время обработки.
  - isNamespaceAware
```
public abstract boolean isNamespaceAware()
```
    Указывает, конфигурируется ли этот синтаксический анализатор, чтобы понять пространства имен.
    
    Возвраты:
    истина, если этот синтаксический анализатор конфигурируется, чтобы понять пространства имен; ложь иначе.
  - isValidating
```
public abstract boolean isValidating()
```
    Указывает, конфигурируется ли этот синтаксический анализатор, чтобы проверить XML-документов.
    
    Возвраты:
    истина, если этот синтаксический анализатор конфигурируется, чтобы проверить XML-документов; ложь иначе.
  - setProperty
```
public abstract void setProperty(String name,
               Object value)
                          throws SAXNotRecognizedException,
                                 SAXNotSupportedException
```
    Устанавливает определенное свойство в базовой реализации XMLReader. Список базовых функций и свойств может быть найден в http://sax.sourceforge.net/?selected=get-set.
    
    Параметры:
    name - Имя свойства, которое будет установлено.
    value - Значение свойства, которое будет установлено.
    
    Броски:
    
    SAXNotRecognizedException - Когда базовый XMLReader не распознает имя свойства.
    
    SAXNotSupportedException - Когда базовый XMLReader распознает, что свойство называет, но не поддерживает свойство.
    См. Также:
    XMLReader.setProperty(java.lang.String, java.lang.Object)
  - getProperty
```
public abstract Object getProperty(String name)
                            throws SAXNotRecognizedException,
                                   SAXNotSupportedException
```
    Возвращает определенное свойство, которое требуют на в базовой реализации XMLReader.
    
    Параметры:
    name - Имя свойства, которое будет получено.
    
    Возвраты:
    Значение требуемого свойства.
    
    Броски:
    
    SAXNotRecognizedException - Когда базовый XMLReader не распознает имя свойства.
    
    SAXNotSupportedException - Когда базовый XMLReader распознает, что свойство называет, но не поддерживает свойство.
    См. Также:
    XMLReader.getProperty(java.lang.String)
  - getSchema
```
public Schema getSchema()
```
    Получите ссылку на Schema будучи используемым процессором XML.
    
    Если никакая схема не используется, null возвращается.
    
    Возвраты:
    Schema будучи используемым или null если ни один в использовании
    
    Броски:
    
    UnsupportedOperationException - Когда реализация не переопределяет этот метод
    С тех пор:
    
    1.5
  - isXIncludeAware
```
public boolean isXIncludeAware()
```
    Получите XInclude обработка режима для этого синтаксического анализатора.
    
    Возвраты:
    возвращаемое значение SAXParserFactory.isXIncludeAware() когда этот синтаксический анализатор создавался из фабрики.
    
    Броски:
    
    UnsupportedOperationException - Когда реализация не переопределяет этот метод
    С тех пор:
    
    1.5
    
    См. Также:
    SAXParserFactory.setXIncludeAware(boolean)

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

Класс SAXParser

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

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

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

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

SAXParser

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

сброс

синтаксический анализ

синтаксический анализ

синтаксический анализ

синтаксический анализ

синтаксический анализ

синтаксический анализ

синтаксический анализ

синтаксический анализ

синтаксический анализ

синтаксический анализ

getParser

getXMLReader

isNamespaceAware

isValidating

setProperty

getProperty

getSchema

isXIncludeAware