public interface RowId
Methods in the interfaces
PreparedStatement, such as
allow a programmer to access a SQL
ROWID value. The
interface provides a method
for representing the value of the
ROWID as a byte array or as a
getRowIdLifetime in the interface
can be used
to determine if a
RowId object remains valid for the duration of the transaction in
RowId was created, the duration of the session in which
RowId was created,
or, effectively, for as long as its identified row is not deleted. In addition
to specifying the duration of its valid lifetime outside its originating data
getRowIdLifetime specifies the duration of a
value's valid lifetime
within its originating data source. In this, it differs from a large object,
because there is no limit on the valid lifetime of a large object within its
originating data source.
All methods on the
RowId interface must be fully implemented if the
JDBC driver supports the data type.
- See Also:
Modifier and Type Method Description
Object obj)(Compares this
RowIdto the specified object.
()Returns an array of bytes representing the value of the SQL
ROWIDdesignated by this
()Returns a hash code value of this
()Returns a String representing the value of the SQL ROWID designated by this
equalsboolean equals(Object obj)Compares this
RowIdto the specified object. The result is
trueif and only if the argument is not null and is a RowId object that represents the same ROWID as this object.
It is important to consider both the origin and the valid lifetime of a
RowIdwhen comparing it to another
RowId. If both are valid, and both are from the same table on the same data source, then if they are equal they identify the same row; if one or more is no longer guaranteed to be valid, or if they originate from different data sources, or different tables on the same data source, they may be equal but still not identify the same row.
getBytesbyte getBytes()Returns an array of bytes representing the value of the SQL
ROWIDdesignated by this
- an array of bytes, whose length is determined by the driver supplying the connection, representing the value of the ROWID designated by this java.sql.RowId object.
toStringString toString()Returns a String representing the value of the SQL ROWID designated by this
java.sql.Date.toString()returns the contents of its DATE as the
String"2004-03-17" rather than as DATE literal in SQL (which would have been the
StringDATE "2004-03-17"), toString() returns the contents of its ROWID in a form specific to the driver supplying the connection, and possibly not as a
hashCodeint hashCode()Returns a hash code value of this