compact2, compact3

org.xml.sax

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

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

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)