public class GemfireTemplate extends GemfireAccessor implements GemfireOperations
GemFireCheckedException
および GemFireException
を Spring DataAccessException
に変換するヘルパークラス。中心となるメソッドは execute で、GemfireCallback インターフェースを実装する Pivotal GemFire アクセスコードをサポートします。専用の処理を提供するため、GemfireCallback 実装も呼び出しコードも Region
ライフサイクル例外の処理を明示的に気にする必要はありません。通常、実装内で Pivotal GemFire を使用するがインターフェースでは GemFire に依存しないデータアクセスサービスまたはビジネスロジックサービスを実装するために使用されます。後者または後者を呼び出すコードは、ビジネスオブジェクト、クエリオブジェクト、org.springframework.dao 例外のみを処理する必要があります。Map
SE, GemfireAccessor
, GemfireOperations
, Region
、Query
、QueryService
、SelectResults
logger
コンストラクターと説明 |
---|
GemfireTemplate() |
GemfireTemplate(org.apache.geode.cache.Region<K,V> region) |
修飾子と型 | メソッドと説明 |
---|---|
void | afterPropertiesSet() |
boolean | containsKey(ObjectSE key) |
boolean | containsKeyOnServer(ObjectSE key) |
boolean | containsValue(ObjectSE value) |
boolean | containsValueForKey(ObjectSE key) |
<K,V> void | create(K key, V value) |
protected <K,V> org.apache.geode.cache.Region<K,V> | createRegionProxy(org.apache.geode.cache.Region<K,V> region) 指定された Pivotal GemFire Cache Region のクローズ抑制プロキシを作成します。 |
<T> T | execute(GemfireCallback<T> action) 指定されたアクションオブジェクトによって指定されたアクションをリージョン内で実行します。 |
<T> T | execute(GemfireCallback<T> action, boolean exposeNativeRegion) 指定されたアクションオブジェクトによって指定されたアクションをリージョン内で実行します。 |
<E> org.apache.geode.cache.query.SelectResults<E> | find(StringSE queryString, ObjectSE... params) 指定された(オプションの)パラメーターを使用して Pivotal GemFire クエリを実行し、結果を返します。 |
<T> T | findUnique(StringSE queryString, ObjectSE... params) 指定された(オプションの)パラメーターを使用して Pivotal GemFire クエリを実行し、結果を返します。 |
<K,V> V | get(K key) |
<K,V> MapSE<K,V> | getAll(CollectionSE<?> keys) |
boolean | isExposeNativeRegion() ネイティブの Pivotal GemFire キャッシュ領域または領域プロキシを GemfireCallback コードに公開するかどうかを返します。 |
<K,V> V | put(K key, V value) |
<K,V> void | putAll(MapSE<? extends K,? extends V> map) |
<K,V> V | putIfAbsent(K key, V value) |
<E> org.apache.geode.cache.query.SelectResults<E> | query(StringSE query) Region.query(String) メソッドのショートカット。 |
<K,V> V | remove(K key) |
<K,V> V | replace(K key, V value) |
<K,V> boolean | replace(K key, V oldValue, V newValue) |
protected org.apache.geode.cache.query.QueryService | resolveQueryService(org.apache.geode.cache.Region<?,?> region) このテンプレートのクエリ / ファインダーメソッドで使用される QueryService を返します。 |
void | setExposeNativeRegion(boolean exposeNativeRegion) ネイティブの Gemfire リージョンを GemfireCallback コードに公開するかどうかを設定します。 |
convertGemFireAccessException, convertGemFireAccessException, convertGemFireQueryException, getRegion, setRegion
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE
public GemfireTemplate()
public GemfireTemplate(org.apache.geode.cache.Region<K,V> region)
public void afterPropertiesSet()
InitializingBean
の afterPropertiesSet
GemfireAccessor
の afterPropertiesSet
public void setExposeNativeRegion(boolean exposeNativeRegion)
close
呼び出しが抑制されます。 インターフェースにキャストする必要があることがよくあるため、公開されたプロキシは元の Region
によって実装されたすべてのインターフェースを実装します。これで十分でない場合は、このフラグを "true" にします。
exposeNativeRegion
- ネイティブ Pivotal GemFire キャッシュ領域を GemfireCallback に公開するかどうかを示すブール値。GemfireCallback
public boolean isExposeNativeRegion()
public boolean containsKey(ObjectSE key)
GemfireOperations
の containsKey
public boolean containsKeyOnServer(ObjectSE key)
GemfireOperations
の containsKeyOnServer
public boolean containsValue(ObjectSE value)
GemfireOperations
の containsValue
public boolean containsValueForKey(ObjectSE key)
GemfireOperations
の containsValueForKey
public <K,V> void create(K key, V value)
GemfireOperations
の create
public <K,V> V get(K key)
GemfireOperations
の get
public <K,V> MapSE<K,V> getAll(CollectionSE<?> keys)
GemfireOperations
の getAll
public <K,V> V put(K key, V value)
GemfireOperations
の put
public <K,V> void putAll(MapSE<? extends K,? extends V> map)
GemfireOperations
の putAll
public <K,V> V putIfAbsent(K key, V value)
GemfireOperations
の putIfAbsent
public <K,V> V remove(K key)
GemfireOperations
の remove
public <K,V> V replace(K key, V value)
GemfireOperations
の replace
public <K,V> boolean replace(K key, V oldValue, V newValue)
GemfireOperations
の replace
public <E> org.apache.geode.cache.query.SelectResults<E> query(StringSE query)
GemfireOperations
Region.query(String)
メソッドのショートカットです。クエリ言語の WHERE 句の構文を持つ文字列として指定された述語を使用して、この領域の値をフィルターします。定義済みの変数 this は、フィルターされる現在の要素を示すために述語内で使用できます。このメソッドは、渡された where 句を評価し、結果を返します。これは、サーバーとクライアントの両方でサポートされています。クライアントで実行される場合、このメソッドは常にサーバーで実行され、結果を返します。クライアントからこのメソッドを呼び出す場合、アプリケーションは where 句または完全なクエリを渡すことができます。GemfireOperations
の query
E
- 選択結果の型を指定する型パラメーター。query
- OQL クエリ言語のブールクエリ述語。Region.query(String)
public <E> org.apache.geode.cache.query.SelectResults<E> find(StringSE queryString, ObjectSE... params) throws InvalidDataAccessApiUsageException
GemfireOperations
GemfireOperations.findUnique(String, Object...)
を使用してください。GemfireOperations.query(String)
メソッドとは対照的に、このメソッドでは、より汎用的なクエリ (複数のリージョンに対しても) を実行できます。リージョンがプール構成やサーバー接続のないクライアントとして構成されている場合は、ローカルクエリサービスが使用されることに注意してください。それ以外の場合は、デフォルトプールのクエリサービスが使用されます。GemfireOperations
の find
E
- 選択結果の型を指定する型パラメーター。queryString
- 実行する OQL クエリステートメント。params
- OQL クエリパラメーターにバインドするための引数として使用されるオブジェクト値の配列 ($1 など)。SelectResults
インスタンス InvalidDataAccessApiUsageException
- クエリが単一の結果を返す場合(SelectResults
ではない)。QueryService.newQuery(String)
、Query.execute(Object[])
、SelectResults
public <T> T findUnique(StringSE queryString, ObjectSE... params) throws InvalidDataAccessApiUsageException
GemfireOperations
GemfireOperations.find(String, Object...)
を使用してください。GemfireOperations.query(String)
メソッドとは対照的に、このメソッドでは、より一般的なクエリ (複数のリージョンに対しても) を実行できます。リージョンがプール構成やサーバー接続のないクライアントとして構成されている場合は、ローカルクエリサービスが使用されることに注意してください。それ以外の場合は、デフォルトプールのクエリサービスが使用されます。GemfireOperations
の findUnique
T
- 返される結果の型を指定する型パラメーター。queryString
- 実行する OQL クエリステートメント。params
- OQL クエリパラメーターにバインドするための引数として使用されるオブジェクト値の配列 ($1 など)。InvalidDataAccessApiUsageException
- クエリが複数のオブジェクトを返す場合(SelectResults
経由)。QueryService.newQuery(String)
, Query.execute(Object[])
protected org.apache.geode.cache.query.QueryService resolveQueryService(org.apache.geode.cache.Region<?,?> region)
QueryService
を返します。region
- Region
は QueryService
を取得するために使用されます。QueryService
。Region
、Region.getRegionService()
、RegionService.getQueryService()
、ClientCache.getLocalQueryService()
public <T> T execute(GemfireCallback<T> action) throws DataAccessException
GemfireOperations
GemfireOperations
の execute
T
- 返される結果の型を指定する型パラメーター。action
- 実行する Gemfire アクションを指定するコールバックオブジェクト。null
。DataAccessException
- Pivotal GemFire エラーの場合。public <T> T execute(GemfireCallback<T> action, boolean exposeNativeRegion) throws DataAccessException
GemfireOperations
GemfireOperations
の execute
T
- 返される結果の型を指定する型パラメーター。action
- 実行する Gemfire アクションを指定するコールバックオブジェクト。exposeNativeRegion
- ネイティブ Pivotal GemFire 領域をコールバックコードに公開するかどうか。null
。DataAccessException
- Pivotal GemFire エラーの場合。protected <K,V> org.apache.geode.cache.Region<K,V> createRegionProxy(org.apache.geode.cache.Region<K,V> region)
Region
のクローズ抑制プロキシを作成します。execute
メソッドによって呼び出されます。K
- リージョンキークラス型。V
- 領域値クラス型。region
- プロキシを作成するための Pivotal GemFire キャッシュ領域。Region.close()
, execute(GemfireCallback, boolean)
Copyright © 2011–2021 Pivotal Software, Inc.. All rights reserved.