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 构建,同时支持:

PaperFake
PaperFake

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 模块,享受开箱即用的“智能字典”体验。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

457

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

549

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

337

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

82

2025.09.10

css中float用法
css中float用法

css中float属性允许元素脱离文档流并沿其父元素边缘排列,用于创建并排列、对齐文本图像、浮动菜单边栏和重叠元素。想了解更多float的相关内容,可以阅读本专题下面的文章。

595

2024.04.28

C++中int、float和double的区别
C++中int、float和double的区别

本专题整合了c++中int和double的区别,阅读专题下面的文章了解更多详细内容。

108

2025.10.23

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1031

2023.08.02

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

614

2024.08.29

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

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

精品课程

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

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 5万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.9万人学习

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

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