MongoDB Extended JSON (v2)

Uso estendido do MongoDB JSON v2

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

EJSON.deserialize( <serialized object> )

EJSON.stringify( <deserialized object> )

EJSON.parse( <string> )

Tipos de dados JSON e representações associadas

A seguir, são apresentados alguns tipos de dados BSON comuns e as representações associadas em Canonical e Relaxed.

A lista completa está aqui.

Array

[ <elements> ]

<Same as Canonical>

Onde os elementos da array são os seguintes:

• <elements>

  • Os elementos da array usam Extended JSON.

  • Para especificar uma array vazia, omita o conteúdo [ ].

Binary

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

<Same as Canonical>

Onde os valores são os seguintes:

• "<payload>"

  • Cadeia de caracteres de carga codificada Base64 (com preenchimento como "=").

• "<t>"

  • Uma string hexadecimal de um ou dois caracteres que corresponde a um subtipo binário BSON. Consulte a documentação estendida do bson http://bsonspec.org/spec.html para conhecer os subtipos disponíveis.

Date

Para datas entre os anos 1970 e 9999, inclusive:

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

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

Para datas anteriores ao ano 1970 ou posteriores ao ano 9999:

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

<Same as Canonical>

Onde os valores são os seguintes:

• "<millis>"

  • Um inteiro assinado de 64 bits como string. O valor representa milissegundos em relação à época.

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

  • Uma data no formato ISO-8601 de data/hora da Internet como string.

  • A data/hora tem uma precisão de tempo máxima de milissegundos:

    • Segundos fracionários têm exatamente 3 casas decimais se a parte fracionária não for zero.

    • Caso contrário, segundos fracionários DEVEM ser omitidos se zero.

Decimal128

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

<Same as Canonical>

Onde os valores são os seguintes:

• "<number>"

  • Um decimal de alta precisão como uma string.

Document

{ <content> }

<Same as Canonical>

Onde o conteúdo do documento é o seguinte:

• <content>

  • Nome:pares de valores que usam JSON estendido.

  • Para especificar um documento vazio, omita o conteúdo { }.

Double

Para números finitos:

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

<non-integer number>

Para números infinitos ou NAN:

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

<Same as Canonical>

Onde os valores são os seguintes:

• "<decimal string>"

  • Um ponto flutuante assinado de 64-bit como uma string.

• <non-integer number>

  • Um número não inteiro. Números inteiros são analisados como um inteiro em vez de um double.

Int64

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

<integer>

Onde os valores são os seguintes:

• "<number>"

  • Um inteiro assinado de 64 bits como string.

• <integer>

  • Um número inteiro assinado de 64 bits.

Int32

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

<integer>

Onde os valores são os seguintes:

• "<number>"

  • Um inteiro assinado de 32 bits como string.

• <integer>

  • Um número inteiro assinado de 32 bits.

MaxKey

{ "$maxKey": 1 }

<Same as Canonical>

O tipo de dados MaxKey BSON compara mais alto do que todos os outros tipos. Consulte Comparação/Ordem de Classificação para obter mais informações sobre a ordem de comparação dos tipos de BSON.

MinKey

{ "$minKey": 1 }

<Same as Canonical>

O tipo de dados MinKey BSON é comparado abaixo de todos os outros tipos. Consulte Comparação/Ordem de Classificação para obter mais informações sobre a ordem de comparação dos tipos de BSON.

ObjectId

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

<Same as Canonical>

Onde os valores são os seguintes:

• "<ObjectId bytes>"

  • Uma cadeia hexadecimal grande e de 24 caracteres que representa os bytes ObjectId.

Regular Expression

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

<Same as Canonical>

Onde os valores são os seguintes:

• "<regexPattern>"

  • Uma string que corresponde ao padrão de expressão regular. A string pode conter caracteres JSON válidos e caracteres de aspas duplas sem recapitulação ("), mas não pode conter caracteres de barra invertida sem recapitulação (/).

• "<options>"

  • Uma string que especifica opções de expressão regular BSON. Você deve especificar as opções em ordem alfabética. Para obter informações sobre as opções aceitas, consulte $options.

Timestamp

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

<Same as Canonical>

Onde os valores são os seguintes:

• <t>

  • Um número inteiro positivo para os segundos desde a época.

• <i>

  • Um número inteiro positivo para o incremento.

Exemplos

Os exemplos a seguir ilustram o uso do JSON estendido.

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")
}