Interfaccia SQLXML
A partire dalla versione 2.0, il driver JDBC per Microsoft SQL Server offre il supporto per l'API di JDBC 4.0, in cui viene presentata l'interfaccia SQLXML. Tale interfaccia definisce i metodi per interagire e modificare i dati XML. Il tipo di dati SQLXML è mappato al tipo di dati xml di SQL Server.
L'interfaccia SQLXML fornisce i metodi per accedere al valore XML come String, Reader o Writer, oppure come Stream. È inoltre possibile accedere al valore XML tramite Source oppure impostarlo come Result, che vengono 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.
Nella tabella seguente sono descritti i metodi definiti nell'interfaccia SQLXML:
| Sintassi del metodo | Descrizione del metodo |
|---|---|
Consente di liberare l'oggetto SQLXML e di rilasciare le risorse da questo bloccate. |
|
Restituisce un flusso di input per la lettura di dati da SQLXML. |
|
Restituisce i dati XML sotto forma di oggetto java.io.Reader o di flusso di caratteri. |
|
Restituisce un elemento Source per la lettura del valore XML specificato dall'oggetto SQLXML. .gif "Nota") 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.
|
|
Restituisce una rappresentazione di stringa del valore XML indicato dall'oggetto SQLXML. |
|
Recupera un flusso che può essere utilizzato per scrivere il valore XML rappresentato dall'oggetto SQLXML. |
|
Restituisce un flusso da utilizzare per scrivere il valore XML rappresentato dall'oggetto SQLXML. |
|
Restituisce un elemento Result per l'impostazione del valore XML specificato dall'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.
|
|
Imposta il valore XML indicato dall'oggetto SQLXML sulla rappresentazione String 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.
Quando l'applicazione chiama uno dei seguenti metodi di richiamo, l'oggetto SQLXML diventa inaccessibile in lettura o scrittura: getSource, getCharacterStream, getBinaryStream e getString.
Quando l'applicazione chiama uno dei seguenti metodi di impostazione, l'oggetto SQLXML diventa inaccessibile in lettura o scrittura: setResult, setCharacterStream, setBinaryStream e setString.
Per ulteriori informazioni sull'interfaccia SQLXML, visitare il sito Web Sun Microsystems.