play.cache

Interface AsyncCacheApi

All Known Implementing Classes:

DefaultAsyncCacheApi

public interface AsyncCacheApi

The Cache API.

Method Summary

Modifier and Type	Method and Description
<T> java.util.concurrent.CompletionStage<T>	get(java.lang.String key) Deprecated. Deprecated as of 2.7.0. Use getOptional(String) instead.
<T> java.util.concurrent.CompletionStage<java.util.Optional<T>>	getOptional(java.lang.String key) Retrieves an object by key.
<T> java.util.concurrent.CompletionStage<T>	getOrElseUpdate(java.lang.String key, java.util.concurrent.Callable<java.util.concurrent.CompletionStage<T>> block) Retrieve a value from the cache, or set it from a default Callable function.
<T> java.util.concurrent.CompletionStage<T>	getOrElseUpdate(java.lang.String key, java.util.concurrent.Callable<java.util.concurrent.CompletionStage<T>> block, int expiration) Retrieve a value from the cache, or set it from a default Callable function.
java.util.concurrent.CompletionStage<akka.Done>	remove(java.lang.String key) Removes a value from the cache.
java.util.concurrent.CompletionStage<akka.Done>	removeAll() Removes all values from the cache.
java.util.concurrent.CompletionStage<akka.Done>	set(java.lang.String key, java.lang.Object value) Sets a value without expiration.
java.util.concurrent.CompletionStage<akka.Done>	set(java.lang.String key, java.lang.Object value, int expiration) Sets a value with expiration.
default SyncCacheApi	sync()

Method Detail

sync

default SyncCacheApi sync()

Returns:

a synchronous version of this cache, which can be used to make synchronous calls.

get

@Deprecated
<T> java.util.concurrent.CompletionStage<T> get(java.lang.String key)

Deprecated. Deprecated as of 2.7.0. Use getOptional(String) instead.

Retrieves an object by key.

Type Parameters:

T - the type of the stored object

Parameters:

key - the key to look up

Returns:

a CompletionStage containing the value

getOptional

<T> java.util.concurrent.CompletionStage<java.util.Optional<T>> getOptional(java.lang.String key)

Retrieves an object by key.

Type Parameters:

T - the type of the stored object

Parameters:

key - the key to look up

Returns:

a CompletionStage containing the value wrapped in an Optional

getOrElseUpdate

<T> java.util.concurrent.CompletionStage<T> getOrElseUpdate(java.lang.String key,
                                                            java.util.concurrent.Callable<java.util.concurrent.CompletionStage<T>> block,
                                                            int expiration)

Retrieve a value from the cache, or set it from a default Callable function.

Type Parameters:

T - the type of the value

Parameters:

key - Item key.

block - block returning value to set if key does not exist

expiration - expiration period in seconds.

Returns:

a CompletionStage containing the value

getOrElseUpdate

<T> java.util.concurrent.CompletionStage<T> getOrElseUpdate(java.lang.String key,
                                                            java.util.concurrent.Callable<java.util.concurrent.CompletionStage<T>> block)

Retrieve a value from the cache, or set it from a default Callable function. The value has no expiration.

Type Parameters:

T - the type of the value

Parameters:

key - Item key.

block - block returning value to set if key does not exist

Returns:

a CompletionStage containing the value

set

java.util.concurrent.CompletionStage<akka.Done> set(java.lang.String key,
                                                    java.lang.Object value,
                                                    int expiration)

Sets a value with expiration.

Parameters:

key - Item key.

value - The value to set.

expiration - expiration in seconds

Returns:

a CompletionStage containing the value

set

java.util.concurrent.CompletionStage<akka.Done> set(java.lang.String key,
                                                    java.lang.Object value)

Sets a value without expiration.

Parameters:

key - Item key.

value - The value to set.

Returns:

a CompletionStage containing the value

remove

java.util.concurrent.CompletionStage<akka.Done> remove(java.lang.String key)

Removes a value from the cache.

Parameters:

key - The key to remove the value for.

Returns:

a CompletionStage containing the value

removeAll

java.util.concurrent.CompletionStage<akka.Done> removeAll()

Removes all values from the cache. This may be useful as an admin user operation if it is supported by your cache.

Returns:

a CompletionStage containing either a Done when successful or an exception when unsuccessful.

Throws:

java.lang.UnsupportedOperationException - if this cache implementation does not support removing all values.