java.sql
類別 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

以 DataTruncation 異常形式拋出的異常（寫入時），或者由於除資料值超出 MaxFieldSize 之外的某種原因意外地截斷該資料值時以 DataTruncation 警告形式報告的異常（讀取時）。

讀取期間 DataTruncation 的 SQLstate 為 01004。

寫入期間 DataTruncation 的 SQLstate 為 22001。

另請參見：

序列化表格

建構子摘要

DataTruncation(int index, boolean parameter, boolean read, int dataSize, int transferSize)
創建一個 DataTruncation 物件，當 read 被設置為 true 時，該物件的 SQLState 初始化為 01004，當 read 被設置為 false 時，則初始化為 22001，reason 被設置為 "Data truncation"，供應商程式碼被設置為 0，其他欄位被設置為給定值。

DataTruncation(int index, boolean parameter, boolean read, int dataSize, int transferSize, Throwable cause)
創建一個 DataTruncation 物件，當 read 被設置為 true 時，該物件的 SQLState 初始化為 01004，當 read 被設置為 false 時，則初始化為 22001，reason 被設置為 "Data truncation"，供應商程式碼被設置為 0，其他欄位被設置為給定值。

方法摘要

int	getDataSize() 獲得應該傳輸的資料位元組數。
int	getIndex() 獲取被截斷的列或參數的索引。
boolean	getParameter() 指示被截斷的值是一個參數值還是一個列值。
boolean	getRead() 指示該值是否在讀取時被截斷。
int	getTransferSize() 獲得實際傳輸的資料位元組數。

從類別 java.sql.SQLWarning 繼承的方法

getNextWarning, setNextWarning

從類別 java.sql.SQLException 繼承的方法

getErrorCode, getNextException, getSQLState, iterator, setNextException

從類別 java.lang.Throwable 繼承的方法

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

建構子詳細資訊

DataTruncation

public DataTruncation(int index,
                      boolean parameter,
                      boolean read,
                      int dataSize,
                      int transferSize)

創建一個 DataTruncation 物件，當 read 被設置為 true 時，該物件的 SQLState 初始化為 01004，當 read 被設置為 false 時，則初始化為 22001，reason 被設置為 "Data truncation"，供應商程式碼被設置為 0，其他欄位被設置為給定值。cause 尚未進行初始化，隨後可通過調用 Throwable.initCause(java.lang.Throwable) 方法初始化。

參數：

index - 參數或列值的索引

parameter - 如果參數值被截斷，則該參數為 true

read - 如果某一 read 欄位被截斷，則該參數為 true

dataSize - 資料的原始大小

transferSize - 截斷後的大小

DataTruncation

public DataTruncation(int index,
                      boolean parameter,
                      boolean read,
                      int dataSize,
                      int transferSize,
                      Throwable cause)

創建一個 DataTruncation 物件，當 read 被設置為 true 時，該物件的 SQLState 初始化為 01004，當 read 被設置為 false 時，則初始化為 22001，reason 被設置為 "Data truncation"，供應商程式碼被設置為 0，其他欄位被設置為給定值。

參數：

index - 參數或列值的索引

parameter - 如果參數值被截斷，則該參數為 true

read - 如果某一 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。

返回：

實際傳輸的資料位元組數