문서 데이터 형식: BSON

개요

이 가이드에서는 BSON 데이터 형식, MongoDB가 이를 사용하는 방법, MongoDB Java 드라이버와 독립적으로 BSON 라이브러리를 설치하는 방법에 대해 알아볼 수 있습니다.

BSON Data Format

BSON 또는 바이너리 JSON은 MongoDB가 데이터를 구성하고 저장하는 데 사용하는 데이터 형식입니다. 이 데이터 형식은 모든 JSON 데이터 구조 유형을 포함하며 날짜, 크기가 다른 정수, ObjectID, 이진 데이터 등의 유형에 대한 지원을 추가합니다. 지원되는 유형의 전체 목록은 BSON 유형 서버 매뉴얼 페이지를 참조하십시오.

바이너리 형식은 사람이 읽을 수 없지만 Java BSON 라이브러리를 사용하여 JSON 표현으로 변환할 수 있습니다. 이러한 형식 간의 관계에 대한 자세한 내용은 JSON 및 BSON에 대한 문서에서 확인할 수 있습니다.

MongoDB 및 BSON

BSON 라이브러리를 사용하는 MongoDB Java 드라이버 사용하면 다음을 포함하여 BSON 인터페이스 를 구현하는 객체 유형 중 하나를 사용하여 BSON 데이터로 작업할 수 있습니다.

• 문서 (BSON 라이브러리 패키지)

• BsonDocument (BSON 라이브러리 패키지)

• RawBsonDocument(BSON 라이브러리 패키지)

• JsonObject (BSON 라이브러리 패키지)

• BasicDBObject(Java 드라이버 패키지)

이러한 객체 유형 사용에 대한 자세한 내용은 문서 가이드를 참조하세요.

BSON 라이브러리 설치

이 지침은 BSON 라이브러리를 프로젝트에 종속성으로 추가하는 방법을 보여줍니다. 프로젝트에 MongoDB Java 드라이버를 종속성으로 추가한 경우, BSON 라이브러리가 이미 드라이버의 필수 종속 요소로 포함되어 있으므로 이 단계를 건너뛸 수 있습니다. 프로젝트에 MongoDB Java 드라이버를 종속성으로 추가하는 방법에 대한 지침은 빠른 시작 가이드의 드라이버 설치 섹션을 참조하세요.

Maven 또는 Gradle 빌드 자동화 도구를 사용하여 프로젝트의 종속 항목을 관리하는 것이 좋습니다. 다음 탭에서 선택하여 해당 도구의 종속성 선언을 확인합니다.

<dependencies>
    <dependency>
        <groupId>org.mongodb</groupId>
        <artifactId>bson</artifactId>
    </dependency>
</dependencies>

dependencies {
   compile 'org.mongodb:bson'
}

위 도구 중 하나를 사용하지 않는 경우에는 sonatype 리포지토리에서 바로 JAR 파일을 다운로드하여 프로젝트에 포함할 수 있습니다.

자주 묻는 질문

이 섹션에서는 BSON 데이터 형식을 사용할 때 발생할 수 있는 질문에 대한 답변을 제공합니다.

// incorrectly formatted update document
collection.updateOne(
    new Document().append("name", "fizz"),
    new Document().append("name", "buzz")
);

// Builder class imports
import static com.mongodb.client.model.Filters.*;
import static com.mongodb.client.model.Updates.*;
// ...
collection.updateOne(eq("name", "fizz"), set("name", "buzz"));