Интерфейс 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 поддерживает тип данных.

Since:

1.6

См. также:

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

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

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

equals

boolean equals(Object obj)

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

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

Overrides:

equals в классе Object

Параметры:

obj - объект Object для сравнения с этим объектом RowId.

Возвращает:

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

Since:

1.6

См. также:

getBytes

byte[] getBytes()

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

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

toString

String toString()

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

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

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

hashCode

int hashCode()

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

Overrides:

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://download.java.net/java/early_access/jdk24/docs/api/java.sql/java/sql/RowId.html