sirius.db.jdbc

Class Row

java.lang.Object

sirius.db.jdbc.Row

public class Row
extends Object

A small wrapper class to represent a result row.

Field Summary

Fields

Modifier and Type	Field and Description
protected Map<String,sirius.kernel.commons.Tuple<String,Object>>	fields

Constructor Summary

Constructors

Constructor and Description
Row()

Method Summary

Modifier and Type	Method and Description
Map<String,Object>	getFields() Deprecated. use getFieldsList() which honors the field names in terms of upper- and lowercase.
Collection<sirius.kernel.commons.Tuple<String,Object>>	getFieldsList() Returns all stored fields as map.
List<Row>	getSublist(Object key) Returns a sub list which was stored for a given key.
sirius.kernel.commons.Value	getValue(Object key) Returns the value associated with the given key.
boolean	hasValue(String key) Determines if a value for a given key is present.
void	setValue(String key, Object value) Stores a value for the given key.
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

fields

protected Map<String,sirius.kernel.commons.Tuple<String,Object>> fields

Constructor Detail

Row

public Row()

Method Detail

getFieldsList

@Nonnull
public Collection<sirius.kernel.commons.Tuple<String,Object>> getFieldsList()

Returns all stored fields as map.

Returns:

the underlying map, containing all fields and values. Modifying this map will modify the row

getFields

@Nonnull
 @Deprecated
public Map<String,Object> getFields()

Deprecated. use getFieldsList() which honors the field names in terms of upper- and lowercase.

Returns the underlying row as map.

Returns:

a map containing all fields and values represented by this row

hasValue

public boolean hasValue(@Nonnull
                        String key)

Determines if a value for a given key is present.

Parameters:

key - the key to check for

Returns:

true if a value for the given key is present (even if it is null), false otherwise

getValue

@Nonnull
public sirius.kernel.commons.Value getValue(@Nonnull
                                                     Object key)

Returns the value associated with the given key.

Parameters:

key - the name of the field to retrieve

Returns:

the value associated with the given key wrapped as Value

Throws:

IllegalArgumentException - if an unknown column key is requested

getSublist

@Nonnull
public List<Row> getSublist(@Nonnull
                                     Object key)

Returns a sub list which was stored for a given key.

It is assumed that the object associated with the given key is a List<Row>.

Parameters:

key - the name of the field to retrieve

Returns:

the list associated with the given key

Throws:

ClassCastException - if the stored value isn't a list. null is handled gracefully

setValue

public void setValue(@Nonnull
                     String key,
                     Object value)

Stores a value for the given key.

Can be used to add computed values for further processing.

Parameters:

key - the key to bind the value to

value - the value to be stored

toString

public String toString()

Overrides:

toString in class Object