SQLXML-Schnittstelle
Ab Microsoft SQL Server JDBC Driver, Version 2.0, unterstützt der JDBC-Treiber die JDBC 4.0-API, in der die SQLXML-Schnittstelle eingeführt wurde. Die SQLXML-Schnittstelle definiert Methoden für die Interaktion mit und die Bearbeitung von XML-Daten. Der SQLXML-Typ entspricht dem SQL Server-Datentyp xml.
Die SQLXML-Schnittstelle bietet Methoden für den Zugriff auf den XML-Wert als String, Reader, Writer oder Stream. Der Zugriff auf den XML-Wert ist auch über Source möglich, und er kann als Result festgelegt werden. Diese werden mit XML-Parser-APIs wie DOM (Document Object Model), SAX (Simple API for XML) und StAX (Streaming API for XML) sowie mit XSLT-Transformationen und XPath verwendet.
In der folgenden Tabelle werden die in der SQLXML-Schnittstelle definierten Methoden beschrieben:
| Methodensyntax | Methodenbeschreibung |
|---|---|
Mit dieser Methode werden das SQLXML-Objekt und die von diesem verwendeten Ressourcen freigegeben. |
|
Gibt einen Eingabedatenstrom zum Lesen von Daten aus dem SQLXML zurück. |
|
Gibt die XML-Daten als java.io.Reader-Objekt oder als Zeichendatenstrom zurück. |
|
Gibt eine Source zum Lesen des XML-Werts zurück, der von diesem SQLXML-Objekt angegeben wird. .gif "Hinweis") Hinweis:
Die getSource-Methode unterstützt die folgenden Quellen: javax.xml.transform.dom.DOMSource, javax.xml.transform.sax.SAXSource, javax.xml.transform.stax.StAXSource und java.io.InputStream.
|
|
Gibt eine Zeichenfolgendarstellung des XML-Werts zurück, der von diesem SQLXML-Objekt angegeben wird. |
|
Ruft einen Datenstrom ab, der zum Schreiben des XML-Werts verwendet werden kann, der von diesem SQLXML-Objekt angegeben wird. |
|
Gibt einen Datenstrom zurück, der zum Schreiben des XML-Werts verwendet werden kann, der von diesem SQLXML-Objekt angegeben wird. |
|
Gibt ein Result zum Festlegen des XML-Werts zurück, der von diesem SQLXML-Objekt angegeben wird. Hinweis:
Die setResult-Methode unterstützt die folgenden Quellen: javax.xml.transform.dom.DOMResult, javax.xml.transform.sax.SAXResult, javax.xml.transform.stax.StaxResult und java.io.OutputStream.
|
|
Legt den von diesem SQLXML-Objekt angegebenen XML-Wert auf die angegebene String-Darstellung fest. |
Die Anwendungen können XML-Werte nur einmal aus einem SQLXML-Objekt lesen bzw. in dieses schreiben.
Nach dem Aufrufen der free()-Methode wird ein SQLXML-Objekt ungültig und kann weder gelesen noch geschrieben werden. Wenn die Anwendung versucht, für das SQLXML-Objekt eine andere Methode als **free()**aufzurufen, wird eine Ausnahme ausgelöst.
Nach dem Aufrufen einer der folgenden Abrufmethoden kann das SQLXML-Objekt nicht mehr gelesen oder geschrieben werden: getSource, getCharacterStream, getBinaryStream und getString.
Nach dem Aufrufen einer der folgenden Festlegungsmethoden kann das SQLXML-Objekt nicht mehr gelesen oder geschrieben werden: setResult, setCharacterStream, setBinaryStream und setString.
Weitere Informationen über die SQLXML-Schnittstelle finden Sie auf der Sun Microsystems-Website.