문서 데이터 형식: 확장 JSON

확장 JSON 예시

다음 예시에서는 각 확장 JSON 형식으로 표시되는 ObjectId, 날짜, 긴 숫자 필드가 포함된 문서를 보여 줍니다. 원하는 형식의 예시 탭을 클릭합니다.

{
  "_id": { "$oid": "573a1391f29313caabcd9637" },
  "createdAt": { "$date": { "$numberLong": "1601499609" }},
  "numViews": { "$numberLong": "36520312" }
}

{
  "_id": { "$oid": "573a1391f29313caabcd9637" },
  "createdAt": { "$date": "2020-09-30T18:22:51.648Z" },
  "numViews": 36520312
}

{
  "_id:": ObjectId("573a1391f29313caabcd9637"),
  "createdAt": ISODate("2020-09-30T18:22:51.648Z"),
  "numViews": NumberLong("36520312")
}

{
  "_id:": { "$oid": "573a1391f29313caabcd9637" },
  "createdAt": { "$date": 1601499609 },
  "numViews": { "$numberLong": "36520312" }
}

문서 클래스 사용

필요한 Realm 객체 유형에 따라 Document 또는 BsonDocument 클래스에서 parse() 정적 메서드를 호출하여 확장 JSON 문자열을 Kotlin 문서 객체로 읽을 수 있습니다. 이 메서드는 모든 형식의 확장 JSON 문자열을 구문 분석하고 데이터가 포함된 해당 클래스의 인스턴스를 반환합니다.

다음 예시에서는 Document 클래스를 활용해 예시 확장 JSON 문자열을 Document 객체로 읽는 방법을 보여 줍니다. parse() 메서드를 사용합니다:

val ejsonStr = """
        { "_id": { "${"$"}oid": "507f1f77bcf86cd799439011"},
        "myNumber": {"${"$"}numberLong": "4794261" }}
    """.trimIndent()
val doc = Document.parse(ejsonStr)
println(doc)

Document{{_id=507f1f77bcf86cd799439011, myNumber=4794261}}

자세한 내용은 문서의 기본 사항 페이지를 참조하세요.

BSON 라이브러리 사용

JsonReader 클래스를 사용하여 MongoDB 코틀린(Kotlin) 드라이버의 문서 클래스를 사용하지 않고도 확장 JSON 문자열을 코틀린(Kotlin) 객체로 읽을 수도 있습니다. 이 클래스에는 모든 형식의 확장 JSON 문자열에서 필드와 값을 순차적으로 구문 분석하고 이를 Kotlin 객체로 반환하는 메서드가 포함되어 있습니다. 드라이버의 문서 클래스도 이 클래스를 사용하여 확장 JSON을 구문 분석합니다.

다음 코드 예시에서는 JsonReader 클래스를 사용하여 확장 JSON 문자열을 코틀린 객체로 변환합니다.

val ejsonStr = """
    { "_id": { "${"$"}oid": "507f1f77bcf86cd799439011"},
      "myNumber": {"${"$"}numberLong": "4794261" }}
    """.trimIndent()
val jsonReader = JsonReader(ejsonStr)
jsonReader.readStartDocument()
jsonReader.readName("_id")
val id = jsonReader.readObjectId()
jsonReader.readName("myNumber")
val myNumber = jsonReader.readInt64()
jsonReader.readEndDocument()
println(id.toString() + " is type: " + id.javaClass.name)
println(myNumber.toString() + " is type: " + myNumber.javaClass.name)
jsonReader.close()

507f1f77bcf86cd799439011 is type: org.bson.types.ObjectId
4794261 is type: java.lang.Long

자세한 내용은 JsonReader API 문서를 참조하세요.

문서 클래스 사용

Document 또는 BsonDocument에서 toJson() 메서드를 호출하여 확장된 JSON 문자열을 작성할 수 있습니다. 선택적으로 JsonWriterSettings 인스턴스를 전달하여 확장된 JSON 형식을 지정할 수 있습니다.

이 예시에서는 확장 JSON을 릴렉스 모드 형식으로 출력합니다.

val myDoc = Document().append("_id", ObjectId("507f1f77bcf86cd799439012"))
    .append("myNumber", 11223344)
val settings = JsonWriterSettings.builder().outputMode(JsonMode.RELAXED).build()
myDoc.toJson(settings)

{"_id": {"$oid": "507f1f77bcf86cd799439012"}, "myNumber": 11223344}

BSON 라이브러리 사용

JsonWriter 클래스와 함께 BSON 라이브러리를 사용하여 Kotlin 객체의 데이터에서 확장 JSON 문자열을 출력할 수도 있습니다. JsonWriter 인스턴스를 구성하려면 Java Writer 의 서브클래스를 전달하여 확장 JSON을 출력할 방법을 지정합니다. 선택적으로 JsonWriterSettings 인스턴스를 전달하여 확장 JSON 형식과 같은 옵션을 지정할 수 있습니다. 기본적으로 JsonWriter 은(는) 완화 모드 형식을 사용합니다. MongoDB 코틀린(Kotlin) 드라이버의 문서 클래스도 이 클래스를 사용하여 BSON을 확장 JSON으로 변환합니다.

다음 코드 예시는 JsonWriter를 사용하여 확장 JSON 문자열을 만들고 이를 System.out으로 출력하는 방법을 보여줍니다. outputMode() 빌더 메서드에 JsonMode.EXTENDED 상수를 전달하여 형식을 지정합니다.

val settings = JsonWriterSettings.builder().outputMode(JsonMode.EXTENDED).build()
JsonWriter(BufferedWriter(OutputStreamWriter(System.out)), settings).use { jsonWriter ->
    jsonWriter.writeStartDocument()
    jsonWriter.writeObjectId("_id", ObjectId("507f1f77bcf86cd799439012"))
    jsonWriter.writeInt64("myNumber", 11223344)
    jsonWriter.writeEndDocument()
    jsonWriter.flush()
}

{"_id": {"$oid": "507f1f77bcf86cd799439012"}, "myNumber": {"$numberLong": "11223344"}}

이 섹션에 언급된 메서드 및 클래스에 대한 자세한 내용은 다음 API 문서를 참조하세요.

• JsonWriter

• JsonWriterSettings

• outputMode()