if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="RowId (Java Platform SE 7 )";
}
//-->
allClassesLink = document.getElementById("allclasses_navbar_top");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
Interface RowId
-
public interface RowId
The representation (mapping) in the Java programming language of an SQL ROWIDvalue. 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
,and
PreparedStatement
, such asgetRowId
andsetRowId
allow a programmer to access a SQL
ROWID
value. TheRowId
interface provides a method
for representing the value of the
ROWID
as a byte array or as aString
.The method
getRowIdLifetime
in the interfaceDatabaseMetaData
,can be used
to determine if a
RowId
object remains valid for the duration of the transaction inwhich the
RowId
was created, the duration of the session in whichthe
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 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 theJDBC 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 this
java.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 RowIdobject 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 another
RowId
. If both are valid, andboth 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
objectagainst.
Returns:
-
true if the
RowId
s are equal; false otherwise
Since:
- 1.6 See Also:
-
Object.hashCode()
,
-
getBytes
byte[] getBytes()
Returns an array of bytes representing the value of the SQLROWID
designated by this
java.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.
-
an array of bytes, whose length is determined by the driver supplying
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 the
String
"2004-03-17"rather than as DATE literal in SQL (which would have been the
String
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 a
ROWID
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)
,
-
allClassesLink = document.getElementById("allclasses_navbar_bottom");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.
一键复制
编辑
Web IDE
原始数据
按行查看
历史