Интерфейс SQLXML

  • Статья

Скачать драйвер JDBC

Драйвер JDBC обеспечивает поддержку API JDBC 4.0, который реализует интерфейс java.sql.SQLXML. Интерфейс SQLXML определяет методы для обмена данными XML и их обработки. Тип данных SQLXML сопоставляется с типом данных SQL Serverxml.

Интерфейс SQLXML предоставляет методы для доступа к значению XML в формате String, Reader или Writer, а также Stream. Обратиться к значению XML можно также через свойство Source, а задать его — через свойство Result. Эти свойства используются интерфейсами API синтаксического анализатора XML, такими как модель DOM, простой интерфейс API для XML (SAX) и потоковый интерфейс API для XML (StAX), а также преобразованиями XSLT и XPath.

Remarks

В следующей таблице приводится описание методов, определенных в интерфейсе SQLXML.

Синтаксис метода Описание метода
void free() Этот метод освобождает объект SQLXML и ресурсы, занятые им.
InputStream getBinaryStream() Возвращает входной поток для чтения данных из SQLXML.
Reader getCharacterStream() Возвращает данные XML в виде объекта java.io.Reader или потока символов.
T extends Source T getSource(Class<T> sourceClass) Возвращает объект Source (источник) для чтения значения XML, заданного этим объектом SQLXML.

Примечание. Метод getSource поддерживает следующие источники: javax.xml.transform.dom.DOMSource, javax.xml.transform.sax.SAXSource, javax.xml.transform.stax.StAXSource и java.io.InputStream.
String getString() Возвращает строковое представление значения XML, указанного данным объектом SQLXML.
OutputStream setBinaryStream() Извлекает поток, который может быть использован для записи значения XML, представляемого данным объектом SQLXML.
Writer setCharacterStream() Возвращает поток, который должен быть использован для записи значения XML, представляемого данным объектом SQLXML.
T extends Result T setResult(Class<T> resultClass) Возвращает объект Result (результат) для записи значения XML, заданного этим объектом SQLXML.

Примечание. Метод setResult поддерживает следующие источники: javax.xml.transform.dom.DOMResult, javax.xml.transform.sax.SAXResult, javax.xml.transform.stax.StaxResult и java.io.OutputStream.
void setString(String value) Задает значение XML, назначенное данным объектом SQLXML для указанного представления String.

Приложения могут читать XML-значения в объекте SQLXML или записывать их только один раз.

При вызове метода free() объект SQLXML становится недействительным: его больше нельзя прочесть или записать в него значения. Если приложение пытается вызвать для этого объекта SQLXML метод, отличный от метода free(), возникает исключение.

Объект SQLXML больше нельзя будет прочесть или записать в него значения, если приложение вызовет любой из следующих методов считывания: getSource, getCharacterStream, getBinaryStream или getString.

Объект SQLXML больше нельзя будет прочесть или записать в него значения, если приложение вызовет любой из следующих методов записи: setResult, setCharacterStream, setBinaryStream или setString.

См. также раздел

Поддержка данных XML