org.springframework.data.gemfire
Interface GemfireOperations

All Known Implementing Classes:

GemfireTemplate

public interface GemfireOperations

Method Summary

boolean	containsKey(Object key)
boolean	containsKeyOnServer(Object key)
boolean	containsValue(Object value)
boolean	containsValueForKey(Object key)
<K,V> void	create(K key, V value)
<T> T	execute(GemfireCallback<T> action)
<T> T	execute(GemfireCallback<T> action, boolean exposeNativeRegion) Execute the action specified by the given action object within a Region.
<E> com.gemstone.gemfire.cache.query.SelectResults<E>	find(String query, Object... params) Executes a GemFire query with the given (optional) parameters and returns the result.
<T> T	findUnique(String query, Object... params) Executes a GemFire query with the given (optional) parameters and returns the result.
<K,V> V	get(K key)
<K,V> Map<K,V>	getAll(Collection<?> keys)
<K,V> V	put(K key, V value)
<K,V> void	putAll(Map<? extends K,? extends V> map)
<K,V> V	putIfAbsent(K key, V value)
<E> com.gemstone.gemfire.cache.query.SelectResults<E>	query(String query) Shortcut for Region.query(String) method.
<K,V> V	remove(K key)
<K,V> V	replace(K key, V value)
<K,V> boolean	replace(K key, V oldValue, V newValue)

Method Detail

containsKey

boolean containsKey(Object key)

containsKeyOnServer

boolean containsKeyOnServer(Object key)

containsValue

boolean containsValue(Object value)

containsValueForKey

boolean containsValueForKey(Object key)

create

<K,V> void create(K key,
                  V value)

get

<K,V> V get(K key)

put

<K,V> V put(K key,
            V value)

putIfAbsent

<K,V> V putIfAbsent(K key,
                    V value)

remove

<K,V> V remove(K key)

replace

<K,V> V replace(K key,
                V value)

replace

<K,V> boolean replace(K key,
                      V oldValue,
                      V newValue)

getAll

<K,V> Map<K,V> getAll(Collection<?> keys)

putAll

<K,V> void putAll(Map<? extends K,? extends V> map)

query

<E> com.gemstone.gemfire.cache.query.SelectResults<E> query(String query)

Shortcut for Region.query(String) method. Filters the values of this region using the predicate given as a string with the syntax of the WHERE clause of the query language. The predefined variable this may be used inside the predicate to denote the current element being filtered. This method evaluates the passed in where clause and returns results. It is supported on servers as well as clients. When executed on a client, this method always runs on the server and returns results. When invoking this method from the client, applications can pass in a where clause or a complete query.

Parameters:

query - A query language boolean query predicate.

Returns:

A SelectResults containing the values of this Region that match the predicate.

See Also:

Region.query(String)

find

<E> com.gemstone.gemfire.cache.query.SelectResults<E> find(String query,
                                                           Object... params)
                                                       throws InvalidDataAccessApiUsageException

Executes a GemFire query with the given (optional) parameters and returns the result. Note this method expects the query to return multiple results; for queries that return only one element use findUnique(String, Object...).

As oppose, to the query(String) method, this method allows for more generic queries (against multiple regions even) to be executed.

Note that the local query service is used if the region is configured as a client without any pool configuration or server connectivity - otherwise the query service on the default pool is being used.

Parameters:

query - GemFire query

params - Values that are bound to parameters (such as $1) in this query.

Returns:

A SelectResults instance holding the objects matching the query

Throws:

InvalidDataAccessApiUsageException - in case the query returns a single result (not a SelectResults).

See Also:

QueryService.newQuery(String), Query.execute(Object[]), SelectResults

findUnique

<T> T findUnique(String query,
                 Object... params)
             throws InvalidDataAccessApiUsageException

Executes a GemFire query with the given (optional) parameters and returns the result. Note this method expects the query to return a single result; for queries that return multiple elements use find(String, Object...).

As oppose, to the query(String) method, this method allows for more generic queries (against multiple regions even) to be executed.

Note that the local query service is used if the region is configured as a client without any pool configuration or server connectivity - otherwise the query service on the default pool is being used.

Parameters:

query - GemFire query

params - Values that are bound to parameters (such as $1) in this query.

Returns:

The (single) object that represents the result of the query.

Throws:

InvalidDataAccessApiUsageException - in case the query returns multiple objects (through SelectResults).

See Also:

QueryService.newQuery(String), Query.execute(Object[])

execute

<T> T execute(GemfireCallback<T> action)
          throws DataAccessException

Throws:

DataAccessException

execute

<T> T execute(GemfireCallback<T> action,
              boolean exposeNativeRegion)
          throws DataAccessException

Execute the action specified by the given action object within a Region.

Parameters:

action - callback object that specifies the Gemfire action

exposeNativeRegion - whether to expose the native GemFire region to callback code

Returns:

a result object returned by the action, or null

Throws:

DataAccessException - in case of GemFire errors