Interface SQLXML

Baixar driver JDBC

O driver JDBC fornece suporte para a API do JDBC 4.0, que apresenta a interface java.sql.SQLXML. A interface SQLXML define métodos para interagir com os dados XML e manipulá-los. O tipo de dados SQLXML é mapeado para o tipo de dados SQL Serverxml.

A interface SQLXML fornece métodos para acessar o valor de XML valor como um String, um Reader ou Writer ou como um Stream. O valor XML também pode ser acessado por meio de uma Fonte ou definido como um Resultado, que é usado com APIs do Analisador de XML como DOM (Modelo de Objeto do Documento), SAX (API Simples para XML) e StAX (API de Fluxo para XML), assim como transformações XSLT e XPath.

Comentários

A tabela a seguir descreve os métodos definidos na interface SQLXML:

Sintaxe de método	Descrição de método
void free()	Esse método libera o objeto SQLXML e os recursos que ele contém.
InputStream getBinaryStream()	Retorna um fluxo de entrada para ler dados do SQLXML.
Reader getCharacterStream()	Retorna os dados XML como um objeto java.io.Reader ou como um fluxo de caracteres.
T estende Source T getSource(Class<T> sourceClass)	Retorna um Source para ler o valor XML especificado por este objeto SQLXML. Observação: o método getSource é compatível com as seguintes origens: javax.xml.transform.dom.DOMSource, javax.xml.transform.sax.SAXSource, javax.xml.transform.stax.StAXSource e java.io.InputStream.
String getString()	Retorna uma representação de cadeia de caracteres do valor XML designado por este objeto SQLXML.
OutputStream setBinaryStream()	Recupera um fluxo que pode ser usado para gravar o valor XML que este objeto SQLXML representa.
Writer setCharacterStream()	Retorna um fluxo para ser usado para gravar o valor XML que este objeto SQLXML representa.
T estende Result T setResult(Class<T> resultClass)	Retorna um Result para configurar o valor XML especificado por este objeto SQLXML. Observação: o método setResult é compatível com as seguintes origens: javax.xml.transform.dom.DOMResult, javax.xml.transform.sax.SAXResult, javax.xml.transform.stax.StaxResult e java.io.OutputStream.
void setString(String value)	Define o valor XML designado por esse objeto SQLXML para a representação String especificada.

Os aplicativos podem ler e gravar valores XML para ou de um objeto SQLXML apenas uma vez.

Quando o método free() é chamado, um objeto SQLXML se torna inválido e não é nem legível nem gravável. Se o aplicativo tentar invocar um método naquele objeto SQLXML diferente do método free(), uma exceção será lançada.

O objeto SQLXML não fica legível nem gravável quando o aplicativo chama qualquer um dos seguintes métodos getter: getSource, getCharacterStream, getBinaryStream e getString.

O objeto SQLXML não fica gravável nem legível quando o aplicativo chama qualquer um dos seguintes métodos setter: setResult, setCharacterStream, setBinaryStream e setString.

Confira também

Suporte a dados XML