play.cache

Class DefaultAsyncCacheApi

java.lang.Object

play.cache.DefaultAsyncCacheApi

All Implemented Interfaces:

AsyncCacheApi

@Singleton
public class DefaultAsyncCacheApi
extends java.lang.Object
implements AsyncCacheApi

Adapts a Scala AsyncCacheApi to a Java AsyncCacheApi. This is Play's default Java AsyncCacheApi implementation.

Constructor Summary

Constructors

Constructor and Description
DefaultAsyncCacheApi(play.api.cache.AsyncCacheApi cacheApi)

Method Summary

Modifier and Type	Method and Description
<T> java.util.concurrent.CompletionStage<T>	get(java.lang.String key) Deprecated.
<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.
SyncCacheApi	sync()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DefaultAsyncCacheApi

@Inject
public DefaultAsyncCacheApi(play.api.cache.AsyncCacheApi cacheApi)

Method Detail

sync

public SyncCacheApi sync()

Specified by:

sync in interface AsyncCacheApi

Returns:

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

get

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

Deprecated.

Description copied from interface: AsyncCacheApi

Retrieves an object by key.

Specified by:

get in interface AsyncCacheApi

Type Parameters:

T - the type of the stored object

Parameters:

key - the key to look up

Returns:

a CompletionStage containing the value

getOptional

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

Description copied from interface: AsyncCacheApi

Retrieves an object by key.

Specified by:

getOptional in interface AsyncCacheApi

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

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

Description copied from interface: AsyncCacheApi

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

Specified by:

getOrElseUpdate in interface AsyncCacheApi

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

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

Description copied from interface: AsyncCacheApi

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

Specified by:

getOrElseUpdate in interface AsyncCacheApi

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

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

Description copied from interface: AsyncCacheApi

Sets a value with expiration.

Specified by:

set in interface AsyncCacheApi

Parameters:

key - Item key.

value - The value to set.

expiration - expiration in seconds

Returns:

a CompletionStage containing the value

set

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

Description copied from interface: AsyncCacheApi

Sets a value without expiration.

Specified by:

set in interface AsyncCacheApi

Parameters:

key - Item key.

value - The value to set.

Returns:

a CompletionStage containing the value

remove

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

Description copied from interface: AsyncCacheApi

Removes a value from the cache.

Specified by:

remove in interface AsyncCacheApi

Parameters:

key - The key to remove the value for.

Returns:

a CompletionStage containing the value

removeAll

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

Description copied from interface: AsyncCacheApi

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

Specified by:

removeAll in interface AsyncCacheApi

Returns:

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