Freigeben über


SQLXML-Schnittstelle

JDBC-Treiber herunterladen

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.

Weitere Informationen:

Unterstützen von XML-Daten