oracle.pgx.api

Class PgxMap<K,V>

java.lang.Object

oracle.pgx.api.internal.ApiObject

oracle.pgx.api.Destroyable

oracle.pgx.api.PgxManagedObject

oracle.pgx.api.PgxMap<K,V>

Type Parameters:

K - the key type

V - the value type

All Implemented Interfaces:

java.lang.AutoCloseable

public class PgxMap<K,V>
extends PgxManagedObject

A map is a collection of key-value pairs.

Method Summary

Modifier and Type	Method and Description
boolean	containsKey(K key) Blocking version of containsKeyAsync(Object).
PgxFuture<java.lang.Boolean>	containsKeyAsync(K key) Checks if the map contains key.
MapIterable<K,V>	entries() Blocking version of entriesAsync().
PgxFuture<MapIterable<K,V>>	entriesAsync() Gets an entry set.
V	get(K key) Blocking version of getAsync(Object).
PgxFuture<V>	getAsync(K key) Gets the value of a key.
PgxGraph	getGraph() Gets the PgxGraph this map is bound to.
PropertyType	getKeyType() Gets the key type.
java.lang.String	getName()
java.lang.String	getSessionId() Gets the session id this map is bound to.
PropertyType	getValueType() Gets the value type.
java.lang.Iterable<K>	keys() Blocking version of keysAsync().
PgxFuture<java.lang.Iterable<K>>	keysAsync()
void	put(K key, V value) Blocking version of putAsync(Object, Object).
PgxFuture<java.lang.Void>	putAsync(K key, V value) Sets the value for a key in the map specified by the given name.
boolean	remove(K key) Blocking version of removeAsync(Object).
PgxFuture<java.lang.Boolean>	removeAsync(K key) Removes the entry specified by the given key from the map with the given name.
int	size() Blocking version of sizeAsync().
PgxFuture<java.lang.Integer>	sizeAsync() Returns the size of the map
java.lang.String	toString()

Methods inherited from class oracle.pgx.api.PgxManagedObject

equals, hashCode

Methods inherited from class oracle.pgx.api.Destroyable

close, destroy, destroyAsync

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Method Detail

containsKey

public boolean containsKey(K key)

Blocking version of containsKeyAsync(Object). Calls containsKeyAsync(Object) and waits for the returned PgxFuture to complete.

containsKeyAsync

public PgxFuture<java.lang.Boolean> containsKeyAsync(K key)

Checks if the map contains key.

Parameters:

key - the key

Returns:

the pgx future

entries

public MapIterable<K,V> entries()

Blocking version of entriesAsync(). Calls entriesAsync() and waits for the returned PgxFuture to complete.

entriesAsync

public PgxFuture<MapIterable<K,V>> entriesAsync()

Gets an entry set.

Returns:

an iterable of the entry set

get

public V get(K key)

Blocking version of getAsync(Object). Calls getAsync(Object) and waits for the returned PgxFuture to complete.

getAsync

public PgxFuture<V> getAsync(K key)

Gets the value of a key.

Parameters:

key -

Returns:

value

getGraph

public PgxGraph getGraph()

Gets the PgxGraph this map is bound to.

Returns:

the graph this PgxMap is bound to.

getKeyType

public PropertyType getKeyType()

Gets the key type.

Returns:

the key type

getName

public java.lang.String getName()

Specified by:

getName in class PgxManagedObject

Returns:

the name identifying this managed object

getSessionId

public java.lang.String getSessionId()

Gets the session id this map is bound to.

Returns:

the session id this PgxMap is bound to.

getValueType

public PropertyType getValueType()

Gets the value type.

Returns:

the value type

keys

public java.lang.Iterable<K> keys()

Blocking version of keysAsync(). Calls keysAsync() and waits for the returned PgxFuture to complete.

keysAsync

public PgxFuture<java.lang.Iterable<K>> keysAsync()

put

public void put(K key,
                V value)

Blocking version of putAsync(Object, Object). Calls putAsync(Object, Object) and waits for the returned PgxFuture to complete.

putAsync

public PgxFuture<java.lang.Void> putAsync(K key,
                                          V value)

Sets the value for a key in the map specified by the given name. Returns the old value for the given key or null if there was no entry for this key before.

Parameters:

key - key of the entry

value - new value

Returns:

old value for the key or null if there was no entry before

remove

public boolean remove(K key)

Blocking version of removeAsync(Object). Calls removeAsync(Object) and waits for the returned PgxFuture to complete.

removeAsync

public PgxFuture<java.lang.Boolean> removeAsync(K key)

Removes the entry specified by the given key from the map with the given name. Returns true if the map did contain an entry with the given key, false otherwise.

Parameters:

key - key of the entry in the map to be removed.

Returns:

true if the map contained the key.

size

public int size()

Blocking version of sizeAsync(). Calls sizeAsync() and waits for the returned PgxFuture to complete.

sizeAsync

public PgxFuture<java.lang.Integer> sizeAsync()

Returns the size of the map

Returns:

size

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object