FileDocCategorySizeDatePackage
DataTruncation.javaAPI DocJava SE 5 API3453Fri Aug 26 14:57:18 BST 2005java.sql

DataTruncation

public class DataTruncation extends SQLWarning
An exception that reports a DataTruncation warning (on reads) or throws a DataTruncation exception (on writes) when JDBC unexpectedly truncates a data value.

The SQLstate for a DataTruncation is 01004.

Fields Summary
private int
index
private boolean
parameter
private boolean
read
private int
dataSize
private int
transferSize
Constructors Summary
public DataTruncation(int index, boolean parameter, boolean read, int dataSize, int transferSize)
Creates a DataTruncation object with the SQLState initialized to 01004, the reason set to "Data truncation", the vendorCode set to the SQLException default, 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

	super("Data truncation", "01004");
	this.index = index;
	this.parameter = parameter;
	this.read = read;
	this.dataSize = dataSize;
	this.transferSize = transferSize;
	DriverManager.println("    DataTruncation: index(" + index + 
			      ") parameter(" + parameter +
			      ") read(" + read +
			      ") data size(" + dataSize +
			      ") transfer size(" + 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;