public class

DataTruncation

extends SQLWarning
implements Serializable
java.lang.Object
   ↳ java.lang.Throwable
     ↳ java.lang.Exception
       ↳ java.sql.SQLException
         ↳ java.sql.SQLWarning
           ↳ java.sql.DataTruncation

Class Overview

An exception which is thrown when a JDBC driver unexpectedly truncates a data value either when reading (resulting in warning), or when writing data (resulting in an error). The SQLState error code for truncated data is 01004.

Summary

Public Constructors
DataTruncation(int index, boolean parameter, boolean read, int dataSize, int transferSize)
Creates the DataTruncation object.
DataTruncation(int index, boolean parameter, boolean read, int dataSize, int transferSize, Throwable cause)
Creates a DataTruncation.
Public Methods
int getDataSize()
Gets the number of bytes of data that should have been read/written.
int getIndex()
Gets the index of the column or of the parameter that was truncated.
boolean getParameter()
Gets whether the value truncated was a parameter value or a column value.
boolean getRead()
Gets whether the value was truncated on a read operation or a write operation
int getTransferSize()
Gets the number of bytes of data that was actually read or written.
[Expand]
Inherited Methods
From class java.sql.SQLWarning
From class java.sql.SQLException
From class java.lang.Throwable
From class java.lang.Object
From interface java.lang.Iterable

Public Constructors

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

Since: API Level 1

Creates the DataTruncation object. The reason is set to "Data truncation", the ErrorCode is set to the SQLException default value, and the other fields are set to the values supplied as arguments.

Parameters
index the Index value of the column value or parameter that was truncated.
parameter true if it was a parameter value that was truncated, false otherwise.
read true if the truncation occurred on a read operation, false otherwise.
dataSize the original size of the truncated data.
transferSize the size of the data after truncation.

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

Since: API Level 9

Creates a DataTruncation. The Reason is set to "Data truncation", the ErrorCode is set to the SQLException default value and other fields are set to the values supplied on this method.

Parameters
index the Index value of the column value or parameter that was truncated
parameter true if it was a Parameter value that was truncated, false otherwise
read true if the truncation occurred on a read operation, false otherwise
dataSize the original size of the truncated data
transferSize the size of the data after truncation
cause the root reason for this DataTruncation

Public Methods

public int getDataSize ()

Since: API Level 1

Gets the number of bytes of data that should have been read/written.

Returns
  • the number of bytes that should have been read or written. The value is set to -1 if the size is unknown.

public int getIndex ()

Since: API Level 1

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

Returns
  • the index number of the column or of the parameter.

public boolean getParameter ()

Since: API Level 1

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

Returns
  • true if the value truncated was a parameter value, false if it was a column value.

public boolean getRead ()

Since: API Level 1

Gets whether the value was truncated on a read operation or a write operation

Returns
  • true if the value was truncated on a read operation, false otherwise.

public int getTransferSize ()

Since: API Level 1

Gets the number of bytes of data that was actually read or written.

Returns
  • the number of bytes actually read/written. The value may be set to -1 if the size is unknown.