[Change][Fix] 调整 CollectionCacheStore 部分命名, 调整泛型声明;

[Change] CollectionCacheStore 调整命名, 由 value/values 更名为 element/elements;
[Fix] ListCacheStore, SetCacheStore 修复因泛型错误导致的类型错误问题;
This commit is contained in:
LamGC 2020-09-03 15:40:10 +08:00
parent 74904cdfdb
commit 6502385641
Signed by: LamGC
GPG Key ID: 6C5AE2A913941E1D
3 changed files with 11 additions and 11 deletions

View File

@ -30,30 +30,30 @@ public interface CollectionCacheStore<E> extends CacheStore<Collection<E>> {
* 为缓存项添加一个元素. * 为缓存项添加一个元素.
* 当缓存项不存在时, 将会创建一个新的缓存项. * 当缓存项不存在时, 将会创建一个新的缓存项.
* @param key 缓存项键名. * @param key 缓存项键名.
* @param value 待添加的元素. * @param element 待添加的元素.
* @return 如果成功返回 true. * @return 如果成功返回 true.
* @throws NullPointerException key value null 时抛出; 本方法不允许存储 null , 因为 null 代表"没有/不存在". * @throws NullPointerException key element null 时抛出; 本方法不允许存储 null , 因为 null 代表"没有/不存在".
*/ */
boolean addElement(String key, E value); boolean addElement(String key, E element);
/** /**
* 为缓存项添加一组元素. * 为缓存项添加一组元素.
* 当缓存项不存在时, 将会创建一个新的缓存项. * 当缓存项不存在时, 将会创建一个新的缓存项.
* @param key 缓存项键名. * @param key 缓存项键名.
* @param values 欲添加的元素集合. * @param elements 欲添加的元素集合.
* @return 如果成功添加, 返回 true, 如果无法添加(例如缓存项 List/Set 长度限制), 返回 false. * @return 如果成功添加, 返回 true, 如果无法添加(例如缓存项 List/Set 长度限制), 返回 false.
* @throws NullPointerException key value null 时抛出; 本方法不允许存储 null , 因为 null 代表"没有/不存在". * @throws NullPointerException key value null 时抛出; 本方法不允许存储 null , 因为 null 代表"没有/不存在".
*/ */
boolean addElements(String key, Collection<E> values); boolean addElements(String key, Collection<E> elements);
/** /**
* 检查指定元素是否包含在指定缓存项中. * 检查指定元素是否包含在指定缓存项中.
* @param key 待检查的缓存项键名. * @param key 待检查的缓存项键名.
* @param value 待查找的缓存值. * @param element 待查找的缓存值.
* @return 如果存在, 返回 true, 如果元素不存在, 或缓存项不存在, 返回 false. * @return 如果存在, 返回 true, 如果元素不存在, 或缓存项不存在, 返回 false.
* @throws NullPointerException key value null 时抛出; 本方法不允许存储 null , 因为 null 代表"没有/不存在". * @throws NullPointerException key element null 时抛出; 本方法不允许存储 null , 因为 null 代表"没有/不存在".
*/ */
boolean containsElement(String key, E value); boolean containsElement(String key, E element);
/** /**
* 检查指定缓存项是否为空. * 检查指定缓存项是否为空.

View File

@ -25,7 +25,7 @@ import java.util.List;
* @param <E> 值类型. * @param <E> 值类型.
* @author LamGC * @author LamGC
*/ */
public interface ListCacheStore<E> extends CollectionCacheStore<List<E>> { public interface ListCacheStore<E> extends CollectionCacheStore<E> {
/** /**
* 获取缓存项中的指定元素. * 获取缓存项中的指定元素.
@ -68,5 +68,5 @@ public interface ListCacheStore<E> extends CollectionCacheStore<List<E>> {
* @return 如果元素存在且删除成功, 返回 true. * @return 如果元素存在且删除成功, 返回 true.
*/ */
@Override @Override
boolean removeElement(String key, List<E> element); boolean removeElement(String key, E element);
} }

View File

@ -24,7 +24,7 @@ import java.util.Set;
* @param <E> 值类型. * @param <E> 值类型.
* @author LamGC * @author LamGC
*/ */
public interface SetCacheStore<E> extends CollectionCacheStore<Set<E>> { public interface SetCacheStore<E> extends CollectionCacheStore<E> {