borland Packages Class Hierarchy jbcl.dataset Package Index
java.lang.Object +----borland.jbcl.dataset.ReadRow +----borland.jbcl.dataset.ReadWriteRow +----borland.jbcl.dataset.InternalRow
Properties Methods
Implements Serializable
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 compare two rows from the same or different data sets, or to copy rows from one data set to another.
public final int getColumnCount()Read-only property that returns the count of Column components.
public Column[] getColumns()Read-only property that returns an array of columns. This property is used by the JBuilder UI tools.
public void copyTo(borland.jbcl.dataset.ReadWriteRow destRow)Copies the row values from this row to destRow. If the Column components of the destRow 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.
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.
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.
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.
public final String format(int ordinal)Returns the String representation of the value at the ordinal position using a Column formatter.
public final String format(java.lang.String columnName)Returns a String representation of the value at the ordinal position using a Column formatter.
public final int getArrayLength(java.lang.String columnName)Returns the length of the Byte Array.
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.
See also: 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.
See also: getBigDecimal(int)
public final InputStream getBinaryStream(int ordinal)Returns the value in the Column indicated by its ordinal position in the ReadRow as a BinaryStream. A DataSetException is thrown if the ordinal position ordinal does not exist, or if its data type is not Variant.BinaryStream.
See also: getBinaryStream(java.lang.String)
public final InputStream getBinaryStream(java.lang.String columnName)Returns the value in the Column named columnName as a BinaryStream. A DataSetException is thrown if columnName does not exist, or if its data type is not Variant.BinaryStream.
This method is typically preferred over getBinaryStream(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.
See also: getBinaryStream(int)
public final boolean getBoolean(int ordinal)Returns the value in the Column indicated by its ordinal position in the ReadRow as a Boolean. A DataSetException is thrown if the ordinal position ordinal does not exist, or if its data type is not Variant.Boolean.
See also: getBoolean(java.lang.String)
public final boolean getBoolean(java.lang.String columnName)Returns the value in the Column named columnName as a Boolean. A DataSetException is thrown if columnName does not exist, or if its data type is not Variant.Boolean.
This method is typically preferred over getBoolean(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.
See also: getBoolean(int)
public final byte getByte(int ordinal)Returns the value in the Column indicated by its ordinal position in the ReadRow as a Byte. A DataSetException is thrown if the ordinal position ordinal does not exist, or if its data type is not Variant.Byte.
See also: getByte(java.lang.String)
public final byte getByte(java.lang.String columnName)Returns the value in the Column named columnName as a Byte. A DataSetException is thrown if columnName does not exist, or if its data type is not Variant.Byte.
This method is typically preferred over getByte(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.
See also: getByte(int)
public final byte[] getByteArray(int ordinal)Returns the value in the Column indicated by its ordinal position in the ReadRow as a ByteArray. A DataSetException is thrown if the ordinal position ordinal does not exist, or if its data type is not Variant.ByteArray.
See also: getByteArray(java.lang.String)
public final byte[] getByteArray(java.lang.String columnName)Returns the value in the Column named columnName as a ByteArray. A DataSetException is thrown if columnName does not exist, or if its data type is not Variant.ByteArray.
This method is typically preferred over getByteArray(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.
See also: getByteArray(int)
public final Column getColumn(int ordinal)Returns the Column component at the specified ordinal index location.
public final Column getColumn(java.lang.String columnName)Returns the column component for the specified columnName.
public final String[] getColumnNames(int columnCount)Returns an array containing the names of the first columnCount Columns.
public final java.sql.Date getDate(int ordinal)Returns the value in the Column indicated by its ordinal position in the ReadRow as a Date. A DataSetException is thrown if the ordinal position ordinal does not exist, or if its data type is not Variant.Date.
See also: getDate(java.lang.String)
public final java.sql.Date getDate(java.lang.String columnName)Returns the value in the Column named columnName as a Date. A DataSetException is thrown if columnName does not exist, or if its data type is not Variant.Date.
This method is typically preferred over getDate(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.
See also: getDate(int)
public final double getDouble(int ordinal)Returns the value in the Column indicated by its ordinal position in the ReadRow as a Double. A DataSetException is thrown if the ordinal position ordinal does not exist, or if its data type is not Variant.Double.
See also: getDouble(java.lang.String)
public final double getDouble(java.lang.String columnName)Returns the value in the Column named columnName as a Double. A DataSetException is thrown if columnName does not exist, or if its data type is not Variant.Double.
This method is typically preferred over getDouble(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.
See also: getDouble(int)
public final float getFloat(int ordinal)Returns the value in the Column indicated by its ordinal position in the ReadRow as a Float. A DataSetException is thrown if the ordinal position ordinal does not exist, or if its data type is not Variant.Float.
See also: getFloat(java.lang.String)
public final float getFloat(java.lang.String columnName)Returns the value in the Column named columnName as a Float. A DataSetException is thrown if columnName does not exist, or if its data type is not Variant.Float.
This method is typically preferred over getFloat(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.
See also: getFloat(int)
public final InputStream getInputStream(int ordinal)
public final InputStream getInputStream(java.lang.String columnName)
public final int getInt(int ordinal)Returns the value in the Column indicated by its ordinal position in the ReadRow as a Variant.Int. A DataSetException is thrown if the ordinal position ordinal does not exist, or if its data type is not an int.
See also: getInt(java.lang.String)
public final int getInt(java.lang.String columnName)Returns the value in the Column named columnName as a Int. A DataSetException is thrown if columnName does not exist, or if its data type is not an Variant.Int.
This method is typically preferred over getInt(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.
See also: getInt(int)
public final long getLong(int ordinal)Returns the value in the Column indicated by its ordinal position in the ReadRow as a long. A DataSetException is thrown if the ordinal position ordinal does not exist, or if its data type is not Variant.long.
See also: getlong(java.lang.String)
public final long getLong(java.lang.String columnName)Returns the value in the Column named columnName as a long. A DataSetException is thrown if columnName does not exist, or if its data type is not Variant.long.
This method is typically preferred over getlong(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.
See also: getlong(int)
public final Object getObject(int ordinal)Returns the value in the Column indicated by its ordinal position in the ReadRow as a Object. A DataSetException is thrown if the ordinal position ordinal does not exist, or if its data type is not Variant.Object.
See also: getObject(java.lang.String)
public final Object getObject(java.lang.String columnName)Returns the value in the Column named columnName as a Object. A DataSetException is thrown if columnName does not exist, or if its data type is not Variant.Object.
This method is typically preferred over getObject(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.
See also: getObject(int)
public final short getShort(int ordinal)Returns the value in the Column indicated by its ordinal position in the ReadRow as a Short. A DataSetException is thrown if the ordinal position ordinal does not exist, or if its data type is not Variant.Short.
See also: getShort(java.lang.String)
public final short getShort(java.lang.String columnName)Returns the value in the Column named columnName as a Short. A DataSetException is thrown if columnName does not exist, or if its data type is not Variant.Short.
This method is typically preferred over getShort(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.
See also: getShort(int)
public final String getString(int ordinal)Returns the value in the Column indicated by its ordinal position in the ReadRow as a String. A DataSetException is thrown if the ordinal position ordinal does not exist, or if its data type is not Variant.String.
See also: getString(java.lang.String)
public final String getString(java.lang.String columnName)Returns the value in the Column named columnName as a String. A DataSetException is thrown if columnName does not exist, or if its data type is not Variant.String.
This method is typically preferred over getString(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.
See also: getString(int)
public final Time getTime(int ordinal)Returns the value in the Column indicated by its ordinal position in the ReadRow as a Time. A DataSetException is thrown if the ordinal position ordinal does not exist, or if its data type is not Variant.Time.
See also: getTime(java.lang.String)
public final Time getTime(java.lang.String columnName)Returns the value in the Column named columnName as a Time. A DataSetException is thrown if columnName does not exist, or if its data type is not Variant.Time.
This method is typically preferred over getTime(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.
See also: getTime(int)
public final Timestamp getTimestamp(int ordinal)Returns the value in the Column indicated by its ordinal position in the ReadRow as a TimeStamp. A DataSetException is thrown if the ordinal position ordinal does not exist, or if its data type is not Variant.TimeStamp.
See also: getTimeStamp(java.lang.String)
public final Timestamp getTimestamp(java.lang.String columnName)Returns the value in the Column named columnName as a TimeStamp. A DataSetException is thrown if columnName does not exist, or if its data type is not Variant.TimeStamp.
This method is typically preferred over getTimeStamp(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.
See also: getTimeStamp(int)
public void getVariant(int ordinal, borland.jbcl.util.Variant value)Returns a Variant (passed into this method as the value parameter) based on its ordinal position in the ReadRow.
public void getVariant(java.lang.String columnName, borland.jbcl.util.Variant value)Returns a Variant (passed into this method as the value parameter) based on its column name in the ReadRow.
public final Column hasColumn(java.lang.String columnName)Returns the Column object as specified by its String name. Similar to getColumn, however this method returns null if the Column is not found instead of throwing a DataSetException.
public final boolean isAssignedNull(int ordinal)Determines whether the data value at location ordinal is an assigned null value. If it returns true, the value is an assigned null value; otherwise, it is not and returns false.
public final boolean isAssignedNull(java.lang.String columnName)Determines whether the data value identified by its column name is an assigned null value. If it returns true, the value is an assigned null value; otherwise, it is not and returns false.
public final boolean isNull(int ordinal)Returns true if the value at the specified ordinal is null; false otherwise.
public final boolean isNull(java.lang.String columnName)Returns true if the value at the specified columnName is null; false otherwise.
public final boolean isUnassignedNull(int ordinal)Returns true if the value at the specified ordinal is an unassigned null; false otherwise.
public final boolean isUnassignedNull(java.lang.String columnName)Returns true if the value at the specified columnName is an unassigned null; false otherwise.
public String toString()Returns a String representation of this ReadRow object. Used by the JBuilder design tools.
Overrides: java.lang.Object.toString()