Interfaz SQLXML
Desde la versión 2.0 del controlador JDBC de Microsoft SQL Server, el controlador JDBC proporciona compatibilidad con la API 4.0 de JDBC, que presenta la interfaz java.sql.SQLXML. La interfaz SQLXML define métodos para interactuar con los datos XML y manipularlos. El tipo de datos SQLXML se asigna al tipo de datos xml de SQL Server.
La interfaz SQLXML proporciona métodos para obtener acceso al valor XML como String, Reader o Writer, o como Stream. También se puede obtener acceso al valor XML mediante un Source o establecerse como un Result, que se usan con las API del analizador XML, como Document Object Model (DOM), Simple API for XML (SAX) y Streaming API for XML (StAX), así como con las transformaciones XSLT y con XPath.
La tabla siguiente describe los métodos definidos en la interfaz SQLXML:
| Sintaxis del método | Descripción del método |
|---|---|
Este método libera el objeto SQLXML y los recursos que contiene. |
|
Devuelve un flujo de entrada para leer datos desde SQLXML. |
|
Devuelve los datos XML como un objeto java.io.Reader o como un flujo de caracteres. |
|
Devuelve un Source para leer el valor XML especificado por este objeto de SQLXML. Nota El método getSource es compatible con los siguientes datos: javax.xml.transform.dom.DOMSource, javax.xml.transform.sax.SAXSource, javax.xml.transform.stax.StAXSource y java.io.InputStream. |
|
Devuelve una representación de cadena del valor XML designado por este objeto SQLXML. |
|
Recupera un flujo que puede ser usada para escribir el valor XML que representa este objeto SQLXML. |
|
Devuelve un flujo que es usada para escribir el valor XML que representa este objeto SQLXML. |
|
Devuelve un Result para establecer el valor XML especificado por este objeto de SQLXML. Nota El método setResult es compatible con los siguientes datos: javax.xml.transform.dom.DOMResult, javax.xml.transform.sax.SAXResult, javax.xml.transform.stax.StaxResult y java.io.OutputStream. |
|
Configura el valor XML designado por este objeto SQLXML en la representación String especificada. |
Las aplicaciones pueden leer y escribir valores XML en o desde un objeto SQLXML solamente una vez.
Cuando se llama al método free(), un objeto SQLXML se vuelve no válido y no puede ser leído ni escrito. Si la aplicación intenta invocar un método en un objeto SQLXML distinto del método free(), se devuelve una excepción.
El objeto SQLXML no puede ser leído ni escrito cuando la aplicación llama a cualquiera de los siguientes métodos captador: getSource, getCharacterStream, getBinaryStream y getString.
El objeto SQLXML no puede ser leído ni escrito cuando la aplicación llama a cualquiera de los siguientes métodos establecedores: setResult, setCharacterStream, setBinaryStream y setString.