JSON格式数据简介

JSON文件的读写应算成Python基础知识的内容，但是由于在编写Nonebot插件时，常常会操作JSON类型的数据，今天就回顾一下Python操作JSON。

JSON 全称“JavaScript Object Notation”，译为“JavaScript 对象简谱”或“JavaScript 对象表示法”，是一种轻量级的、基于文本的、开放的数据交换格式。JSON 在 Web 开发领域有着举足轻重的地位，如果您想在 Web 开发领域大展身手的话，就必须了解 JSON。通俗点来说Json是一种文本格式，常用于数据存储。基本结构为键: 值，键仅可以为字符串，而值可以是字符串，列表，数字，或者另一些键值对。
下面这段数据很好的展示了不同形式的Json结构：

{
    "max": 1,
    "1": {
        "user": 825882638,
        "type": "image"
        "title": "超人"
    },
    "a": [
        "芝麻开门",
        {
            "a": 2
        },
        "b"
    ],
    "c": {
        "d": 888
        "g": 888
    }
}

注意：所有Json文本最外层都必须有{}

使用Python读写JSON格式数据

接下来我们就以上面这个Json文本为样板讲解一下Json文件的解析。

在Python当中，如果我们要解析Json文件，就必须先导入Python安装时自带的json库，即import json，之后才可以进行json操作。

1.读取json文件

下面的代码告诉了我们如何读入一个json文件

with open("./new.json", "r", encoding="utf-8") as f:
    content = json.load(f)

json.load是直接从文件读取json文本，而json.loads是读取进行了json编码的文本而非本地文件。

上述代码即从当前目录下的"new.json"文件当中读入json数据，随后json.load方法会将读入的json文本转换成Python当中的字典存入content变量当中。而在Python中操作JSON格式数据实际上就是操作字典、列表所组成的组合数据类型。

例如我们现在想要在上面的json文本当中提取最下面的"d"的值(代码中1号位置)，可以这么操作val=content[“c”][“d”]，这样就可以取到d的值，也就是333了。除此之外上例我们还可以看到[]包裹的列表，如果我们想取到其中的"a"(代码中2号位置)的值，应该这么写：val=content[“a”][1][“a”]，此时val的值为2。

2.写入json文件

with open("./new.json", "w", encoding="utf-8") as f:
    json.dump(data, f, indent=4, ensure_ascii=False)

上述代码用于向json文件当中写入data数据，其中dump方法拥有很多参数，这里只讲上面代码中的三个，其他的请自行查阅。

obj:即上述第一个参数，用于传入需要写入Json文件当中的数据。

fp:即上述第二个参数，用于传入需要写入Json数据的文本指针

indent:传入Json文件换行缩进量，一般为2或者4。

ensure_ascii:是否允许Ascii码。若为True(默认)，则输入的中文全会转化为\uXXXX存储。

自己编写一个JsonUtils

代码来源于github上一个大佬，如何使用的话代码注释给出了详细说明！如果对此方面比较感兴趣可以去瞧瞧大佬！点击去见大佬

import json, os

class JsonUtils():
    relative_url = "./data/"
    abstract_url = "file:///home/ubuntu/qqbot/data/rpg/"

    @staticmethod
    def __preBuildFile(file: str, *default: Union[str, dict]) -> bool:
        """
        判断文件及路径是否存在,若不存在则创建并生成对应文件内容

        :param file: 文件路径
        :param default: 默认文件内容
        :return:
        """
        if (not os.path.exists(file)):
            path = os.path.split(file)
            if (not os.path.exists(path[0])):
                os.mkdir(path[0])
            with open(file, "w", encoding=utf-8") as f:
                if (default):
                    arg = default[0]
                    if (isinstance(arg, str)):
                        f.write(arg)
                    elif (isinstance(arg, dict)):
                        try:
                            js = json.dumps(arg, indent=4, ensure_ascii=False)
                            f.write(js)
                        except json.JSONEncoder:
                            return False
                    else:
                        f.write(str(arg))
                else:
                    f.write("")
        return True
                      
    @classmethod
    async def read(cls, filename: str, *default) -> Tuple[dict, bool]:
        """
        读取指定json文件

        :param filename: 文件路径
        :param default: 若无此文件,创建该文件时写入的内容
        :return: [读取到的内容, 是否为新创建的文件]
        """
        file_url = cls.relative_url + filename
        if (default):
            res = JsonUtils.__preBuildFile(file_url, default[0])
        else:
            res = JsonUtils.__preBuildFile(file_url)
        with open(file_url, "r", encoding="utf-8") as f:
            content = json.load(f)
        return (content, res)

    @classmethod
    async def write(cls, filename: str, data: dict) -> None:
        """
        写入Json数据
        
        :param filename: 文件路径
        :param data: 写入的数据
        :return: 
        """
        file_url = cls.relative_url + filename
        JsonUtils.__preBuildFile(file_url)
        with open(file_url, "w", encoding="utf-8") as f:
            content = json.dumps(data, indent=4, ensure_ascii=False)
            f.write(content)