Интерфейс XMLReader

Ищет значение флага функциональности.

Имя функциональности — это любой полностью определённый URI. XMLReader может распознавать имя функциональности, но временно быть не в состоянии вернуть его значение. Некоторые значения функциональности могут быть доступны только в определённых контекстах, таких как до, во время или после анализа. Кроме того, некоторые значения функциональности могут быть недоступны программным способом. (В случае адаптера для SAX1 Parser, нет независимого от реализации способа показать, выполняет ли базовый анализатор валидацию, разворачивает ли внешние сущности и так далее.)

Все XMLReaders обязаны распознавать имена функциональности http://xml.org/sax/features/namespaces и http://xml.org/sax/features/namespace-prefixes.

Типичное использование выглядит примерно так:

XMLReader r = new MySAXDriver();

                         // try to activate validation
 try {
   r.setFeature("http://xml.org/sax/features/validation", true);
 } catch (SAXException e) {
   System.err.println("Cannot activate validation.");
 }

                         // register event handlers
 r.setContentHandler(new MyContentHandler());
 r.setErrorHandler(new MyErrorHandler());

                         // parse the first document
 try {
   r.parse("http://www.foo.com/mydoc.xml");
 } catch (IOException e) {
   System.err.println("I/O exception reading XML document");
 } catch (SAXException e) {
   System.err.println("XML exception reading document.");
 }

Разработчики могут свободно (и им это рекомендуется) создавать свои собственные функциональности, используя имена, основанные на своих собственных URI.

Устанавливает значение флага функциональности.

Имя функциональности — это любой полностью определённый URI. XMLReader может предоставлять значение функциональности, но быть не в состоянии изменить текущее значение. Некоторые значения функциональности могут быть неизменяемыми или изменяемыми только в определённых контекстах, таких как до, во время или после анализа.

Все XMLReaders обязаны поддерживать установку http://xml.org/sax/features/namespaces в true и http://xml.org/sax/features/namespace-prefixes в false.

Ищет значение свойства.

Имя свойства — это любой полностью определённый URI. XMLReader может распознавать имя свойства, но временно быть не в состоянии вернуть его значение. Некоторые значения свойств могут быть доступны только в определённых контекстах, таких как до, во время или после анализа.

XMLReaders не обязаны распознавать какие-либо конкретные имена свойств, хотя начальный основной набор документирован для SAX2.

Разработчики могут свободно (и им это рекомендуется) создавать свои собственные свойства, используя имена, основанные на своих собственных URI.

Устанавливает значение свойства.

Имя свойства — это любой полностью определённый URI. XMLReader может распознавать имя свойства, но быть не в состоянии изменить текущее значение. Некоторые значения свойств могут быть неизменяемыми или изменяемыми только в определённых контекстах, таких как до, во время или после анализа.

XMLReaders не обязаны распознавать установку каких-либо конкретных имён свойств, хотя основной набор определён SAX2.

Этот метод также является стандартным механизмом для установки расширенных обработчиков.

Позволяет приложению зарегистрировать решатель сущностей.

Если приложение не регистрирует решатель сущностей, XMLReader будет выполнять собственное разрешение по умолчанию.

Приложения могут зарегистрировать новый или другой решатель в середине анализа, и SAX-анализатор должен начать использовать новый решатель немедленно.

Позволяет приложению зарегистрировать обработчик событий DTD.

Если приложение не регистрирует обработчик DTD, все события DTD, сообщённые SAX-анализатором, будут молча игнорироваться.

Приложения могут зарегистрировать новый или другой обработчик в середине анализа, и SAX-анализатор должен начать использовать новый обработчик немедленно.

Позволяет приложению зарегистрировать обработчик событий контента.

Если приложение не регистрирует обработчик контента, все события контента, сообщённые SAX-анализатором, будут молча игнорироваться.

Приложения могут зарегистрировать новый или другой обработчик в середине анализа, и SAX-анализатор должен начать использовать новый обработчик немедленно.

Позволяет приложению зарегистрировать обработчик событий ошибок.

Если приложение не регистрирует обработчик ошибок, все события ошибок, сообщённые SAX-анализатором, будут молча игнорироваться; однако, нормальная обработка может не продолжиться. Настоятельно рекомендуется, чтобы все SAX-приложения реализовали обработчик ошибок, чтобы избежать непредвиденных ошибок.

Приложения могут зарегистрировать новый или другой обработчик в середине анализа, и SAX-анализатор должен начать использовать новый обработчик немедленно.

Разбирает XML-документ.

Приложение может использовать этот метод, чтобы указать XML-читателю начать разбор XML-документа из любого допустимого источника ввода (поток символов, байтовый поток или URI).

Приложения не могут вызывать этот метод во время анализа (вместо этого они должны создавать новый XMLReader для каждого вложенного XML-документа). После завершения анализа приложение может повторно использовать один и тот же объект XMLReader, возможно, с другим источником ввода. Конфигурация объекта XMLReader (например, привязки обработчиков и значения, установленные для флагов функциональности и свойств), не изменяется по завершении анализа, если только определение этого аспекта конфигурации явно не указывает другое поведение. (Например, флаги функциональности или свойства, показывающие характеристики анализируемого документа.)

Во время анализа XMLReader будет предоставлять информацию о XML-документе через зарегистрированные обработчики событий.

Этот метод является синхронным: он не вернётся, пока не закончится разбор. Если клиентское приложение хочет преждевременно завершить разбор, оно должно выбросить исключение.

Разбирает XML-документ из системного идентификатора (URI).

Этот метод является сокращением для распространённого случая чтения документа из системного идентификатора. Он является точным эквивалентом следующего:

parse(new InputSource(systemId));

Если системный идентификатор является URL, он должен быть полностью разрешён приложением, прежде чем он будет передан анализатору.