Package org.firebirdsql.jdbc.field

Class FBWorkaroundStringField

java.lang.Object

org.firebirdsql.jdbc.field.FBField

org.firebirdsql.jdbc.field.FBWorkaroundStringField

public final class FBWorkaroundStringField
extends FBField

Class implementing workaround for "operation was cancelled" bug in server. When we send some string data exceeding maximum length of the corresponding field causes "operation was cancelled" in remote module of the server instead of "arithmetic exception..." error. This makes code debugging harder, since error message is not very informative.

However we cannot simply check length locally. Maximum allowed length in bytes is connected with the character set of the field as defined lengh * maximum number of bytes per character in that encoding. However this does not work for system tables which have defined length 31, character set UNICODE_FSS and maximum allowed length of 31 (instead of 31 * 3 = 63).

Until this bug is fixed in the engine we will simply check if field belongs to the system table and do not throw data truncation error locally.

Author:

Roman Rokytskyy, Mark Rotteveel

Field Summary

Fields

Modifier and Type	Field	Description
protected final int	possibleCharLength

Fields inherited from class org.firebirdsql.jdbc.field.FBField

fieldDescriptor, gdsHelper, requiredType, scale

Method Summary

Modifier and Type	Method	Description
BigDecimal	getBigDecimal()
BigInteger	getBigInteger()
InputStream	getBinaryStream()
boolean	getBoolean()
byte	getByte()
byte[]	getBytes()
Date	getDate()
Date	getDate(Calendar cal)
double	getDouble()
float	getFloat()
int	getInt()
long	getLong()
short	getShort()
String	getString()	Get string value of this field.
Time	getTime()
Time	getTime(Calendar cal)
Timestamp	getTimestamp()
Timestamp	getTimestamp(Calendar cal)
void	setBigDecimal(BigDecimal value)
void	setBigInteger(BigInteger value)
protected void	setBinaryStreamInternal(InputStream in, long length)
void	setBoolean(boolean value)
void	setByte(byte value)
void	setBytes(byte[] value)
protected void	setCharacterStreamInternal(Reader in, long length)
void	setDate(Date value)
void	setDate(Date value, Calendar cal)
void	setDouble(double value)
void	setFloat(float value)
void	setInteger(int value)
void	setLong(long value)
void	setShort(short value)
void	setString(String value)
void	setStringForced(String value)	Set string value without any check of its length.
void	setTime(Time value)
void	setTime(Time value, Calendar cal)
void	setTimestamp(Timestamp value)
void	setTimestamp(Timestamp value, Calendar cal)
void	setTrimString(boolean trimString)

Methods inherited from class org.firebirdsql.jdbc.field.FBField

close, createField, getAlias, getArray, getBigDecimal, getBlob, getCharacterStream, getClob, getDatatypeCoder, getDecimal, getDecimal, getFieldData, getName, getObject, getObject, getObject, getObjectConverter, getRawDateTimeStruct, getRef, getRelationName, getRowId, isInvertTimeZone, isNull, isType, setBinaryStream, setBinaryStream, setBinaryStream, setBlob, setCharacterStream, setCharacterStream, setCharacterStream, setClob, setConnection, setDecimal, setFieldData, setNull, setObject, setRawDateTimeStruct, setRequiredType, setRowId

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

possibleCharLength

protected final int possibleCharLength

Method Details

setTrimString

public void setTrimString(boolean trimString)

setString

public void setString(String value)
               throws SQLException

Throws:

SQLException

setStringForced

public void setStringForced(String value)
                     throws SQLException

Set string value without any check of its length. This is a workaround for the problem described above.

Parameters:

value - value to set.

Throws:

SQLException - if something went wrong.

getString

public String getString()
                 throws SQLException

Get string value of this field.

Returns:

string value of this filed or null if the value is NULL.

Throws:

SQLException

getByte

public byte getByte()
             throws SQLException

Overrides:

getByte in class FBField

Throws:

SQLException

getShort

public short getShort()
               throws SQLException

Overrides:

getShort in class FBField

Throws:

SQLException

getInt

public int getInt()
           throws SQLException

Overrides:

getInt in class FBField

Throws:

SQLException

getLong

public long getLong()
             throws SQLException

Overrides:

getLong in class FBField

Throws:

SQLException

getBigDecimal

public BigDecimal getBigDecimal()
                         throws SQLException

Overrides:

getBigDecimal in class FBField

Throws:

SQLException

getFloat

public float getFloat()
               throws SQLException

Overrides:

getFloat in class FBField

Throws:

SQLException

getDouble

public double getDouble()
                 throws SQLException

Overrides:

getDouble in class FBField

Throws:

SQLException

getBoolean

public boolean getBoolean()
                   throws SQLException

Overrides:

getBoolean in class FBField

Throws:

SQLException

getBinaryStream

public InputStream getBinaryStream()
                            throws SQLException

Overrides:

getBinaryStream in class FBField

Throws:

SQLException

getBytes

public byte[] getBytes()
                throws SQLException

Overrides:

getBytes in class FBField

Throws:

SQLException

getDate

public Date getDate(Calendar cal)
             throws SQLException

Overrides:

getDate in class FBField

Throws:

SQLException

getDate

public Date getDate()
             throws SQLException

Overrides:

getDate in class FBField

Throws:

SQLException

getTime

public Time getTime(Calendar cal)
             throws SQLException

Overrides:

getTime in class FBField

Throws:

SQLException

getTime

public Time getTime()
             throws SQLException

Overrides:

getTime in class FBField

Throws:

SQLException

getTimestamp

public Timestamp getTimestamp(Calendar cal)
                       throws SQLException

Overrides:

getTimestamp in class FBField

Throws:

SQLException

getTimestamp

public Timestamp getTimestamp()
                       throws SQLException

Overrides:

getTimestamp in class FBField

Throws:

SQLException

getBigInteger

public BigInteger getBigInteger()
                         throws SQLException

Overrides:

getBigInteger in class FBField

Throws:

SQLException

setByte

public void setByte(byte value)
             throws SQLException

Overrides:

setByte in class FBField

Throws:

SQLException

setShort

public void setShort(short value)
              throws SQLException

Overrides:

setShort in class FBField

Throws:

SQLException

setInteger

public void setInteger(int value)
                throws SQLException

Overrides:

setInteger in class FBField

Throws:

SQLException

setLong

public void setLong(long value)
             throws SQLException

Overrides:

setLong in class FBField

Throws:

SQLException

setFloat

public void setFloat(float value)
              throws SQLException

Overrides:

setFloat in class FBField

Throws:

SQLException

setDouble

public void setDouble(double value)
               throws SQLException

Overrides:

setDouble in class FBField

Throws:

SQLException

setBigDecimal

public void setBigDecimal(BigDecimal value)
                   throws SQLException

Overrides:

setBigDecimal in class FBField

Throws:

SQLException

setBoolean

public void setBoolean(boolean value)
                throws SQLException

Overrides:

setBoolean in class FBField

Throws:

SQLException

setBinaryStreamInternal

protected void setBinaryStreamInternal(InputStream in,
 long length)
                                throws SQLException

Overrides:

setBinaryStreamInternal in class FBField

Throws:

SQLException

setCharacterStreamInternal

protected void setCharacterStreamInternal(Reader in,
 long length)
                                   throws SQLException

Overrides:

setCharacterStreamInternal in class FBField

Throws:

SQLException

setBytes

public void setBytes(byte[] value)
              throws SQLException

Overrides:

setBytes in class FBField

Throws:

SQLException

setDate

public void setDate(Date value,
 Calendar cal)
             throws SQLException

Overrides:

setDate in class FBField

Throws:

SQLException

setDate

public void setDate(Date value)
             throws SQLException

Overrides:

setDate in class FBField

Throws:

SQLException

setTime

public void setTime(Time value,
 Calendar cal)
             throws SQLException

Overrides:

setTime in class FBField

Throws:

SQLException

setTime

public void setTime(Time value)
             throws SQLException

Overrides:

setTime in class FBField

Throws:

SQLException

setTimestamp

public void setTimestamp(Timestamp value,
 Calendar cal)
                  throws SQLException

Overrides:

setTimestamp in class FBField

Throws:

SQLException

setTimestamp

public void setTimestamp(Timestamp value)
                  throws SQLException

Overrides:

setTimestamp in class FBField

Throws:

SQLException

setBigInteger

public void setBigInteger(BigInteger value)
                   throws SQLException

Overrides:

setBigInteger in class FBField

Throws:

SQLException