Class BufferRow

java.lang.Object

com.mysql.jdbc.ResultSetRow

com.mysql.jdbc.BufferRow

public class BufferRow
extends ResultSetRow

A RowHolder implementation that holds one row packet (which is re-used by the driver, and thus saves memory allocations), and tries when possible to avoid allocations to break out the results as individual byte[]s. (this isn't possible when doing things like reading floating point values).

Field Summary

Fields inherited from class ResultSetRow

exceptionInterceptor

Constructor Summary

Constructors

Constructor	Description
BufferRow(Buffer buf, Field[] fields, boolean isBinaryEncoded, ExceptionInterceptor exceptionInterceptor)

Method Summary

Modifier and Type	Method	Description
void	closeOpenStreams()	Called during navigation to next row to close all open streams.
InputStream	getBinaryInputStream(int columnIndex)	Returns data at the given index as an InputStream with no character conversion.
int	getBytesSize()
byte[]	getColumnValue(int index)	Returns the value at the given column (index starts at 0) "raw" (i.e. as-returned by the server).
Date	getDateFast(int columnIndex, MySQLConnection conn, ResultSetImpl rs, Calendar targetCalendar)
int	getInt(int columnIndex)	Returns the value at the given column (index starts at 0) as an int
long	getLong(int columnIndex)	Returns the value at the given column (index starts at 0) as a long
Date	getNativeDate(int columnIndex, MySQLConnection conn, ResultSetImpl rs, Calendar cal)
Object	getNativeDateTimeValue(int columnIndex, Calendar targetCalendar, int jdbcType, int mysqlType, TimeZone tz, boolean rollForward, MySQLConnection conn, ResultSetImpl rs)
double	getNativeDouble(int columnIndex)
float	getNativeFloat(int columnIndex)
int	getNativeInt(int columnIndex)
long	getNativeLong(int columnIndex)
short	getNativeShort(int columnIndex)
Time	getNativeTime(int columnIndex, Calendar targetCalendar, TimeZone tz, boolean rollForward, MySQLConnection conn, ResultSetImpl rs)
Timestamp	getNativeTimestamp(int columnIndex, Calendar targetCalendar, TimeZone tz, boolean rollForward, MySQLConnection conn, ResultSetImpl rs)
Reader	getReader(int columnIndex)
String	getString(int columnIndex, String encoding, MySQLConnection conn)	Returns the value at the given column (index starts at 0) as a java.lang.String with the requested encoding, using the given MySQLConnection to find character converters.
Time	getTimeFast(int columnIndex, Calendar targetCalendar, TimeZone tz, boolean rollForward, MySQLConnection conn, ResultSetImpl rs)
Timestamp	getTimestampFast(int columnIndex, Calendar targetCalendar, TimeZone tz, boolean rollForward, MySQLConnection conn, ResultSetImpl rs, boolean useGmtMillis, boolean useJDBCCompliantTimezoneShift)
boolean	isFloatingPointNumber(int index)	Could the column value at the given index (which starts at 0) be interpreted as a floating-point number (has +/-/E/e in it)?
boolean	isNull(int index)	Is the column value at the given index (which starts at 0) NULL?
long	length(int index)	Returns the length of the column at the given index (which starts at 0).
void	setColumnValue(int index, byte[] value)	Sets the given column value (only works currently with ByteArrayRowHolder).
ResultSetRow	setMetadata(Field[] f)

Methods inherited from class ResultSetRow

getDateFast, getNativeDate, getNativeDateTimeValue, getNativeDouble, getNativeFloat, getNativeInt, getNativeLong, getNativeShort, getNativeTime, getNativeTimestamp, getString, getTimeFast, getTimestampFast

Methods inherited from class Object

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

Constructor Details

BufferRow

public BufferRow(Buffer buf,
 Field[] fields,
 boolean isBinaryEncoded,
 ExceptionInterceptor exceptionInterceptor)
          throws SQLException

Throws:

SQLException

Method Details

closeOpenStreams

public void closeOpenStreams()

Description copied from class: ResultSetRow

Called during navigation to next row to close all open streams.

Specified by:

closeOpenStreams in class ResultSetRow

getBinaryInputStream

public InputStream getBinaryInputStream(int columnIndex)
                                 throws SQLException

Description copied from class: ResultSetRow

Returns data at the given index as an InputStream with no character conversion.

Specified by:

getBinaryInputStream in class ResultSetRow

Parameters:

columnIndex - of the column value (starting at 0) to return.

Returns:

the value at the given index as an InputStream or null if null.

Throws:

SQLException - if an error occurs while retrieving the value.

getColumnValue

public byte[] getColumnValue(int index)
                      throws SQLException

Description copied from class: ResultSetRow

Returns the value at the given column (index starts at 0) "raw" (i.e. as-returned by the server).

Specified by:

getColumnValue in class ResultSetRow

Parameters:

index - of the column value (starting at 0) to return.

Returns:

the value for the given column (including NULL if it is)

Throws:

SQLException - if an error occurs while retrieving the value.

getInt

public int getInt(int columnIndex)
           throws SQLException

Description copied from class: ResultSetRow

Returns the value at the given column (index starts at 0) as an int. *

Specified by:

getInt in class ResultSetRow

Returns:

the value for the given column (returns 0 if NULL, use isNull() to determine if the value was actually NULL)

Throws:

SQLException - if an error occurs while retrieving the value.

getLong

public long getLong(int columnIndex)
             throws SQLException

Description copied from class: ResultSetRow

Returns the value at the given column (index starts at 0) as a long. *

Specified by:

getLong in class ResultSetRow

Returns:

the value for the given column (returns 0 if NULL, use isNull() to determine if the value was actually NULL)

Throws:

SQLException - if an error occurs while retrieving the value.

getNativeDouble

public double getNativeDouble(int columnIndex)
                       throws SQLException

Specified by:

getNativeDouble in class ResultSetRow

Throws:

SQLException

getNativeFloat

public float getNativeFloat(int columnIndex)
                     throws SQLException

Specified by:

getNativeFloat in class ResultSetRow

Throws:

SQLException

getNativeInt

public int getNativeInt(int columnIndex)
                 throws SQLException

Specified by:

getNativeInt in class ResultSetRow

Throws:

SQLException

getNativeLong

public long getNativeLong(int columnIndex)
                   throws SQLException

Specified by:

getNativeLong in class ResultSetRow

Throws:

SQLException

getNativeShort

public short getNativeShort(int columnIndex)
                     throws SQLException

Specified by:

getNativeShort in class ResultSetRow

Throws:

SQLException

getNativeTimestamp

public Timestamp getNativeTimestamp(int columnIndex,
 Calendar targetCalendar,
 TimeZone tz,
 boolean rollForward,
 MySQLConnection conn,
 ResultSetImpl rs)
                             throws SQLException

Specified by:

getNativeTimestamp in class ResultSetRow

Throws:

SQLException

getReader

public Reader getReader(int columnIndex)
                 throws SQLException

Specified by:

getReader in class ResultSetRow

Throws:

SQLException

getString

public String getString(int columnIndex,
 String encoding,
 MySQLConnection conn)
                 throws SQLException

Description copied from class: ResultSetRow

Returns the value at the given column (index starts at 0) as a java.lang.String with the requested encoding, using the given MySQLConnection to find character converters.

Specified by:

getString in class ResultSetRow

Parameters:

columnIndex - of the column value (starting at 0) to return.

encoding - the Java name for the character encoding

conn - the connection that created this result set row

Returns:

the value for the given column (including NULL if it is) as a String

Throws:

SQLException - if an error occurs while retrieving the value.

getTimeFast

public Time getTimeFast(int columnIndex,
 Calendar targetCalendar,
 TimeZone tz,
 boolean rollForward,
 MySQLConnection conn,
 ResultSetImpl rs)
                 throws SQLException

Specified by:

getTimeFast in class ResultSetRow

Throws:

SQLException

getTimestampFast

public Timestamp getTimestampFast(int columnIndex,
 Calendar targetCalendar,
 TimeZone tz,
 boolean rollForward,
 MySQLConnection conn,
 ResultSetImpl rs,
 boolean useGmtMillis,
 boolean useJDBCCompliantTimezoneShift)
                           throws SQLException

Specified by:

getTimestampFast in class ResultSetRow

Throws:

SQLException

isFloatingPointNumber

public boolean isFloatingPointNumber(int index)
                              throws SQLException

Description copied from class: ResultSetRow

Could the column value at the given index (which starts at 0) be interpreted as a floating-point number (has +/-/E/e in it)?

Specified by:

isFloatingPointNumber in class ResultSetRow

Parameters:

index - of the column value (starting at 0) to check.

Returns:

true if the column value at the given index looks like it might be a floating-point number, false if not.

Throws:

SQLException - if an error occurs

isNull

public boolean isNull(int index)
               throws SQLException

Description copied from class: ResultSetRow

Is the column value at the given index (which starts at 0) NULL?

Specified by:

isNull in class ResultSetRow

Parameters:

index - of the column value (starting at 0) to check.

Returns:

true if the column value is NULL, false if not.

Throws:

SQLException - if an error occurs

length

public long length(int index)
            throws SQLException

Description copied from class: ResultSetRow

Returns the length of the column at the given index (which starts at 0).

Specified by:

length in class ResultSetRow

Parameters:

index - of the column value (starting at 0) for which to return the length.

Returns:

the length of the requested column, 0 if null (clients of this interface should use isNull() beforehand to determine status of NULL values in the column).

Throws:

SQLException

setColumnValue

public void setColumnValue(int index,
 byte[] value)
                    throws SQLException

Description copied from class: ResultSetRow

Sets the given column value (only works currently with ByteArrayRowHolder).

Specified by:

setColumnValue in class ResultSetRow

Parameters:

index - index of the column value (starting at 0) to set.

value - the (raw) value to set

Throws:

SQLException - if an error occurs, or the concrete RowHolder doesn't support this operation.

setMetadata

public ResultSetRow setMetadata(Field[] f)
                         throws SQLException

Overrides:

setMetadata in class ResultSetRow

Throws:

SQLException

getDateFast

public Date getDateFast(int columnIndex,
 MySQLConnection conn,
 ResultSetImpl rs,
 Calendar targetCalendar)
                 throws SQLException

Specified by:

getDateFast in class ResultSetRow

Throws:

SQLException

getNativeDate

public Date getNativeDate(int columnIndex,
 MySQLConnection conn,
 ResultSetImpl rs,
 Calendar cal)
                   throws SQLException

Specified by:

getNativeDate in class ResultSetRow

Throws:

SQLException

getNativeDateTimeValue

public Object getNativeDateTimeValue(int columnIndex,
 Calendar targetCalendar,
 int jdbcType,
 int mysqlType,
 TimeZone tz,
 boolean rollForward,
 MySQLConnection conn,
 ResultSetImpl rs)
                              throws SQLException

Specified by:

getNativeDateTimeValue in class ResultSetRow

Throws:

SQLException

getNativeTime

public Time getNativeTime(int columnIndex,
 Calendar targetCalendar,
 TimeZone tz,
 boolean rollForward,
 MySQLConnection conn,
 ResultSetImpl rs)
                   throws SQLException

Specified by:

getNativeTime in class ResultSetRow

Throws:

SQLException

getBytesSize

public int getBytesSize()

Specified by:

getBytesSize in class ResultSetRow