Interface SQLXML
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.