Интерфейс 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
См. также:: DatabaseMetaData

Методы

Модификатор и тип	Метод и описание
`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
См. также:: Object.hashCode(), HashMap

getBytes

byte[] getBytes()

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

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

toString

String toString()

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

Так же как java.sql.Date.toString() возвращает содержимое его DATE как строку "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
См. также:: Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

© 1993, 2020, 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.