Interface SQLXML
Le pilote JDBC prend en charge l'API JDBC 4.0, ce qui permet l'introduction de l'interface java.sql.SQLXML. L’interface SQLXML définit des méthodes d’interaction et de manipulation des données XML. Le type de données SQLXML correspond au type de données SQL Server xml.
L’interface SQLXML fournit des méthodes permettant d’accéder à la valeur XML en tant que String, Reader ou Writer, ou Stream. La valeur XML est également accessible à l’aide de Source ou via la définition de Result, qui sont utilisés avec les API d’analyseurs XML tels que DOM (Document Object Model), SAX (Simple API for XML) et StAX (Streaming API for XML), ainsi que les transformations XSLT et XPath.
Notes
Le tableau suivant décrit les méthodes définies dans l'interface SQLXML :
| Syntaxe de la méthode | Description de la méthode |
|---|---|
| void free() | Cette méthode libère l'objet SQLXML ainsi que les ressources qu'il détient. |
| InputStream getBinaryStream() | Retourne un flux d'entrée pour la lecture des données de l'objet SQLXML. |
| Reader getCharacterStream() | Retourne les données XML en tant qu’objet java.io.Reader ou flux de caractères. |
| T étend Source T getSource(Class<T> sourceClass) | Retourne une Source permettant de lire la valeur XML spécifiée par cet objet SQLXML. Remarque : la méthode getSource prend en charge les sources suivantes : javax.xml.transform.dom.DOMSource, javax.xml.transform.sax.SAXSource, javax.xml.transform.stax.StAXSource et java.io.InputStream. |
| String getString() | Retourne une représentation sous forme de chaîne de la valeur XML désignée par cet objet SQLXML. |
| OutputStream setBinaryStream() | Récupère un flux qui permet d’écrire la valeur XML représentée par cet objet SQLXML. |
| Writer setCharacterStream() | Retourne un flux à utiliser pour écrire la valeur XML représentée par cet objet SQLXML. |
| T étend Result T setResult(Class<T> resultClass) | Retourne un Result permettant de définir la valeur XML spécifiée par cet objet SQLXML. Remarque : La méthode setResult prend en charge les sources suivantes : javax.xml.transform.dom.DOMResult, javax.xml.transform.sax.SAXResult, javax.xml.transform.stax.StaxResult et java.io.OutputStream. |
| void setString(String value) | Affecte la valeur XML désignée par cet objet SQLXML à la représentation String spécifiée. |
Les applications ne peuvent lire et écrire des valeurs XML dans un objet SQLXML qu'une seule fois.
Quand la méthode free() est appelée, l’objet SQLXML devient non valide et n’est plus accessible en lecture ni en écriture. Si l’application tente d’appeler sur cet objet SQLXML une autre méthode que free(), une exception est levée.
L’objet SQLXML cesse d’être accessible en lecture et en écriture lorsque l’application appelle l’une des méthodes getter suivantes : getSource, getCharacterStream, getBinaryStream et getString.
L’objet SQLXML cesse d’être accessible en lecture et en écriture lorsque l’application appelle l’une des méthodes setter suivantes : setResult, setCharacterStream, setBinaryStream et setString.