mirror of
https://github.com/LamGC/ContentGrabbingJi.git
synced 2025-04-30 06:37:36 +00:00
[Change][Fix] 调整 CollectionCacheStore 部分命名, 调整泛型声明;
[Change] CollectionCacheStore 调整命名, 由 value/values 更名为 element/elements; [Fix] ListCacheStore, SetCacheStore 修复因泛型错误导致的类型错误问题;
This commit is contained in:
parent
74904cdfdb
commit
6502385641
@ -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);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 检查指定缓存项是否为空.
|
* 检查指定缓存项是否为空.
|
||||||
|
@ -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);
|
||||||
}
|
}
|
||||||
|
@ -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> {
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user