Interface GemfireOperations

All Known Implementing Classes:
GemfireTemplate

public interface GemfireOperations
GemfireOperations defines the {Region data access operations that can be performed using the Template software design pattern.
Author:
David Turanski, John Blum
See Also:
  • Method Details

    • 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)
    • getAll

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

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

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

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

      <K, V> V remove(K key)
    • removeAll

      default void removeAll(Collection<?> keys)
    • replace

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

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

      <E> 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.
      Type Parameters:
      E - type parameter specifying the type of the select results.
      Parameters:
      query - the OQL query statement to execute.
      params - an array of Object values used as arguments to bind to the OQL query parameters (such as $1).
      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:
    • 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.
      Type Parameters:
      T - type parameter specifying the returned result type.
      Parameters:
      query - the OQL query statement to execute.
      params - an array of Object values used as arguments to bind to the OQL query parameters (such as $1).
      Returns:
      The (single) object that represents the result of the query.
      Throws:
      InvalidDataAccessApiUsageException - in case the query returns multiple objects (through SelectResults).
      See Also:
    • query

      <E> 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.
      Type Parameters:
      E - type parameter specifying the type of the select results.
      Parameters:
      query - an OQL Query language boolean query predicate.
      Returns:
      A SelectResults containing the values of this Region that match the predicate.
      See Also:
    • execute

      <T> T execute(GemfireCallback<T> action) throws DataAccessException
      Execute the action specified by the given action object within a Region.
      Type Parameters:
      T - type parameter specifying the returned result type.
      Parameters:
      action - callback object that specifies the Gemfire action to execute.
      Returns:
      a result object returned by the action, or null.
      Throws:
      DataAccessException - in case of GemFire errors.
    • execute

      <T> T execute(GemfireCallback<T> action, boolean exposeNativeRegion) throws DataAccessException
      Execute the action specified by the given action object within a Region.
      Type Parameters:
      T - type parameter specifying the returned result type.
      Parameters:
      action - callback object that specifies the Gemfire action to execute.
      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.