Antarmuka SQLXML
Driver JDBC menyediakan dukungan untuk API JDBC 4.0, yang memperkenalkan antarmuka java.sql.SQLXML. Antarmuka SQLXML mendefinisikan metode untuk berinteraksi dan memanipulasi data XML. Jenis data SQLXML memetakan ke jenis data xml SQL Server.
Antarmuka SQLXML menyediakan metode untuk mengakses nilai XML sebagai String, Pembaca atau Penulis, atau sebagai Aliran. Nilai XML juga dapat diakses melalui Sumber atau ditetapkan sebagai Hasil, yang digunakan dengan XML Parser API seperti Document Object Model (DOM), Simple API for XML (SAX), dan Streaming API untuk XML (StAX), serta dengan transformasi XSLT dan XPath.
Keterangan
Tabel berikut menjelaskan metode yang ditentukan dalam antarmuka SQLXML:
| Sintaks Metode | Deskripsi Metode |
|---|---|
| void free() | Metode ini membebaskan objek SQLXML dan merilis sumber daya yang dimilikinya. |
| InputStream getBinaryStream() | Mengembalikan aliran input untuk membaca data dari SQLXML. |
| Pembaca getCharacterStream() | Mengembalikan data XML sebagai objek java.io.Reader atau sebagai aliran karakter. |
| T memperluas Source T getSource(Class<T> sourceClass) | Mengembalikan Sumber untuk membaca nilai XML yang ditentukan oleh objek SQLXML ini. Catatan: Metode getSource mendukung sumber berikut: javax.xml.transform.dom.DOMSource, javax.xml.transform.sax.SAXSource, javax.xml.transform.stax.StAXSource, dan java.io.InputStream. |
| String getString() | Mengembalikan representasi string dari nilai XML yang ditunjuk oleh objek SQLXML ini. |
| SetBinaryStream OutputStream() | Mengambil aliran yang dapat digunakan untuk menulis nilai XML yang diwakili objek SQLXML ini. |
| Penulis setCharacterStream() | Mengembalikan aliran yang akan digunakan untuk menulis nilai XML yang diwakili objek SQLXML ini. |
| T memperluas Result T setResult(Class<T> resultClass) | Mengembalikan Hasil untuk mengatur nilai XML yang ditentukan oleh objek SQLXML ini. Catatan: Metode setResult mendukung sumber berikut: javax.xml.transform.dom.DOMResult, javax.xml.transform.sax.SAXResult, javax.xml.transform.stax.StaxResult, dan java.io.OutputStream. |
| void setString(Nilai string) | Mengatur nilai XML yang ditunjuk oleh objek SQLXML ini ke representasi String yang ditentukan. |
Aplikasi dapat membaca dan menulis nilai XML ke atau dari objek SQLXML hanya sekali.
Ketika metode free() dipanggil, objek SQLXML menjadi tidak valid dan tidak dapat dibaca atau ditulis. Jika aplikasi mencoba memanggil metode pada objek SQLXML tersebut selain metode free(), pengecualian akan dilemparkan.
Objek SQLXML menjadi tidak dapat dibaca atau ditulis ketika aplikasi memanggil salah satu metode getter berikut: getSource, getCharacterStream, getBinaryStream, dan getString.
Objek SQLXML menjadi tidak dapat ditulis atau dibaca ketika aplikasi memanggil salah satu metode setter berikut: setResult, setCharacterStream, setBinaryStream, dan setString.