Condividi tramite


Interfaccia SQLXML

Scaricare il driver JDBC

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.

Vedi anche

Supporto dei dati XML