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 sequência 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 nesta página usam dados do conjunto de dados de amostra sample_mflix. Para obter detalhes sobre como carregar esse conjunto de dados em sua implantação autogerenciada do MongoDB , consulte Carregar o conjunto de dados de amostra. Se você fez modificações nos bancos de dados de amostra, talvez seja necessário descartar e recriar os bancos de dados para executar os exemplos nesta página.

Os exemplos a seguir ilustram o uso do JSON estendido.

serialized = EJSON.serialize(
   db.comments.find( {}, { _id: 1, date: 1 } ).sort( { _id: 1 } ).limit(1).next()
)

{
  _id: {
    '$oid': '5a9427648b0beebeb69579e7'
  },
  date: {
    '$date': '2002-08-18T04:56:07.000Z'
  }
}

EJSON.deserialize( serialized )

{
  _id: ObjectId('5a9427648b0beebeb69579e7'),
  date: ISODate('2002-08-18T04:56:07.000Z')
}

stringified = EJSON.stringify(
   db.comments.find( {}, { _id: 1, date: 1 } ).sort( { _id: 1 } ).limit(1).next()
)

{"_id":{"$oid":"5a9427648b0beebeb69579e7"},"date":{"$date":"2002-08-18T04:56:07.000Z"}}

EJSON.parse( stringified )

{
  _id: ObjectId('5a9427648b0beebeb69579e7'),
  date: ISODate('2002-08-18T04:56:07.000Z')
}