borland.jbcl Packages  borland.jbcl Class Hierarchy  borland.jbcl.dataset 

ReadRow class (abstract)

java.lang.Object
   +----borland.jbcl.dataset.ReadRow
           +----borland.jbcl.dataset.ReadWriteRow
           +----borland.jbcl.dataset.InternalRow

About the ReadRow class

Variables  Properties  Methods  
The ReadRow class provides read access to a row of data. It has methods to read values from a single Column according to its data type, as well as methods to read the value from a Column of any data type into a Variant. It also has methods to compare or copy an entire row or a subset of its columns to another row.

The ReadRow class is extended by ReadWriteRow, which provides similar methods to write values to Columns. The ReadWriteRow class is in turn extended by DataSet, DataRow, and ParameterRow. These three classes all use the read and write methods in ReadRow and ReadWriteRow heavily to manipulate Column values.

You can use the equals(), findDifference(), and copyTo() methods to companre two rows from the same or different data sets, or to copy rows from one data set to another.


ReadRow variables

Variables implemented in this class

ReadRow properties

*Read-only properties **Write-only properties

Properties implemented in this class

Properties implemented in java.lang.Object

ReadRow methods

Methods implemented in this class

Methods implemented in java.lang.Object


ReadRow variables

rowValues

  protected RowVariant[] rowValues

ReadRow properties

columnCount

 public final int getColumnCount()
Read-only property that returns the count of Column components.

ReadRow methods

columnCount()

  public final int columnCount()
Returns the count of Column components.

copyTo(borland.jbcl.dataset.ReadWriteRow)

  public void copyTo(borland.jbcl.dataset.ReadWriteRow destRow)
Copies the row values from this row to destRow. If the destRow Column components are not from the same DataSet, columns with the same name are copied, assuming the data types of the columns match. If this row does not have columns with the same type and name as all columns in destRow, a DataSetException is thrown.

copyTo(java.lang.String[], borland.jbcl.dataset.ReadRow, java.lang.String[], borland.jbcl.dataset.ReadWriteRow)

  public static void copyTo(java.lang.String[] sourceNames, borland.jbcl.dataset.ReadRow sourceRow, java.lang.String[] destNames, borland.jbcl.dataset.ReadWriteRow destRow)
Copies values of a ReadRow to a ReadWriteRow given an array of source and destination names.

equals(borland.jbcl.dataset.ReadRow)

  public final boolean equals(borland.jbcl.dataset.ReadRow compareRow)
Returns true if the scoped values of columns in compareRow are equal to the column values in this row that have the same name. If this row does not have columns with the same name and type as all columns in compareRow, a DataSetException is thrown.

findDifference(int, borland.jbcl.dataset.ReadRow)

  public final int findDifference(int startOrdinal, borland.jbcl.dataset.ReadRow compareRow)
Returns the ordinal of the first column value that differs between this row and compareRow starting from startOrdinal. If there are no more differences, -1 is returned.

format(int)

  public final String format(int ordinal)
Returns the String representation of the value at the ordinal position using a Column formatter.

format(java.lang.String)

  public final String format(java.lang.String columnName)
Returns a String representation of the value at the ordinal position using a Column formatter.

getArrayLength(java.lang.String)

  public final int getArrayLength(java.lang.String columnName)

getBigDecimal(int)

  public final BigDecimal getBigDecimal(int ordinal)
Returns the value in the Column indicated by its ordinal position in the ReadRow as a BigDecimal. A DataSetException is thrown if the ordinal position ordinal does not exist, or if its data type is not Variant.BIGDECIMAL.

getBigDecimal(java.lang.String)

  public final BigDecimal getBigDecimal(java.lang.String columnName)
Returns the value in the Column named columnName as a BigDecimal. A DataSetException is thrown if columnName does not exist, or if its data type is not Variant.BIGDECIMAL.

This method is typically preferred over getBigDecimal(int) since it is more reliable. A column's ordinal value may unexpectedly change due to persistent columns, columns that are automatically added to a query to provide a unique row identifier, and other conditions.

getBinaryStream(int)

  public final InputStream getBinaryStream(int ordinal)

getBinaryStream(java.lang.String)

  public final InputStream getBinaryStream(java.lang.String columnName)

getBoolean(int)

  public final boolean getBoolean(int ordinal)

getBoolean(java.lang.String)

  public final boolean getBoolean(java.lang.String columnName)

getByte(int)

  public final byte getByte(int ordinal)

getByte(java.lang.String)

  public final byte getByte(java.lang.String columnName)

getByteArray(int)

  public final byte[] getByteArray(int ordinal)

getByteArray(java.lang.String)

  public final byte[] getByteArray(java.lang.String columnName)

getColumn(int)

  public final Column getColumn(int ordinal)
Get column commponent for columnName.

getColumn(java.lang.String)

  public final Column getColumn(java.lang.String columnName)
Get column commponent for columnName.

getDate(int)

  public final java.sql.Date getDate(int ordinal)

getDate(java.lang.String)

  public final java.sql.Date getDate(java.lang.String columnName)

getDouble(int)

  public final double getDouble(int ordinal)

getDouble(java.lang.String)

  public final double getDouble(java.lang.String columnName)

getFloat(int)

  public final float getFloat(int ordinal)

getFloat(java.lang.String)

  public final float getFloat(java.lang.String columnName)

getInt(int)

  public final int getInt(int ordinal)

getInt(java.lang.String)

  public final int getInt(java.lang.String columnName)

getLong(int)

  public final long getLong(int ordinal)

getLong(java.lang.String)

  public final long getLong(java.lang.String columnName)

getObject(int)

  public final Object getObject(int ordinal)

getObject(java.lang.String)

  public final Object getObject(java.lang.String columnName)

getShort(int)

  public final int getShort(int ordinal)

getShort(java.lang.String)

  public final short getShort(java.lang.String columnName)

getString(int)

  public final String getString(int ordinal)

getString(java.lang.String)

  public final String getString(java.lang.String columnName)

getTime(int)

  public final Time getTime(int ordinal)

getTime(java.lang.String)

  public final Time getTime(java.lang.String columnName)

getTimestamp(int)

  public final Timestamp getTimestamp(int ordinal)

getTimestamp(java.lang.String)

  public final Timestamp getTimestamp(java.lang.String columnName)

getVariant(int, borland.jbcl.util.Variant)

  public void getVariant(int ordinal, borland.jbcl.util.Variant value)

getVariant(java.lang.String, borland.jbcl.util.Variant)

  public void getVariant(java.lang.String columnName, borland.jbcl.util.Variant value)

hasColumn(java.lang.String)

  public final Column hasColumn(java.lang.String columnName)
Get a Column by its String name. This method is similar to getColumn, but returns null if the Column not found rather than throwing a DataSetException.

isAssignedNull(int)

  public final boolean isAssignedNull(int ordinal)

isAssignedNull(java.lang.String)

  public final boolean isAssignedNull(java.lang.String columnName)

isNull(int)

  public final boolean isNull(int ordinal)

isNull(java.lang.String)

  public final boolean isNull(java.lang.String columnName)

isUnassignedNull(int)

  public final boolean isUnassignedNull(int ordinal)

isUnassignedNull(java.lang.String)

  public final boolean isUnassignedNull(java.lang.String columnName)

toString()

  public String toString()

Overrides: java.lang.Object.toString()