Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 erweitert 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 erweitert 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.