Module java.sql

软件包 java.sql

Class DataTruncation

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.sql.SQLException

java.sql.SQLWarning

java.sql.DataTruncation

All Implemented Interfaces:

Serializable ， Iterable<Throwable>

public class DataTruncation
extends SQLWarning

由于其超出MaxFieldSize原因，数据值意外截断时，异常抛出DataTruncation异常（写入）或报告为DataTruncation警告（读取时）。

读取期间的DataTruncation的DataTruncation为01004 。

写入期间的DataTruncation的DataTruncation为22001 。

从以下版本开始：

1.1

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor	描述
DataTruncation(int index, boolean parameter, boolean read, int dataSize, int transferSize)	创建 DataTruncation与初始化为01004时的SQLState对象 read设定为 true时和22001 read设定为 false ，设置为“数据截断”，供应商代码设置为0的原因，而其他字段被设置为给定值。
DataTruncation(int index, boolean parameter, boolean read, int dataSize, int transferSize, Throwable cause)	创建 DataTruncation与初始化为01004时的SQLState对象 read设定为 true时和22001 read设定为 false ，设置为“数据截断”，供应商代码设置为0的原因，而其他字段被设置为给定值。

方法摘要

Modifier and Type	方法	描述
int	getDataSize()	获取应该传输的数据的字节数。
int	getIndex()	检索被截断的列或参数的索引。
boolean	getParameter()	指示truncated的值是参数值还是列值。
boolean	getRead()	指示值是否在读取时被截断。
int	getTransferSize()	获取实际传输的数据的字节数。

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from class java.lang.Object

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

Methods inherited from class java.sql.SQLException

getErrorCode, getNextException, getSQLState, iterator, setNextException

Methods inherited from class java.sql.SQLWarning

getNextWarning, setNextWarning

Methods inherited from class java.lang.Throwable

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

构造方法详细信息

DataTruncation

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

创建DataTruncation与初始化为01004时的SQLState对象read设定为true时和22001 read设定为false ，设置为“数据截断”，供应商代码设置为0的原因，而其他字段被设置为给定值。 cause未初始化，可以随后通过调用Throwable.initCause(java.lang.Throwable)方法进行初始化。

参数

index - 参数或列值的索引

parameter - 如果参数值被截断， parameter true

read - 如果读取被截断， read true

dataSize - 数据的原始大小

transferSize - 截断后的大小

DataTruncation

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

创建 DataTruncation与初始化为01004时的SQLState对象 read设定为 true时和22001 read设定为 false ，设置为“数据截断”，供应商代码设置为0的原因，而其他字段被设置为给定值。

参数

index - 参数或列值的索引

parameter - 如果参数值被截断， parameter true

read - 如果读取被截断， read true

dataSize - 数据的原始大小

transferSize - 截断后的大小

cause - DataTruncation （其保存以供getCause()方法稍后检索）的根本原因; 可能为空，表示原因不存在或未知。

从以下版本开始：

1.6

方法详细信息

getIndex

public int getIndex()

检索被截断的列或参数的索引。

如果列或参数索引未知，则可能为-1，在这种情况下，应忽略parameter和read字段。

结果

截断的参数或列值的索引

getParameter

public boolean getParameter()

指示truncated的值是参数值还是列值。

结果

true如果truncated的值是一个参数; false如果它是列值

getRead

public boolean getRead()

指示值是否在读取时被截断。

结果

true如果从数据库读取值被截断; false如果数据在写入时被截断

getDataSize

public int getDataSize()

获取应该传输的数据的字节数。 如果正在执行数据转换，此数字可能是近似值。 如果大小未知，则该值可能为-1 。

结果

应该传输的数据的字节数

getTransferSize

public int getTransferSize()

获取实际传输的数据的字节数。 如果大小未知，则该值可能为-1 。

结果

实际传输的数据的字节数