com.xj.anylogic.engine.connectivity
Class KeyValueTable<K,V>

java.lang.Object
  com.xj.anylogic.engine.connectivity.KeyValueTable<K,V>

Type Parameters:

K - Key type

V - Value type

All Implemented Interfaces:

java.io.Serializable

public final class KeyValueTable<K,V>
extends java.lang.Object

An object that maps keys to values. A map cannot contain duplicate keys; each key can map to at most one value.
Key-Value mappings are loaded from database via execute() method or on first call of any data-retrieving method
The value mapping for given key can be obtained using get(Object) method call
This object is only available in the AnyLogic Professional

Author:

XJ Technologies Company Ltd. www.anylogic.com

See Also:

Serialized Form

Constructor Summary

KeyValueTable(java.lang.String name, Database database, java.lang.String tableName, java.lang.String keyColumn, java.lang.String valueColumn)
Creates KeyValueTable based on the table with given tableName

Method Summary

boolean	containsKey(java.lang.Object key) Returns true if this KeyValueTable contains a mapping for the specified key.
boolean	containsValue(java.lang.Object value) Returns true if this KeyValueTable maps one or more keys to the specified value.
void	destroy() Releases resources acquired by this object Also destroys all not destroyed contributors associated with this object Doest nothing if object is already destroyed
void	execute() Loads (reloads) Key-Value mappings from database table This method is automatically invoked if data is not loaded on first data-retrieving method call
V	get(K key) Returns the value to which the specified key is mapped, or null if this KeyValueTable contains no mapping for the key.
java.lang.String	getName() Returns the name of this object
boolean	isEmpty() Returns true if this KeyValueTable contains no key-value mappings.
java.util.Set<K>	keySet() Returns a Set view of the keys contained in this table.
int	size() Returns the number of key-value mappings in this KeyValueTable.
java.lang.String	toString()
java.util.Collection<V>	values() Returns a Collection view of the values contained in this KeyValueTable.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

KeyValueTable

public KeyValueTable(java.lang.String name,
                     Database database,
                     java.lang.String tableName,
                     java.lang.String keyColumn,
                     java.lang.String valueColumn)

Creates KeyValueTable based on the table with given tableName

Parameters:

name - object name (decoration purpose)

database - database to connect to

tableName - name of table with Key-Value mappings

keyColumn - Key column name in the table

valueColumn - Value column name in the table

Method Detail

execute

public void execute()

Loads (reloads) Key-Value mappings from database table
This method is automatically invoked if data is not loaded on first data-retrieving method call

get

public V get(K key)

Returns the value to which the specified key is mapped, or null if this KeyValueTable contains no mapping for the key.

More formally, if this KeyValueTable contains a mapping from a key k to a value v such that (key==null ? k==null : key.equals(k)), then this method returns v; otherwise it returns null. (There can be at most one such mapping.)

A return value of null does not necessarily indicate that the KeyValueTable contains no mapping for the key; it's also possible that the KeyValueTable explicitly maps the key to null. The containsKey operation may be used to distinguish these two cases.

Parameters:

key - the key whose associated value is to be returned

Returns:

the value to which the specified key is mapped, or null if this KeyValueTable contains no mapping for the key

keySet

public java.util.Set<K> keySet()

Returns a Set view of the keys contained in this table. The set is unmodifiable.

Returns:

a set view of the keys contained in this KeyValueTable

containsKey

public boolean containsKey(java.lang.Object key)

Returns true if this KeyValueTable contains a mapping for the specified key. More formally, returns true if and only if this KeyValueTable contains a mapping for a key k such that (key==null ? k==null : key.equals(k)). (There can be at most one such mapping.)

Parameters:

key - key whose presence in this KeyValueTable is to be tested

Returns:

true if this KeyValueTable contains a mapping for the specified key

containsValue

public boolean containsValue(java.lang.Object value)

Returns true if this KeyValueTable maps one or more keys to the specified value. More formally, returns true if and only if this KeyValueTable contains at least one mapping to a value v such that (value==null ? v==null : value.equals(v)). This operation will require time linear in the KeyValueTable size.

Parameters:

value - value whose presence in this KeyValueTable is to be tested

Returns:

true if this KeyValueTable maps one or more keys to the specified value

isEmpty

public boolean isEmpty()

Returns true if this KeyValueTable contains no key-value mappings.

Returns:

true if this KeyValueTable contains no key-value mappings

size

public int size()

Returns the number of key-value mappings in this KeyValueTable. If the KeyValueTable contains more than Integer.MAX_VALUE elements, returns Integer.MAX_VALUE.

Returns:

the number of key-value mappings in this KeyValueTable

values

public java.util.Collection<V> values()

Returns a Collection view of the values contained in this KeyValueTable. The collection is unmodifiable.

Returns:

a collection view of the values contained in this KeyValueTable

getName

public final java.lang.String getName()

Returns the name of this object

Returns:

the name of this object

destroy

public final void destroy()

Releases resources acquired by this object
Also destroys all not destroyed contributors associated with this object

Doest nothing if object is already destroyed

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object