SpringBoot系列——cache快取

　　前言

　　日常開發中，快取是解決資料庫壓力的一種方案，通常用於頻繁查詢的資料，例如新聞中的熱點新聞，本文記錄springboot中使用cache快取。

　　官方文件介紹：https://docs.spring.io/spring-boot/docs/2.1.0.RELEASE/reference/htmlsingle/#boot-features-caching-provider-generic

　　工程結構

　　程式碼編寫

　　pom引入依賴，引入cache快取，資料庫使用mysql，ORM框架用jpa

        <!--新增springdata-cache依賴 -->

        <dependency>

            <groupId>org.springframework.boot</groupId>

            <artifactId>spring-boot-starter-cache</artifactId>

        </dependency>

        <!-- 引入ehcache支援 -->

        <dependency>

            <groupId>net.sf.ehcache</groupId>

            <artifactId>ehcache</artifactId>

        </dependency>

        <!--新增springdata-jpa依賴 -->

        <dependency>

            <groupId>org.springframework.boot</groupId>

            <artifactId>spring-boot-starter-data-jpa</artifactId>

        </dependency>

        <!--新增MySQL驅動依賴 -->

        <dependency>

            <groupId>mysql</groupId>

            <artifactId>mysql-connector-java</artifactId>

        </dependency>

　　配置檔案

server.port=10010

spring.application.name=springboot-cache

spring.cache.type=ehcache

spring.cache.ehcache.config=classpath:/ehcache.xml

　　ehcache.xml

<?xml version="1.0" encoding="UTF-8"?>

<ehcache xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://ehcache.org/ehcache.xsd" updateCheck="false">

    <!-- 磁碟快取位置 -->

    <diskStore path="java.io.tmpdir"/>

    <!-- maxEntriesLocalHeap:堆記憶體中最大快取物件數，0沒有限制 -->

    <!-- maxElementsInMemory： 在記憶體中快取的element的最大數目。-->

    <!-- eternal:elements是否永久有效，如果為true，timeouts將被忽略，element將永不過期 -->

    <!-- timeToIdleSeconds:發呆秒數，發呆期間未訪問快取立即過期，當eternal為false時，這個屬性才有效，0為不限制 -->

    <!-- timeToLiveSeconds:總存活秒數，當eternal為false時，這個屬性才有效，0為不限制 -->

    <!-- overflowToDisk： 如果記憶體中資料超過記憶體限制，是否要快取到磁碟上 -->

    <!-- statistics：是否收集統計資訊。如果需要監控快取使用情況，應該開啟這個選項。預設為關閉（統計會影響效能）。設定statistics="true"開啟統計 -->

    <!--

        預設快取

        無過期時間，但 600 秒內無人訪問快取立即過期

    -->

    <defaultCache

            maxElementsInMemory="1000"

            eternal="false"

            timeToIdleSeconds="600"

            timeToLiveSeconds="0"

            overflowToDisk="false">

    </defaultCache>

    <!--

        xx業務快取

        在有效的 120 秒內，如果連續 60 秒未訪問快取，則快取失效。

        就算有訪問，也只會存活 120 秒。

    -->

    <cache name="myCache"

           maxElementsInMemory="1000"

           eternal="false"

           timeToIdleSeconds="120"

           timeToLiveSeconds="0"

           overflowToDisk="false">

    </cache>

</ehcache>

　　先寫一個套tb_user表的CRUD程式碼

@RestController

@RequestMapping("/tbUser/")

public class TbUserController {

    @Autowired

    private TbUserService tbUserService;

    //方便測試暫時改成GetMapping

    @GetMapping("list")

//    @PostMapping("list")

    public List<TbUser> list(TbUser entityVo) {

        return tbUserService.list(entityVo);

    }

    @GetMapping("get/{id}")

    public TbUser get(@PathVariable("id")Integer id) {

        return tbUserService.get(id);

    }

    //方便測試暫時改成GetMapping

    @GetMapping("save")

//    @PostMapping("save")

    public TbUser save(TbUser entityVo) {

        return tbUserService.save(entityVo);

    }

    @GetMapping("delete/{id}")

    public Integer delete( @PathVariable("id") Integer id) {

        return tbUserService.delete(id);

    }

}

　　opjo實體類要實現序列化

@Entity

@Table(name = "tb_user")

@Data

public class TbUser implements Serializable {

    @Id

    @GeneratedValue(strategy= GenerationType.IDENTITY)

    private Integer id;//表id

    private String username;//使用者名稱

    private String password;//密碼

    private Date created;//建立時間

    private Integer descriptionId;//關聯詳情id

}

　　serviceImpl中，使用註解來開啟快取

@Service

@Transactional

@CacheConfig(cacheNames = {"myCache"})

public class TbUserServiceImpl implements TbUserService{

    @PersistenceContext

    private EntityManager em;

    @Autowired

    private TbUserRepository tbUserRepository;

    //@Cacheable快取資料：key為userList，value為返回值List<TbUser>

    @Cacheable(key = "'userList'")

    @Override

    public List<TbUser> list(TbUser entityVo) {

        System.out.println("獲取list使用者列表快取資料,"+new Date());

        return tbUserRepository.findAll(Example.of(entityVo));

    }

    //@Cacheable快取資料：key為引數id，value為返回值TbUser

    @Cacheable(key = "#id")

    @Override

    public TbUser get(Integer id) {

        System.out.println("獲取資料快取，key:"+id);

        Optional<TbUser> optionalE = tbUserRepository.findById(id);

        if (!optionalE.isPresent()) {

            throw new RuntimeException("ID不存在！");

        }

        return optionalE.get();

    }

    //@CachePut快取新增的或更新的資料到快取，其中快取的名稱為people，資料的key是person的id

    @CachePut(key = "#entityVo.id")

    // @CacheEvict從快取中刪除key為引數userList的資料

    @CacheEvict(key = "'userList'")

    @Override

    public TbUser save(TbUser entityVo) {

        System.out.println("新增/更新快取，key:"+entityVo.getId());

        //entityVo傳啥存啥，會全部更新

        return tbUserRepository.save(entityVo);

    }

    //清空所有快取

    @CacheEvict(allEntries=true)

    @Override

    public Integer delete(Integer id) {

        System.out.println("清空所有快取");

        tbUserRepository.deleteById(id);

        return id;

    }

}

　　效果演示

　　http://localhost:10010/tbUser/save?id=2&username=李四

　　呼叫save方法，key為2，value為當前tbUser物件的資料被快取下來

　　http://localhost:10010/tbUser/get/2

　　當我們呼叫get方法時，直接獲取快取資料，控制檯啥也不列印，連serviceImpl的get方法都不進去（可以打斷點除錯）

　　http://localhost:10010/tbUser/save?id=2&username=王五

　　當我們再次呼叫save方法更新username時，快取資料也被更新

　　http://localhost:10010/tbUser/get/2

　　再次呼叫get介面，直接返回快取資料，後臺也是方法都不進去，啥也不列印

　　http://localhost:10010/tbUser/delete/2

　　呼叫delete介面，刪除資料，同時刪除快取

　　再次呼叫get介面，發現快取資料被清除，查詢資料庫

　　http://localhost:10010/tbUser/list

　　首次呼叫list介面，key為userList的，value為使用者集合資料被快取下來，再次呼叫直接返回快取資料

　　當呼叫save介面，資料更新，刪除key為userList的快取，再次呼叫list時，重新查庫並設定快取

　　我們配置了快取發呆時間，當120秒內未使用該快取，立即過期，一直用就會一直存在

　　我們先同時訪問兩個介面list、get，list介面2分鐘後再次訪問，get介面不能超過2分鐘是不是訪問一下，結果如預期

　　PS：原先使用了這個jar包，有報錯

    <dependency>

      <groupId>org.ehcache</groupId>

      <artifactId>ehcache</artifactId>

      <version>3.8.1</version>

    </dependency>

　　後面改成用上面“程式碼編寫”裡pom中引的jnet.sf.ehcache下面的ar

　　後記

　　快取除了能緩解資料庫壓力，還能做使用者登入狀態控制，例如：使用者登入成功後cookie中儲存頒發的token令牌設定永不過期，快取存活時間也設定永不過期，發呆時間設定1天，這樣只有使用者在1天內有訪問快取介面，那他就可以一直保留登入狀態，直至有其他業務將token或者快取清掉。

　　springboot使用cache快取暫時先記錄到這，後續有空再進行補充。

　　程式碼開源

　　程式碼已經開源、託管到我的GitHub、碼雲：

　　GitHub：https://github.com/huanzi-qch/springBoot

　　碼雲：https://gitee.com/huanzi-qch/springBoot

SpringBoot系列——cache快取