MongoDB 扩展 JSON (v2)

MongoDB 扩展 JSON v2 用法

EJSON.serialize( db.<collection>.findOne() )

EJSON.deserialize( <serialized object> )

EJSON.stringify( <deserialized object> )

EJSON.parse( <string> )

BSON 数据类型和相关表示形式

下文介绍某些常见 BSON 数据类型，以及在规范和宽松模式下的相关表示形式。

完整列表 请见此处。

Array

[ <elements> ]

<Same as Canonical>

其中数组元素如下：

• <elements>

  • 数组元素使用扩展 JSON。

  • 要指定空数组，请省略内容 [ ]。

Binary

{ "$binary":
   {
      "base64": "<payload>",
      "subType": "<t>"
   }
}

<Same as Canonical>

其中的值如下所示：

• "<payload>"

  • Base64 编码（填充为 "="）有效负载字符串。

• "<t>"

  • 对应于 BSON 二进制子类型的一个或两个字符的十六进制字符串。请参阅扩展 bson 文档 http://bsonspec.org/spec.html 可用的子类型。

Date

对于 1970 年至 9999 年之间的日期（含）：

{"$date": {"$numberLong": "<millis>"}}

{"$date": "<ISO-8601 Date/Time Format>"}

对于 1970 年之前或 9999 年之后的日期：

{"$date": {"$numberLong": "<millis>"}}

<Same as Canonical>

其中的值如下所示：

• "<millis>"

  • 作为字符串的 64 位有符号整数。该值表示相对于纪元的毫秒数。

• "<ISO-8601 Date/Time Format>"

  • 以 ISO-8601 互联网日期/时间格式为字符串的日期。

  • 日期/时间的最大时间精度为毫秒：

    • 如果小数部分为非零，则小数形式的秒数实际有 3 个小数位。

    • 否则，如果秒的小数部分为零，则应省略。

Decimal128

{ "$numberDecimal": "<number>" }

<Same as Canonical>

其中的值如下所示：

• "<number>"

  • 高精度小数作为字符串。

Document

{ <content> }

<Same as Canonical>

其中文档内容如下所示：

• <content>

  • 使用扩展 JSON 的“名称:值”对。

  • 要指定空文档，请省略内容 { }。

Double

对于有限数：

{"$numberDouble": "<decimal string>" }

<non-integer number>

对于无限数或 NAN：

{"$numberDouble": <"Infinity"|"-Infinity"|"NaN"> }

<Same as Canonical>

其中的值如下所示：

• "<decimal string>"

  • 作为字符串的 64 位带符号浮点数。

• <non-integer number>

  • 非整数。整数数字将解析为整数而不是 double。

Int64

{ "$numberLong": "<number>" }

<integer>

其中的值如下所示：

• "<number>"

  • 作为字符串的 64 位有符号整数。

• <integer>

  • 64 位有符号整数。

Int32

{ "$numberInt": "<number>" }

<integer>

其中的值如下所示：

• "<number>"

  • 作为字符串的 32 位有符号整数。

• <integer>

  • 一个 32 位有符号整数。

MaxKey

{ "$maxKey": 1 }

<Same as Canonical>

MaxKey BSON 数据类型的比较高于所有其他类型。请参阅比较/排序顺序以了解有关 BSON 类型的比较顺序的更多信息。

MinKey

{ "$minKey": 1 }

<Same as Canonical>

MinKey BSON 数据类型的比较值低于所有其他类型。数据类型有关 BSON 类型的比较顺序的更多信息，请参阅比较/排序顺序。

ObjectId

{ "$oid": "<ObjectId bytes>" }

<Same as Canonical>

其中的值如下所示：

• "<ObjectId bytes>"

  • 一个 24 个字符大端十六进制字符串，表示对象标识符字节。

Regular Expression

{ "$regularExpression":
   {
      "pattern": "<regexPattern>",
      "options": "<options>"
  }
}

<Same as Canonical>

其中的值如下所示：

• "<regexPattern>"

  • 与正则表达式模式相对应的字符串。字符串可以包含有效的 JSON 字符和非转义双引号 (") 字符，但不能包含未转义的正斜杠 (/) 字符。

• "<options>"

  • 指定 BSON 正则表达式选项的字符串。必须按字母顺序指定选项。有关受支持选项的信息，请参阅 $options 。

Timestamp

{"$timestamp": {"t": <t>, "i": <i>}}

<Same as Canonical>

其中的值如下所示：

• <t>

  • 自纪元以来的秒数的正整数。

• <i>

  • 增量的正整数。

举例

以下示例说明了扩展 JSON 的用法。

db.conversions.insertOne( { insertDate: new Date() } )

{
  acknowledged: true,
  insertedId: ObjectId("61fbaf25671c45f3f5f4074a")
}

serialized = EJSON.serialize( db.conversions.findOne() )

{
  _id: { '$oid': '61fbaf25671c45f3f5f4074a' },
  insertDate: { '$date': '2022-02-03T10:32:05.230Z' }
}

EJSON.deserialize( serialized )

{
  _id: new ObjectId( "61fbaf25671c45f3f5f4074a" ),
  insertDate: ISODate( "2022-02-03T10:32:05.230Z" )
}

stringified = EJSON.stringify( db.conversions.findOne() )

{
   "_id": {"$oid":"61fbaf25671c45f3f5f4074a"},
   "insertDate":{"$date":"2022-02-03T10:32:05.230Z"}
}

EJSON.parse( stringified )

{
  _id: new ObjectId("61fbaf25671c45f3f5f4074a"),
  insertDate: ISODate("2022-02-03T10:32:05.230Z")
}