FileDocCategorySizeDatePackage
DataTruncation.javaAPI DocJava SE 6 API5132Tue Jun 10 00:25:50 BST 2008java.sql

DataTruncation

public class DataTruncation extends SQLWarning
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 execeeded MaxFieldSize.

The SQLstate for a DataTruncation during read is 01004.

The SQLstate for a DataTruncation during write is 22001.

Fields Summary
private int
index
private boolean
parameter
private boolean
read
private int
dataSize
private int
transferSize
private static final long
serialVersionUID
Constructors 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 {@link Throwable#initCause(java.lang.Throwable)} method.

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

	super("Data truncation", read == true?"01004":"22001");
	this.index = index;
	this.parameter = parameter;
	this.read = read;
	this.dataSize = dataSize;
	this.transferSize = transferSize;
        
    
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.

param
index The index of the parameter or column value
param
parameter true if a parameter value was truncated
param
read true if a read was truncated
param
dataSize the original size of the data
param
transferSize the size after truncation
param
cause 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

	super("Data truncation", read == true?"01004":"22001",cause);
	this.index = index;
	this.parameter = parameter;
	this.read = read;
	this.dataSize = dataSize;
	this.transferSize = transferSize;
    
Methods Summary
public intgetDataSize()
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.

return
the number of bytes of data that should have been transferred

	return dataSize;
    
public intgetIndex()
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.

return
the index of the truncated paramter or column value

	return index;
    
public booleangetParameter()
Indicates whether the value truncated was a parameter value or a column value.

return
true if the value truncated was a parameter; false if it was a column value

	return parameter;
    
public booleangetRead()
Indicates whether or not the value was truncated on a read.

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

	return read;
    
public intgetTransferSize()
Gets the number of bytes of data actually transferred. The value may be -1 if the size is unknown.

return
the number of bytes of data actually transferred

	return transferSize;