Класс 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 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, когда этот параметр передаётся в качестве аргумента, трансформер поддерживает входной источник этого типа.

См. также:: Значения константных полей

Конструкторы

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-ввода, которая должна быть не равной 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 или системный идентификатор), с которого будут разрешаться 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