Класс 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 из объекта источника.

Методы, объявленные в классе 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, при передаче этого значения в качестве аргумента, трансформер поддерживает вход Source этого типа.

См. также:

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

SAXSource

public SAXSource()

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

См. также:

SAXSource

public SAXSource(XMLReader reader, InputSource inputSource)

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

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

SAXSource

public SAXSource(InputSource inputSource)

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

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

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

setXMLReader

public void setXMLReader(XMLReader reader)

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

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

getXMLReader

public XMLReader getXMLReader()

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

Returns:: Действительная ссылка на XMLReader или XMLFilter, или null.

setInputSource

public void setInputSource(InputSource inputSource)

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

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

getInputSource

public InputSource getInputSource()

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

Returns:: Действительная ссылка на InputSource, или null.

УстановитьИдентификаторСистемы

public void setSystemId(String systemId)

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

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

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

ПолучитьИдентификаторСистемы

public String getSystemId()

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

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

sourceToInputSource

public static InputSource sourceToInputSource(Source source)

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

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

isEmpty

public boolean isEmpty()

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

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

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

© 1993, 2023, 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/21/docs/api/java.xml/javax/xml/transform/sax/SAXSource.html