Интерфейс 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()`	Возвращает строку, представляющую значение 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()

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

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

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

hashCode

int hashCode()

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

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

hashCode в классе Object

Возвращает:

хэш-код объекта RowId

См. также:

© 1993, 2023, 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/21/docs/api/java.sql/java/sql/RowId.html