SQLXML arabirimi

JDBC sürücüsünü indirin

JDBC sürücüsü, java.sql.SQLXML arabirimini tanıtırken JDBC 4.0 API'sine yönelik destek sağlar. SQLXML arabirimi, XML verileriyle etkileşim kurma ve işleme yöntemlerini tanımlar. SQLXML veri türü, SQL Serverxml veri türüyle eşler.

SQLXML arabirimi , XML değerine Dize, Okuyucu veya Yazıcı ya da Akış olarak erişmek için yöntemler sağlar. XML değerine bir Kaynak aracılığıyla da erişilebilir veya Sonuç olarak ayarlanabilir. Bu API'ler Belge Nesne Modeli (DOM), XML için Basit API (SAX) ve XML için Akış API'sinin (StAX) yanı sıra XSLT dönüşümleri ve XPath gibi XML Ayrıştırıcı API'leriyle birlikte kullanılır.

Açıklamalar

Aşağıdaki tabloda SQLXML arabiriminde tanımlanan yöntemler açıklanmaktadır:

Yöntem Sözdizimi Yöntem Açıklaması
void free() Bu yöntem SQLXML nesnesini serbest bırakır ve içerdiği kaynakları serbest bırakır.
InputStream getBinaryStream() SQLXML'den verileri okumak için bir giriş akışı döndürür.
Reader getCharacterStream() XML verilerini java.io.Reader nesnesi veya karakter akışı olarak döndürür.
T Source'u genişletir T getSource(Sınıf<T> sourceClass) Bu SQLXML nesnesi tarafından belirtilen XML değerini okumak için bir Kaynak döndürür.

Not: getSource yöntemi şu kaynakları destekler: javax.xml.transform.dom.DOMSource, javax.xml.transform.sax.SAXSource, javax.xml.transform.stax.StAXSource ve java.io.InputStream.
getString() yöntemi Bu SQLXML nesnesi tarafından belirlenen XML değerinin dize gösterimini döndürür.
OutputStream setBinaryStream() Bu SQLXML nesnesinin temsil ettiği XML değerini yazmak için kullanılabilecek bir akış alır.
Yazıcı setCharacterStream() Bu SQLXML nesnesinin temsil ettiği XML değerini yazmak için kullanılacak bir akış döndürür.
T, Result T setResult(Sınıf<T> resultClass) genişletir Bu SQLXML nesnesi tarafından belirtilen XML değerini ayarlamak için bir Sonuç döndürür.

Not: setResult yöntemi şu kaynakları destekler: javax.xml.transform.dom.DOMResult, javax.xml.transform.sax.SAXResult, javax.xml.transform.stax.StaxResult ve java.io.OutputStream.
void setString(Dize değeri) Bu SQLXML nesnesi tarafından belirlenen XML değerini belirtilen Dize gösterimine ayarlar.

Uygulamalar, SQLXML nesnesine veya nesnesinden XML değerlerini yalnızca bir kez okuyabilir ve yazabilir.

free() yöntemi çağrıldığında, bir SQLXML nesnesi geçersiz olur ve ne okunabilir ne de yazılabilir olur. Uygulama bu SQLXML nesnesinde free() yöntemi dışında bir yöntem çağırmaya çalışırsa, bir özel durum oluşturulur.

Uygulama şu getter yöntemlerinden herhangi birini çağırdığında SQLXML nesnesi ne okunabilir ne de yazılabilir hale gelir: getSource, getCharacterStream, getBinaryStream ve getString.

Uygulama aşağıdaki ayarlayıcı yöntemlerden herhangi birini çağırdığında SQLXML nesnesi yazılabilir veya okunamaz hale gelir: setResult, setCharacterStream, setBinaryStream ve setString.

Ayrıca bakınız

XML verilerini destekleme