SQLXML-Schnittstelle
JDBC Driver bietet Unterstützung für die JDBC 4.0-API, in der die java.sql.SQLXML-Schnittstelle eingeführt wird. Die SQLXML-Schnittstelle definiert Methoden für die Interaktion mit und die Bearbeitung von XML-Daten. Der Datentyp SQLXML ist dem SQL Server-Datentypen xml zugeordnet.
Die SQLXML-Schnittstelle stellt Methoden für den Zugriff auf den XML-Wert als String, Reader, Writer oder als Stream bereit. Der Zugriff auf den XML-Wert ist auch über eine Quelle möglich, und er kann als Ergebnis 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.
Bemerkungen
In der folgenden Tabelle werden die in der SQLXML-Schnittstelle definierten Methoden beschrieben:
| Methodensyntax | Methodenbeschreibung |
|---|---|
| void free() | Mit dieser Methode werden das SQLXML-Objekt und die von diesem verwendeten Ressourcen freigegeben. |
| InputStream getBinaryStream() | Gibt einen Eingabedatenstrom zum Lesen von Daten aus dem SQLXML zurück. |
| Reader getCharacterStream() | Gibt die XML-Daten als java.io.Reader-Objekt oder als Zeichendatenstrom zurück. |
| T extends Source T getSource(Class<T> sourceClass) | Gibt eine Quelle zum Lesen des XML-Werts zurück, der von diesem SQLXML-Objekt angegeben wird Hinweis: Die Methode „getSource“ unterstützt die folgenden Quellen: javax.xml.transform.dom.DOMSource, javax.xml.transform.sax.SAXSource, javax.xml.transform.stax.StAXSource und java.io.InputStream. |
| String getString() | Gibt eine Zeichenfolgendarstellung des XML-Werts zurück, der von diesem SQLXML-Objekt angegeben wird. |
| OutputStream setBinaryStream() | Ruft einen Datenstrom ab, der zum Schreiben des XML-Werts verwendet werden kann, der von diesem SQLXML-Objekt angegeben wird. |
| Writer setCharacterStream() | Gibt einen Datenstrom zurück, der zum Schreiben des XML-Werts verwendet werden kann, der von diesem SQLXML-Objekt angegeben wird. |
| T extends Result T setResult(Class<T> resultClass) | Gibt ein Ergebnis zum Festlegen des XML-Werts zurück, der von diesem SQLXML-Objekt angegeben wird Hinweis: Die Methode „setResult“ unterstützt die folgenden Quellen: javax.xml.transform.dom.DOMResult, javax.xml.transform.sax.SAXResult, javax.xml.transform.stax.StaxResult und java.io.OutputStream. |
| void setString(String value) | 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 Methode „free()“ 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 Festlegemethoden kann das SQLXML-Objekt nicht mehr gelesen oder geschrieben werden: setResult, setCharacterStream, setBinaryStream und setString.