SQLXML

public interface SQLXML

JavaTM编程语言中针对SQL XML类型的映射。 XML是一种内置类型，它将XML值作为列值存储在数据库表的一行中。 默认情况下，驱动程序将SQLXML对象实现为XML数据的逻辑指针，而不是数据本身。 SQLXML对象在创建它的事务期间有效。

SQLXML接口提供了以String，Reader或Writer或Stream的形式访问XML值的方法。 XML值也可以通过Source访问或设置为Result，这些XML值用于DOM，SAX和StAX等XML解析器API，以及XSLT转换和XPath评估。

接口ResultSet，CallableStatement和PreparedStatement中的方法（如getSQLXML）允许程序员访问XML值。 另外，这个接口还有更新XML值的方法。

SQLXML实例的XML值可以使用BinaryStream获取

   SQLXML sqlxml = resultSet.getSQLXML(column);
   InputStream binaryStream = sqlxml.getBinaryStream();
 

   DocumentBuilder parser = DocumentBuilderFactory.newInstance().newDocumentBuilder();
   Document result = parser.parse(binaryStream);
 

   SAXParser parser = SAXParserFactory.newInstance().newSAXParser();
   parser.parse(binaryStream, myHandler);
 

   XMLInputFactory factory = XMLInputFactory.newInstance();
   XMLStreamReader streamReader = factory.createXMLStreamReader(binaryStream);
 

因为数据库可能使用XML的优化表示法，所以通过getSource（）和setResult（）访问值可以提高处理性能，而无需序列化为流表示并解析XML。

例如，要获取DOM文档节点：

   DOMSource domSource = sqlxml.getSource(DOMSource.class);
   Document document = (Document) domSource.getNode();
 

   DOMResult domResult = sqlxml.setResult(DOMResult.class);
   domResult.setNode(myNode);
 

   SAXSource saxSource = sqlxml.getSource(SAXSource.class);
   XMLReader xmlReader = saxSource.getXMLReader();
   xmlReader.setContentHandler(myHandler);
   xmlReader.parse(saxSource.getInputSource());
 

   SAXResult saxResult = sqlxml.setResult(SAXResult.class);
   ContentHandler contentHandler = saxResult.getXMLReader().getContentHandler();
   contentHandler.startDocument();
   // set the XML elements and attributes into the result
   contentHandler.endDocument();
 

   StAXSource staxSource = sqlxml.getSource(StAXSource.class);
   XMLStreamReader streamReader = staxSource.getXMLStreamReader();
 

   StAXResult staxResult = sqlxml.setResult(StAXResult.class);
   XMLStreamWriter streamWriter = staxResult.getXMLStreamWriter();
 

   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 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);
 

   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);
 

   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 domSource = new DOMSource(domResult.getNode());
 

不完整或无效的XML值可能在设置时导致SQLException，或者在执行execute（）时发生异常。 所有流必须在execute（）发生之前关闭，否则将引发SQLException。

从一个SQLXML对象读取或写入XML值最多只能发生一次。 可读和不可读的概念状态决定了其中一个读API将返回一个值还是抛出一个异常。 可写和不可写的概念状态决定了其中一个写API将设置值或抛出异常。

getBinaryStream（），getCharacterStream（），getSource（）和getString（）会调用free（）或任何读取API时，状态从可读性变为不可读性。 当发生这种情况时，实现也可能会将状态更改为不可写。

setBinaryStream（），setCharacterStream（），setResult（）和setString（），一旦free（）或任何写入API被调用，状态就从可写入移动到不可写入状态。 当这种情况发生时，实现也可能会将状态更改为不可读。

如果JDBC驱动程序支持数据类型，则必须完全实现 SQLXML接口上的所有方法。

Summary

Public methods

void free ()

InputStream getBinaryStream ()

Reader getCharacterStream ()

T getSource (Class<T> sourceClass)

   SAXSource saxSource = sqlxml.getSource(SAXSource.class);
   XMLReader xmlReader = saxSource.getXMLReader();
   xmlReader.setContentHandler(myHandler);
   xmlReader.parse(saxSource.getInputSource());
 

   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
 

String getString ()

OutputStream setBinaryStream ()

Writer setCharacterStream ()

T setResult (Class<T> resultClass)

   SAXResult saxResult = sqlxml.setResult(SAXResult.class);
   ContentHandler contentHandler = saxResult.getXMLReader().getContentHandler();
   contentHandler.startDocument();
   // set the XML elements and attributes into the result
   contentHandler.endDocument();
 

   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
 

void setString (String value)