インタフェースNClob

すべてのスーパー・インタフェース:
AutoCloseable, Clob
public interface NClob extends Clob
SQL NCLOB型のJavaプログラミング言語でのマッピング。 SQLのNCLOBは、各国の文字セットを使用してキャラクタ・ラージ・オブジェクトをデータベース表の行内の列値として格納する組込みの型です。

NClobインタフェースは、Clobインタフェースを拡張します。このインタフェースは、SQLのNCLOB値の長さの取得、クライアントでのNCLOB値のマテリアライズ、およびNCLOB値内の部分文字列またはNCLOBオブジェクトの検索を行うメソッドを提供します。 NClobオブジェクトは、Clobオブジェクトと同様に、それが生成されたトランザクションの期間中に有効です。 ResultSet、CallableStatement、およびPreparedStatementの各インタフェースのメソッド(getNClob、setNClobなど)を使用すると、プログラマはSQLのNCLOB値にアクセスできます。 さらにこのインタフェースはNCLOB値を更新するためのメソッドを備えています。

NClobオブジェクトで使用されるリソースを解放するには、アプリケーションはClob.free()またはClob.close()メソッドを呼び出す必要があります。 NClobオブジェクトがクローズされた後にClob.free()またはClob.close()以外のメソッドを呼び出そうとすると、SQLExceptionがスローされます。

JDBCドライバがそのデータ型をサポートする場合は、NClobインタフェースのすべてのメソッドが完全に実装される必要があります。

導入されたバージョン:
1.6

  • メソッドのサマリー

    インタフェース Clobで宣言されたメソッド

    close, free, getAsciiStream, getCharacterStream, getCharacterStream, getSubString, length, position, position, setAsciiStream, setCharacterStream, setString, setString, truncate
    修飾子と型
    メソッド
    説明
    default void
    close()
    このClobオブジェクトによって保持されているリソースを閉じて解放します。
    void
    free()
    このClobオブジェクトによって保持されているリソースを閉じて解放します。
    InputStream
    getAsciiStream()
    このClobオブジェクトによって指定されたCLOB値をASCIIストリームとして取得します。
    Reader
    getCharacterStream()
    このClobオブジェクトによって指定されたCLOB値をjava.io.Readerオブジェクト(または文字のストリーム)として取り出します。
    Reader
    getCharacterStream(long pos, long length)
    Clob値の一部(文字位置posから長さlength文字分)を格納したReaderオブジェクトを返します。
    String
    getSubString(long pos, int length)
    このClobオブジェクトによって指定されたCLOB値内の指定された部分文字列のコピーを取得します。
    long
    length()
    このClobオブジェクトによって指定されたCLOB値の文字数を取得します。
    long
    position(String searchstr, long start)
    このClobオブジェクトで表されるSQL CLOB値内で、指定された部分文字列searchstrが現れる文字位置を取得します。
    long
    position(Clob searchstr, long start)
    このClobオブジェクト内で、指定されたClobオブジェクトsearchstrが現れる文字位置を取得します。
    OutputStream
    setAsciiStream(long pos)
    このClobオブジェクトが表すCLOB値へのASCII文字の書込みに使用するストリームを取得します。ストリームはposの位置から開始します。
    Writer
    setCharacterStream(long pos)
    このClobオブジェクトが表すCLOB値へのUnicode文字のストリームの書込みに使用する、posの位置のストリームを取得します。
    int
    setString(long pos, String str)
    このClobオブジェクトが指定するCLOB値へ、指定されたJava Stringをposの位置に書き込みます。
    int
    setString(long pos, String str, int offset, int len)
    strの文字offsetから始まるlen個の文字を、このClobが表すCLOB値に書き込みます。
    void
    truncate(long len)
    このClobが指定するCLOB値をlen文字の長さに切り詰めます。