python标准库-json

json简介

json(javascript object notation) 是一种轻量级的数据交换格式,python3中可以使用json模块来对json数据进行编解码
该模块主要提供了四种方法:

  • dumps
  • dump
  • loads
  • load

dumps 和dump 对python对象进行序列化,将一个python对象进行json格式的编码

json.dump(obj, fp, *, skipkeys=False, ensure_ascii=True, check_circular=True, allow_nan=True, cls=None, indent=None, separators=None, default=None, sort_keys=False, **kw)
  • obj:表示要序列化的对象
  • fp:文件描述符,将序列化的str保存到文件中,json模块总是生成str对象,而不是字节对象,因此fp.write()必须支持str输入
  • skipkey: 默认为False,如果skipkeys为True(默认值为False),则将跳过不是基本类型(str, int, float, bool, Nose)的dict键,不会引发TypeError
  • ensure_ascii: 默认值为True, 能将所有传入的非ASCII字符转移输出,如果ensure_ascii为False,则这些字符将按原样输出
  • check_circular:默认值为True,如果check_circular为False,则将跳过对容器类型的循环引用检查,循环引用将导致OverflowError
  • allow_nan: 默认值为True,如果allow_nan为Flase, 则严格遵守Json规范,序列化超出范围的浮点值(nan, inf, -inf)会引发ValueError,
    如果allow_nan为True,则将使用它们的JavaScript等销项(NaN,Infinity, -Infinity)
  • Indent: 设置缩进格式,默认值为None,选择的是最紧凑的表示,如果Indent是非负整数或者字符串, 那么json数组元素对象和成员将
    使用该缩进级别进行输入;如果Indent为0、负数或者“”,则仅插入换行符;indent使用正整数缩进多个空格;如果indent是一个字符串(如“\t”)则该字符串用于缩进每个级别
  • separators: 去除分隔符后面的空格,默认值为None,如果指定,则分隔符应为(item_separator, key_separator)元组,如果缩进为None,则默认为(',', ':');要获得最紧凑的json表示,则可以指定(',',':')以消除空格
  • default: 默认值为None, 如果指定,则default应该是为无法以其他方式序列化的对象调用的函数,它应返回对象的json可编码版本
    或引发TypeError,如果未指定,则引发TypeError
  • sort_keys: 默认值为False,如果sort_keys为True,则字典的输出将按照键值排序
json.dumps(obj, *, skipkeys=False, ensure_ascii=True, check_circular=True, allow_nan=True, cls=None, indent=None, separators=None, default=None, sort_keys=False, **kw)

dumps函数不需要传文件描述符,其他参数与dump函数的一样

laod 和 loads 反序列化方法, 将json格式数据解码为python对象

json.load(fp, *, cls=None, object_hook=None, parse_float=None, parse_int=None, parse_constant=None, object_pairs_hook=None, **kw)
  • fp: 文件描述符,将fp反序列化为python对象
  • object_hook: 默认值为None, object_hook是一个可选函数,此功能可用于实现自定义解码器,指定一个函数,该函数负责把反序列化后的基本类型对象转换成自定义类型的对象
  • parse_float: 默认值为None,如果指定了parse_float, 用来对json float字符串进行解码,这可用于为json浮点数使用另一种数据类型或解析器
  • parse_int: 默认值为None,如果指定了parse_int, 用来对json int 字符串进行解码,这可以用于为json整数使用另一种数据类型或解析器
  • parse_constant:默认值为None,如果指定了parse_constant,对-Infnity, Infinity,NaN字符串进行调用,如果遇到了无效的json符号,会引发异常,如果进行反序列化(解码)的数据不是一个有效的json文档,将会引发jsondecodeerror异常
json.loads(s, *, encoding=None, cls=None, object_hook=None, parse_float=None, parse_int=None, parse_constant=None, object_pairs_hook=None, **kw)
  • s: 将s (包含json文档的str, bytes或bytearray)反序列化为python对象

  • encoding: 指定一个编码的格式

loads也是不需要文件描述符,其他参数的含义和load函数一致

json中的数据格式与python中的数据格式的转化关系:

Json             Python
object           dict
array            list
string           str
number(int)      int
number(real)     flaot
true/false       true/false
null             None

dump和dumps实例:

import json

# dumps 可以格式化所有的基本数据类型为字符串

data_01 = json.dumps([1, 2, 3])
print(data_01, type(data_01))

data_02 = json.dumps(9)
print(data_02, type(data_02))

data_03 = json.dumps({ "city": 'shenzhen', "age": 18})
print(data_03, type(data_03))


def json_dumps_test(file_path, py_data):
    with open(file_path, 'w', encoding='utf-8') as f:
        f.write(json.dumps(py_data, indent=4))
        # json.dump(py_data, f, indent=4)

json_dumps_test('./topic.json', data_03)

load和loads实例:

json_data = '{"name": "tom", "age": 20}'
py_data_01 = json.loads(json_data)
print(py_data_01, type(py_data_01))

with open("./topic.json", "r", encoding="utf-8") as f:
    py_data_02 = json.loads(f.read())  # load 的传入参数为字符串类型
    print(py_data_02, type(py_data_02))

常见异常:
直接使用以下方式对多行json文件进行读取

with open("./topic.json", "r", encoding="utf-8") as f:
    py_data_02 = json.loads(f.read())

会直接抛出JsonDecodeError异常,由于json只能读取一个文档对象,因此我们有两个解决办法:

  • 单行读取文件,一次读取一行文件
with open(json_path, 'r') as f:
    for line in f.readlines():
        json_data = json.loads(line)

但这种方法依然有可能会抛出JsonDecodeError异常,即在json文件中包含空行时,此时需要先处理空行在进行文件读取操作

  • 将json文件处理为一个文件对象然后在进行读取文件

小结:

  • json.dumps 将 Python 对象编码成 JSON 字符串
  • json.loads 将已编码的 JSON 字符串解码为 Python 对象
  • json.dump和json.load,需要传入文件描述符,加上文件操作。
  • JSON内部的格式要注意,一个好的格式能够方便读取,可以用indent格式化。

你可能感兴趣的:(python标准库-json)