Интерфейс 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:: Object.hashCode(), HashMap

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:: Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)