-
public interface RowId
The representation (mapping) in the Java programming language of an SQL ROWID value. An SQL ROWID is a built-in type, a value of which can be thought of as an address for its identified row in a database table. Whether that address is logical or, in any respects, physical is determined by its originating data source.Methods in the interfaces
ResultSet
,CallableStatement
, andPreparedStatement
, such asgetRowId
andsetRowId
allow a programmer to access a SQLROWID
value. TheRowId
interface provides a method for representing the value of theROWID
as a byte array or as aString
.The method
getRowIdLifetime
in the interfaceDatabaseMetaData
, can be used to determine if aRowId
object remains valid for the duration of the transaction in which theRowId
was created, the duration of the session in which theRowId
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 aROWID
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:
DatabaseMetaData
-
-
Method Summary
Methods Modifier and Type Method and Description boolean
equals(Object obj)
Compares thisRowId
to the specified object.byte[]
getBytes()
Returns an array of bytes representing the value of the SQLROWID
designated by thisjava.sql.RowId
object.int
hashCode()
Returns a hash code value of thisRowId
object.String
toString()
Returns a String representing the value of the SQL ROWID designated by thisjava.sql.RowId
object.
-
-
-
Method Detail
-
equals
boolean equals(Object obj)
Compares thisRowId
to the specified object. The result istrue
if 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
RowId
when 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.- Overrides:
equals
in classObject
- Parameters:
obj
- theObject
to compare thisRowId
object against.- Returns:
- true if the
RowId
s are equal; false otherwise - Since:
- 1.6
- See Also:
Object.hashCode()
,HashMap
-
getBytes
byte[] getBytes()
Returns an array of bytes representing the value of the SQLROWID
designated by thisjava.sql.RowId
object.- 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.
-
toString
String toString()
Returns a String representing the value of the SQL ROWID designated by thisjava.sql.RowId
object.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 theString
DATE "2004-03-17"), toString() returns the contents of its ROWID in a form specific to the driver supplying the connection, and possibly not as aROWID
literal.
-
hashCode
int hashCode()
Returns a hash code value of thisRowId
object.- Overrides:
hashCode
in classObject
- Returns:
- a hash code for the
RowId
- See Also:
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-java/sql/rowid.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.