Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Ovladač JDBC poskytuje podporu rozhraní JDBC 4.0 API, které zavádí rozhraní java.sql.SQLXML. Rozhraní SQLXML definuje metody pro interakci a manipulaci s daty XML. Datový typ SQLXML se mapuje na datový typXML SQL Serveru.
Rozhraní SQLXML poskytuje metody pro přístup k hodnotě XML jako String, Reader nebo Writer nebo jako Stream. K hodnotě XML je možné přistupovat také prostřednictvím Source nebo nastaveno jako Result, které se používají s rozhraními API analyzátoru XML, jako jsou Document Object Model (DOM), Simple API for XML (SAX), a Streaming API pro XML (StAX), stejně jako s transformacemi XSLT a XPath.
Poznámky
Následující tabulka popisuje metody definované v rozhraní SQLXML:
| Syntaxe metody | Popis metody |
|---|---|
| void free() | Tato metoda uvolní objekt SQLXML a uvolní prostředky, které obsahuje. |
| InputStream getBinaryStream() | Vrátí vstupní datový proud pro čtení dat z SQLXML. |
| Čtenář getCharacterStream() | Vrátí data XML jako objekt java.io.Reader nebo jako datový proud znaků. |
| T rozšiřuje Source T getSource(Třída<T> sourceClass) | Vrátí zdroj pro čtení hodnoty XML určené tímto objektem SQLXML . Poznámka: Metoda getSource podporuje následující zdroje: javax.xml.transform.dom.DOMSource, javax.xml.transform.sax.SAXSource, javax.xml.transform.stax.StAXSource a java.io.InputStream. |
| String getString() | Vrátí řetězcovou reprezentaci hodnoty XML určené tímto objektem SQLXML. |
| OutputStream setBinaryStream() | Načte datový proud, který lze použít k zápisu hodnoty XML , kterou tento objekt SQLXML představuje. |
| Writer setCharacterStream() | Vrátí datový proud, který se použije k zápisu hodnoty XML , kterou tento objekt SQLXML představuje. |
| T rozšiřuje Result T setResult(Class<T> resultClass) | Vrátí výsledek pro nastavení hodnoty XML určené tímto objektem SQLXML . Poznámka: Metoda setResult podporuje následující zdroje: javax.xml.transform.dom.DOMResult, javax.xml.transform.sax.SAXResult, javax.xml.transform.stax.StaxResult a java.io.OutputStream. |
| void setString(String value) | Nastaví hodnotu XML určenou tímto objektem SQLXML na zadanou řetězcovou reprezentaci. |
Aplikace mohou číst a zapisovat hodnoty XML do nebo z objektu SQLXML pouze jednou.
Při volání metody free() se objekt SQLXML stane neplatným a není čitelný ani zapisovatelný. Pokud se aplikace pokusí vyvolat metodu pro tento objekt SQLXML jiné než free(), je vyvolána výjimka.
SQLXML objekt není čitelný ani zapisovatelný, když aplikace volá některou z následujících getter metod: getSource, getCharacterStream, getBinaryStream a getString.
SQLXML objekt není zapisovatelný ani čitelný, když aplikace volá některou z následujících metod setter: setResult, setCharacterStream, setBinaryStream a setString.