狗堆缓存

狗堆

Dogpile 由两个子系统组成，一个子系统构建在另一个子系统之上。

dogpile提供了“dogpile 锁”的概念，这是一种控制结构，允许选择单个执行线程作为某些资源的“创建者”，同时允许其他执行线程将该资源的先前版本引用为该资源的“创建者”。创作收益；如果没有以前的版本，那么这些线程将阻塞，直到该对象可用。

dogpile.cache是一个缓存 API，它为任何类型的缓存后端提供通用接口，并且还提供 API 挂钩，将这些缓存后端与dogpile的锁定机制集成在一起。

总的来说，dogpile.cache 旨在替代 Beaker 缓存系统，其内部结构由同一作者编写。 Beaker 中所有“有效”的想法都以更高效、更简洁的方式在dogpile.cache 中重新实现，所有的废品（Beaker 的内部结构于 2005 年首次编写）都被扔进了垃圾堆。

文档

请参阅dogpile.cache 文档中的dogpile.cache 的完整文档。以下部分提供了dogpile包的简要概要。

特征

• 一个简洁的 API，鼓励预先配置预定义的“区域”，每个区域定义一组缓存特性，包括存储后端、配置选项和默认过期时间。
• 提供了标准的获取/设置/删除 API 以及函数装饰器 API。
• 密钥生成的机制是完全可定制的。函数装饰器 API 具有可插入的“密钥生成器”，可自定义如何使缓存密钥与函数调用相对应，并且可选的“密钥修饰器”功能可根据需要提供可插入的密钥修饰（例如编码、SHA-1 哈希）对于每个地区。
• Dogpile Lock 最初是作为 Beaker 缓存系统背后的核心引擎开发的，在这里得到了极大的简化、改进和更好的测试。 Beaker 架构固有的一些关键性能问题，特别是经常从缓存中“重复获取”值的问题，已得到修复。
• 后端实现自己版本的“分布式”锁，其中“分布”与后端的存储系统相匹配。例如，memcached 后端允许所有客户端使用 memcached 本身协调值的创建。 dbm 文件后端与 dbm 文件一起使用锁定文件。新的后端，例如基于 Redis 的后端，可以提供适合存储引擎的自己的锁定机制。
• 编写新的后端或对现有后端进行黑客攻击旨在成为例行公事 - 所需要的只是基本的获取/设置/删除方法。针对后端定制的分布式锁是一个可选的添加，否则dogpile 使用常规线程互斥体。新的后端可以直接注册到dogpile.cache，或者通过setuptools入口点提供。
• 包含的后端包括三个 memcached 后端（python-memcached、pylibmc、bmemcached）、一个 Redis 后端、一个基于 Python 的 anydbm 的后端和一个普通字典后端。
• 第三方插件的空间，包括为 Mako 模板提供dogpile.cache 引擎的插件。

SQLAlchemy 项目

Dogpile 是 SQLAlchemy 项目的一部分，并遵循与核心项目相同的标准和约定。

开发/错误报告/拉取请求

请参阅 SQLAlchemy 社区指南，了解编码和参与此项目的指南。

行为守则

最重要的是，SQLAlchemy 非常强调用户和开发人员之间礼貌、深思熟虑和建设性的沟通。请参阅行为准则中我们当前的行为准则。

执照

Dogpile 是根据 MIT 许可证分发的。