JSR107 Java缓存API规范详解

需积分: 0 156 浏览量更新于2024-07-06 收藏 818KB PDF 举报

身份认证购VIP最低享 7 折!

30元优惠券

资源详情

资源推荐

Java

Caching API – Final

#D"

3. A Simple Example

This simple example creates a default CacheManager, configures a cache on it called “simpleCache”

with a key type of String and a value type of Integer and an expiry of one hour and then performs

some cache operations.

//resolve a cache manager

CachingProvider cachingProvider = Caching.getCachingProvider();

CacheManager cacheManager = cachingProvider.getCacheManager();

//configure the cache

MutableConfiguration<String, Integer> config =

new MutableConfiguration<>()

.setTypes(String.class, Integer.class)

.setExpiryPolicyFactory(AccessedExpiryPolicy.factoryOf(ONE_HOUR))

.setStatisticsEnabled(true);

//create the cache

Cache<String, Integer> cache = cacheManager.createCache("simpleCache", config);

//cache operations

String key = "key";

Integer value1 = 1;

cache.put("key", value1);

Integer value2 = cache.get(key);

assertEquals(value1, value2);

cache.remove(key);

assertNull(cache.get(key));

Where the default CachingProvider and default CacheManager are being used, there is a static

convenience method for getting a Cache, Caching.getCache:

//get the cache

Cache<String, Integer> cache = Caching.getCache("simpleCache",

String.class, Integer.class);

Java

Caching API – Final

#M"

URI getURI();

/**

* Get the {@link ClassLoader} used by the {@link CacheManager}.

* @return the {@link ClassLoader} used by the {@link CacheManager}

ClassLoader getClassLoader();

/**

* Get the {@link Properties} that were used to create this

* {@link CacheManager}.

*

* Implementations are not required to re-configure the

* {@link CacheManager} should modifications to the returned

* {@link Properties} be made.

* @return the Properties used to create the {@link CacheManager}

Properties getProperties();

/**

* Creates a named {@link Cache} at runtime.

*

* If a {@link Cache} with the specified name is known to the {@link

* CacheManager}, a CacheException is thrown.

*

* If a {@link Cache} with the specified name is unknown the {@link

* CacheManager}, one is created according to the provided {@link Configuration}

* after which it becomes managed by the {@link CacheManager}.

*

* Prior to a {@link Cache} being created, the provided {@link Configuration}s is

* validated within the context of the {@link CacheManager} properties and

* implementation.

*

* Implementers should be aware that the {@link Configuration} may be used to

* configure other {@link Cache}s.

*

* There's no requirement on the part of a developer to call this method for

* each {@link Cache} an application may use. Implementations may support

* the use of declarative mechanisms to pre-configure {@link Cache}s, thus

* removing the requirement to configure them in an application. In such

* circumstances a developer may simply call either the

* {@link #getCache(String)} or {@link #getCache(String, Class, Class)}

* methods to acquire a previously established or pre-configured {@link Cache}.

* @param cacheName the name of the {@link Cache}

* @param configuration a {@link Configuration} for the {@link Cache}

* @throws IllegalStateException if the {@link CacheManager}

* {@link #isClosed()}

Java

Caching API – Final

!Q"

* @throws CacheException if there was an error configuring the

* {@link Cache}, which includes trying

* to create a cache that already exists.

* @throws IllegalArgumentException if the configuration is invalid

* @throws UnsupportedOperationException if the configuration specifies

* an unsupported feature

* @throws NullPointerException if the cache configuration or name

* is null

* @throws SecurityException when the operation could not be performed

* due to the current security settings

<K, V, C extends Configuration<K, V>> Cache<K, V> createCache(String cacheName,

C configuration)

throws IllegalArgumentException;

/**

* Looks up a managed {@link Cache} given its name.

*

* This method must be used for {@link Cache}s that were configured with

* runtime key and value types. Use {@link #getCache(String)} for

* {@link Cache}s where these were not specified.

*

* Implementations must ensure that the key and value types are the same as

* those configured for the {@link Cache} prior to returning from this method.

*

* Implementations may further perform type checking on mutative cache operations

* and throw a {@link ClassCastException} if these checks fail.

*

* Implementations that support declarative mechanisms for pre-configuring

* {@link Cache}s may return a pre-configured {@link Cache} instead of

* <code>null</code>.

* @param cacheName the name of the managed {@link Cache} to acquire

* @param keyType the expected {@link Class} of the key

* @param valueType the expected {@link Class} of the value

* @return the Cache or null if it does exist or can't be pre-configured

* @throws IllegalStateException if the {@link CacheManager}

* is {@link #isClosed()}

* @throws IllegalArgumentException if the specified key and/or value types are

* incompatible with the configured cache.

* @throws SecurityException when the operation could not be performed

* due to the current security settings

<K, V> Cache<K, V> getCache(String cacheName, Class<K> keyType,

Class<V> valueType);

/**

* Looks up a managed {@link Cache} given its name.

*

* This method may only be used to acquire {@link Cache}s that were

剩余139页未读，继续阅读

顧棟

粉丝: 3628
资源: 14

JSR107 Java缓存API规范详解

JSR107 Specification 1.1.1.pdf

JSR-107 标准手册 Specification

jsr107spec：JSR107缓存规范

Java™ Caching API - JSR107 1.1.1规范详解

jsr107cache

jsr107-开源

jsr：Java规范请求

The_Java_Portlet_Specification(JSR168规范英文版)

jsf 2.0(JSR-314) 最终规范 包含javadoc

JSR技术规范

jcache-examples:JSR107 JCache示例

JSR规范大全

appengine-jsr107cache-1.8.8.zip

appengine-jsr107cache-1.7.3.zip

portalet规范2.0（jsr286）英文版

JSR-107 文档

com.springsource.net.sf.jsr107cache-1.0.0.jar

最新资源

jsf 2.0(JSR-314) 最终规范包含javadoc