linux使用mailx傳送郵件
1. 功能說明
@Cacheable 註解在方法上，表示該方法的返回結果是可以快取的。也就是說，該方法的返回結果會放在快取中，以便於以後使用相同的引數呼叫該方法時，會返回快取中的值，而不會實際執行該方法。
注意，這裡強調了一點：引數相同。這一點應該是很容易理解的，因為快取不關心方法的執行邏輯，它能確定的是：對於同一個方法，如果引數相同，那麼返回結果也是相同的。但是如果引數不同，快取只能假設結果是不同的，所以對於同一個方法，你的程式執行過程中，使用了多少種引數組合呼叫過該方法，理論上就會生成多少個快取的 key（當然，這些組合的引數指的是與生成 key 相關的）。下面來了解一下 @Cacheable 的一些引數：
2. cacheNames & value
@Cacheable 提供兩個引數來指定快取名：value、cacheNames，二者選其一即可。這是 @Cacheable 最簡單的用法示例：
@Override
@Cacheable("menu")
public Menu findById(String id) {
Menu menu = this.getById(id);
if (menu != null){
System.out.println("menu.name = " + menu.getName());
}
return menu;}
在這個例子中，findById 方法與一個名為 menu 的快取關聯起來了。呼叫該方法時，會檢查 menu 快取，如果快取中有結果，就不會去執行方法了。
3. 關聯多個快取名
其實，按照官方文件，@Cacheable 支援同一個方法關聯多個快取。這種情況下，當執行方法之前，這些關聯的每一個快取都會被檢查，而且只要至少其中一個快取命中了，那麼這個快取中的值就會被返回。示例：
@Override
@Cacheable({"menu", "menuById"})
public Menu findById(String id) {
Menu menu = this.getById(id);
if (menu != null){
System.out.println("menu.name = " + menu.getName());
}
return menu;
}
---------
@GetMapping("/findById/{id}")
public Menu findById(@PathVariable("id")String id){
Menu menu0 = menuService.findById("fe278df654adf23cf6687f64d1549c0a");
Menu menu2 = menuService.findById("fb6106721f289ebf0969565fa8361c75");
return menu0;
}
為了直觀起見，直接將 id 引數寫到程式碼裡。現在，我們來測試一下，看一下結果：
4. key & keyGenerator
一個快取名對應一個被註解的方法，但是一個方法可能傳入不同的引數，那麼結果也就會不同，這應該如何區分呢？這就需要用到 key 。在 spring 中，key 的生成有兩種方式：顯式指定和使用 keyGenerator 自動生成。
4.1. KeyGenerator 自動生成
當我們在宣告 @Cacheable 時不指定 key 引數，則該快取名下的所有 key 會使用 KeyGenerator 根據引數 自動生成。spring 有一個預設的 SimpleKeyGenerator ，在 spring boot 自動化配置中，這個會被預設注入。生成規則如下：
a. 如果該快取方法沒有引數，返回 SimpleKey.EMPTY ；
b. 如果該快取方法有一個引數，返回該引數的例項 ；
c. 如果該快取方法有多個引數，返回一個包含所有引數的 SimpleKey ；
預設的 key 生成器要求引數具有有效的 hashCode() 和 equals() 方法實現。另外，keyGenerator 也支援自定義， 並通過 keyGenerator 來指定。關於 KeyGenerator 這裡不做詳細介紹，有興趣的話可以去看看原始碼，其實就是使用 hashCode 進行加乘運算。跟 String 和 ArrayList 的 hash 計算類似。
4.2. 顯式指定 key
相較於使用 KeyGenerator 生成，spring 官方更推薦顯式指定 key 的方式，即指定 @Cacheable 的 key 引數。
即便是顯式指定，但是 key 的值還是需要根據引數的不同來生成，那麼如何實現動態拼接呢？SpEL（Spring Expression Language，Spring 表示式語言） 能做到這一點。下面是一些使用 SpEL 生成 key 的例子。
@Override
@Cacheable(value = {"menuById"}, key = "#id")
public Menu findById(String id) {
Menu menu = this.getById(id);
if (menu != null){
System.out.println("menu.name = " + menu.getName());
}
return menu;
}
@Override
@Cacheable(value = {"menuById"}, key = "'id-' + #menu.id")
public Menu findById(Menu menu) {
return menu;
}
@Override
@Cacheable(value = {"menuById"}, key = "'hash' + #menu.hashCode()")
public Menu findByHash(Menu menu) {
return menu;
}
結果：
顯示指定的好處在於，直觀明瞭，看到程式碼就能想象生成的 key 是什麼樣。而且 SpEL 也很強大。關於 SpEL 的詳細用法，這裡不詳述，可以參考官方文件：
https://docs.spring.io/spring/docs/current/spring-framework-reference/core.html#expressions
注意：官方說 key 和 keyGenerator 引數是互斥的，同時指定兩個會導致異常。
5. cacheManager & cacheResolver
CacheManager，快取管理器是用來管理（檢索）一類快取的。通常來講，快取管理器是與快取元件型別相關聯的。我們知道，spring 快取抽象的目的是為使用不同快取元件型別提供統一的訪問介面，以向開發者遮蔽各種快取元件的差異性。那麼 CacheManager 就是承擔了這種遮蔽的功能。spring 為其支援的每一種快取的元件型別提供了一個預設的 manager，如：RedisCacheManager 管理 redis 相關的快取的檢索、EhCacheManager 管理 ehCache 相關的緩等。
CacheResolver，快取解析器是用來管理快取管理器的，CacheResolver 保持一個 cacheManager 的引用，並通過它來檢索快取。CacheResolver 與 CacheManager 的關係有點類似於 KeyGenerator 跟 key。spring 預設提供了一個 SimpleCacheResolver，開發者可以自定義並通過 @Bean 來注入自定義的解析器，以實現更靈活的檢索。
大多數情況下，我們的系統只會配置一種快取，所以我們並不需要顯式指定 cacheManager 或者 cacheResolver。但是 spring 允許我們的系統同時配置多種快取元件，這種情況下，我們需要指定。指定的方式是使用 @Cacheable 的 cacheManager 或者 cacheResolver 引數。
注意：按照官方文件，cacheManager 和 cacheResolver 是互斥引數，同時指定兩個可能會導致異常。
6. sync
是否同步，true/false。在一個多執行緒的環境中，某些操作可能被相同的引數併發地呼叫，這樣同一個 value 值可能被多次計算（或多次訪問 db），這樣就達不到快取的目的。針對這些可能高併發的操作，我們可以使用 sync 引數來告訴底層的快取提供者將快取的入口鎖住，這樣就只能有一個執行緒計算操作的結果值，而其它執行緒需要等待，這樣就避免了 n-1 次資料庫訪問。
sync = true 可以有效的避免快取擊穿的問題。
7. condition
呼叫前判斷，快取的條件。有時候，我們可能並不想對一個方法的所有呼叫情況進行快取，我們可能想要根據呼叫方法時候的某些引數值，來確定是否需要將結果進行快取或者從快取中取結果。比如當我根據年齡查詢使用者的時候，我只想要快取年齡大於 35 的查詢結果。那麼 condition 能實現這種效果。
condition 接收一個結果為 true 或 false 的表示式，表示式同樣支援 SpEL 。如果表示式結果為 true，則呼叫方法時會執行正常的快取邏輯（查快取-有就返回-沒有就執行方法-方法返回不空就新增快取）；否則，呼叫方法時就好像該方法沒有宣告快取一樣（即無論傳入了什麼引數或者快取中有些什麼值，都會執行方法，並且結果不放入快取）。下面舉個例子：
我們看一下資料庫，以這兩條資料為例：
我們首先定義一個帶條件的快取方法：
@Override
@Cacheable(value = {"menuById"}, key = "#id", condition = "#conditionValue > 1")
public Menu findById(String id, Integer conditionValue) {
Menu menu = this.getById(id);
if (menu != null){
System.out.println("menu.name = " + menu.getName());
}
return menu;
}
然後分兩種情況呼叫（為了直觀可見，直接將 id 寫在程式碼中）：
@GetMapping("/findById/{id}")
public Menu findById(@PathVariable("id")String id){
Menu menu0 = menuService.findById("fe278df654adf23cf6687f64d1549c0a", 0);
Menu menu2 = menuService.findById("fb6106721f289ebf0969565fa8361c75", 2);
return menu0;
}
然後我們請求一下，看看快取中的結果和控制檯列印：
可以看到，兩次請求都執行方法（因為原來快取中都沒有資料），但是隻有“微服務測試2”快取了。這說明，只有滿足 condition 條件的呼叫，結果才會被快取。接下來我們再請求一遍，看下結果和列印：
可以看到，“微服務測試2”由於已經有了快取，所以沒有再執行方法體。而“微服務測試0”又一次執行了。
8. unless
執行後判斷，不快取的條件。unless 接收一個結果為 true 或 false 的表示式，表示式支援 SpEL。當結果為 true 時，不快取。舉個例子：
我們先清除 redis 中的資料。然後看看 mysql 中的資料：
然後編寫一個快取方法（在該方法中，result代表方法的返回值。關於）：
@Override
@Cacheable(value = {"menuById"}, key = "#id", unless = "#result.type == 'folder'")
public Menu findById(String id) {
Menu menu = this.getById(id);
if (menu != null){
System.out.println("menu.name = " + menu.getName());
}
return menu;
}
然後呼叫該方法：
@GetMapping("/findById/{id}")
public Menu findById(@PathVariable("id")String id){
Menu menu0 = menuService.findById("fe278df654adf23cf6687f64d1549c0a");
Menu menu2 = menuService.findById("fb6106721f289ebf0969565fa8361c75");
return menu0;
}
看看快取結果和列印：
可以看到，兩次都執行了方法體（其實，unless 條件就是在方法執行完畢後呼叫，所以它不會影響方法的執行），但是結果只有 menu.type = 'page' 的快取了，說明 unless 引數生效了。
9. condition VS unless ？
既然 condition 和 unless 都能決定是否進行快取，那麼同時指定這兩個引數並且結果相沖突的時候，會怎麼樣呢？我們來試一試。
首先清除 redis 資料，然後在快取方法上加上 condition="true"，如：
@Override
@Cacheable(value = {"menuById"}, key = "#id", condition = "true", unless = "#result.type == 'folder'")
public Menu findById(String id) {
Menu menu = this.getById(id);
if (menu != null){
System.out.println("menu.name = " + menu.getName());
}
return menu;
}
其它程式碼不變，我們來看一下快取結果和列印：
可以看到，雖然兩次呼叫都執行了，但是，type='folder' 的還是被排除了。說明這種情況下，unless 比 condition 優先順序要高。接下來我們把 condition="false"，再來試試，結果：
可以看到，兩次呼叫的結果都沒有快取。說明在這種情況下，condition 比 unless 的優先順序高。總結起來就是：
condition 不指定相當於 true，unless 不指定相當於 false
當 condition = false，一定不會快取；
當 condition = true，且 unless = true，不快取；
當 condition = true，且 unless = false，不快取；