Класс SAXSource

java.lang.Object

javax.xml.transform.sax.SAXSource

Все реализованные интерфейсы:: Source

public class SAXSource extends Object implements Source

Выступает в роли держателя источника SAX.

Обратите внимание, что XSLT требует поддержки пространств имён. Попытка преобразования входного источника, который не сгенерирован с помощью парсера, поддерживающего пространства имён, может привести к ошибкам. Парсеры могут быть сделаны поддерживающими пространства имён путём вызова метода SAXParserFactory.setNamespaceAware(boolean awareness).

С момента:: 1.4

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final String`	`FEATURE`	Если `TransformerFactory.getFeature(java.lang.String)` возвращает true при передаче этого значения в качестве аргумента, трансформатор поддерживает входной источник этого типа.

Краткое описание конструкторов

Конструктор	Описание
`SAXSource()`	Конструктор по умолчанию без аргументов.
`SAXSource(InputSource inputSource)`	Создаёт `SAXSource`, используя SAX `InputSource`.
`SAXSource(XMLReader reader, InputSource inputSource)`	Создаёт `SAXSource`, используя `XMLReader` и SAX InputSource.

Краткое описание методов

Модификатор и тип	Метод	Описание
`InputSource`	`getInputSource()`	Получить SAX InputSource, который будет использоваться для источника.
`String`	`getSystemId()`	Получить базовый идентификатор (URI или системный идентификатор), из которого будут разрешаться URI.
`XMLReader`	`getXMLReader()`	Получить XMLReader, который будет использоваться для источника.
`boolean`	`isEmpty()`	Указывает, является ли объект `SAXSource` пустым.
`void`	`setInputSource(InputSource inputSource)`	Установить SAX InputSource, который будет использоваться для источника.
`void`	`setSystemId(String systemId)`	Установить системный идентификатор для этого источника.
`void`	`setXMLReader(XMLReader reader)`	Установить XMLReader, который будет использоваться для источника.
`static InputSource`	`sourceToInputSource(Source source)`	Попытка получить объект SAX InputSource из объекта Source.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей

FEATURE

public static final String FEATURE

Если TransformerFactory.getFeature(java.lang.String) возвращает true при передаче этого значения в качестве аргумента, Transformer поддерживает входные данные типа Source.

См. также:

Значения константных полей

Подробное описание конструкторов

SAXSource

public SAXSource()

Конструктор по умолчанию без аргументов. Если используется этот конструктор, и источник SAX не установлен с помощью setInputSource(InputSource inputSource), то Transformer создаст пустой источник InputSource с помощью new InputSource().

См. также:

Transformer.transform(Source xmlSource, Result outputTarget)

SAXSource

public SAXSource(XMLReader reader, InputSource inputSource)

Создает SAXSource, используя XMLReader и SAX InputSource. Transformer или SAXTransformerFactory установит себя в качестве обработчика ContentHandler читателя, а затем вызовет reader.parse(inputSource).

Параметры:: reader - XMLReader, который будет использоваться для разбора.; inputSource - Ссылка на источник SAX Input, которая должна быть не null и будет передана методу reader parse.

SAXSource

public SAXSource(InputSource inputSource)

Создаёт SAXSource, используя SAX InputSource. Transformer или SAXTransformerFactory создаёт читатель (если setXMLReader не используется), устанавливает себя как обработчик событий ContentHandler читателя и вызывает reader.parse(inputSource).

Параметры:: inputSource - Ссылка на источник ввода, которая должна быть не null и будет передана методу parse читателя.

Подробное описание методов

setXMLReader

public void setXMLReader(XMLReader reader)

Устанавливает XMLReader, который будет использоваться для источника.

Параметры:: reader - Действительная ссылка на XMLReader или XMLFilter.

getXMLReader

public XMLReader getXMLReader()

Возвращает XMLReader, который будет использоваться для источника.

Возвращает:: Действительная ссылка на XMLReader или XMLFilter, или null.

setInputSource

public void setInputSource(InputSource inputSource)

Устанавливает SAX InputSource, который будет использоваться для источника.

Параметры:: inputSource - Действительная ссылка на InputSource.

getInputSource

public InputSource getInputSource()

Возвращает SAX InputSource, который будет использоваться для источника.

Возвращает:: Действительная ссылка на InputSource, или null.

setSystemId

public void setSystemId(String systemId)

Устанавливает идентификатор системы для этого источника. Если источник ввода уже задан, он установит идентификатор системы или для этого источника ввода, иначе создаст новый источник ввода.

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

Определено в:: setSystemId в интерфейсе Source
Параметры:: systemId - Идентификатор системы как строка URI.

getSystemId

public String getSystemId()

Получить базовый идентификатор (URI или системный ID), из которого будут разрешаться URI.

Определено в:: getSystemId в интерфейсе Source
Возвращает:: Базовый URL для Source, или null.

sourceToInputSource

public static InputSource sourceToInputSource(Source source)

Попытка получить объект SAX InputSource из объекта Source.

Параметры:: source - Должен быть ссылкой на объект Source, не равной null.
Возвращает:: Объект InputSource или null, если объект Source преобразовать нельзя.

isEmpty

public boolean isEmpty()

Указывает, пуст ли объект SAXSource. Пустым считается, если:

идентификатор системы и InputSource равны null;
идентификатор системы равен null, а InputSource пуст.

Определено в:: isEmpty в интерфейсе Source
Возвращает:: true, если объект SAXSource пуст, иначе false

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.xml/javax/xml/transform/sax/SAXSource.html