Interface RowId
 Methods in the interfaces ResultSet, CallableStatement,
 and PreparedStatement, such as getRowId and setRowId
 allow a programmer to access a SQL ROWID  value. The RowId
 interface provides a method
 for representing the value of the ROWID as a byte array or as a
 String.
 
 The method getRowIdLifetime in the interface DatabaseMetaData,
 can be used
 to determine if a RowId object remains valid for the duration of the transaction in
 which  the RowId was created, the duration of the session in which
 the 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
 source, getRowIdLifetime specifies the duration of a ROWID
 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.
- Since:
- 1.6
- See Also:
- 
Method SummaryModifier and TypeMethodDescriptionbooleanCompares thisRowIdto the specified object.byte[]getBytes()Returns an array of bytes representing the value of the SQLROWIDdesignated by thisjava.sql.RowIdobject.inthashCode()Returns a hash code value of thisRowIdobject.toString()Returns a String representing the value of the SQL ROWID designated by thisjava.sql.RowIdobject.
- 
Method Details- 
equalsCompares thisRowIdto the specified object. The result istrueif 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 anotherRowId. 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 SQLROWIDdesignated by thisjava.sql.RowIdobject.- Returns:
- 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 thisjava.sql.RowIdobject.Like java.sql.Date.toString()returns the contents of its DATE as theString"2004-03-17" rather than as DATE literal in SQL (which would have been theStringDATE "2004-03-17"), toString() returns the contents of its ROWID in a form specific to the driver supplying the connection, and possibly not as aROWIDliteral.
- 
hashCode
 
-