io.inversion.utils

Class Rows.Row

java.lang.Object

io.inversion.utils.Rows.Row

All Implemented Interfaces:

java.util.Map<java.lang.String,java.lang.Object>

Enclosing class:

Rows

public static class Rows.Row
extends java.lang.Object
implements java.util.Map<java.lang.String,java.lang.Object>

Represents a single row in a database result set where values can be accessed by a zero based integer index or by a case insensitive key/column name.

It is not possible to implement both List and Map but that is the practical purpose of this class.

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

java.util.Map.Entry<K,V>

Constructor Summary

Constructors

Constructor and Description
Row()

Method Summary

Modifier and Type	Method and Description
void	add(java.lang.Object value) Adds value as the last column
java.util.List<java.lang.Object>	asList()
void	clear() Sets all values to null, but does not modify RowKeys or change the length of values.
boolean	containsKey(java.lang.Object key)
boolean	containsValue(java.lang.Object value)
java.util.Set<java.util.Map.Entry<java.lang.String,java.lang.Object>>	entrySet()
java.lang.Object	get(int index)
java.lang.Object	get(java.lang.Object keyOrIndex)
java.lang.Object	get(java.lang.String key) Gets the value for the key/column.
boolean	getBoolean(int index)
boolean	getBoolean(java.lang.String key)
float	getFloat(int index)
float	getFloat(java.lang.String key)
int	getInt(int index)
int	getInt(java.lang.String key)
java.lang.String	getKey(int index)
long	getLong(int index)
long	getLong(java.lang.String key)
java.lang.String	getString(int index)
java.lang.String	getString(java.lang.String key)
int	indexOf(java.lang.String key)
boolean	isEmpty()
java.util.Set<java.lang.String>	keySet()
java.lang.Object	put(java.lang.String key, java.lang.Object value) Translates key into a column index and inserts value at that index.
void	putAll(java.util.Map<? extends java.lang.String,? extends java.lang.Object> m)
java.lang.Object	remove(java.lang.Object key) Sets the value for keyOrIndex to null.
void	set(int index, java.lang.Object value) Sets the indexth column to value
int	size()
java.lang.String	toString()
java.util.Collection<java.lang.Object>	values()

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Map

compute, computeIfAbsent, computeIfPresent, equals, forEach, getOrDefault, hashCode, merge, putIfAbsent, remove, replace, replace, replaceAll

Constructor Detail

Row

public Row()

Method Detail

getKey

public java.lang.String getKey(int index)

Parameters:

index - the column key to get

Returns:

the key/column name for the given index

getString

public java.lang.String getString(int index)

Parameters:

index - the column number to get

Returns:

the value at index stringified if it exists

getString

public java.lang.String getString(java.lang.String key)

Parameters:

key - the column name to get

Returns:

the value for key stringified if it exists

getInt

public int getInt(int index)

Parameters:

index - the column number to get

Returns:

the value at index stringified and parsed as an int if it exists

getInt

public int getInt(java.lang.String key)

Parameters:

key - the column name to get

Returns:

the value for key stringified and parsed as an int if it exists

getLong

public long getLong(int index)

Parameters:

index - the column value to get

Returns:

the value at index stringified and parsed as a long if it exists

getLong

public long getLong(java.lang.String key)

Parameters:

key - the columnn name to get

Returns:

the value for key stringified and parsed as a long if it exists

getFloat

public float getFloat(int index)

Parameters:

index - the column number to get

Returns:

the value at index stringified and parsed as a float if it exists

getFloat

public float getFloat(java.lang.String key)

Parameters:

key - the column name to get

Returns:

the value for key stringified and parsed as a float if it exists

getBoolean

public boolean getBoolean(int index)

Parameters:

index - the column number to get

Returns:

the value at index stringified and parsed as a boolean if it exists

getBoolean

public boolean getBoolean(java.lang.String key)

Parameters:

key - the key of the value to get

Returns:

the value for key stringified and parsed as a boolean if it exists

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

size

public int size()

Specified by:

size in interface java.util.Map<java.lang.String,java.lang.Object>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface java.util.Map<java.lang.String,java.lang.Object>

containsKey

public boolean containsKey(java.lang.Object key)

Specified by:

containsKey in interface java.util.Map<java.lang.String,java.lang.Object>

indexOf

public int indexOf(java.lang.String key)

containsValue

public boolean containsValue(java.lang.Object value)

Specified by:

containsValue in interface java.util.Map<java.lang.String,java.lang.Object>

get

public java.lang.Object get(java.lang.String key)

Gets the value for the key/column.

Parameters:

key - the column name to get

Returns:

the value at the index associate with key if it exists, otherwise null.

get

public java.lang.Object get(int index)
                     throws java.lang.ArrayIndexOutOfBoundsException

Parameters:

index - the column number to get

Returns:

the value at index

Throws:

java.lang.ArrayIndexOutOfBoundsException - if index is >= values.length()

get

public java.lang.Object get(java.lang.Object keyOrIndex)

Specified by:

get in interface java.util.Map<java.lang.String,java.lang.Object>

Parameters:

keyOrIndex - the String key or an Integer index to retrieve

Returns:

the value at keyOrIndex as an Integer index or the value for keyOrIndex as a String key

set

public void set(int index,
                java.lang.Object value)

Sets the indexth column to value

Parameters:

index - the column number to set

value - the value to set

add

public void add(java.lang.Object value)

Adds value as the last column

Parameters:

value - the value to add

put

public java.lang.Object put(java.lang.String key,
                            java.lang.Object value)

Translates key into a column index and inserts value at that index.

If key does not exists, it is add to the shared RowKeys as the last column.

Specified by:

put in interface java.util.Map<java.lang.String,java.lang.Object>

Parameters:

key - the column name to set

value - the column value to set

remove

public java.lang.Object remove(java.lang.Object key)

Sets the value for keyOrIndex to null.

It does not actually remove the key from RowKeys or remove the Row list element because RowKeys is shared across all Row instances and the iteration order and number of keys/columns needs to be the same for all of them.

Specified by:

remove in interface java.util.Map<java.lang.String,java.lang.Object>

Parameters:

key - the String key or an Integer index to remove.

Returns:

the previous value for the column

putAll

public void putAll(java.util.Map<? extends java.lang.String,? extends java.lang.Object> m)

Specified by:

putAll in interface java.util.Map<java.lang.String,java.lang.Object>

clear

public void clear()

Sets all values to null, but does not modify RowKeys or change the length of values.

Specified by:

clear in interface java.util.Map<java.lang.String,java.lang.Object>

keySet

public java.util.Set<java.lang.String> keySet()

Specified by:

keySet in interface java.util.Map<java.lang.String,java.lang.Object>

Returns:

the RowKeys keySet which is common to all Row instances in this Rows.

See Also:

Rows.RowKeys.keySet()

values

public java.util.Collection<java.lang.Object> values()

Specified by:

values in interface java.util.Map<java.lang.String,java.lang.Object>

asList

public java.util.List<java.lang.Object> asList()

entrySet

public java.util.Set<java.util.Map.Entry<java.lang.String,java.lang.Object>> entrySet()

Specified by:

entrySet in interface java.util.Map<java.lang.String,java.lang.Object>

Returns:

a new LinkedHashSet of key/value pairs preserving column iteration order.