docs(core): 更新 XXL-CACHE 官方文档

- 新增缓存对象定义、缓存写入、查询和删除的示例代码
- 更新 XxlCacheHelper.getCache 方法签名，增加生存时间参数
- 移除 gson依赖，精简 Core 体积- 更新项目版本号至 1.2.0

Author: xuxueli

doc/XXL-CACHE官方文档.md

@@ -129,16 +129,28 @@ public XxlCacheFactory xxlCacheFactory() {
 示例代码：
 ```
 String category = "user";
+long survivalTime = 60*1000;
 String key = "user03";
 
-// 缓存写入 
-XxlCacheHelper.getCache(category).set(key, value);
-
-// 缓存查询
-String value = XxlCacheHelper.getCache(category).get(key);
-
-// 缓存删除
-XxlCacheHelper.getCache(category).del(key);
+/**
+* 1、定义缓存对象，并指定 “缓存category + 过期时间”
+*/
+XxlCacheHelper.XxlCache userCache = XxlCacheHelper.getCache(category, survivalTime);
+
+/**
+* 2、缓存写：按照 L1 -> L2 顺序依次写缓存，同时借助内部广播机制更新全局L1节点缓存；
+*/
+userCache.set(key, value);
+
+/**
+* 3、缓存读：按照 L1 -> L2 顺序依次读取缓存，如果L1存在缓存则返回，否则读取L2缓存并同步L1；
+*/
+userCache.get(key);
+
+/**
+* 4、缓存删：按照 L1 -> L2 顺序依次删缓存，同时借助内部广播机制更新全局L1节点缓存；
+*/
+userCache.del(key);
 ... 
 
 ```
@@ -197,7 +209,8 @@ XXL-CACHE 定位多级缓存框架，高效组合本地缓存和分布式缓存(
 - 7、【优化】核心依赖推送maven中央仓库, 方便用户接入和使用;
 
 ### v1.2.0 Release Notes[2025-02-07]
-- 1、【增强】L2缓存序列化能力强化，支持自定义扩展序列化方案；
+- 1、【重构】L2缓存序列化组件抽象，支持自定义扩展序列化方案 （Serializer）；
+- 2、【优化】移除容易依赖，精简Core体积；
 
 ### v1.2.1 Release Notes[迭代中]
 - 1、[迭代中]缓存监控：L1、L2缓存命中率，L1缓存容量、内容占用等；

pom.xml

@@ -3,7 +3,7 @@
 	<modelVersion>4.0.0</modelVersion>
 	<groupId>com.xuxueli</groupId>
 	<artifactId>xxl-cache</artifactId>
-	<version>1.1.1-SNAPSHOT</version>
+	<version>1.2.0</version>
 	<packaging>pom</packaging>
 
 	<name>${project.artifactId}</name>
@@ -36,8 +36,6 @@
 		<jedis.version>5.2.0</jedis.version>
 		<!-- caffeine -->
 		<caffeine.version>2.9.3</caffeine.version>
-		<!-- gson -->
-		<gson.version>2.12.1</gson.version>
 
 		<!-- spring-boot -->
 		<spring-boot.version>2.7.18</spring-boot.version>

xxl-cache-core/pom.xml

@@ -6,10 +6,9 @@
     <parent>
         <groupId>com.xuxueli</groupId>
         <artifactId>xxl-cache</artifactId>
-        <version>1.1.1-SNAPSHOT</version>
+        <version>1.2.0</version>
     </parent>
     <artifactId>xxl-cache-core</artifactId>
-    <version>1.1.1-SNAPSHOT</version>
     <packaging>jar</packaging>
 
     <dependencies>
@@ -41,11 +40,11 @@
         </dependency>
 
         <!-- gson -->
-        <dependency>
+        <!--<dependency>
             <groupId>com.google.code.gson</groupId>
             <artifactId>gson</artifactId>
             <version>${gson.version}</version>
-        </dependency>
+        </dependency>-->
 
     </dependencies>
 

xxl-cache-core/src/main/java/com/xxl/cache/core/XxlCacheHelper.java

@@ -18,7 +18,8 @@ public class XxlCacheHelper {
     /**
      * get cache by category
      *
-     * @param category
+     * @param category      cache category
+     * @param survivalTime  survival time length, milliseconds. Expires after the specified time from the current
      * @return
      */
     public static XxlCache getCache(String category, long survivalTime) {

xxl-cache-samples/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>com.xuxueli</groupId>
         <artifactId>xxl-cache</artifactId>
-        <version>1.1.1-SNAPSHOT</version>
+        <version>1.2.0</version>
     </parent>
     <artifactId>xxl-cache-samples</artifactId>
     <packaging>pom</packaging>

xxl-cache-samples/xxl-cache-sample-frameless/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>com.xuxueli</groupId>
         <artifactId>xxl-cache-samples</artifactId>
-        <version>1.1.1-SNAPSHOT</version>
+        <version>1.2.0</version>
     </parent>
     <artifactId>xxl-cache-sample-frameless</artifactId>
     <packaging>jar</packaging>

xxl-cache-samples/xxl-cache-sample-springboot/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>com.xuxueli</groupId>
         <artifactId>xxl-cache-samples</artifactId>
-        <version>1.1.1-SNAPSHOT</version>
+        <version>1.2.0</version>
     </parent>
     <artifactId>xxl-cache-sample-springboot</artifactId>
     <packaging>jar</packaging>