インターフェース SqlXmlHandler

すべての既知の実装クラス:
Jdbc4SqlXmlHandler

@DeprecatedSE(since="6.2") public interface SqlXmlHandler
使用すべきではありません。
6.2 では、ResultSet.getSQLXML(int)SEConnection.createSQLXML() を直接使用し、カスタム SqlValue 実装と組み合わせて使用することをお勧めします。
特定のデータベースで XML フィールドを処理するための抽象化。その主な目的は、データベースに格納されている XML のデータベース固有の処理を分離することです。

JDBC 4.0 は新しいデータ型 java.sql.SQLXML を導入しますが、ほとんどのデータベースとそのドライバーは現在データベース固有のデータ型と機能に依存しています。

XML フィールドにアクセサーメソッドを提供し、SqlXmlValue インスタンスのファクトリとして機能します。

導入:
2.5.5
作成者:
Thomas Risberg
関連事項:
  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    getXmlAsBinaryStream(ResultSetSE rs, int columnIndex)
    使用すべきではありません。
    指定された ResultSet から、指定された列をバイナリストリームとして取得します。
    使用すべきではありません。
    指定された ResultSet から、指定された列をバイナリストリームとして取得します。
    使用すべきではありません。
    指定された ResultSet から、指定された列を文字ストリームとして取得します。
    使用すべきではありません。
    指定された ResultSet から、指定された列を文字ストリームとして取得します。
    getXmlAsSource(ResultSetSE rs, int columnIndex, ClassSE<? extends SourceSE> sourceClass)
    使用すべきではありません。
    指定された ResultSet から、指定されたソースクラスを使用して実装されたソースとして指定された列を取得します。
    getXmlAsSource(ResultSetSE rs, StringSE columnName, ClassSE<? extends SourceSE> sourceClass)
    使用すべきではありません。
    指定された ResultSet から、指定されたソースクラスを使用して実装されたソースとして指定された列を取得します。
    getXmlAsString(ResultSetSE rs, int columnIndex)
    使用すべきではありません。
    指定された ResultSet から指定された列を文字列として取得します。
    使用すべきではありません。
    指定された ResultSet から指定された列を文字列として取得します。
    newSqlXmlValue(ClassSE<? extends ResultSE> resultClass, XmlResultProvider provider)
    使用すべきではありません。
    基盤となる JDBC ドライバーでサポートされているように、指定された XML データの SqlXmlValue インスタンスを作成します。
    使用すべきではありません。
    基盤となる JDBC ドライバーでサポートされているように、指定された XML データの SqlXmlValue インスタンスを作成します。
    使用すべきではありません。
    基盤となる JDBC ドライバーでサポートされているように、指定された XML データの SqlXmlValue インスタンスを作成します。
    使用すべきではありません。
    基盤となる JDBC ドライバーでサポートされているように、指定された XML データの SqlXmlValue インスタンスを作成します。
    使用すべきではありません。
    基盤となる JDBC ドライバーでサポートされているように、指定された XML データの SqlXmlValue インスタンスを作成します。
  • メソッドの詳細

    • getXmlAsString

      @Nullable StringSE getXmlAsString(ResultSetSE rs, StringSE columnName) throws SQLExceptionSE
      使用すべきではありません。
      指定された ResultSet から指定された列を文字列として取得します。

      データベースとドライバに応じて、ResultSet.getString を呼び出すか、SQLXML またはデータベース固有のクラスを操作するだけです。

      パラメーター:
      rs - コンテンツを取得する ResultSet
      columnName - 使用する列名
      戻り値:
      文字列としてのコンテンツ、または SQL NULL の場合は null 
      例外:
      SQLExceptionSE - JDBC メソッドによってスローされた場合
      関連事項:
    • getXmlAsString

      @Nullable StringSE getXmlAsString(ResultSetSE rs, int columnIndex) throws SQLExceptionSE
      使用すべきではありません。
      指定された ResultSet から指定された列を文字列として取得します。

      データベースとドライバに応じて、ResultSet.getString を呼び出すか、SQLXML またはデータベース固有のクラスを操作するだけです。

      パラメーター:
      rs - コンテンツを取得する ResultSet
      columnIndex - 使用する列インデックス
      戻り値:
      文字列としてのコンテンツ、または SQL NULL の場合は null 
      例外:
      SQLExceptionSE - JDBC メソッドによってスローされた場合
      関連事項:
    • getXmlAsBinaryStream

      @Nullable InputStreamSE getXmlAsBinaryStream(ResultSetSE rs, StringSE columnName) throws SQLExceptionSE
      使用すべきではありません。
      指定された ResultSet から、指定された列をバイナリストリームとして取得します。

      データベースとドライバに応じて、ResultSet.getAsciiStream を呼び出すか、SQLXML またはデータベース固有のクラスを操作するだけです。

      パラメーター:
      rs - コンテンツを取得する ResultSet
      columnName - 使用する列名
      戻り値:
      バイナリストリームとしてのコンテンツ、または SQL NULL の場合は null 
      例外:
      SQLExceptionSE - JDBC メソッドによってスローされた場合
      関連事項:
    • getXmlAsBinaryStream

      @Nullable InputStreamSE getXmlAsBinaryStream(ResultSetSE rs, int columnIndex) throws SQLExceptionSE
      使用すべきではありません。
      指定された ResultSet から、指定された列をバイナリストリームとして取得します。

      データベースとドライバに応じて、ResultSet.getAsciiStream を呼び出すか、SQLXML またはデータベース固有のクラスを操作するだけです。

      パラメーター:
      rs - コンテンツを取得する ResultSet
      columnIndex - 使用する列インデックス
      戻り値:
      バイナリストリームとしてのコンテンツ、または SQL NULL の場合は null 
      例外:
      SQLExceptionSE - JDBC メソッドによってスローされた場合
      関連事項:
    • getXmlAsCharacterStream

      @Nullable ReaderSE getXmlAsCharacterStream(ResultSetSE rs, StringSE columnName) throws SQLExceptionSE
      使用すべきではありません。
      指定された ResultSet から、指定された列を文字ストリームとして取得します。

      データベースとドライバに応じて、ResultSet.getCharacterStream を呼び出すか、SQLXML またはデータベース固有のクラスを操作するだけです。

      パラメーター:
      rs - コンテンツを取得する ResultSet
      columnName - 使用する列名
      戻り値:
      文字ストリームとしてのコンテンツ、または SQL NULL の場合は null 
      例外:
      SQLExceptionSE - JDBC メソッドによってスローされた場合
      関連事項:
    • getXmlAsCharacterStream

      @Nullable ReaderSE getXmlAsCharacterStream(ResultSetSE rs, int columnIndex) throws SQLExceptionSE
      使用すべきではありません。
      指定された ResultSet から、指定された列を文字ストリームとして取得します。

      データベースとドライバに応じて、ResultSet.getCharacterStream を呼び出すか、SQLXML またはデータベース固有のクラスを操作するだけです。

      パラメーター:
      rs - コンテンツを取得する ResultSet
      columnIndex - 使用する列インデックス
      戻り値:
      文字ストリームとしてのコンテンツ、または SQL NULL の場合は null 
      例外:
      SQLExceptionSE - JDBC メソッドによってスローされた場合
      関連事項:
    • getXmlAsSource

      @Nullable SourceSE getXmlAsSource(ResultSetSE rs, StringSE columnName, @Nullable ClassSE<? extends SourceSE> sourceClass) throws SQLExceptionSE
      使用すべきではありません。
      指定された ResultSet から、指定されたソースクラスを使用して実装されたソースとして指定された列を取得します。

      データベースとドライバーに応じて、SQLXML またはデータベース固有のクラスで機能する場合があります。

      パラメーター:
      rs - コンテンツを取得する ResultSet
      columnName - 使用する列名
      sourceClass - 使用する実装クラス
      戻り値:
      文字ストリームとしてのコンテンツ、または SQL NULL の場合は null 
      例外:
      SQLExceptionSE - JDBC メソッドによってスローされた場合
      関連事項:
    • getXmlAsSource

      @Nullable SourceSE getXmlAsSource(ResultSetSE rs, int columnIndex, @Nullable ClassSE<? extends SourceSE> sourceClass) throws SQLExceptionSE
      使用すべきではありません。
      指定された ResultSet から、指定されたソースクラスを使用して実装されたソースとして指定された列を取得します。

      データベースとドライバーに応じて、SQLXML またはデータベース固有のクラスで機能する場合があります。

      パラメーター:
      rs - コンテンツを取得する ResultSet
      columnIndex - 使用する列インデックス
      sourceClass - 使用する実装クラス
      戻り値:
      文字ストリームとしてのコンテンツ、または SQL NULL の場合は null 
      例外:
      SQLExceptionSE - JDBC メソッドによってスローされた場合
      関連事項:
    • newSqlXmlValue

      SqlXmlValue newSqlXmlValue(StringSE value)
      使用すべきではありません。
      基盤となる JDBC ドライバーでサポートされているように、指定された XML データの SqlXmlValue インスタンスを作成します。
      パラメーター:
      value - XML データを提供する XML 文字列値
      戻り値:
      実装固有のインスタンス
      関連事項:
    • newSqlXmlValue

      SqlXmlValue newSqlXmlValue(XmlBinaryStreamProvider provider)
      使用すべきではありません。
      基盤となる JDBC ドライバーでサポートされているように、指定された XML データの SqlXmlValue インスタンスを作成します。
      パラメーター:
      provider - XML データを提供する XmlBinaryStreamProvider 
      戻り値:
      実装固有のインスタンス
      関連事項:
    • newSqlXmlValue

      SqlXmlValue newSqlXmlValue(XmlCharacterStreamProvider provider)
      使用すべきではありません。
      基盤となる JDBC ドライバーでサポートされているように、指定された XML データの SqlXmlValue インスタンスを作成します。
      パラメーター:
      provider - XML データを提供する XmlCharacterStreamProvider 
      戻り値:
      実装固有のインスタンス
      関連事項:
    • newSqlXmlValue

      SqlXmlValue newSqlXmlValue(ClassSE<? extends ResultSE> resultClass, XmlResultProvider provider)
      使用すべきではありません。
      基盤となる JDBC ドライバーでサポートされているように、指定された XML データの SqlXmlValue インスタンスを作成します。
      パラメーター:
      resultClass - 使用される Result 実装クラス
      provider - XML データを提供する XmlResultProvider 
      戻り値:
      実装固有のインスタンス
      関連事項:
    • newSqlXmlValue

      SqlXmlValue newSqlXmlValue(DocumentSE doc)
      使用すべきではありません。
      基盤となる JDBC ドライバーでサポートされているように、指定された XML データの SqlXmlValue インスタンスを作成します。
      パラメーター:
      doc - 使用する XML ドキュメント
      戻り値:
      実装固有のインスタンス
      関連事項: