OpenJDK 1.23 · java.sql.DataTruncation · APIdia, the JavaDoc alternative

An exception thrown as a DataTruncation exception (on writes) or reported as a DataTruncation warning (on reads) when a data values is unexpectedly truncated for reasons other than its having exceeded MaxFieldSize.

The SQLstate for a DataTruncation during read is 01004.

The SQLstate for a DataTruncation during write is 22001.

Modifier and Type	Field and Description
private int	dataSize
private int	index
private boolean	parameter
private boolean	read
private static final long	serialVersionUID Hides java.sql.SQLWarning.serialVersionUID.
private int	transferSize

Constructor Summary

Access Constructor and Description

Access	Constructor and Description
public	DataTruncation(int The index of the parameter or column value index, boolean true if a parameter value was truncated parameter, boolean true if a read was truncated read, int the original size of the data dataSize, int the size after truncation transferSize) Creates a `DataTruncation` object with the SQLState initialized to 01004 when `read` is set to `true` and 22001 when `read` is set to `false`, the reason set to "Data truncation", the vendor code set to 0, and the other fields set to the given values.
public	DataTruncation(int The index of the parameter or column value index, boolean true if a parameter value was truncated parameter, boolean true if a read was truncated read, int the original size of the data dataSize, int the size after truncation transferSize, Throwable the underlying reason for this `DataTruncation` (which is saved for later retrieval by the `getCause()` method); may be null indicating the cause is non-existent or unknown. cause) Creates a `DataTruncation` object with the SQLState initialized to 01004 when `read` is set to `true` and 22001 when `read` is set to `false`, the reason set to "Data truncation", the vendor code set to 0, and the other fields set to the given values.

public

DataTruncation(int

The index of the parameter or column value

index, boolean

true if a parameter value was truncated

parameter, boolean

true if a read was truncated

read, int

the original size of the data

dataSize, int

the size after truncation

transferSize)

public

DataTruncation(int

The index of the parameter or column value

index, boolean

true if a parameter value was truncated

parameter, boolean

true if a read was truncated

read, int

the original size of the data

dataSize, int

the size after truncation

transferSize, Throwable

the underlying reason for this DataTruncation (which is saved for later retrieval by the getCause() method); may be null indicating the cause is non-existent or unknown.

cause)

Method Summary

Modifier and Type	Method and Description
public int	Returns: the number of bytes of data that should have been transferred getDataSize() Gets the number of bytes of data that should have been transferred.
public int	Returns: the index of the truncated parameter or column value getIndex() Retrieves the index of the column or parameter that was truncated.
public boolean	Returns: `true` if the value truncated was a parameter; `false` if it was a column value getParameter() Indicates whether the value truncated was a parameter value or a column value.
public boolean	Returns: `true` if the value was truncated when read from the database; `false` if the data was truncated on a write getRead() Indicates whether or not the value was truncated on a read.
public int	Returns: the number of bytes of data actually transferred getTransferSize() Gets the number of bytes of data actually transferred.

Inherited from java.sql.SQLWarning:: getNextWarning setNextWarning

Field Detail

dataSize	back to summary
private int dataSize

index	back to summary
private int index

parameter	back to summary
private boolean parameter

read	back to summary
private boolean read

serialVersionUID	back to summary
private static final long serialVersionUID Hides java.sql.SQLWarning.serialVersionUID.

transferSize	back to summary
private int transferSize

Constructor Detail

DataTruncation back to summary

DataTruncation	back to summary
public DataTruncation(int index, boolean parameter, boolean read, int dataSize, int transferSize) Creates a `DataTruncation` object with the SQLState initialized to 01004 when `read` is set to `true` and 22001 when `read` is set to `false`, the reason set to "Data truncation", the vendor code set to 0, and the other fields set to the given values. The `cause` is not initialized, and may subsequently be initialized by a call to the `Throwable#initCause(java.lang.Throwable)` method. Parameters index:int The index of the parameter or column value parameter:boolean true if a parameter value was truncated read:boolean true if a read was truncated dataSize:int the original size of the data transferSize:int the size after truncation

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

Creates a DataTruncation object with the SQLState initialized to 01004 when read is set to true and 22001 when read is set to false, the reason set to "Data truncation", the vendor code set to 0, and the other fields set to the given values. The cause is not initialized, and may subsequently be initialized by a call to the Throwable#initCause(java.lang.Throwable) method.

Parameters

index:int: The index of the parameter or column value
parameter:boolean: true if a parameter value was truncated
read:boolean: true if a read was truncated
dataSize:int: the original size of the data
transferSize:int: the size after truncation

DataTruncation back to summary

DataTruncation	back to summary
public DataTruncation(int index, boolean parameter, boolean read, int dataSize, int transferSize, Throwable cause) Creates a `DataTruncation` object with the SQLState initialized to 01004 when `read` is set to `true` and 22001 when `read` is set to `false`, the reason set to "Data truncation", the vendor code set to 0, and the other fields set to the given values. Parameters index:int The index of the parameter or column value parameter:boolean true if a parameter value was truncated read:boolean true if a read was truncated dataSize:int the original size of the data transferSize:int the size after truncation cause:Throwable the underlying reason for this `DataTruncation` (which is saved for later retrieval by the `getCause()` method); may be null indicating the cause is non-existent or unknown. Since 1.6

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

Parameters

index:int: The index of the parameter or column value
parameter:boolean: true if a parameter value was truncated
read:boolean: true if a read was truncated
dataSize:int: the original size of the data
transferSize:int: the size after truncation
cause:Throwable: the underlying reason for this DataTruncation (which is saved for later retrieval by the getCause() method); may be null indicating the cause is non-existent or unknown.

Since

1.6

Method Detail

getDataSize back to summary

getDataSize	back to summary
public int getDataSize() Gets the number of bytes of data that should have been transferred. This number may be approximate if data conversions were being performed. The value may be `-1` if the size is unknown. Returns:int the number of bytes of data that should have been transferred

public int getDataSize()

Gets the number of bytes of data that should have been transferred. This number may be approximate if data conversions were being performed. The value may be -1 if the size is unknown.

Returns:int: the number of bytes of data that should have been transferred

getIndex back to summary

getIndex	back to summary
public int getIndex() Retrieves the index of the column or parameter that was truncated. This may be -1 if the column or parameter index is unknown, in which case the `parameter` and `read` fields should be ignored. Returns:int the index of the truncated parameter or column value

public int getIndex()

Retrieves the index of the column or parameter that was truncated.

This may be -1 if the column or parameter index is unknown, in which case the parameter and read fields should be ignored.

Returns:int: the index of the truncated parameter or column value

getParameter back to summary

getParameter	back to summary
public boolean getParameter() Indicates whether the value truncated was a parameter value or a column value. Returns:boolean `true` if the value truncated was a parameter; `false` if it was a column value

public boolean getParameter()

Indicates whether the value truncated was a parameter value or a column value.

Returns:boolean: true if the value truncated was a parameter; false if it was a column value

getRead back to summary

getRead	back to summary
public boolean getRead() Indicates whether or not the value was truncated on a read. Returns:boolean `true` if the value was truncated when read from the database; `false` if the data was truncated on a write

public boolean getRead()

Indicates whether or not the value was truncated on a read.

Returns:boolean: true if the value was truncated when read from the database; false if the data was truncated on a write

getTransferSize back to summary

getTransferSize	back to summary
public int getTransferSize() Gets the number of bytes of data actually transferred. The value may be `-1` if the size is unknown. Returns:int the number of bytes of data actually transferred

public int getTransferSize()

Gets the number of bytes of data actually transferred. The value may be -1 if the size is unknown.

Returns:int: the number of bytes of data actually transferred

public Class DataTruncation

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail