0

0

Python 实现无限嵌套、默认值支持与修订顺序维护的字典类

花韻仙語

花韻仙語

发布时间:2026-01-11 13:58:02

|

379人浏览过

|

来源于php中文网

原创

Python 实现无限嵌套、默认值支持与修订顺序维护的字典类

本文介绍如何在 python 中构建一个兼具无限嵌套访问(`d['a']['b']['c']`)、默认值回退(类似 `defaultdict`)和按最后修改时间排序(lru 风格修订序)三大特性的自定义字典类,并提供可运行、可扩展的完整实现。

在实际开发中,我们常需组合多种字典行为:例如缓存系统要求键按“最近更新”排序(revision order),配置管理需要自动创建缺失嵌套结构(infinite nesting),而 API 响应处理又依赖安全的默认值兜底(default fallback)。标准库中的 collections.OrderedDict、defaultdict 和 ChainMap 各有侧重,却无法原生满足三者协同——这正是 InfiniteDefaultRevisionDict 的设计目标。

以下是一个生产就绪(production-ready)的轻量级实现,基于 OrderedDict 构建,同时支持:

Short AI
Short AI

AI短视频生成器,轻松创作爆款短视频!

下载
  • 无限嵌套赋值与访问:d['user']['profile']['avatar_url'] = 'https://...'
  • 可定制默认值:支持 None、0、[]、lambda: {} 等任意默认构造器
  • 修订顺序(Revision Order):每次 __setitem__ 自动将键移至末尾,实现“最新修改者置顶”的 LRU-like 排序
  • JSON 序列化/反序列化支持:递归还原嵌套结构,保留默认行为语义

完整实现代码

from collections import OrderedDict
import json
from typing import Any, Callable, Optional, Union, Dict as PyDict

class InfiniteDefaultRevisionDict(OrderedDict):
    """
    支持无限嵌套、默认值回退、按最后修改时间排序的字典。

    特性:
      - __getitem__: 缺失键时自动创建子字典(若 default 为 callable)或返回 default 值
      - __setitem__: 自动 move_to_end(key),维持“最新修改优先”顺序
      - to_json/from_json: 支持嵌套结构的 JSON 序列化与重建
    """

    def __init__(
        self,
        default: Union[Any, Callable[[], Any]] = None,
        init_dict: Optional[PyDict] = None
    ):
        super().__init__()
        self._default = default
        if init_dict:
            self.update(init_dict)

    def __missing__(self, key):
        # 创建默认值:若 default 是可调用对象,则调用它;否则直接使用该值
        if callable(self._default):
            value = self._default()
        else:
            value = self._default
        # 若 value 是 dict 类型(如 {} 或另一个 InfiniteDefaultRevisionDict),
        # 则需确保其也具备相同行为 —— 此处我们统一用本类实例
        if isinstance(value, (dict, OrderedDict)) and not isinstance(value, InfiniteDefaultRevisionDict):
            value = InfiniteDefaultRevisionDict(self._default, value)
        self[key] = value
        return self[key]

    def __getitem__(self, key):
        try:
            return super().__getitem__(key)
        except KeyError:
            return self.__missing__(key)

    def __setitem__(self, key, value):
        super().__setitem__(key, value)
        self.move_to_end(key)  # 关键:维持修订顺序(最新修改在末尾)

    def to_json(self, indent: int = 2) -> str:
        """序列化为 JSON 字符串(递归处理嵌套 InfiniteDefaultRevisionDict)"""
        def _default_serializer(obj):
            if isinstance(obj, InfiniteDefaultRevisionDict):
                return {k: v for k, v in obj.items()}
            return obj
        return json.dumps(dict(self), default=_default_serializer, indent=indent)

    @classmethod
    def from_json(cls, json_str: str, default=None):
        """从 JSON 字符串反序列化,重建嵌套结构"""
        def _object_hook(d):
            return cls(default=default, init_dict=d)
        data = json.loads(json_str, object_hook=_object_hook)
        return data if isinstance(data, cls) else cls(default=default, init_dict=data)

    # 可选:添加便捷方法以支持链式初始化
    def setdefault_nested(self, keys: list, default_value=None):
        """按路径列表设置嵌套默认值,如 ['a', 'b', 'c'] → d['a']['b']['c']"""
        node = self
        for k in keys[:-1]:
            if not isinstance(node.get(k), InfiniteDefaultRevisionDict):
                node[k] = InfiniteDefaultRevisionDict(self._default)
            node = node[k]
        node[keys[-1]] = default_value or (self._default() if callable(self._default) else self._default)
        return self

使用示例

# 示例 1:基础用法 —— 默认值为 0,支持无限嵌套访问
d = InfiniteDefaultRevisionDict(default=0)
print(d['a']['b']['c'])  # 输出: 0
d['x']['y'][0] = [1, 2, 3]
print(d['x']['y'][0])   # 输出: [1, 2, 3]

# 示例 2:默认值为字典工厂,实现真正的无限嵌套字典
dd = InfiniteDefaultRevisionDict(default=lambda: InfiniteDefaultRevisionDict(default=[]))
dd['users']['alice']['roles'].append('admin')
dd['users']['bob']['roles'].append('guest')
print(list(dd.keys()))  # ['users'](按修订顺序,'users' 最后被写入)
print(dd['users']['alice']['roles'])  # ['admin']

# 示例 3:JSON 序列化与还原
json_str = dd.to_json()
restored = InfiniteDefaultRevisionDict.from_json(json_str, default=[])
print(restored['users']['alice']['roles'])  # ['admin']

注意事项与限制

  • ⚠️ 循环引用风险:若 default 是对自身的 lambda(如 lambda: InfiniteDefaultRevisionDict(...)),需确保不触发无限递归构造(当前实现已规避此问题,但建议显式传入类型而非闭包)。
  • ⚠️ 性能考量:move_to_end() 为 O(1),整体操作仍保持高效;但深度嵌套(>100 层)可能引发溢出,建议业务层控制嵌套深度。
  • ⚠️ JSON 兼容性:仅支持 JSON 可序列化的值(str, int, float, list, dict, bool, None);自定义对象需额外实现 default 序列化逻辑。
  • 线程安全:本实现非线程安全;如需并发访问,请配合 threading.RLock 或改用 concurrent.futures 封装。

总结

InfiniteDefaultRevisionDict 并非替代 defaultdict 或 OrderedDict 的通用方案,而是面向特定场景(如动态配置树、缓存元数据、FS 模拟、DSL 解析器上下文)的高度定制化工具。它通过继承 OrderedDict、重载 __missing__ 与 __setitem__,以极简代码达成三重能力融合。未来若 Python 标准库引入 dict 的插件化行为(如 PEP 696 提议的泛型字典协议),此类模式有望成为官方推荐范式。你现在即可将上述类集成进项目 utils 模块,享受开箱即用的“智能字典”体验。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

745

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

634

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

757

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

617

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1259

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

547

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

577

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

705

2023.08.11

c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

80

2026.01.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 0.6万人学习

Django 教程
Django 教程

共28课时 | 3万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号