跳到主要内容

cache.abstract_cache_base

AbstractCache

class AbstractCache(Protocol)

该协议定义了缓存操作的基本接口。 实现类应该为这些方法提供具体实现以处理缓存机制。

获取

def get(key: str, default: Optional[Any] = None) -> Optional[Any]

从缓存中检索一个项目。

参数:

  • key str - 用于标识缓存中项目的键。
  • default 可选 - 如果未找到键,则返回的默认值。默认为None。

返回:

如果找到与键相关联的值,则返回该值,否则返回默认值。

设置

def set(key: str, value: Any) -> None

在缓存中设置一个项目。

参数:

  • key str - 用于存储项的键。
  • value - 要存储在缓存中的值。

关闭

def close() -> None

关闭缓存。执行任何必要的清理工作,例如关闭网络连接或释放资源。

__enter__

def __enter__() -> Self

进入与此对象相关的运行时上下文。

with语句会将此方法的返回值绑定到语句的as子句中指定的目标(如果有的话)。

__exit__

def __exit__(exc_type: Optional[Type[BaseException]],
exc_value: Optional[BaseException],
traceback: Optional[TracebackType]) -> None

退出运行时上下文并关闭缓存。

参数:

  • exc_type - 如果在上下文中引发了异常,那么这是异常的类型。
  • exc_value - 如果在上下文中引发了异常,则为异常值。
  • traceback - 如果在上下文中引发了异常,则为回溯信息。