Синтаксический анализатор (Платформа Java SE 7)

Все Известные Классы с реализацией:

XMLReaderAdapter

Осуждаемый.
Этот интерфейс был заменен SAX2 XMLReader интерфейс, который включает поддержку Пространства имен.
```
public interface Parser
```
Основной интерфейс для SAX (Простой API для XML) синтаксические анализаторы.
Этот модуль, и исходный код и документация, находится в Общедоступном Домене, и прибывает без ГАРАНТИИ. См. http://www.saxproject.org для дополнительной информации.

Это было основным интерфейсом поставщика события для SAX1; это было заменено в SAX2 XMLReader, который включает поддержку Пространства имен и сложную конфигурируемость и расширяемость.

Все синтаксические анализаторы SAX1 должны реализовать этот основной интерфейс: это позволяет приложениям регистрировать обработчики для различных типов событий и инициировать синтаксический анализ от URI, или символьный поток.

Все синтаксические анализаторы SAX1 должны также реализовать конструктора нулевого параметра (хотя другим конструкторам также разрешают).

Синтаксические анализаторы SAX1 являются допускающими повторное использование, но не повторно используемыми: приложение может снова использовать объект синтаксического анализатора (возможно с различным входным источником), как только первый синтаксический анализ завершился успешно, но это, возможно, не вызывает синтаксический анализ () методы рекурсивно в пределах синтаксического анализа.

С тех пор:

SAX 1.0

См. Также:
EntityResolver, DTDHandler, DocumentHandler, ErrorHandler, HandlerBase, InputSource

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

Методы
Модификатор и Тип	Метод и Описание
`void`	`parse(InputSource source)` Осуждаемый. Проанализируйте XML-документ.
`void`	`parse(String systemId)` Осуждаемый. Проанализируйте XML-документ от системного идентификатора (URI).
`void`	`setDocumentHandler(DocumentHandler handler)` Осуждаемый. Позвольте приложению регистрировать обработчик событий документа.
`void`	`setDTDHandler(DTDHandler handler)` Осуждаемый. Позвольте приложению регистрировать обработчик событий DTD.
`void`	`setEntityResolver(EntityResolver resolver)` Осуждаемый. Позвольте приложению регистрировать пользовательский преобразователь объекта.
`void`	`setErrorHandler(ErrorHandler handler)` Осуждаемый. Позвольте приложению регистрировать ошибочный обработчик событий.
`void`	`setLocale(Locale locale)` Осуждаемый. Позвольте приложению запрашивать локаль на ошибки и предупреждения.

- Деталь метода
  - setLocale
```
void setLocale(Locale locale)
               throws SAXException
```
    Осуждаемый.
    
    Позвольте приложению запрашивать локаль на ошибки и предупреждения.
    Синтаксические анализаторы SAX не обязаны обеспечивать локализацию для ошибок и предупреждений; если они не могут поддерживать требуемую локаль, однако, они должны выдать исключение SAX. Приложения, возможно, не запрашивают изменения локали в середине синтаксического анализа.
    
    Параметры:
    locale - Объект Локали Java.
    
    Броски:
    
    SAXException - Выдает исключение (использующий предыдущую или локаль по умолчанию), если требуемая локаль не поддерживается.
    См. Также:
    SAXException, SAXParseException
  - setEntityResolver
```
void setEntityResolver(EntityResolver resolver)
```
    Осуждаемый.
    
    Позвольте приложению регистрировать пользовательский преобразователь объекта.
    Если приложение не зарегистрирует преобразователь объекта, то синтаксический анализатор SAX разрешит системные идентификаторы и откроет соединения с объектами самостоятельно (это - поведение по умолчанию, реализованное в HandlerBase).
    
    Приложения могут зарегистрировать новый или различный преобразователь объекта в середине синтаксического анализа, и синтаксический анализатор SAX должен начать использовать новый преобразователь сразу.
    
    Параметры:
    resolver - Объект для того, чтобы разрешить объекты.
    См. Также:
    EntityResolver, HandlerBase
  - setDTDHandler
```
void setDTDHandler(DTDHandler handler)
```
    Осуждаемый.
    
    Позвольте приложению регистрировать обработчик событий DTD.
    Если приложение не зарегистрирует обработчик DTD, то все события DTD, о которых сообщает синтаксический анализатор SAX, будут тихо проигнорированы (это - поведение по умолчанию, реализованное HandlerBase).
    
    Приложения могут зарегистрировать новый или различный обработчик в середине синтаксического анализа, и синтаксический анализатор SAX должен начать использовать новый обработчик сразу.
    
    Параметры:
    handler - Обработчик DTD.
    См. Также:
    DTDHandler, HandlerBase
  - setDocumentHandler
```
void setDocumentHandler(DocumentHandler handler)
```
    Осуждаемый.
    
    Позвольте приложению регистрировать обработчик событий документа.
    Если приложение не зарегистрирует обработчик документа, то все события документа, о которых сообщает синтаксический анализатор SAX, будут тихо проигнорированы (это - поведение по умолчанию, реализованное HandlerBase).
    
    Приложения могут зарегистрировать новый или различный обработчик в середине синтаксического анализа, и синтаксический анализатор SAX должен начать использовать новый обработчик сразу.
    
    Параметры:
    handler - Обработчик документа.
    См. Также:
    DocumentHandler, HandlerBase
  - setErrorHandler
```
void setErrorHandler(ErrorHandler handler)
```
    Осуждаемый.
    
    Позвольте приложению регистрировать ошибочный обработчик событий.
    Если приложение не зарегистрирует ошибочный обработчик событий, то все ошибочные события, о которых сообщает синтаксический анализатор SAX, будут тихо проигнорированы, за исключением fatalError, который бросит SAXException (это - поведение по умолчанию, реализованное HandlerBase).
    
    Приложения могут зарегистрировать новый или различный обработчик в середине синтаксического анализа, и синтаксический анализатор SAX должен начать использовать новый обработчик сразу.
    
    Параметры:
    handler - Обработчик ошибок.
    См. Также:
    ErrorHandler, SAXException, HandlerBase
  - синтаксический анализ
```
void parse(InputSource source)
           throws SAXException,
                  IOException
```
    Осуждаемый.
    
    Проанализируйте XML-документ.
    Приложение может использовать этот метод, чтобы дать синтаксическому анализатору SAX команду начинать анализировать XML-документ из любого допустимого входного источника (символьный поток, поток байтов, или URI).
    
    Приложения, возможно, не вызывают этот метод, в то время как синтаксический анализ происходит (они должны создать новый Синтаксический анализатор вместо этого для каждого дополнительного XML-документа). Как только синтаксический анализ полон, приложение может снова использовать тот же самый объект Синтаксического анализатора, возможно с различным входным источником.
    
    Параметры:
    source - Входной источник для верхнего уровня XML-документа.
    
    Броски:
    
    SAXException - Любое исключение SAX, возможно обертывая другое исключение.
    
    IOException - Исключение IO из синтаксического анализатора, возможно из потока байтов или символьного потока предоставляется приложением.
    См. Также:
    InputSource, parse(java.lang.String), setEntityResolver(org.xml.sax.EntityResolver), setDTDHandler(org.xml.sax.DTDHandler), setDocumentHandler(org.xml.sax.DocumentHandler), setErrorHandler(org.xml.sax.ErrorHandler)
  - синтаксический анализ
```
void parse(String systemId)
           throws SAXException,
                  IOException
```
    Осуждаемый.
    Проанализируйте XML-документ от системного идентификатора (URI).
    Этот метод является ярлыком для общего падежа чтения документа от системного идентификатора. Это - точный эквивалент следующего:
```
 parse(new InputSource(systemId));
 
```
    Если системным идентификатором является URL, он должен быть полностью разрешен приложением прежде, чем его передадут к синтаксическому анализатору.
    Параметры:
    systemId - Системный идентификатор (URI).
    
    Броски:
    
    SAXException - Любое исключение SAX, возможно обертывая другое исключение.
    
    IOException - Исключение IO из синтаксического анализатора, возможно из потока байтов или символьного потока предоставляется приложением.
    См. Также:
    parse(org.xml.sax.InputSource)

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

Интерфейсный Синтаксический анализатор

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

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

setLocale

setEntityResolver

setDTDHandler

setDocumentHandler

setErrorHandler

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

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