Interfaccia SQLXML
Con il driver JDBC viene fornito supporto per l'API di JDBC 4.0, in cui viene presentata l'interfaccia java.sql.SQLXML. Tale interfaccia definisce i metodi per interagire e modificare i dati XML. Il tipo di dati SQLXML viene mappato al tipo di dati xml di SQL Server.
L'interfaccia SQLXML offre metodi per accedere al valore XML come Stringa, Lettore o Scrittore oppure come Flusso. È inoltre possibile accedere al valore XML tramite Origine oppure impostarlo come Risultato, utilizzati con le API dei parser XML, tra cui Document Object Model (DOM), Simple API for XML (SAX) e Streaming API for XML (StAX), nonché con trasformazioni XSLT e XPath.
Osservazioni:
Nella tabella seguente sono descritti i metodi definiti nell'interfaccia SQLXML:
| Sintassi del metodo | Descrizione del metodo |
|---|---|
| void free() | Consente di liberare l'oggetto SQLXML e di rilasciare le risorse da questo bloccate. |
| InputStream getBinaryStream() | Restituisce un flusso di input per la lettura di dati da SQLXML. |
| Reader getCharacterStream() | Restituisce i dati XML come oggetto java.io.Reader o come flusso di caratteri. |
| T extends Source T getSource(Class<T> sourceClass) | Restituisce un Source per la lettura del valore XML specificato da questo oggetto SQLXML. Nota: Il metodo getSource supporta le seguenti origini: javax.xml.transform.dom.DOMSource, javax.xml.transform.sax.SAXSource, javax.xml.transform.stax.StAXSource e java.io.InputStream. |
| String getString() | Restituisce una rappresentazione di stringa del valore XML indicato dall'oggetto SQLXML. |
| OutputStream setBinaryStream() | Recupera un flusso che può essere utilizzato per scrivere il valore XML rappresentato dall'oggetto SQLXML. |
| Writer setCharacterStream() | Restituisce un flusso da utilizzare per scrivere il valore XML rappresentato dall'oggetto SQLXML. |
| T extends Result T setResult(Class<T> resultClass) | Restituisce un Result per l'impostazione del valore XML specificato da questo oggetto SQLXML. Nota: Il metodo setResult supporta le seguenti origini: javax.xml.transform.dom.DOMResult, javax.xml.transform.sax.SAXResult, javax.xml.transform.stax.StaxResult e java.io.OutputStream. |
| void setString(String value) | Imposta il valore XML indicato dall'oggetto SQLXML sulla rappresentazione Stringa specificata. |
Le applicazioni possono leggere e scrivere valori XML da e in un oggetto SQLXML una sola volta.
Quando viene chiamato il metodo free(), un oggetto SQLXML diventa non valido e non è accessibile in lettura o scrittura. Se l'applicazione tenta di richiamare su tale oggetto SQLXML un metodo diverso da free(), verrà generata un'eccezione.
L'oggetto SQLXML diventa inaccessibile in lettura o scrittura quando l'applicazione chiama uno dei seguenti metodi getter: getSource, getCharacterStream, getBinaryStream e getString.
L'oggetto SQLXML diventa inaccessibile in lettura o scrittura quando l'applicazione chiama uno dei seguenti metodi setter: setResult, setCharacterStream, setBinaryStream e setString.