注解Spring Cache+Redis缓存

Spring Cache介绍

缓存是实际工作中非常常用的一种提高性能的方法, 我们会在许多场景下来使用缓存。

本文通过一个简单的例子进行展开,通过对比我们原来的自定义缓存和 spring 的基于注释的 cache 配置方法,展现了 spring cache 的强大之处,然后介绍了其基本的原理,扩展点和使用场景的限制。通过阅读本文,你应该可以短时间内掌握 spring 带来的强大缓存技术,在很少的配置下即可给既有代码提供缓存能力。

  • 概述
    Spring 3.1 引入了激动人心的基于注释(annotation)的缓存(cache)技术,它本质上不是一个具体的缓存实现方案(例如EHCache 或者 OSCache),而是一个对缓存使用的抽象,通过在既有代码中添加少量它定义的各种 annotation,即能够达到缓存方法的返回对象的效果。

Spring 的缓存技术还具备相当的灵活性,不仅能够使用 SpEL(Spring Expression Language)来定义缓存的 key 和各种 condition,还提供开箱即用的缓存临时存储方案,也支持和主流的专业缓存例如 EHCache 集成。

其特点总结如下:

通过少量的配置 annotation 注释即可使得既有代码支持缓存
支持开箱即用 Out-Of-The-Box,即不用安装和部署额外第三方组件即可使用缓存
支持 Spring Express Language,能使用对象的任何属性或者方法来定义缓存的 key 和 condition
支持 AspectJ,并通过其实现任何方法的缓存支持
支持自定义 key 和自定义缓存管理者,具有相当的灵活性和扩展性
本文将针对上述特点对 Spring cache 进行详细的介绍,主要通过一个简单的例子和原理介绍展开,然后我们将一起看一个比较实际的缓存例子,最后会介绍 spring cache 的使用限制和注意事项。好吧,让我们开始吧

  • 我们以前如何自己实现缓存的呢
    这里先展示一个完全自定义的缓存实现,即不用任何第三方的组件来实现某种对象的内存缓存。

场景如下:
对一个账号查询方法做缓存,以账号名称为 key,账号对象为 value,当以相同的账号名称查询账号的时候,直接从缓存中返回结果,否则更新缓存。账号查询服务还支持 reload 缓存(即清空缓存)
首先定义一个实体类:账号类,具备基本的 id 和 name 属性,且具备 getter 和 setter 方法

public class Account {

    private int id;
    private String name;

    public Account(String name) {
        this.name = name;
    }
    public int getId() {
        return id;
    }
    public void setId(int id) {
        this.id = id;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }

}

然后定义一个缓存管理器,这个管理器负责实现缓存逻辑,支持对象的增加、修改和删除,支持值对象的泛型。如下:

import com.google.common.collect.Maps;

import java.util.Map;

/**
 * @author wenchao.ren
 *         2015/1/5.
 */
public class CacheContext {

    private Map cache = Maps.newConcurrentMap();

    public T get(String key){
        return  cache.get(key);
    }

    public void addOrUpdateCache(String key,T value) {
        cache.put(key, value);
    }

    // 根据 key 来删除缓存中的一条记录
    public void evictCache(String key) {
        if(cache.containsKey(key)) {
            cache.remove(key);
        }
    }

    // 清空缓存中的所有记录
    public void evictCache() {
        cache.clear();
    }

}

好,现在我们有了实体类和一个缓存管理器,还需要一个提供账号查询的服务类,此服务类使用缓存管理器来支持账号查询缓存,如下:

import com.google.common.base.Optional;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Service;

import javax.annotation.Resource;

/**
 * @author wenchao.ren
 *         2015/1/5.
 */
@Service
public class AccountService1 {

    private final Logger logger = LoggerFactory.getLogger(AccountService1.class);

    @Resource
    private CacheContext accountCacheContext;

    public Account getAccountByName(String accountName) {
        Account result = accountCacheContext.get(accountName);
        if (result != null) {
            logger.info("get from cache... {}", accountName);
            return result;
        }

        Optional accountOptional = getFromDB(accountName);
        if (!accountOptional.isPresent()) {
            throw new IllegalStateException(String.format("can not find account by account name : [%s]", accountName));
        }

        Account account = accountOptional.get();
        accountCacheContext.addOrUpdateCache(accountName, account);
        return account;
    }

    public void reload() {
        accountCacheContext.evictCache();
    }

    private Optional getFromDB(String accountName) {
        logger.info("real querying db... {}", accountName);
        //Todo query data from database
        return Optional.fromNullable(new Account(accountName));
    }

}

现在我们开始写一个测试类,用于测试刚才的缓存是否有效

import org.junit.Before;
import org.junit.Test;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.context.support.ClassPathXmlApplicationContext;

import static org.junit.Assert.*;

public class AccountService1Test {

    private AccountService1 accountService1;

    private final Logger logger = LoggerFactory.getLogger(AccountService1Test.class);

    @Before
    public void setUp() throws Exception {
        ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext("applicationContext1.xml");
        accountService1 = context.getBean("accountService1", AccountService1.class);
    }

    @Test
    public void testInject(){
        assertNotNull(accountService1);
    }

    @Test
    public void testGetAccountByName() throws Exception {
        accountService1.getAccountByName("accountName");
        accountService1.getAccountByName("accountName");

        accountService1.reload();
        logger.info("after reload ....");

        accountService1.getAccountByName("accountName");
        accountService1.getAccountByName("accountName");
    }
}

按照分析,执行结果应该是:首先从数据库查询,然后直接返回缓存中的结果,重置缓存后,应该先从数据库查询,然后返回缓存中的结果. 查看程序运行的日志如下:

00:53:17.166 [main] INFO  c.r.s.cache.example1.AccountService - real querying db... accountName
00:53:17.168 [main] INFO  c.r.s.cache.example1.AccountService - get from cache... accountName
00:53:17.168 [main] INFO  c.r.s.c.example1.AccountServiceTest - after reload ....
00:53:17.168 [main] INFO  c.r.s.cache.example1.AccountService - real querying db... accountName
00:53:17.169 [main] INFO  c.r.s.cache.example1.AccountService - get from cache... accountName

可以看出我们的缓存起效了,但是这种自定义的缓存方案有如下劣势:

缓存代码和业务代码耦合度太高,如上面的例子,AccountService 中的 getAccountByName()方法中有了太多缓存的逻辑,不便于维护和变更
不灵活,这种缓存方案不支持按照某种条件的缓存,比如只有某种类型的账号才需要缓存,这种需求会导致代码的变更
缓存的存储这块写的比较死,不能灵活的切换为使用第三方的缓存模块
如果你的代码中有上述代码的影子,那么你可以考虑按照下面的介绍来优化一下你的代码结构了,也可以说是简化,你会发现,你的代码会变得优雅的多!

  • Spring cache是如何做的呢
    我们对AccountService1 进行修改,创建AccountService2:
import com.google.common.base.Optional;
import com.rollenholt.spring.cache.example1.Account;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.cache.annotation.Cacheable;
import org.springframework.stereotype.Service;

/**
 * @author wenchao.ren
 *         2015/1/5.
 */
@Service
public class AccountService2 {

    private final Logger logger = LoggerFactory.getLogger(AccountService2.class);

    // 使用了一个缓存名叫 accountCache
    @Cacheable(value="accountCache")
    public Account getAccountByName(String accountName) {

        // 方法内部实现不考虑缓存逻辑,直接实现业务
        logger.info("real querying account... {}", accountName);
        Optional accountOptional = getFromDB(accountName);
        if (!accountOptional.isPresent()) {
            throw new IllegalStateException(String.format("can not find account by account name : [%s]", accountName));
        }

        return accountOptional.get();
    }

    private Optional getFromDB(String accountName) {
        logger.info("real querying db... {}", accountName);
        //Todo query data from database
        return Optional.fromNullable(new Account(accountName));
    }

}

我们注意到在上面的代码中有一行:

@Cacheable(value="accountCache")

这个注释的意思是,当调用这个方法的时候,会从一个名叫 accountCache 的缓存中查询,如果没有,则执行实际的方法(即查询数据库),并将执行的结果存入缓存中,否则返回缓存中的对象。这里的缓存中的 key 就是参数 accountName,value 就是 Account 对象。“accountCache”缓存是在 spring*.xml 中定义的名称。我们还需要一个 spring 的配置文件来支持基于注释的缓存

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:cache="http://www.springframework.org/schema/cache"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
           http://www.springframework.org/schema/beans/spring-beans.xsd
           http://www.springframework.org/schema/context
           http://www.springframework.org/schema/context/spring-context.xsd
           http://www.springframework.org/schema/cache
           http://www.springframework.org/schema/cache/spring-cache.xsd">

    <context:component-scan base-package="com.rollenholt.spring.cache"/>

    <context:annotation-config/>

    <cache:annotation-driven/>

    <bean id="cacheManager" class="org.springframework.cache.support.SimpleCacheManager">
        <property name="caches">
            <set>
                <bean class="org.springframework.cache.concurrent.ConcurrentMapCacheFactoryBean">
                    <property name="name" value="default"/>
                bean>
                <bean class="org.springframework.cache.concurrent.ConcurrentMapCacheFactoryBean">
                    <property name="name" value="accountCache"/>
                bean>
            set>
        property>
    bean>

beans>

注意这个 spring 配置文件有一个关键的支持缓存的配置项:

<cache:annotation-driven />

这个配置项缺省使用了一个名字叫 cacheManager 的缓存管理器,这个缓存管理器有一个 spring 的缺省实现,即 org.springframework.cache.support.SimpleCacheManager,这个缓存管理器实现了我们刚刚自定义的缓存管理器的逻辑,它需要配置一个属性 caches,即此缓存管理器管理的缓存集合,除了缺省的名字叫 default 的缓存,我们还自定义了一个名字叫 accountCache 的缓存,使用了缺省的内存存储方案 ConcurrentMapCacheFactoryBean,它是基于 java.util.concurrent.ConcurrentHashMap 的一个内存缓存实现方案。

然后我们编写测试程序:

import org.junit.Before;
import org.junit.Test;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.context.support.ClassPathXmlApplicationContext;

import static org.junit.Assert.*;

public class AccountService2Test {

    private AccountService2 accountService2;

    private final Logger logger = LoggerFactory.getLogger(AccountService2Test.class);

    @Before
    public void setUp() throws Exception {
        ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext("applicationContext2.xml");
        accountService2 = context.getBean("accountService2", AccountService2.class);
    }

    @Test
    public void testInject(){
        assertNotNull(accountService2);
    }

    @Test
    public void testGetAccountByName() throws Exception {
        logger.info("first query...");
        accountService2.getAccountByName("accountName");

        logger.info("second query...");
        accountService2.getAccountByName("accountName");
    }
}

上面的测试代码主要进行了两次查询,第一次应该会查询数据库,第二次应该返回缓存,不再查数据库,我们执行一下,看看结果

01:10:32.435 [main] INFO  c.r.s.c.example2.AccountService2Test - first query...
01:10:32.456 [main] INFO  c.r.s.cache.example2.AccountService2 - real querying account... accountName
01:10:32.457 [main] INFO  c.r.s.cache.example2.AccountService2 - real querying db... accountName
01:10:32.458 [main] INFO  c.r.s.c.example2.AccountService2Test - second query...

可以看出我们设置的基于注释的缓存起作用了,而在 AccountService.java 的代码中,我们没有看到任何的缓存逻辑代码,只有一行注释:@Cacheable(value=”accountCache”),就实现了基本的缓存方案,是不是很强大?

  • 如何清空缓存
    好,到目前为止,我们的 spring cache 缓存程序已经运行成功了,但是还不完美,因为还缺少一个重要的缓存管理逻辑:清空缓存.

当账号数据发生变更,那么必须要清空某个缓存,另外还需要定期的清空所有缓存,以保证缓存数据的可靠性。

为了加入清空缓存的逻辑,我们只要对 AccountService2.java 进行修改,从业务逻辑的角度上看,它有两个需要清空缓存的地方

当外部调用更新了账号,则我们需要更新此账号对应的缓存
当外部调用说明重新加载,则我们需要清空所有缓存
我们在AccountService2的基础上进行修改,修改为AccountService3,代码如下:

import com.google.common.base.Optional;
import com.rollenholt.spring.cache.example1.Account;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.cache.annotation.CacheEvict;
import org.springframework.cache.annotation.Cacheable;
import org.springframework.stereotype.Service;

/**
 * @author wenchao.ren
 *         2015/1/5.
 */
@Service
public class AccountService3 {

    private final Logger logger = LoggerFactory.getLogger(AccountService3.class);

    // 使用了一个缓存名叫 accountCache
    @Cacheable(value="accountCache")
    public Account getAccountByName(String accountName) {

        // 方法内部实现不考虑缓存逻辑,直接实现业务
        logger.info("real querying account... {}", accountName);
        Optional accountOptional = getFromDB(accountName);
        if (!accountOptional.isPresent()) {
            throw new IllegalStateException(String.format("can not find account by account name : [%s]", accountName));
        }

        return accountOptional.get();
    }

    @CacheEvict(value="accountCache",key="#account.getName()")
    public void updateAccount(Account account) {
        updateDB(account);
    }

    @CacheEvict(value="accountCache",allEntries=true)
    public void reload() {
    }

    private void updateDB(Account account) {
        logger.info("real update db...{}", account.getName());
    }

    private Optional getFromDB(String accountName) {
        logger.info("real querying db... {}", accountName);
        //Todo query data from database
        return Optional.fromNullable(new Account(accountName));
    }
}

我们的测试代码如下:

import com.rollenholt.spring.cache.example1.Account;
import org.junit.Before;
import org.junit.Test;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.context.support.ClassPathXmlApplicationContext;

public class AccountService3Test {

private AccountService3 accountService3;

private final Logger logger = LoggerFactory.getLogger(AccountService3Test.class);

@Before
public void setUp() throws Exception {
    ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext("applicationContext2.xml");
    accountService3 = context.getBean("accountService3", AccountService3.class);
}

@Test
public void testGetAccountByName() throws Exception {

    logger.info("first query.....");
    accountService3.getAccountByName("accountName");

    logger.info("second query....");
    accountService3.getAccountByName("accountName");

}

@Test
public void testUpdateAccount() throws Exception {
    Account account1 = accountService3.getAccountByName("accountName1");
    logger.info(account1.toString());
    Account account2 = accountService3.getAccountByName("accountName2");
    logger.info(account2.toString());

    account2.setId(121212);
    accountService3.updateAccount(account2);

    // account1会走缓存
    account1 = accountService3.getAccountByName("accountName1");
    logger.info(account1.toString());
    // account2会查询db
    account2 = accountService3.getAccountByName("accountName2");
    logger.info(account2.toString());

}

@Test
public void testReload() throws Exception {
    accountService3.reload();
    // 这2行查询数据库
    accountService3.getAccountByName("somebody1");
    accountService3.getAccountByName("somebody2");

    // 这两行走缓存
    accountService3.getAccountByName("somebody1");
    accountService3.getAccountByName("somebody2");
}

}
在这个测试代码中我们重点关注testUpdateAccount()方法,在测试代码中我们已经注释了在update完account2以后,再次查询的时候,account1会走缓存,而account2不会走缓存,而去查询db,观察程序运行日志,运行日志为:

01:37:34.549 [main] INFO c.r.s.cache.example3.AccountService3 - real querying account… accountName1
01:37:34.551 [main] INFO c.r.s.cache.example3.AccountService3 - real querying db… accountName1
01:37:34.552 [main] INFO c.r.s.c.example3.AccountService3Test - Account{id=0, name=’accountName1’}
01:37:34.553 [main] INFO c.r.s.cache.example3.AccountService3 - real querying account… accountName2
01:37:34.553 [main] INFO c.r.s.cache.example3.AccountService3 - real querying db… accountName2
01:37:34.555 [main] INFO c.r.s.c.example3.AccountService3Test - Account{id=0, name=’accountName2’}
01:37:34.555 [main] INFO c.r.s.cache.example3.AccountService3 - real update db…accountName2
01:37:34.595 [main] INFO c.r.s.c.example3.AccountService3Test - Account{id=0, name=’accountName1’}
01:37:34.596 [main] INFO c.r.s.cache.example3.AccountService3 - real querying account… accountName2
01:37:34.596 [main] INFO c.r.s.cache.example3.AccountService3 - real querying db… accountName2
01:37:34.596 [main] INFO c.r.s.c.example3.AccountService3Test - Account{id=0, name=’accountName2’}
我们会发现实际运行情况和我们预估的结果是一致的。

如何按照条件操作缓存
前面介绍的缓存方法,没有任何条件,即所有对 accountService 对象的 getAccountByName 方法的调用都会起动缓存效果,不管参数是什么值。

如果有一个需求,就是只有账号名称的长度小于等于 4 的情况下,才做缓存,大于 4 的不使用缓存

虽然这个需求比较坑爹,但是抛开需求的合理性,我们怎么实现这个功能呢?

通过查看CacheEvict注解的定义,我们会发现:

/**
* Annotation indicating that a method (or all methods on a class) trigger(s)
* a cache invalidate operation.
*
* @author Costin Leau
* @author Stephane Nicoll
* @since 3.1
* @see CacheConfig
*/
@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
public @interface CacheEvict {

/**
 * Qualifier value for the specified cached operation.
 * 

May be used to determine the target cache (or caches), matching the qualifier * value (or the bean name(s)) of (a) specific bean definition. */ String[] value() default {}; /** * Spring Expression Language (SpEL) attribute for computing the key dynamically. *

Default is "", meaning all method parameters are considered as a key, unless * a custom {@link #keyGenerator()} has been set. */ String key() default ""; /** * The bean name of the custom {@link org.springframework.cache.interceptor.KeyGenerator} to use. *

Mutually exclusive with the {@link #key()} attribute. */ String keyGenerator() default ""; /** * The bean name of the custom {@link org.springframework.cache.CacheManager} to use to * create a default {@link org.springframework.cache.interceptor.CacheResolver} if none * is set already. *

Mutually exclusive with the {@link #cacheResolver()} attribute. * @see org.springframework.cache.interceptor.SimpleCacheResolver */ String cacheManager() default ""; /** * The bean name of the custom {@link org.springframework.cache.interceptor.CacheResolver} to use. */ String cacheResolver() default ""; /** * Spring Expression Language (SpEL) attribute used for conditioning the method caching. *

Default is "", meaning the method is always cached. */ String condition() default ""; /** * Whether or not all the entries inside the cache(s) are removed or not. By * default, only the value under the associated key is removed. *

Note that setting this parameter to {@code true} and specifying a {@link #key()} * is not allowed. */ boolean allEntries() default false; /** * Whether the eviction should occur after the method is successfully invoked (default) * or before. The latter causes the eviction to occur irrespective of the method outcome (whether * it threw an exception or not) while the former does not. */ boolean beforeInvocation() default false;

}
定义中有一个condition描述:

Spring Expression Language (SpEL) attribute used for conditioning the method caching.Default is “”, meaning the method is always cached.

我们可以利用这个方法来完成这个功能,下面只给出示例代码:

@Cacheable(value=”accountCache”,condition=”#accountName.length() <= 4”)// 缓存名叫 accountCache
public Account getAccountByName(String accountName) {
// 方法内部实现不考虑缓存逻辑,直接实现业务
return getFromDB(accountName);
}
注意其中的 condition=”#accountName.length() <=4”,这里使用了 SpEL 表达式访问了参数 accountName 对象的 length() 方法,条件表达式返回一个布尔值,true/false,当条件为 true,则进行缓存操作,否则直接调用方法执行的返回结果。

如果有多个参数,如何进行 key 的组合
我们看看CacheEvict注解的key()方法的描述:

Spring Expression Language (SpEL) attribute for computing the key dynamically. Default is “”, meaning all method parameters are considered as a key, unless a custom {@link #keyGenerator()} has been set.

假设我们希望根据对象相关属性的组合来进行缓存,比如有这么一个场景:

要求根据账号名、密码和是否发送日志查询账号信息

很明显,这里我们需要根据账号名、密码对账号对象进行缓存,而第三个参数“是否发送日志”对缓存没有任何影响。所以,我们可以利用 SpEL 表达式对缓存 key 进行设计

我们为Account类增加一个password 属性, 然后修改AccountService代码:

@Cacheable(value=”accountCache”,key=”#accountName.concat(#password)”)
public Account getAccount(String accountName,String password,boolean sendLog) {
// 方法内部实现不考虑缓存逻辑,直接实现业务
return getFromDB(accountName,password);
}

注意上面的 key 属性,其中引用了方法的两个参数 accountName 和 password,而 sendLog 属性没有考虑,因为其对缓存没有影响。

accountService.getAccount(“accountName”, “123456”, true);// 查询数据库
accountService.getAccount(“accountName”, “123456”, true);// 走缓存
accountService.getAccount(“accountName”, “123456”, false);// 走缓存
accountService.getAccount(“accountName”, “654321”, true);// 查询数据库
accountService.getAccount(“accountName”, “654321”, true);// 走缓存
如何做到:既要保证方法被调用,又希望结果被缓存
根据前面的例子,我们知道,如果使用了 @Cacheable 注释,则当重复使用相同参数调用方法的时候,方法本身不会被调用执行,即方法本身被略过了,取而代之的是方法的结果直接从缓存中找到并返回了。

现实中并不总是如此,有些情况下我们希望方法一定会被调用,因为其除了返回一个结果,还做了其他事情,例如记录日志,调用接口等,这个时候,我们可以用 @CachePut 注释,这个注释可以确保方法被执行,同时方法的返回值也被记录到缓存中。

@Cacheable(value=”accountCache”)
public Account getAccountByName(String accountName) {
// 方法内部实现不考虑缓存逻辑,直接实现业务
return getFromDB(accountName);
}

// 更新 accountCache 缓存
@CachePut(value=”accountCache”,key=”#account.getName()”)
public Account updateAccount(Account account) {
return updateDB(account);
}
private Account updateDB(Account account) {
logger.info(“real updating db…”+account.getName());
return account;
}
我们的测试代码如下

Account account = accountService.getAccountByName(“someone”);
account.setPassword(“123”);
accountService.updateAccount(account);
account.setPassword(“321”);
accountService.updateAccount(account);
account = accountService.getAccountByName(“someone”);
logger.info(account.getPassword());
如上面的代码所示,我们首先用 getAccountByName 方法查询一个人 someone 的账号,这个时候会查询数据库一次,但是也记录到缓存中了。然后我们修改了密码,调用了 updateAccount 方法,这个时候会执行数据库的更新操作且记录到缓存,我们再次修改密码并调用 updateAccount 方法,然后通过 getAccountByName 方法查询,这个时候,由于缓存中已经有数据,所以不会查询数据库,而是直接返回最新的数据,所以打印的密码应该是“321”

@Cacheable、@CachePut、@CacheEvict 注释介绍
@Cacheable 主要针对方法配置,能够根据方法的请求参数对其结果进行缓存
@CachePut 主要针对方法配置,能够根据方法的请求参数对其结果进行缓存,和 @Cacheable 不同的是,它每次都会触发真实方法的调用
-@CachEvict 主要针对方法配置,能够根据一定的条件对缓存进行清空
基本原理
一句话介绍就是Spring AOP的动态代理技术。 如果读者对Spring AOP不熟悉的话,可以去看看官方文档

扩展性
直到现在,我们已经学会了如何使用开箱即用的 spring cache,这基本能够满足一般应用对缓存的需求。

但现实总是很复杂,当你的用户量上去或者性能跟不上,总需要进行扩展,这个时候你或许对其提供的内存缓存不满意了,因为其不支持高可用性,也不具备持久化数据能力,这个时候,你就需要自定义你的缓存方案了。

还好,spring 也想到了这一点。我们先不考虑如何持久化缓存,毕竟这种第三方的实现方案很多。

我们要考虑的是,怎么利用 spring 提供的扩展点实现我们自己的缓存,且在不改原来已有代码的情况下进行扩展。

首先,我们需要提供一个 CacheManager 接口的实现,这个接口告诉 spring 有哪些 cache 实例,spring 会根据 cache 的名字查找 cache 的实例。另外还需要自己实现 Cache 接口,Cache 接口负责实际的缓存逻辑,例如增加键值对、存储、查询和清空等。

利用 Cache 接口,我们可以对接任何第三方的缓存系统,例如 EHCache、OSCache,甚至一些内存数据库例如 memcache 或者 redis 等。下面我举一个简单的例子说明如何做。

import java.util.Collection;

import org.springframework.cache.support.AbstractCacheManager;

public class MyCacheManager extends AbstractCacheManager {
private Collection

<bean id="cacheManager" class="org.springframework.cache.guava.GuavaCacheManager">
    <property name="cacheSpecification" value="concurrencyLevel=4,expireAfterAccess=100s,expireAfterWrite=100s" />
    <property name="cacheNames">
        <list>
            <value>dictTableCachevalue>
        list>
    property>
bean>

spring cache 与redis缓存整合

spring cache,基本能够满足一般应用对缓存的需求,但现实总是很复杂,当你的用户量上去或者性能跟不上,总需要进行扩展,这个时候你或许对其提供的内存缓存不满意了,因为其不支持高可用性,也不具备持久化数据能力,这个时候,你就需要自定义你的缓存方案了,还好,spring 也想到了这一点。

本篇文章采用spring cache与redis进行整合,实现自己想要的缓存。

我们先配置redis:

第一步,要安装redis,这个自行百度,我们主要是配置redis。

增加一个redis配置文件,可以放在跟目录下

[html] view plain copy
redis.host=192.168.0.43
redis.port=6379
redis.pass=2015
redis.maxIdle=50
redis.maxActive=50
redis.maxWait=50
redis.testOnBorrow=true
redis.timeout=1000

还需要在spring的配置文件中去配置redis

[java] view plain copy

  
      
      
      
      
  

  
      
      
      
      
      
  

  
      
  

好了,配置redis完成了。

现在我们来配置spring的cache:

[html] view plain copy

[java] view plain copy
/** 
 *  
 * 公共接口 
 *  
 * @author Administrator 
 * @see [相关类/方法](可选) 
 * @since [产品/模块版本] (可选) 
 */  
@Service("commonService")  
public class CommonServiceImpl implements CommonService {  

    /** 
     * 日志记录器 
     */  
    private static final Logger LOGGER = LoggerFactory.getLogger(CommonServiceImpl.class);  

    @Autowired  
    private DalClient dalClient;  

    /* 
     * @Autowired RedisTemplate redisTemplate; 
     */  

    /** 
     * 根据名称获取自增序列squence的当前值 
     *  
     * @param SequenceName 自增序列名称 
     * @return 自增序列当前值 
     * @see [相关类/方法](可选) 
     * @since [产品/模块版本](可选) 
     */  
    @Override  
    public String getSequenceByName(String SequenceName) {  
        if (StringUtils.isEmpty(SequenceName)) {  
            LOGGER.error("自增序列名称为空,无法返回正常的自增序列值");  
            return null;  
        } else {  
            Map paramMap = new HashMap();  
            paramMap.put("sequenceName", SequenceName);  
            // 查询sequence当前值  
            Map resultMap = dalClient.queryForMap("common.GET_SEQUENCE_BY_NAME", paramMap);  
            if (null != resultMap && !resultMap.isEmpty()) {  
                return String.valueOf(resultMap.get("sequenceValue"));  
            } else {  
                return null;  
            }  
        }  
    }  

    /** 
     * 根据上一级的城市编码 查询 所有下属城市 列表 
     *  
     * @param parentCityCode 
     * @return 
     * @see [相关类/方法](可选) 
     * @since [产品/模块版本](可选) 
     */  
    @Override  
    @Cacheable(value = "commonService.queryCityListByParentCode", key = "new String('commonService.queryCityListByParentCode')+#parentCityCode.toString()", condition = "null != #parentCityCode")  
    public List queryCityListByParentCode(final Integer parentCityCode) {  
        Map paramMap = new HashMap();  
        if (null != parentCityCode) {  
            // 根据所选省份 \ 城市 查询所属城市列表  
            paramMap.put("parentCityCode", parentCityCode);  

            final List cityListResult = dalClient.queryForList("T_CITY.SELECT_BY_PARENTCODE", paramMap,  
                    CityBean.class);  
            return cityListResult;  
        } else {  
            final List provinceListResult = dalClient.queryForList("T_CITY.SELECT_ALL_FIRST_STEP_CITY",  
                    paramMap, CityBean.class);  
            return provinceListResult;  
        }  
    }  

    /** 
     * 根据上一级的行业编码 查询 所有下属所有行业 
     *  
     * @param parentCityCode 
     * @return 
     * @see [相关类/方法](可选) 
     * @since [产品/模块版本](可选) 
     */  
    @Override  
    @Cacheable(value = "commonService.queryIndustryListByParentCode", key = "new String('commonService.queryIndustryListByParentCode')+#parentIndustryCode.toString", condition = "null != #parentIndustryCode")  
    public List queryIndustryListByParentCode(final Integer parentIndustryCode) {  
        Map paramMap = new HashMap();  
        if (null != parentIndustryCode) {  
            paramMap.put("parentIndustryCode", parentIndustryCode);  
            final List industryListResult = dalClient.queryForList("T_INDUSTRY.SELECT_BY_PARENTCODE",  
                    paramMap, IndustryBean.class);  
            return industryListResult;  
        } else {  
            final List industryListResult = dalClient.queryForList(  
                    "T_INDUSTRY.SELECT_ALL_FIRST_STEP_INDUSTRY", paramMap, IndustryBean.class);  
            return industryListResult;  
        }  
    }  

    /** 
     * 根据行业编码查询 行业信息 
     *  
     * @param industryCode 
     * @return 
     * @see [相关类/方法](可选) 
     * @since [产品/模块版本](可选) 
     */  
    @Override  
    @Cacheable(value = "commonService.queryIndustryInfoById", key = "new String('commonService.queryIndustryInfoById')+#industryCode", condition = "(null != #industryCode) and (#industryCode.length() > 0)")  
    public IndustryBean queryIndustryInfoById(final String industryCode) {  
        if (StringUtils.isEmpty(industryCode)) {  
            return null;  
        } else {  
            Map paramMap = new HashMap();  
            paramMap.put("industryCode", industryCode);  
            final IndustryBean industryInfoResult = dalClient.queryForObject("T_INDUSTRY.SELECT_BY_ID", paramMap,  
                    IndustryBean.class);  
            return industryInfoResult;  
        }  
    }  

    /** 
     * 递归删除 元素 因为可能存在重复的 
     *  
     * @param list 列表 
     * @param item 要删除的元素 
     * @see [相关类/方法](可选) 
     * @since [产品/模块版本](可选) 
     */  
    private void deleteListElement(ArrayList list, String item) {  
        if (null != list && !list.isEmpty() && StringUtils.isNotBlank(item)) {  
            if (list.contains(item)) {  
                list.remove(item);  
                if (list.contains(item)) {  
                    deleteListElement(list, item);  
                }  
            }  
        }  
    }  

    /** 
     * 根据行业id查询 行业名称 
     *  
     * @param industryIds 行业Id可能有多个 以分号分隔 
     * @return 行业名称列表 
     * @see [相关类/方法](可选) 
     * @since [产品/模块版本](可选) 
     */  
    @Override  
    @Cacheable(value = "commonService.queryIndustryNameByIds", key = "new String('commonService.queryIndustryNameByIds')+#industryIds", condition = "null != #industryIds and #industryIds.length() > 0")  
    public List queryIndustryNameByIds(final String industryIds) {  
        if (StringUtils.isBlank(industryIds)) {  
            return null;  
        } else {  
            String[] industryIdArr = industryIds.split(";");  
            if (null != industryIdArr && industryIdArr.length > 0) {  
                ArrayList paramList = new ArrayList();  
                paramList.addAll(Arrays.asList(industryIdArr));  
                if (null != paramList && !paramList.isEmpty()) {  
                    Map paramMap = new HashMap();  
                    paramMap.put("industryIdList", paramList);  
                    // 查询行业列表  
                    List queryResultList = dalClient.queryForList("T_INDUSTRY.SELECT_BY_ID_LIST",  
                            paramMap, IndustryBean.class);  
                    // 封装查询结果  
                    List industryNameList = new ArrayList();  
                    if (null != queryResultList && !queryResultList.isEmpty()) {  
                        // 遍历查询列表 将已经存在的编码去掉 剩下的 就是 根據编码查询不出行业的 直接将行业的名字返回  
                        String tempId;  
                        for (IndustryBean industryInfo : queryResultList) {  
                            if (null != industryInfo) {  
                                if (null == industryInfo.getIndustryCode()) {  
                                    continue;  
                                } else {  
                                    tempId = industryInfo.getIndustryCode().toString();  
                                    if (paramList.contains(tempId)) {  
                                        deleteListElement(paramList, tempId);  
                                    }  
                                    if (StringUtils.isNotBlank(industryInfo.getIndustryName())) {  
                                        industryNameList.add(industryInfo.getIndustryName());  
                                    }  
                                }  
                            }  
                        }  
                    }  
                    // 将根据编码查询不出来 的 行业编码 直接返回  
                    industryNameList.addAll(paramList);  
                    return industryNameList;  
                }  
            }  
            return null;  
        }  
    }  

    /** 
     * 根据城市id查询 城市名称 
     *  
     * @param industryIds 行业Id可能有多个 以分号分隔 
     * @return 行业名称列表 
     * @see [相关类/方法](可选) 
     * @since [产品/模块版本](可选) 
     */  
    @Override  
    @Cacheable(value = "commonService.queryCityNameByIds", key = "new String('commonService.queryCityNameByIds')+#cityIds", condition = "null != #cityIds and #cityIds.length() > 0")  
    public List queryCityNameByIds(String cityIds) {  
        if (StringUtils.isBlank(cityIds)) {  
            return null;  
        } else {  
            String replacyedCityIds = cityIds.replace(";", ",");  
            String[] industryIdArr = replacyedCityIds.split(",");  
            if (null != industryIdArr && industryIdArr.length > 0) {  
                ArrayList paramList = new ArrayList();  
                paramList.addAll(Arrays.asList(industryIdArr));  
                if (null != paramList && !paramList.isEmpty()) {  
                    Map paramMap = new HashMap();  
                    paramMap.put("cityIdList", paramList);  
                    // 查询行业列表  
                    List queryResultList = dalClient.queryForList("T_CITY.SELECT_BY_ID_LIST", paramMap,  
                            CityBean.class);  
                    List industryNameList = new ArrayList();  
                    if (null != queryResultList && !queryResultList.isEmpty()) {  
                        // 遍历查询列表 将已经存在的编码去掉 剩下的 就是 根據编码查询不出行业的 直接将行业的名字返回  
                        // 封装查询结果  
                        String tempId;  
                        for (CityBean industryInfo : queryResultList) {  
                            if (null != industryInfo) {  
                                if (null == industryInfo.getCityCode()) {  
                                    continue;  
                                } else {  
                                    tempId = industryInfo.getCityCode().toString();  
                                    if (paramList.contains(tempId)) {  
                                        deleteListElement(paramList, tempId);  
                                    }  
                                    if (StringUtils.isNotBlank(industryInfo.getCityName())) {  
                                        industryNameList.add(industryInfo.getCityName());  
                                    }  
                                }  
                            }  
                        }  
                    }  
                    // 将根据编码查询不出来 的 行业编码 直接返回  
                    industryNameList.addAll(paramList);  
                    return industryNameList;  
                }  
            }  
            return null;  
        }  
    }  

    /** 
     * 查询第一级所有职位 
     *  
     * @return 
     */  
    @Override  
    public List queryFirstJobList() {  
        /* 
         * List redisIndustryListResult = redisTemplate.execute(new RedisCallback>() { 
         * @Override public List doInRedis(RedisConnection connection) { byte[] industryListList = 
         * connection.get((RedisConstants.JOB_FIRST_LIST).getBytes()); if (null != industryListList && 
         * industryListList.length > 0) { return (List) SerializableObjectUtil.unserialize(industryListList); 
         * } else { return null; } } }); if (null != redisIndustryListResult && !redisIndustryListResult.isEmpty()) { 
         * return redisIndustryListResult; } else { 
         */  
        final List queryIndustryListResult = dalClient.queryForList("T_JOB_TYPE.SELECT_FIRST_JOB_CODE",  
                null, JobTypeVo.class);  
        /* 
         * if (null != queryIndustryListResult && !queryIndustryListResult.isEmpty()) { redisTemplate.execute(new 
         * RedisCallback() { 
         * @Override public Boolean doInRedis(RedisConnection connection) { 
         * connection.set((RedisConstants.JOB_FIRST_LIST).getBytes(), 
         * SerializableObjectUtil.serialize(queryIndustryListResult)); return true; } }); } 
         */  
        return queryIndustryListResult;  
        /* } */  
    }  

    /** 
     * 查询 对应级别的职位信息 
     *  
     * @param typeValue 
     * @param jobCode 
     * @return 
     */  
    @Override  
    public List queryJobTypeList(final int typeValue, final int jobCode) {  
        /* 
         * List redisIndustryListResult = redisTemplate.execute(new RedisCallback>() { 
         * @Override public List doInRedis(RedisConnection connection) { byte[] industryListList = 
         * connection.get((RedisConstants.JOB_FIRST_LIST + typeValue + jobCode) .getBytes()); if (null != 
         * industryListList && industryListList.length > 0) { return (List) 
         * SerializableObjectUtil.unserialize(industryListList); } else { return null; } } }); if (null != 
         * redisIndustryListResult && !redisIndustryListResult.isEmpty()) { return redisIndustryListResult; } else { 
         */  
        Map paramMap = new HashMap();  
        paramMap.put("typeValue", typeValue);  
        paramMap.put("jobFirstCode", jobCode);  
        final List queryResult = dalClient.queryForList("T_JOB_TYPE.SELECT_BY_JOB_CODE", paramMap,  
                JobTypeBean.class);  
        /* 
         * if (null != queryResult && !queryResult.isEmpty()) { redisTemplate.execute(new RedisCallback() { 
         * @Override public Boolean doInRedis(RedisConnection connection) { 
         * connection.set((RedisConstants.JOB_FIRST_LIST + typeValue + jobCode).getBytes(), 
         * SerializableObjectUtil.serialize(queryResult)); return true; } }); } 
         */  
        return queryResult;  
        /* } */  
    }  

    /** 
     * 判断学校是否 特殊学校 
     *  
     * @param schoolName 学校名称 
     * @param schoolType 学校分类(1:211 暂无其他) 
     * @return true:是, false:否 
     * @see [相关类/方法](可选) 
     * @since [产品/模块版本](可选) 
     */  
    @Override  
    @Cacheable(value = "commonService.isSpecialSchool", key = "new String('commonService.isSpecialSchool')+#schoolName + #schoolType", condition = "null != #schoolName and null !=#schoolType and #schoolName.length() > 0")  
    public boolean isSpecialSchool(String schoolName, int schoolType) {  
        if (StringUtils.isEmpty(schoolName)) {  
            return false;  
        } else {  
            Map paramMap = new HashMap();  
            paramMap.put("schoolName", schoolName);  
            paramMap.put("schoolType", schoolType);  
            Map resultMap = dalClient.queryForMap("T_MY_SPECIAL_SCHOOL.SELECT_BY_NAME_TYPE", paramMap);  
            if (null != resultMap && !resultMap.isEmpty() && resultMap.containsKey("NUM")) {  
                return (long) resultMap.get("NUM") > 0;  
            } else {  
                return false;  
            }  
        }  
    }  

    /** 
     * 根据城市名称获取 城市所在 省份名称 
     *  
     * @param cityNames 
     * @return 
     * @see [相关类/方法](可选) 
     * @since [产品/模块版本](可选) 
     */  
    @Override  
    @Cacheable(value = "commonService.getProvinceByCity", key = "new String('commonService.getProvinceByCity')+#cityNames", condition = "null != #cityNames and #cityNames.length() > 0")  
    public String getProvinceByCity(final String cityNames) {  
        if (StringUtils.isBlank(cityNames)) {  
            return null;  
        } else {  
            String[] cityArr = cityNames.split("、");  
            Map paramMap = new HashMap();  
            Map resultMap;  
            String provinceName;  
            List provinceLait = new ArrayList();  
            for (String cityName : cityArr) {  
                if (StringUtils.isNotBlank(cityName)) {  
                    paramMap.put("cityName", cityName);  
                    resultMap = dalClient.queryForMap("T_CITY.SELECT_PROVINCE_NAMEBY_CITY_NAME", paramMap);  
                    if (null != resultMap && !resultMap.isEmpty() && resultMap.containsKey("provinceName")) {  
                        provinceName = String.valueOf(resultMap.get("provinceName"));  
                        if (!provinceLait.contains(provinceName)) {  
                            provinceLait.add(provinceName);  
                        }  
                    }  
                }  
            }  
            StringBuffer sb = new StringBuffer(100);  
            if (!provinceLait.isEmpty()) {  
                for (int i = 0; i < provinceLait.size(); i++) {  
                    if (i < provinceLait.size() - 1) {  
                        sb.append(provinceLait.get(i)).append(",");  
                    } else {  
                        sb.append(provinceLait.get(i));  
                    }  
                }  
            }  
            return sb.toString();  
        }  
    }  

已queryCityListByParentCode方法为例:
在这个方法上面有@Cacheable这个注解,这个是spring3.1以后增加的注解缓存标签,它会根据value = “commonService.queryCityListByParentCode”中value的属性值去查找我们配置在spring的xml文件中的name属性去查找,找到对应的配置文件后,该方法会通过我们自定义的缓存实现类去实现对应的逻辑,如果对spring注解的意义不清楚的可以先去了解下spring cache注解的含义。

好了,spring cache与redis的缓存整合就ok了

你可能感兴趣的:(spring)