Antarmuka SQLXML

  • Artikel

Unduh driver JDBC

Driver JDBC menyediakan dukungan untuk API JDBC 4.0, yang memperkenalkan antarmuka java.sql.SQLXML. Antarmuka SQLXML menentukan metode untuk berinteraksi dan memanipulasi data XML. Jenis data SQLXML memetakan ke jenis data SQL Server xml.

Antarmuka SQLXML menyediakan metode untuk mengakses nilai XML sebagai String, Pembaca atau Penulis, atau sebagai Stream. Nilai XML juga dapat diakses melalui Sumber atau ditetapkan sebagai Hasil, yang digunakan dengan API Pengurai XML seperti Model Objek Dokumen (DOM), API Sederhana untuk XML (SAX), dan API Streaming untuk XML (StAX), serta dengan transformasi XSLT dan JalurX.

Keterangan

Tabel berikut menjelaskan metode yang ditentukan dalam antarmuka SQLXML:

Sintaks Metode Deskripsi Metode
void free() Metode ini membebaskan objek SQLXML dan melepaskan sumber daya yang dipegangnya.
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.
OutputStream setBinaryStream() Mengambil aliran yang dapat digunakan untuk menulis nilai XML yang diwakili objek SQLXML ini.
Writer 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 dapat 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.

Lihat juga

Mendukung data XML