Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
JDBC-stuurprogramma downloaden
Het JDBC-stuurprogramma biedt ondersteuning voor de JDBC 4.0-API, waarmee de interface java.sql.SQLXML wordt geïntroduceerd. De SQLXML-interface definieert methoden voor interactie en manipulatie van XML-gegevens. Het SQLXML-gegevenstype wordt toegewezen aan hetXML-gegevenstype van SQL Server.
De SQLXML-interface biedt methoden voor toegang tot de XML-waarde als een tekenreeks, een lezer of schrijver of als stream. De XML-waarde kan ook worden geopend via een bron of set als resultaat, die worden gebruikt met XML-parser-API's zoals Document Object Model (DOM), Simple API for XML (SAX) en streaming-API voor XML (StAX), evenals met XSLT-transformaties en XPath.
Opmerkingen
In de volgende tabel worden de methoden beschreven die zijn gedefinieerd in de SQLXML-interface:
| Methodesyntaxis | Beschrijving van methode |
|---|---|
| void free() | Met deze methode wordt het SQLXML-object vrijgemaakt en worden de resources vrijgegeven die het bevat. |
| InputStream getBinaryStream() | Hiermee wordt een invoerstroom geretourneerd voor het lezen van gegevens uit SQLXML. |
| Lezer getCharacterStream() | Retourneert de XML-gegevens als een java.io.Reader-object of als een stroom tekens. |
| T breidt bron T getSource(klasse<T> sourceClass) uit | Retourneert een bron voor het lezen van de XML-waarde die is opgegeven door dit SQLXML-object . Opmerking: De methode getSource ondersteunt de volgende bronnen: javax.xml.transform.dom.DOMSource, javax.xml.transform.sax.SAXSource, javax.xml.transform.stax.StAXSource en java.io.InputStream. |
| String getString() | Retourneert een tekenreeksweergave van de XML-waarde die is aangewezen door dit SQLXML-object. |
| OutputStream setBinaryStream() | Hiermee haalt u een stroom op die kan worden gebruikt om de XML-waarde te schrijven die dit SQLXML-object vertegenwoordigt. |
| Writer setCharacterStream() | Hiermee wordt een stroom geretourneerd die moet worden gebruikt om de XML-waarde te schrijven die dit SQLXML-object vertegenwoordigt. |
| T breidt Result T setResult(Class<T> resultClass) uit | Retourneert een resultaat voor het instellen van de XML-waarde die is opgegeven door dit SQLXML-object . Opmerking: De methode setResult ondersteunt de volgende bronnen: javax.xml.transform.dom.DOMResult, javax.xml.transform.sax.SAXResult, javax.xml.transform.stax.StaxResult en java.io.OutputStream. |
| void setString(tekenreekswaarde) | Stelt de XML-waarde die door dit SQLXML-object is aangewezen in op de opgegeven String-representatie. |
De toepassingen kunnen XML-waarden slechts één keer lezen en schrijven naar of van een SQLXML-object.
Wanneer de methode free() wordt aangeroepen, wordt een SQLXML-object ongeldig en kan het niet worden gelezen of schrijfbaar. Als de toepassing probeert een methode aan te roepen voor dat SQLXML-object anders dan de methode free(), wordt er een uitzondering gegenereerd.
Het SQLXML-object wordt niet leesbaar of beschrijfbaar wanneer de toepassing een van de volgende gettermethoden aanroept: getSource, getCharacterStream, getBinaryStream en getString.
Het SQLXML-object wordt niet schrijfbaar of leesbaar wanneer de toepassing een van de volgende settermethoden aanroept: setResult, setCharacterStream, setBinaryStream en setString.