SaStorage 规范数据读写接口

sa-token-core/src/main/java/cn/dev33/satoken/application/SaApplication.java

@@ -8,6 +8,7 @@ import cn.dev33.satoken.dao.SaTokenDao;
 
 /**
  * Application Model，全局作用域的读取值对象 
+ * <p> 在应用全局范围内: 存值、取值
  * 
  * @author kong
  * @since: 2022-8-17
@@ -33,11 +34,8 @@ public class SaApplication implements SaSetValueInterface {
 		return set(key, value, SaTokenDao.NEVER_EXPIRE);
 	}
 
-	/**
-	 * 删值
-	 * @param key 要删除的key
-	 * @return 对象自身
-	 */
+	/** 删值 */
+	@Override
 	public SaApplication delete(String key) {
 		SaManager.getSaTokenDao().deleteObject(splicingDataKey(key));
 		return this;

sa-token-core/src/main/java/cn/dev33/satoken/context/model/SaStorage.java

@@ -1,37 +1,34 @@
 package cn.dev33.satoken.context.model;
 
+import cn.dev33.satoken.application.SaSetValueInterface;
+
 /**
- * [存储器] 包装类
- * <p> 在 Request作用域里: 存值、取值
+ * Storage Model，请求作用域的读取值对象 
+ * <p> 在一次请求范围内: 存值、取值
+ * 
  * @author kong
  *
  */
-public interface SaStorage {
+public interface SaStorage extends SaSetValueInterface {
 
 	/**
 	 * 获取底层源对象 
 	 * @return see note 
 	 */
 	public Object getSource();
-	
-	/**
-	 * 在 [Request作用域] 里写入一个值 
-	 * @param key 键 
-	 * @param value 值
-	 */
-	public void set(String key, Object value);
-	
-	/**
-	 * 在 [Request作用域] 里获取一个值 
-	 * @param key 键 
-	 * @return 值 
-	 */
+
+	// ---- 实现接口存取值方法 
+
+	/** 取值 */
+	@Override
 	public Object get(String key);
 
-	/**
-	 * 在 [Request作用域] 里删除一个值 
-	 * @param key 键 
-	 */
-	public void delete(String key);
+	/** 写值 */
+	@Override
+	public SaStorage set(String key, Object value);
+	
+	/** 删值 */
+	@Override
+	public SaStorage delete(String key);
 
 }

sa-token-core/src/main/java/cn/dev33/satoken/session/SaSession.java

@@ -14,7 +14,8 @@ import cn.dev33.satoken.dao.SaTokenDao;
 import cn.dev33.satoken.util.SaFoxUtil;
 
 /**
- * Session Model
+ * Session Model，会话作用域的读取值对象 
+ * <p> 在一次会话范围内: 存值、取值
  *
  * @author kong
  *