play.cache
类 Cache

java.lang.Object
  play.cache.Cache

public abstract class Cache
extends java.lang.Object

The Cache. Mainly an interface to memcached or EhCache. Note: When specifying expiration == "0s" (zero seconds) the actual expiration-time may vary between different cache implementations

字段摘要

static CacheImpl	cacheImpl The underlying cache implementation
static CacheImpl	forcedCacheImpl Sometime we REALLY need to change the implementation :)

构造方法摘要

Cache()

方法摘要

static void	add(java.lang.String key, java.lang.Object value) Add an element only if it doesn't exist and store it indefinitely.
static void	add(java.lang.String key, java.lang.Object value, java.lang.String expiration) Add an element only if it doesn't exist.
static void	clear() Clear all data from cache.
static long	decr(java.lang.String key) Decrement the element value (must be a Number) by 1.
static long	decr(java.lang.String key, int by) Decrement the element value (must be a Number).
static void	delete(java.lang.String key) Delete an element from the cache.
static java.util.Map<java.lang.String,java.lang.Object>	get(java.lang.String... key) Bulk retrieve.
static java.lang.Object	get(java.lang.String key) Retrieve an object.
static <T> T	get(java.lang.String key, java.lang.Class<T> clazz) Convenient clazz to get a value a class type;
static long	incr(java.lang.String key) Increment the element value (must be a Number) by 1.
static long	incr(java.lang.String key, int by) Increment the element value (must be a Number).
static void	init() Initialize the cache system.
static void	replace(java.lang.String key, java.lang.Object value) Replace an element only if it already exists and store it indefinitely.
static void	replace(java.lang.String key, java.lang.Object value, java.lang.String expiration) Replace an element only if it already exists.
static boolean	safeAdd(java.lang.String key, java.lang.Object value, java.lang.String expiration) Add an element only if it doesn't exist, and return only when the element is effectively cached.
static boolean	safeDelete(java.lang.String key) Delete an element from the cache and return only when the element is effectively removed.
static boolean	safeReplace(java.lang.String key, java.lang.Object value, java.lang.String expiration) Replace an element only if it already exists and return only when the element is effectively cached.
static boolean	safeSet(java.lang.String key, java.lang.Object value, java.lang.String expiration) Set an element and return only when the element is effectively cached.
static void	set(java.lang.String key, java.lang.Object value) Set an element and store it indefinitely.
static void	set(java.lang.String key, java.lang.Object value, java.lang.String expiration) Set an element.
static void	stop() Stop the cache system.

从类 java.lang.Object 继承的方法

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

字段详细信息

cacheImpl

public static CacheImpl cacheImpl

The underlying cache implementation

forcedCacheImpl

public static CacheImpl forcedCacheImpl

Sometime we REALLY need to change the implementation :)

构造方法详细信息

Cache

public Cache()

方法详细信息

add

public static void add(java.lang.String key,
                       java.lang.Object value,
                       java.lang.String expiration)

Add an element only if it doesn't exist.

参数：

key - Element key

value - Element value

expiration - Ex: 10s, 3mn, 8h

safeAdd

public static boolean safeAdd(java.lang.String key,
                              java.lang.Object value,
                              java.lang.String expiration)

Add an element only if it doesn't exist, and return only when the element is effectively cached.

参数：

key - Element key

value - Element value

expiration - Ex: 10s, 3mn, 8h

返回：

If the element an eventually been cached

add

public static void add(java.lang.String key,
                       java.lang.Object value)

Add an element only if it doesn't exist and store it indefinitely.

参数：

key - Element key

value - Element value

set

public static void set(java.lang.String key,
                       java.lang.Object value,
                       java.lang.String expiration)

Set an element.

参数：

key - Element key

value - Element value

expiration - Ex: 10s, 3mn, 8h

safeSet

public static boolean safeSet(java.lang.String key,
                              java.lang.Object value,
                              java.lang.String expiration)

Set an element and return only when the element is effectively cached.

参数：

key - Element key

value - Element value

expiration - Ex: 10s, 3mn, 8h

返回：

If the element an eventually been cached

set

public static void set(java.lang.String key,
                       java.lang.Object value)

Set an element and store it indefinitely.

参数：

key - Element key

value - Element value

replace

public static void replace(java.lang.String key,
                           java.lang.Object value,
                           java.lang.String expiration)

Replace an element only if it already exists.

参数：

key - Element key

value - Element value

expiration - Ex: 10s, 3mn, 8h

safeReplace

public static boolean safeReplace(java.lang.String key,
                                  java.lang.Object value,
                                  java.lang.String expiration)

Replace an element only if it already exists and return only when the element is effectively cached.

参数：

key - Element key

value - Element value

expiration - Ex: 10s, 3mn, 8h

返回：

If the element an eventually been cached

replace

public static void replace(java.lang.String key,
                           java.lang.Object value)

Replace an element only if it already exists and store it indefinitely.

参数：

key - Element key

value - Element value

incr

public static long incr(java.lang.String key,
                        int by)

Increment the element value (must be a Number).

参数：

key - Element key

by - The incr value

返回：

The new value

incr

public static long incr(java.lang.String key)

Increment the element value (must be a Number) by 1.

参数：

key - Element key

返回：

The new value

decr

public static long decr(java.lang.String key,
                        int by)

Decrement the element value (must be a Number).

参数：

key - Element key

by - The decr value

返回：

The new value

decr

public static long decr(java.lang.String key)

Decrement the element value (must be a Number) by 1.

参数：

key - Element key

返回：

The new value

get

public static java.lang.Object get(java.lang.String key)

Retrieve an object.

参数：

key - The element key

返回：

The element value or null

get

public static java.util.Map<java.lang.String,java.lang.Object> get(java.lang.String... key)

Bulk retrieve.

参数：

key - List of keys

返回：

Map of keys & values

delete

public static void delete(java.lang.String key)

Delete an element from the cache.

参数：

key - The element key

safeDelete

public static boolean safeDelete(java.lang.String key)

Delete an element from the cache and return only when the element is effectively removed.

参数：

key - The element key

返回：

If the element an eventually been deleted

clear

public static void clear()

Clear all data from cache.

get

public static <T> T get(java.lang.String key,
                        java.lang.Class<T> clazz)

Convenient clazz to get a value a class type;

类型参数：

T - The needed type

参数：

key - The element key

clazz - The type class

返回：

The element value or null

init

public static void init()

Initialize the cache system.

stop

public static void stop()

Stop the cache system.