Класс 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(String)` возвращает true при передаче этого значения в качестве аргумента, Transformer поддерживает входные данные Source этого типа.

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

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

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

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

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

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

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

FEATURE

public static final String FEATURE

Если TransformerFactory.getFeature(String) возвращает true при передаче этого значения в качестве аргумента, Transformer поддерживает входные данные 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.

SAXSource

public SAXSource(InputSource inputSource)

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

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

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

setXMLReader

public void setXMLReader(XMLReader reader)

Задаёт XMLReader, используемый для Source.

Параметры:: reader - Допустимая ссылка на XMLReader или XMLFilter.

getXMLReader

public XMLReader getXMLReader()

Возвращает XMLReader, используемый для Source.

Возвращает:: Допустимую ссылку на XMLReader или XMLFilter либо null.

setInputSource

public void setInputSource(InputSource inputSource)

Задаёт SAX InputSource, используемый для Source.

Параметры:: inputSource - Допустимая ссылка на InputSource.

getInputSource

public InputSource getInputSource()

Возвращает SAX InputSource, используемый для Source.

Возвращает:: Допустимую ссылку на InputSource либо null.

setSystemId

public void setSystemId(String systemId)

Задаёт системный идентификатор для этого Source. Если источник входных данных уже задан, в нём будет установлен системный идентификатор; в противном случае будет создан новый источник входных данных.

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

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

getSystemId

public String getSystemId()

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

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

sourceToInputSource

public static InputSource sourceToInputSource(Source source)

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

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

isEmpty

public boolean isEmpty()

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

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

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

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