Класс 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, когда в качестве аргумента передаётся это значение, преобразователь поддерживает входные данные 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 или системного ID), с которого будут разрешаться 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.

Методы, объявленные в классе 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.parse(inputSource).

Параметры:: reader - XMLReader, используемый для разбора.; inputSource - Ссылка на источник SAX входных данных, которая не должна быть null и которая будет передана методу 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, используемого для 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. Если источник входных данных уже задан, он установит системный ID для этого источника, иначе он создаст новый источник входных данных.

Идентификатор системы необязателен, если есть байтовый поток или строковый поток, но всё же полезно предоставить его, так как приложение может использовать его для разрешения относительных 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, 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://download.java.net/java/early_access/jdk24/docs/api/java.xml/javax/xml/transform/sax/SAXSource.html