Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Sterownik JDBC zapewnia obsługę interfejsu API JDBC 4.0, który wprowadza interfejs java.sql.SQLXML. Interfejs SQLXML definiuje metody interakcji i manipulowania danymi XML. Typ danych SQLXML jest przypisany do typu danych xml programu SQL Server.
Interfejs SQLXML udostępnia metody uzyskiwania dostępu do wartości XML jako ciąg, czytelnik lub składnik zapisywania lub jako strumień. Dostęp do wartości XML można również uzyskać za pośrednictwem elementu Source lub ustawić jako Wynik, co jest używane z interfejsami API parsera XML, takimi jak Document Object Model (DOM), Simple API for XML (SAX) i Streaming API for XML (StAX), a także z transformacjami XSLT i XPath.
Uwagi
W poniższej tabeli opisano metody zdefiniowane w interfejsie SQLXML:
| Składnia metody | Opis metody |
|---|---|
| void free() | Ta metoda zwalnia obiekt SQLXML i zwalnia przechowywane zasoby. |
| InputStream getBinaryStream() | Zwraca strumień wejściowy do odczytu danych z programu SQLXML. |
| Czytelnik getCharacterStream() | Zwraca dane XML jako obiekt java.io.Reader lub strumień znaków. |
| T rozszerza źródło T getSource(Klasa<T> sourceClass) | Zwraca źródło do odczytywania wartości XML określonej przez ten obiekt SQLXML . Uwaga: Metoda getSource obsługuje następujące źródła: javax.xml.transform.dom.DOMSource, javax.xml.transform.sax.SAXSource, javax.xml.transform.stax.StAXSource i java.io.InputStream. |
| String getString() | Zwraca reprezentację ciągu wartości XML wyznaczonej przez ten obiekt SQLXML. |
| OutputStream setBinaryStream() | Pobiera strumień, którego można użyć do zapisania wartości XML reprezentowanej przez ten obiekt SQLXML. |
| setCharacterStream() obiektu Writer | Zwraca strumień, który ma zostać użyty do zapisania wartości XML reprezentowanej przez ten obiekt SQLXML. |
| T jest rozszerzeniem Result T setResult(Class<T> resultClass) | Zwraca wynik ustawiania wartości XML określonej przez ten obiekt SQLXML . Uwaga: Metoda setResult obsługuje następujące źródła: javax.xml.transform.dom.DOMResult, javax.xml.transform.sax.SAXResult, javax.xml.transform.stax.StaxResult i java.io.OutputStream. |
| void setString(wartość ciągu) | Ustawia wartość XML wyznaczoną przez ten obiekt SQLXML na określoną reprezentację ciągu . |
Aplikacje mogą odczytywać i zapisywać wartości XML do lub z obiektu SQLXML tylko raz.
Po wywołaniu metody free() obiekt SQLXML staje się nieprawidłowy i nie jest ani czytelny, ani zapisywalny. Jeśli aplikacja próbuje wywołać metodę dla tego obiektu SQLXML innego niż metoda free(), zgłaszany jest wyjątek.
Obiekt SQLXML nie staje się ani czytelny, ani zapisywalny, gdy aplikacja wywołuje dowolną z następujących metod getter: getSource, getCharacterStream, getBinaryStream i getString.
Obiekt SQLXML nie może być ani zapisywalny, ani czytelny, gdy aplikacja wywołuje dowolną z następujących metod ustawiania: setResult, setCharacterStream, setBinaryStream i setString.