Интерфейс RowId

public interface RowId

Представление (отображение) значения SQL ROWID в языке программирования Java. SQL ROWID — это встроенный тип, значение которого можно рассматривать как адрес идентифицированной им строки в таблице базы данных. Определяется исходным источником данных, является ли этот адрес логическим или в каком-либо отношении физическим.

Методы в интерфейсах ResultSet, CallableStatement и PreparedStatement, например getRowId и setRowId, позволяют программисту получать доступ к значению SQL ROWID. Интерфейс RowId предоставляет метод для представления значения ROWID в виде массива байтов или String.

Метод getRowIdLifetime в интерфейсе DatabaseMetaData можно использовать, чтобы определить, остается ли объект RowId действительным в течение транзакции, в которой был создан RowId, в течение сеанса, в котором был создан RowId, или, по существу, до тех пор, пока идентифицированная им строка не будет удалена. Помимо указания срока действия за пределами исходного источника данных, getRowIdLifetime определяет срок действия значения ROWID в пределах его исходного источника данных. В этом отношении он отличается от большого объекта, поскольку срок действия большого объекта в пределах его исходного источника данных не ограничен.

Все методы интерфейса RowId должны быть полностью реализованы, если драйвер JDBC поддерживает этот тип данных.

С версии:

1.6

См. также:

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object obj)`	Сравнивает этот `RowId` с указанным объектом.
`byte[]`	`getBytes()`	Возвращает массив байтов, представляющий значение SQL `ROWID`, обозначенное этим объектом `java.sql.RowId`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта `RowId`.
`String`	`toString()`	Возвращает строку String, представляющую значение SQL ROWID, обозначенное этим объектом `java.sql.RowId`.

Подробное описание методов

equals

boolean equals(Object obj)

Сравнивает этот RowId с указанным объектом. Результат равен true тогда и только тогда, когда аргумент не равен null и является объектом RowId, представляющим тот же ROWID, что и этот объект.

При сравнении RowId с другим RowId важно учитывать как его источник, так и срок его действия. Если оба значения действительны и относятся к одной и той же таблице в одном и том же источнике данных, то в случае их равенства они идентифицируют одну и ту же строку; если одно или несколько значений больше не гарантированно действительны либо они получены из разных источников данных или из разных таблиц одного источника данных, они могут быть равны, но при этом идентифицировать разные строки.

Переопределяет:

equals в классе Object

Параметры:

obj — объект Object, с которым сравнивается этот объект RowId.

Возвращает:

true, если объекты RowId равны; в противном случае false

С версии:

1.6

См. также:

getBytes

byte[] getBytes()

Возвращает массив байтов, представляющий значение SQL ROWID, обозначенное этим объектом java.sql.RowId.

Возвращает:: массив байтов, длина которого определяется драйвером, предоставляющим соединение, и который представляет значение ROWID, обозначенное этим объектом java.sql.RowId.

toString

String toString()

Возвращает строку String, представляющую значение SQL ROWID, обозначенное этим объектом java.sql.RowId.

Подобно тому, как java.sql.Date.toString() возвращает содержимое своего DATE в виде String "2004-03-17", а не в виде литерала DATE в SQL (которым было бы String DATE "2004-03-17"), метод toString() возвращает содержимое своего ROWID в формате, специфичном для драйвера, предоставляющего соединение, и, возможно, не в виде литерала ROWID.

Переопределяет:: toString в классе Object
Возвращает:: строку String в формате, определяемом драйвером, предоставляющим соединение, которая представляет значение ROWID, обозначенное этим объектом java.sql.RowId.

hashCode

int hashCode()

Возвращает хеш-код этого объекта RowId.

Переопределяет:

hashCode в классе Object

Возвращает:

хеш-код для RowId

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.sql/java/sql/RowId.html