Интерфейс 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

See Also:

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. Если оба действительны и оба из одной таблицы одного источника данных, то если они равны, они идентифицируют одну и ту же строку; если один или несколько больше не гарантированно действуют, или если они происходят из разных источников данных или разных таблиц в одном источнике данных, они могут быть равны, но все же не идентифицировать одну и ту же строку.

Overrides:

equals в классе Object

Parameters:

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

Returns:

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

Since:

1.6

See Also:

getBytes

byte[] getBytes()

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

Returns:: массив байтов, длина которого определяется драйвером, предоставляющим соединение, представляющий значение 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.

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

hashCode

int hashCode()

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

Overrides:

hashCode в классе Object

Returns:

хэш-код для RowId

See Also:

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