SQLXML (Платформа Java SE 7)

```
public interface SQLXML
```
Отображение в языке программирования JavaTM для типа XML SQL. XML является встроенным типом, который хранит значение XML как значение столбца подряд таблицы базы данных. Драйверами по умолчанию реализуют объект SQLXML как логический указатель на данные XML, а не данные непосредственно. Объект SQLXML допустим для продолжительности транзакции, в которой это создавалось.
Интерфейс SQLXML обеспечивает методы для того, чтобы они получили доступ к значению XML как к Строке, Читателю или Писателю, или как Поток. К значению XML можно также получить доступ через Источник или установлено в результате, которые используются с XML API Синтаксического анализатора, такие как ДОМ, SAX, и StAX, так же как с XSLT преобразовывает и оценки XPath.
Методы в интерфейсах ResultSet, CallableStatement, и PreparedStatement, таких как getSQLXML позволяют программисту получать доступ к значению XML. Кроме того, у этого интерфейса есть методы для того, чтобы обновить значение XML.
Значение XML экземпляра SQLXML может быть получено как использование BinaryStream
```
   SQLXML sqlxml = resultSet.getSQLXML(column);
   InputStream binaryStream = sqlxml.getBinaryStream();
 
```
Например, чтобы проанализировать значение XML с синтаксическим анализатором ДОМА:
```
   DocumentBuilder parser = DocumentBuilderFactory.newInstance().newDocumentBuilder();
   Document result = parser.parse(binaryStream);
 
```
или проанализировать значение XML с синтаксическим анализатором SAX к Вашему обработчику:
```
   SAXParser parser = SAXParserFactory.newInstance().newSAXParser();
   parser.parse(binaryStream, myHandler);
 
```
или проанализировать значение XML с синтаксическим анализатором StAX:
```
   XMLInputFactory factory = XMLInputFactory.newInstance();
   XMLStreamReader streamReader = factory.createXMLStreamReader(binaryStream);
 
```
Поскольку базы данных могут использовать оптимизированное представление для XML, получая доступ к значению через getSource (), и setResult () может привести к улучшенной производительности обработки, не сериализируя к потоковому представлению и анализируя XML.
Например, чтобы получить Узел ДОМА Докьюмнта:
```
   DOMSource domSource = sqlxml.getSource(DOMSource.class);
   Document document = (Document) domSource.getNode();
 
```
или установить значение в Узел ДОМА Докьюмнта к myNode:
```
   DOMResult domResult = sqlxml.setResult(DOMResult.class);
   domResult.setNode(myNode);
 
```
или, чтобы отправить события SAX Вашему обработчику:
```
   SAXSource saxSource = sqlxml.getSource(SAXSource.class);
   XMLReader xmlReader = saxSource.getXMLReader();
   xmlReader.setContentHandler(myHandler);
   xmlReader.parse(saxSource.getInputSource());
 
```
или, чтобы установить значение результата от событий SAX:
```
   SAXResult saxResult = sqlxml.setResult(SAXResult.class);
   ContentHandler contentHandler = saxResult.getXMLReader().getContentHandler();
   contentHandler.startDocument();
   // set the XML elements and attributes into the result
   contentHandler.endDocument();
 
```
или, чтобы получить события StAX:
```
   StAXSource staxSource = sqlxml.getSource(StAXSource.class);
   XMLStreamReader streamReader = staxSource.getXMLStreamReader();
 
```
или, чтобы установить значение результата от событий StAX:
```
   StAXResult staxResult = sqlxml.setResult(StAXResult.class);
   XMLStreamWriter streamWriter = staxResult.getXMLStreamWriter();
 
```
или, чтобы выполнить преобразования XSLT на значении XML, используя XSLT в выводе xsltFile к файлу resultFile:
```
   File xsltFile = new File("a.xslt");
   File myFile = new File("result.xml");
   Transformer xslt = TransformerFactory.newInstance().newTransformer(new StreamSource(xsltFile));
   Source source = sqlxml.getSource(null);
   Result result = new StreamResult(myFile);
   xslt.transform(source, result);
 
```
или, чтобы оценить выражение XPath на значении XML:
```
   XPath xpath = XPathFactory.newInstance().newXPath();
   DOMSource domSource = sqlxml.getSource(DOMSource.class);
   Document document = (Document) domSource.getNode();
   String expression = "/foo/@bar";
   String barValue = xpath.evaluate(expression, document);
 
```
Чтобы установить значение XML, чтобы быть результатом XSLT, преобразуйте:
```
   File sourceFile = new File("source.xml");
   Transformer xslt = TransformerFactory.newInstance().newTransformer(new StreamSource(xsltFile));
   Source streamSource = new StreamSource(sourceFile);
   Result result = sqlxml.setResult(null);
   xslt.transform(streamSource, result);
 
```
Любой Источник может быть преобразован к Результату, используя идентификационные данные, преобразовывают определенный, вызывая newTransformer ():
```
   Transformer identity = TransformerFactory.newInstance().newTransformer();
   Source source = sqlxml.getSource(null);
   File myFile = new File("result.xml");
   Result result = new StreamResult(myFile);
   identity.transform(source, result);
 
```
Записать содержание Источника к стандартному выводу:
```
   Transformer identity = TransformerFactory.newInstance().newTransformer();
   Source source = sqlxml.getSource(null);
   Result result = new StreamResult(System.out);
   identity.transform(source, result);
 
```
Создать DOMSource из DOMResult:
```
    DOMSource domSource = new DOMSource(domResult.getNode());
 
```
Неполные или недопустимые значения XML могут вызвать SQLException когда установлено, или исключение может произойти, когда выполняются (), происходит. Все потоки должны быть закрыты, прежде выполняются (), происходит, или SQLException будет брошен.
Чтение и запись XML оценивают, или от SQLXML объект может произойти самое большее однажды. Концептуальные состояния читаемых и не читаемый определяют, возвратит ли один из API чтения значение или выдаст исключение. Концептуальные состояния перезаписываемых и не перезаписываемый определяют, установит ли один из API записи значение или выдаст исключение.
Перемещения состояния от читаемого до не читаемый однажды свободный () или любой из API чтения вызывают: getBinaryStream (), getCharacterStream (), getSource (), и getString (). Реализации могут также изменить состояние на не перезаписываемый, когда это происходит.
Перемещения состояния от перезаписываемого до не writeable однажды свободный () или любой из API записи вызывают: setBinaryStream (), setCharacterStream (), setResult (), и setString (). Реализации могут также изменить состояние на не читаемый, когда это происходит.

Все методы на SQLXML интерфейс должен быть полностью реализован, если драйвер JDBC поддерживает тип данных.
С тех пор:

1.6

См. Также:
javax.xml.parsers, javax.xml.stream, javax.xml.transform, javax.xml.xpath

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`void`	`free()` Этот метод закрывает этот объект и высвобождает средства, которые это содержало.
`InputStream`	`getBinaryStream()` Получает значение XML, определяемое этим экземпляром SQLXML как поток.
`Читатель`	`getCharacterStream()` Получает значение XML, определяемое этим экземпляром SQLXML как java.io. Объект читателя.
`<T extends Source> T`	`getSource(Class<T> sourceClass)` Возвращает Источник для того, чтобы считать значение XML, определяемое этим экземпляром SQLXML.
`Строка`	`getString()` Возвращает строковое представление значения XML, определяемого этим экземпляром SQLXML.
`OutputStream`	`setBinaryStream()` Получает поток, который может использоваться, чтобы записать значение XML, которое представляет этот экземпляр SQLXML.
`Писатель`	`setCharacterStream()` Получает поток, который будет использоваться, чтобы записать значение XML, которое представляет этот экземпляр SQLXML.
`<T extends Result> T`	`setResult(Class<T> resultClass)` Возвращает Результат для того, чтобы установить значение XML, определяемое этим экземпляром SQLXML.
`void`	`setString(String value)` Устанавливает значение XML, определяемое этим экземпляром SQLXML к данному Строковому представлению.

- Деталь метода
  - свободный
```
void free()
          throws SQLException
```
    Этот метод закрывает этот объект и высвобождает средства, которые это содержало. Объект XML SQL становится недопустимым и ни один читаемый или writeable, когда этот метод вызывают. После free был вызван, любая попытка вызвать метод кроме free приведет к a SQLException быть брошенным. Если free вызывается многократно, последующие звонки free обрабатываются как нет.
    
    Броски:
    
    SQLException - если есть ошибка, освобождая значение XML.
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    С тех пор:
    
    1.6
  - getBinaryStream
```
InputStream getBinaryStream()
                            throws SQLException
```
    Получает значение XML, определяемое этим экземпляром SQLXML как поток. Байты входного потока интерпретируются согласно приложению F спецификации XML 1.0. Поведение этого метода является тем же самым как ResultSet.getBinaryStream (), когда у определяемого столбца ResultSet есть тип java.sql. Типы SQLXML.
    Объект XML SQL становится не читаемым, когда этот метод вызывают и может также стать не перезаписываемым в зависимости от реализации.
    
    Возвраты:
    поток, содержащий данные XML.
    
    Броски:
    
    SQLException - если есть ошибка, обрабатывая значение XML. Исключение выдается, если состояние не читаемо.
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    С тех пор:
    
    1.6
  - setBinaryStream
```
OutputStream setBinaryStream()
                             throws SQLException
```
    Получает поток, который может использоваться, чтобы записать значение XML, которое представляет этот экземпляр SQLXML. Поток начинается в позиции 0. Байты потока интерпретируются согласно приложению F спецификации XML 1.0, поведение этого метода является тем же самым как ResultSet.updateBinaryStream (), когда у определяемого столбца ResultSet есть тип java.sql. Типы SQLXML.
    Объект XML SQL становится не writeable, когда этот метод вызывают и может также стать не читаемым в зависимости от реализации.
    
    Возвраты:
    поток, которому могут быть записаны данные.
    
    Броски:
    
    SQLException - если есть ошибка, обрабатывая значение XML. Исключение выдается, если состояние не перезаписываемо.
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    С тех пор:
    
    1.6
  - getCharacterStream
```
Reader getCharacterStream()
                          throws SQLException
```
    Получает значение XML, определяемое этим экземпляром SQLXML как java.io. Объект читателя. Формат этого потока определяется org.xml.sax. InputSource, где символы в потоке представляют unicode кодовые точки для XML согласно разделу 2 и приложение B спецификации XML 1.0. Хотя объявление кодирования кроме unicode может присутствовать, кодирование потока является unicode. Поведение этого метода является тем же самым как ResultSet.getCharacterStream (), когда у определяемого столбца ResultSet есть тип java.sql. Типы SQLXML.
    Объект XML SQL становится не читаемым, когда этот метод вызывают и может также стать не перезаписываемым в зависимости от реализации.
    
    Возвраты:
    поток, содержащий данные XML.
    
    Броски:
    
    SQLException - если есть ошибка, обрабатывая значение XML. getCause () метод исключения может обеспечить более подробное исключение, например, если поток не содержит допустимые символы. Исключение выдается, если состояние не читаемо.
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    С тех пор:
    
    1.6
  - setCharacterStream
```
Writer setCharacterStream()
                          throws SQLException
```
    Получает поток, который будет использоваться, чтобы записать значение XML, которое представляет этот экземпляр SQLXML. Формат этого потока определяется org.xml.sax. InputSource, где символы в потоке представляют unicode кодовые точки для XML согласно разделу 2 и приложение B спецификации XML 1.0. Хотя объявление кодирования кроме unicode может присутствовать, кодирование потока является unicode. Поведение этого метода является тем же самым как ResultSet.updateCharacterStream (), когда у определяемого столбца ResultSet есть тип java.sql. Типы SQLXML.
    Объект XML SQL становится не writeable, когда этот метод вызывают и может также стать не читаемым в зависимости от реализации.
    
    Возвраты:
    поток, которому могут быть записаны данные.
    
    Броски:
    
    SQLException - если есть ошибка, обрабатывая значение XML. getCause () метод исключения может обеспечить более подробное исключение, например, если поток не содержит допустимые символы. Исключение выдается, если состояние не перезаписываемо.
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    С тех пор:
    
    1.6
  - getString
```
String getString()
                 throws SQLException
```
    Возвращает строковое представление значения XML, определяемого этим экземпляром SQLXML. Формат этой Строки определяется org.xml.sax. InputSource, где символы в потоке представляют unicode кодовые точки для XML согласно разделу 2 и приложение B спецификации XML 1.0. Хотя объявление кодирования кроме unicode может присутствовать, кодирование Строки является unicode. Поведение этого метода является тем же самым как ResultSet.getString (), когда у определяемого столбца ResultSet есть тип java.sql. Типы SQLXML.
    Объект XML SQL становится не читаемым, когда этот метод вызывают и может также стать не перезаписываемым в зависимости от реализации.
    
    Возвраты:
    строковое представление значения XML определяется этим экземпляром SQLXML.
    
    Броски:
    
    SQLException - если есть ошибка, обрабатывая значение XML. getCause () метод исключения может обеспечить более подробное исключение, например, если поток не содержит допустимые символы. Исключение выдается, если состояние не читаемо.
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    С тех пор:
    
    1.6
  - setString
```
void setString(String value)
               throws SQLException
```
    Устанавливает значение XML, определяемое этим экземпляром SQLXML к данному Строковому представлению. Формат этой Строки определяется org.xml.sax. InputSource, где символы в потоке представляют unicode кодовые точки для XML согласно разделу 2 и приложение B спецификации XML 1.0. Хотя объявление кодирования кроме unicode может присутствовать, кодирование Строки является unicode. Поведение этого метода является тем же самым как ResultSet.updateString (), когда у определяемого столбца ResultSet есть тип java.sql. Типы SQLXML.
    Объект XML SQL становится не writeable, когда этот метод вызывают и может также стать не читаемым в зависимости от реализации.
    
    Параметры:
    value - значение XML
    
    Броски:
    
    SQLException - если есть ошибка, обрабатывая значение XML. getCause () метод исключения может обеспечить более подробное исключение, например, если поток не содержит допустимые символы. Исключение выдается, если состояние не перезаписываемо.
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    С тех пор:
    
    1.6
  - getSource
```
<T extends Source> T getSource(Class<T> sourceClass)
                           throws SQLException
```
    Возвращает Источник для того, чтобы считать значение XML, определяемое этим экземпляром SQLXML. Источники используются в качестве вводов к синтаксическим анализаторам XML и преобразователям XSLT.
    У источников для синтаксических анализаторов XML будет обработка пространства имен на по умолчанию. systemID Источника является зависящим от реализации.
    Объект XML SQL становится не читаемым, когда этот метод вызывают и может также стать не перезаписываемым в зависимости от реализации.
    Отметьте, что SAX является архитектурой обратного вызова, таким образом, возвращенный SAXSource должен тогда быть установлен с обработчиком содержимого, который получит события SAX от парсинга. Обработчик содержимого получит обратные вызовы, основанные на содержании XML.
```
   SAXSource saxSource = sqlxml.getSource(SAXSource.class);
   XMLReader xmlReader = saxSource.getXMLReader();
   xmlReader.setContentHandler(myHandler);
   xmlReader.parse(saxSource.getInputSource());
 
```
    Параметры:
    sourceClass - Класс источника, или нуль. Если класс будет нулем, то поставщик specifc Исходная реализация будет возвращен. Следующие классы поддерживаются как минимум:
    javax.xml.transform.dom.DOMSource - returns a DOMSource javax.xml.transform.sax.SAXSource - returns a SAXSource javax.xml.transform.stax.StAXSource - returns a StAXSource javax.xml.transform.stream.StreamSource - returns a StreamSource
    Возвраты:
    Источник для того, чтобы считать значение XML.
    
    Броски:
    
    SQLException - если есть ошибка, обрабатывая значение XML или если эта функция не поддерживается. getCause () метод исключения может обеспечить более подробное исключение, например, если исключение синтаксического анализатора XML происходит. Исключение выдается, если состояние не читаемо.
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    С тех пор:
    
    1.6
  - setResult
```
<T extends Result> T setResult(Class<T> resultClass)
                           throws SQLException
```
    Возвращает Результат для того, чтобы установить значение XML, определяемое этим экземпляром SQLXML.
    systemID Результата является зависящим от реализации.
    Объект XML SQL становится не writeable, когда этот метод вызывают и может также стать не читаемым в зависимости от реализации.
    Отметьте, что SAX является архитектурой обратного вызова, и возвращенному SAXResult присваивали обработчик содержимого, который получит события SAX, основанные на содержании XML. Вызовите обработчик содержимого с содержанием XML-документа, чтобы присвоить значения.
```
   SAXResult saxResult = sqlxml.setResult(SAXResult.class);
   ContentHandler contentHandler = saxResult.getXMLReader().getContentHandler();
   contentHandler.startDocument();
   // set the XML elements and attributes into the result
   contentHandler.endDocument();
 
```
    Параметры:
    resultClass - Класс результата, или нуль. Если resultClass будет нулем, поставщик, то определенная реализация Результата будет возвращена. Следующие классы поддерживаются как минимум:
    javax.xml.transform.dom.DOMResult - returns a DOMResult javax.xml.transform.sax.SAXResult - returns a SAXResult javax.xml.transform.stax.StAXResult - returns a StAXResult javax.xml.transform.stream.StreamResult - returns a StreamResult
    Возвраты:
    Возвращает Результат для того, чтобы установить значение XML.
    
    Броски:
    
    SQLException - если есть ошибка, обрабатывая значение XML или если эта функция не поддерживается. getCause () метод исключения может обеспечить более подробное исключение, например, если исключение синтаксического анализатора XML происходит. Исключение выдается, если состояние не перезаписываемо.
    
    SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
    С тех пор:
    
    1.6

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Интерфейсный SQLXML

Сводка метода

Деталь метода

свободный

getBinaryStream

setBinaryStream

getCharacterStream

setCharacterStream

getString

setString

getSource

setResult