Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O driver JDBC fornece suporte para a API JDBC 4.0, que introduz a interface java.sql.SQLXML. A interface SQLXML define métodos para interagir e manipular dados XML. O tipo de dados SQLXML é mapeado para o tipo de dadosxml do SQL Server.
A interface SQLXML fornece métodos para aceder ao valor XML como uma String, um Leitor ou Escritor, ou como um Fluxo. O valor XML pode ser acedido também através de uma Fonte ou ser definido como Resultado, que são usados com APIs de parser XML como Document Object Model (DOM), Simple API for XML (SAX) e Streaming API for XML (StAX), bem como com transformações XSLT e XPath.
Observações
A tabela seguinte descreve os métodos definidos na interface SQLXML:
| Sintaxe do método | Descrição do método |
|---|---|
| void free() | Este método liberta o objeto SQLXML e liberta os recursos que ele detém. |
| InputStream getBinaryStream() | Devolve um fluxo de entrada para ler dados do SQLXML. |
| Reader getCharacterStream() | Devolve os dados XML como um objeto java.io.Reader ou como um fluxo de caracteres. |
| T estende Source T getSource(Class<T> sourceClass) | Devolve uma Fonte para ler o valor XML especificado por este objeto SQLXML . Nota: O método getSource suporta as seguintes fontes: javax.xml.transform.dom.DOMSurce, javax.xml.transform.sax.SAXSource, javax.xml.transform.stax.StAXSource e java.io.InputStream. |
| String getString() | Devolve uma representação em cadeia do valor XML designado por este objeto SQLXML. |
| OutputStream setBinaryStream() | Recupera um fluxo que pode ser usado para escrever o valor XML que este objeto SQLXML representa. |
| Writer setCharacterStream() | Devolve um fluxo a ser usado para escrever o valor XML que este objeto SQLXML representa. |
| T estende o resultado T setResult(Classe<T> resultClasseResultado) | Devolve um Resultado para definir o valor XML especificado por este objeto SQLXML . Nota: O método setResult suporta as seguintes fontes: javax.xml.transform.dom.DOMResult, javax.xml.transform.sax.SAXResult, javax.xml.transform.stax.StaxResult e java.io.OutputStream. |
| void setString(String valor) | Define o valor XML designado por este objeto SQLXML para a representação String especificada. |
As aplicações podem ler e escrever valores XML para ou a partir de um objeto SQLXML apenas uma vez.
Quando o método free() é chamado, um objeto SQLXML torna-se inválido e não é nem legível nem gravável. Se a aplicação tentar invocar um método nesse objeto SQLXML diferente do método free(), é lançada uma exceção.
O objeto SQLXML torna-se nem legível nem gravável quando a aplicação chama qualquer um dos seguintes métodos getter: getSource, getCharacterStream, getBinaryStream e getString.
O objeto SQLXML não se torna nem gravável nem legível quando a aplicação chama qualquer um dos seguintes métodos de setter: setResult, setCharacterStream, setBinaryStream e setString.