クラスDataTruncation

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.sql.SQLException
java.sql.SQLWarning
java.sql.DataTruncation
すべての実装されたインタフェース:
Serializable, Iterable<Throwable>
public class DataTruncation extends SQLWarning
MaxFieldSizeを超過した以外の理由でデータ値が予期せず切り捨てられたときに、DataTruncation例外としてスローされる例外(書込み時)、またはDataTruncation警告として報告される例外(読取り時)です。

読込み時のDataTruncationのSQLstateは01004です。

書込み時のDataTruncationのSQLstateは22001です。

導入されたバージョン:
1.1
関連項目:

  • コンストラクタのサマリー

    コンストラクタ
    コンストラクタ
    説明
    DataTruncation(int index, boolean parameter, boolean read, int dataSize, int transferSize)
    DataTruncationオブジェクトを生成します。その際SQLStateは、readがtrueに設定された場合は01004に初期化され、readがfalseに設定された場合は22001に初期化されます。また、reasonは「Data truncation」、ベンダー・コードは0、その他のフィールドは指定された値にそれぞれ設定されます。
    DataTruncation(int index, boolean parameter, boolean read, int dataSize, int transferSize, Throwable cause)
    DataTruncationオブジェクトを生成します。その際SQLStateは、readがtrueに設定された場合は01004に初期化され、readがfalseに設定された場合は22001に初期化されます。また、reasonは「Data truncation」、ベンダー・コードは0、その他のフィールドは指定された値にそれぞれ設定されます。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    int
    getDataSize()
    転送される予定だったデータのバイト数を取得します。
    int
    getIndex()
    切り詰められた列またはパラメータのインデックスを取得します。
    boolean
    getParameter()
    切り詰められたのが、パラメータ値、列値のいずれであるかを示します。
    boolean
    getRead()
    値の切詰めが読取り時に発生したかどうかを示します。
    int
    getTransferSize()
    実際に転送されたデータのバイト数を取得します。

    クラスで宣言されたメソッド SQLWarning

    getNextWarning, setNextWarning
    修飾子と型
    メソッド
    説明
    SQLWarning
    getNextWarning()
    setNextWarningによってこのSQLWarningオブジェクトにチェーンされた警告を取得します。
    void
    setNextWarning(SQLWarning w)
    チェーンの最後にSQLWarningオブジェクトを追加します。

    クラスで宣言されたメソッド SQLException

    getErrorCode, getNextException, getSQLState, iterator, setNextException
    修飾子と型
    メソッド
    説明
    int
    getErrorCode()
    このSQLExceptionオブジェクトのベンダー固有の例外コードを取得します。
    SQLException
    getNextException()
    setNextException(SQLException ex)によってこのSQLExceptionオブジェクトにチェーンされた例外を取得します。
    String
    getSQLState()
    このSQLExceptionオブジェクトのSQLStateを取得します。
    Iterator<Throwable>
    iterator()
    チェーンされたSQLExceptionについてのイテレータを返します。
    void
    setNextException(SQLException ex)
    チェーンの最後にSQLExceptionオブジェクトを追加します。

    Throwableクラスで宣言されたメソッド

    addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
    修飾子と型
    メソッド
    説明
    final void
    addSuppressed(Throwable exception)
    この例外を提供する目的で抑制された例外に、指定された例外を追加します。
    Throwable
    fillInStackTrace()
    実行スタック・トレースを埋め込みます。
    Throwable
    getCause()
    このスロー可能オブジェクトの原因を返しますが、原因が存在しないか不明な場合はnullを返します。
    String
    getLocalizedMessage()
    このスロー可能オブジェクトの、ローカライズされた記述を作成します。
    String
    getMessage()
    このスロー可能オブジェクトの詳細メッセージ文字列を返します。
    StackTraceElement[]
    getStackTrace()
    Throwable.printStackTrace()によって出力されるスタック・トレース情報にプログラムでアクセスできるようにします。
    final Throwable[]
    getSuppressed()
    この例外を提供する目的で(通常try-with-resources文によって)抑制された例外をすべて含む配列を返します。
    Throwable
    initCause(Throwable cause)
    このスロー可能オブジェクトの原因を、指定された値に初期化します。
    void
    printStackTrace()
    このスロー可能オブジェクトおよびそのバックトレースを標準エラー・ストリームに出力します。
    void
    printStackTrace(PrintStream s)
    このスロー可能オブジェクトとそのバックトレースを指定された印刷ストリームに出力します。
    void
    printStackTrace(PrintWriter s)
    このスロー可能オブジェクトとそのバックトレースを指定されたプリント・ライターに出力します。
    void
    setStackTrace(StackTraceElement[] stackTrace)
    Throwable.getStackTrace()によって返され、Throwable.printStackTrace()と関連メソッドによって出力される、スタック・トレース要素を設定します。
    String
    toString()
    このスロー可能オブジェクトの短い記述を返します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

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

    forEach, spliterator
    修飾子と型
    メソッド
    説明
    default void
    forEach(Consumer<? super Throwable> action)
    Iterableの各要素に対して指定されたアクションを、すべての要素が処理されるか、アクションが例外をスローするまで実行します。
    default Spliterator<Throwable>
    spliterator()
    このIterableによって記述される要素に対するSpliteratorを作成します。

  • コンストラクタの詳細

    • DataTruncation

      public DataTruncation(int index, boolean parameter, boolean read, int dataSize, int transferSize)
      DataTruncationオブジェクトを生成します。その際SQLStateは、readがtrueに設定された場合は01004に初期化され、readがfalseに設定された場合は22001に初期化されます。また、reasonは「Data truncation」、ベンダー・コードは0、その他のフィールドは指定された値にそれぞれ設定されます。 causeは初期化されませんが、続いてThrowable.initCause(java.lang.Throwable)メソッドを呼び出すことで初期化できます。
      パラメータ:
      index - パラメータ値または列値のインデックス
      parameter - パラメータ値が切り詰められた場合はtrue
      read - 読込みが切り詰められた場合はtrue
      dataSize - データの元のサイズ
      transferSize - 切詰め後のサイズ

    • DataTruncation

      public DataTruncation(int index, boolean parameter, boolean read, int dataSize, int transferSize, Throwable cause)
      DataTruncationオブジェクトを生成します。その際SQLStateは、readがtrueに設定された場合は01004に初期化され、readがfalseに設定された場合は22001に初期化されます。また、reasonは「Data truncation」、ベンダー・コードは0、その他のフィールドは指定された値にそれぞれ設定されます。
      パラメータ:
      index - パラメータ値または列値のインデックス
      parameter - パラメータ値が切り詰められた場合はtrue
      read - 読込みが切り詰められた場合はtrue
      dataSize - データの元のサイズ
      transferSize - 切詰め後のサイズ
      cause - このDataTruncationの基となる原因(あとでgetCause()メソッドで取得するために保存されます); null値が許可されており、原因が存在しないか不明であることを示します。
      導入されたバージョン:
      1.6

  • メソッドの詳細

    • getIndex

      public int getIndex()
      切り詰められた列またはパラメータのインデックスを取得します。

      列またはパラメータのインデックスが不明な場合、この値は -1になります。その場合、parameterフィールドとreadフィールドは無視するようにしてください。

      戻り値:
      切り詰められたパラメータ値または列値のインデックス

    • getParameter

      public boolean getParameter()
      切り詰められたのが、パラメータ値、列値のいずれであるかを示します。
      戻り値:
      切り詰められたのがパラメータ値である場合はtrue、列値である場合はfalse

    • getRead

      public boolean getRead()
      値の切詰めが読取り時に発生したかどうかを示します。
      戻り値:
      値(データ)の切詰めがデータベースからの読取り時に発生した場合はtrue、書込み時に発生した場合はfalse

    • getDataSize

      public int getDataSize()
      転送される予定だったデータのバイト数を取得します。 データ変換が実行されていた場合、このバイト数は概算値になります。 サイズが不明な場合、この値は-1になります。
      戻り値:
      転送される予定だったデータのバイト数

    • getTransferSize

      public int getTransferSize()
      実際に転送されたデータのバイト数を取得します。 サイズが不明な場合、この値は-1になります。
      戻り値:
      実際に転送されたデータのバイト数