SqlXmlHandler (Spring Framework 5.1.5.RELEASE API)

既知のすべてのサブインターフェース:
SqlXmlObjectMappingHandler
すべての既知の実装クラス:
Jdbc4SqlXmlHandler
```
public interface SqlXmlHandler
```
特定のデータベースで XML フィールドを処理するための抽象化。その主な目的は、データベースに格納されている XML のデータベース固有の処理を分離することです。
JDBC 4.0 は新しいデータ型 java.sql.SQLXML を導入しますが、ほとんどのデータベースとそのドライバーは現在データベース固有のデータ型と機能に依存しています。
XML フィールドにアクセサーメソッドを提供し、SqlXmlValue インスタンスのファクトリとして機能します。
導入:
2.5.5
作成者:
Thomas Risberg
関連事項:
Jdbc4SqlXmlHandler, SQLXML、ResultSet.getSQLXML(int)、PreparedStatement.setSQLXML(int, java.sql.SQLXML)

方法の概要

すべてのメソッドインスタンスメソッド抽象メソッド
修飾子と型	メソッドと説明
`java.io.InputStream`	`getXmlAsBinaryStream(java.sql.ResultSet rs, int columnIndex)` 指定された ResultSet から、指定された列をバイナリストリームとして取得します。
`java.io.InputStream`	`getXmlAsBinaryStream(java.sql.ResultSet rs, java.lang.String columnName)` 指定された ResultSet から、指定された列をバイナリストリームとして取得します。
`java.io.Reader`	`getXmlAsCharacterStream(java.sql.ResultSet rs, int columnIndex)` 指定された ResultSet から、指定された列を文字ストリームとして取得します。
`java.io.Reader`	`getXmlAsCharacterStream(java.sql.ResultSet rs, java.lang.String columnName)` 指定された ResultSet から、指定された列を文字ストリームとして取得します。
`javax.xml.transform.Source`	`getXmlAsSource(java.sql.ResultSet rs, int columnIndex, java.lang.Class<? extends javax.xml.transform.Source> sourceClass)` 指定された ResultSet から、指定されたソースクラスを使用して実装されたソースとして指定された列を取得します。
`javax.xml.transform.Source`	`getXmlAsSource(java.sql.ResultSet rs, java.lang.String columnName, java.lang.Class<? extends javax.xml.transform.Source> sourceClass)` 指定された ResultSet から、指定されたソースクラスを使用して実装されたソースとして指定された列を取得します。
`java.lang.String`	`getXmlAsString(java.sql.ResultSet rs, int columnIndex)` 指定された ResultSet から指定された列を文字列として取得します。
`java.lang.String`	`getXmlAsString(java.sql.ResultSet rs, java.lang.String columnName)` 指定された ResultSet から指定された列を文字列として取得します。
`SqlXmlValue`	`newSqlXmlValue(java.lang.Class<? extends javax.xml.transform.Result> resultClass, XmlResultProvider provider)` 基盤となる JDBC ドライバーでサポートされているように、指定された XML データの `SqlXmlValue` インスタンスを作成します。
`SqlXmlValue`	`newSqlXmlValue(org.w3c.dom.Document doc)` 基盤となる JDBC ドライバーでサポートされているように、指定された XML データの `SqlXmlValue` インスタンスを作成します。
`SqlXmlValue`	`newSqlXmlValue(java.lang.String value)` 基盤となる JDBC ドライバーでサポートされているように、指定された XML データの `SqlXmlValue` インスタンスを作成します。
`SqlXmlValue`	`newSqlXmlValue(XmlBinaryStreamProvider provider)` 基盤となる JDBC ドライバーでサポートされているように、指定された XML データの `SqlXmlValue` インスタンスを作成します。
`SqlXmlValue`	`newSqlXmlValue(XmlCharacterStreamProvider provider)` 基盤となる JDBC ドライバーでサポートされているように、指定された XML データの `SqlXmlValue` インスタンスを作成します。

- メソッドの詳細
  - getXmlAsString
```
@Nullable
java.lang.String getXmlAsString(java.sql.ResultSet rs,
                                          java.lang.String columnName)
                                   throws java.sql.SQLException
```
    指定された ResultSet から指定された列を文字列として取得します。
    データベースとドライバに応じて、ResultSet.getString を呼び出すか、SQLXML またはデータベース固有のクラスを操作するだけです。
    パラメーター:
    rs - コンテンツを取得する ResultSet
    columnName - 使用する列名
    戻り値:
    文字列としてのコンテンツ、または SQL NULL の場合は null
    例外:
    java.sql.SQLException - JDBC メソッドによってスローされた場合
    関連事項:
    ResultSet.getString(int), ResultSet.getSQLXML(int)
  - getXmlAsString
```
@Nullable
java.lang.String getXmlAsString(java.sql.ResultSet rs,
                                          int columnIndex)
                                   throws java.sql.SQLException
```
    指定された ResultSet から指定された列を文字列として取得します。
    データベースとドライバに応じて、ResultSet.getString を呼び出すか、SQLXML またはデータベース固有のクラスを操作するだけです。
    パラメーター:
    rs - コンテンツを取得する ResultSet
    columnIndex - 使用する列インデックス
    戻り値:
    文字列としてのコンテンツ、または SQL NULL の場合は null
    例外:
    java.sql.SQLException - JDBC メソッドによってスローされた場合
    関連事項:
    ResultSet.getString(int), ResultSet.getSQLXML(int)
  - getXmlAsBinaryStream
```
@Nullable
java.io.InputStream getXmlAsBinaryStream(java.sql.ResultSet rs,
                                                   java.lang.String columnName)
                                            throws java.sql.SQLException
```
    指定された ResultSet から、指定された列をバイナリストリームとして取得します。
    データベースとドライバに応じて、ResultSet.getAsciiStream を呼び出すか、SQLXML またはデータベース固有のクラスを操作するだけです。
    パラメーター:
    rs - コンテンツを取得する ResultSet
    columnName - 使用する列名
    戻り値:
    バイナリストリームとしてのコンテンツ、または SQL NULL の場合は null
    例外:
    java.sql.SQLException - JDBC メソッドによってスローされた場合
    関連事項:
    ResultSet.getSQLXML(int), SQLXML.getBinaryStream()
  - getXmlAsBinaryStream
```
@Nullable
java.io.InputStream getXmlAsBinaryStream(java.sql.ResultSet rs,
                                                   int columnIndex)
                                            throws java.sql.SQLException
```
    指定された ResultSet から、指定された列をバイナリストリームとして取得します。
    データベースとドライバに応じて、ResultSet.getAsciiStream を呼び出すか、SQLXML またはデータベース固有のクラスを操作するだけです。
    パラメーター:
    rs - コンテンツを取得する ResultSet
    columnIndex - 使用する列インデックス
    戻り値:
    バイナリストリームとしてのコンテンツ、または SQL NULL の場合は null
    例外:
    java.sql.SQLException - JDBC メソッドによってスローされた場合
    関連事項:
    ResultSet.getSQLXML(int), SQLXML.getBinaryStream()
  - getXmlAsCharacterStream
```
@Nullable
java.io.Reader getXmlAsCharacterStream(java.sql.ResultSet rs,
                                                 java.lang.String columnName)
                                          throws java.sql.SQLException
```
    指定された ResultSet から、指定された列を文字ストリームとして取得します。
    データベースとドライバに応じて、ResultSet.getCharacterStream を呼び出すか、SQLXML またはデータベース固有のクラスを操作するだけです。
    パラメーター:
    rs - コンテンツを取得する ResultSet
    columnName - 使用する列名
    戻り値:
    文字ストリームとしてのコンテンツ、または SQL NULL の場合は null
    例外:
    java.sql.SQLException - JDBC メソッドによってスローされた場合
    関連事項:
    ResultSet.getSQLXML(int), SQLXML.getCharacterStream()
  - getXmlAsCharacterStream
```
@Nullable
java.io.Reader getXmlAsCharacterStream(java.sql.ResultSet rs,
                                                 int columnIndex)
                                          throws java.sql.SQLException
```
    指定された ResultSet から、指定された列を文字ストリームとして取得します。
    データベースとドライバに応じて、ResultSet.getCharacterStream を呼び出すか、SQLXML またはデータベース固有のクラスを操作するだけです。
    パラメーター:
    rs - コンテンツを取得する ResultSet
    columnIndex - 使用する列インデックス
    戻り値:
    文字ストリームとしてのコンテンツ、または SQL NULL の場合は null
    例外:
    java.sql.SQLException - JDBC メソッドによってスローされた場合
    関連事項:
    ResultSet.getSQLXML(int), SQLXML.getCharacterStream()
  - getXmlAsSource
```
@Nullable
javax.xml.transform.Source getXmlAsSource(java.sql.ResultSet rs,
                                                    java.lang.String columnName,
                                                    @Nullable
                                                    java.lang.Class<? extends javax.xml.transform.Source> sourceClass)
                                             throws java.sql.SQLException
```
    指定された ResultSet から、指定されたソースクラスを使用して実装されたソースとして指定された列を取得します。
    データベースとドライバーに応じて、SQLXML またはデータベース固有のクラスで機能する場合があります。
    パラメーター:
    rs - コンテンツを取得する ResultSet
    columnName - 使用する列名
    sourceClass - 使用する実装クラス
    戻り値:
    文字ストリームとしてのコンテンツ、または SQL NULL の場合は null
    例外:
    java.sql.SQLException - JDBC メソッドによってスローされた場合
    関連事項:
    ResultSet.getSQLXML(int), SQLXML.getSource(java.lang.Class<T>)
  - getXmlAsSource
```
@Nullable
javax.xml.transform.Source getXmlAsSource(java.sql.ResultSet rs,
                                                    int columnIndex,
                                                    @Nullable
                                                    java.lang.Class<? extends javax.xml.transform.Source> sourceClass)
                                             throws java.sql.SQLException
```
    指定された ResultSet から、指定されたソースクラスを使用して実装されたソースとして指定された列を取得します。
    データベースとドライバーに応じて、SQLXML またはデータベース固有のクラスで機能する場合があります。
    パラメーター:
    rs - コンテンツを取得する ResultSet
    columnIndex - 使用する列インデックス
    sourceClass - 使用する実装クラス
    戻り値:
    文字ストリームとしてのコンテンツ、または SQL NULL の場合は null
    例外:
    java.sql.SQLException - JDBC メソッドによってスローされた場合
    関連事項:
    ResultSet.getSQLXML(int), SQLXML.getSource(java.lang.Class<T>)
  - newSqlXmlValue
```
SqlXmlValue newSqlXmlValue(java.lang.String value)
```
    基盤となる JDBC ドライバーでサポートされているように、指定された XML データの SqlXmlValue インスタンスを作成します。
    パラメーター:
    value - XML データを提供する XML 文字列値
    戻り値:
    実装固有のインスタンス
    関連事項:
    SqlXmlValue, SQLXML.setString(String)
  - newSqlXmlValue
```
SqlXmlValue newSqlXmlValue(XmlBinaryStreamProvider provider)
```
    基盤となる JDBC ドライバーでサポートされているように、指定された XML データの SqlXmlValue インスタンスを作成します。
    パラメーター:
    provider - XML データを提供する XmlBinaryStreamProvider
    戻り値:
    実装固有のインスタンス
    関連事項:
    SqlXmlValue, SQLXML.setBinaryStream()
  - newSqlXmlValue
```
SqlXmlValue newSqlXmlValue(XmlCharacterStreamProvider provider)
```
    基盤となる JDBC ドライバーでサポートされているように、指定された XML データの SqlXmlValue インスタンスを作成します。
    パラメーター:
    provider - XML データを提供する XmlCharacterStreamProvider
    戻り値:
    実装固有のインスタンス
    関連事項:
    SqlXmlValue, SQLXML.setCharacterStream()
  - newSqlXmlValue
```
SqlXmlValue newSqlXmlValue(java.lang.Class<? extends javax.xml.transform.Result> resultClass,
                           XmlResultProvider provider)
```
    基盤となる JDBC ドライバーでサポートされているように、指定された XML データの SqlXmlValue インスタンスを作成します。
    パラメーター:
    resultClass - 使用される Result 実装クラス
    provider - XML データを提供する XmlResultProvider
    戻り値:
    実装固有のインスタンス
    関連事項:
    SqlXmlValue, SQLXML.setResult(Class)
  - newSqlXmlValue
```
SqlXmlValue newSqlXmlValue(org.w3c.dom.Document doc)
```
    基盤となる JDBC ドライバーでサポートされているように、指定された XML データの SqlXmlValue インスタンスを作成します。
    パラメーター:
    doc - 使用する XML ドキュメント
    戻り値:
    実装固有のインスタンス
    関連事項:
    SqlXmlValue

インターフェース SqlXmlHandler

方法の概要

メソッドの詳細

getXmlAsString

getXmlAsString

getXmlAsBinaryStream

getXmlAsBinaryStream

getXmlAsCharacterStream

getXmlAsCharacterStream

getXmlAsSource

getXmlAsSource

newSqlXmlValue

newSqlXmlValue

newSqlXmlValue

newSqlXmlValue

newSqlXmlValue