io.r2dbc.spi

Interface Row

All Superinterfaces:

Readable

public interface Row
extends Readable

Represents a row returned from a database query. Values from columns can be either retrieved by specifying a column name or the column index. Column indexes are 0-based. Column names do not necessarily reflect the column names how they are in the underlying tables but rather how columns are represented (e.g. aliased) in the result.

Column names used as input to getter methods are case-insensitive. When a get method is called with a column name and several columns have the same name, then the value of the first matching column will be returned. The column name option is designed to be used when column names are used in the SQL query that generated the result set. Columns that are not explicitly named in the query should be referenced through column indexes.

For maximum portability, result columns within each Row should be read in left-to-right order, and each column should be read only once.

Readable.get(String) and Readable.get(int) without specifying a target type returns a suitable value representation. The R2DBC specification contains a mapping table that shows default mappings between database types and Java types. Specifying a target type, the R2DBC driver attempts to convert the value to the target type.

A row is invalidated after consumption in the mapping function.

The number, type and characteristics of columns are described through RowMetadata

Method Summary

Modifier and Type	Method and Description
RowMetadata	getMetadata() Returns the RowMetadata for all columns in this row.

Methods inherited from interface io.r2dbc.spi.Readable

get, get, get, get

Method Detail

getMetadata

RowMetadata getMetadata()

Returns the RowMetadata for all columns in this row.

Returns:

the RowMetadata for all columns in this row

Since:

0.9