Класс 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` с использованием `InputSource` SAX.
`SAXSource(XMLReader reader, InputSource inputSource)`	Создает `SAXSource` с использованием `XMLReader` и InputSource SAX.

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

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

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект «равным» этому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удален в будущей версии. Финализация устарела и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого объекта `Object`.
`int`	`hashCode()`	Возвращает значение хеш-кода для этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

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 и InputSource SAX. Transformer или SAXTransformerFactory назначит себя в качестве ContentHandler средства чтения, а затем вызовет reader.parse(inputSource).

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

SAXSource

public SAXSource(InputSource inputSource)

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

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

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

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)

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

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

getInputSource

public InputSource getInputSource()

Возвращает InputSource SAX, который будет использоваться для 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)

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

Параметры:: source - Должна быть задана ненулевая ссылка на 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.