Use is subject to License Terms. Your use of this web site or any of its content or software indicates your agreement to be bound by these License Terms.
Copyright © 2006 Sun Microsystems, Inc. All rights reserved.
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:
- java.io.Serializable
- 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
.
- See Also:
- Serialized Form
Constructor Summary |
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. |
Method Summary |
int |
getDataSize()
Gets the number of bytes of data that should have been transferred. |
int |
getIndex()
Retrieves the index of the column or parameter that was truncated. |
boolean |
getParameter()
Indicates whether the value truncated was a parameter value or
a column value. |
boolean |
getRead()
Indicates whether or not the value was truncated on a read. |
int |
getTransferSize()
Gets the number of bytes of data actually transferred. |
java.lang.String |
toString()
Outputs contents of DataTruncation warning |
Methods inherited from class java.lang.Throwable |
fillInStackTrace, getLocalizedMessage, getMessage, printStackTrace, printStackTrace, printStackTrace |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
DataTruncation
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.
- Parameters:
index
- The index of the parameter or column valueparameter
- true if a parameter value was truncatedread
- true if a read was truncateddataSize
- the original size of the datatransferSize
- the size after truncation
getIndex
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:
- the index of the truncated paramter or column value
getParameter
public boolean getParameter()
- Indicates whether the value truncated was a parameter value or
a column value.
- Returns:
true
if the value truncated was a parameter;
false
if it was a column value
getRead
public boolean getRead()
- Indicates whether or not the value was truncated on a read.
- Returns:
true
if the value was truncated when read from
the database; false
if the data was truncated on a write
getDataSize
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:
- the number of bytes of data that should have been transferred
getTransferSize
public int getTransferSize()
- Gets the number of bytes of data actually transferred.
The value may be
-1
if the size is unknown.
- Returns:
- the number of bytes of data actually transferred
toString
public java.lang.String toString()
- Outputs contents of
DataTruncation
warning
- Overrides:
toString
in class SQLWarning
- Returns:
- the contents of the
DataTruncation
warning
Copyright © 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to License Terms. Your use of this web site or any of its content or software indicates your agreement to be bound by these License Terms.
For more information, please consult the JSR 169 specification.