문서 삽입
이 버전의 문서는 보관되어 더 이상 지원되지 않습니다. Java 드라이버 버전을 업그레이드 하는 방법을 학습 보려면최신 문서 를 참조하세요.
MongoCollection 객체의 insertOne() 메서드를 사용하여 단일 문서를 컬렉션에 삽입할 수 있습니다. 문서를 삽입하려면 저장하려는 필드와 값이 포함된 Document 객체를 생성합니다. 아직 존재하지 않는 컬렉션에서 insertOne() 메서드를 호출하면 서버에서 자동으로 컬렉션을 생성합니다.
삽입에 성공하면 insertOne()은 InsertOneResult의 인스턴스를 반환합니다. InsertOneResult 인스턴스에서 getInsertedId() 메서드를 호출하여 삽입한 문서의 _id 필드와 같은 정보를 검색할 수 있습니다.
삽입 작업이 실패하면 드라이버에서 예외가 발생합니다. 특정 조건에서 발생하는 예외 유형에 대한 자세한 내용은 이 페이지 하단에 링크된 insertOne() 에 대한 API 문서를 참조하세요.
예시
다음 스니펫은 movies 컬렉션에 단일 문서를 삽입합니다.
참고
이 예시 에서는 연결 URI를 사용하여 MongoDB 인스턴스 에 연결합니다. MongoDB 인스턴스 에 연결하는 방법에 학습 보려면 연결 가이드 를 참조하세요.
package usage.examples; import java.util.Arrays; import org.bson.Document; import org.bson.types.ObjectId; import com.mongodb.MongoException; import com.mongodb.client.MongoClient; import com.mongodb.client.MongoClients; import com.mongodb.client.MongoCollection; import com.mongodb.client.MongoDatabase; import com.mongodb.client.result.InsertOneResult; public class InsertOne { public static void main(String[] args) { // Replace the uri string with your MongoDB deployment's connection string String uri = "<connection string uri>"; try (MongoClient mongoClient = MongoClients.create(uri)) { MongoDatabase database = mongoClient.getDatabase("sample_mflix"); MongoCollection<Document> collection = database.getCollection("movies"); try { InsertOneResult result = collection.insertOne(new Document() .append("_id", new ObjectId()) .append("title", "Ski Bloopers") .append("genres", Arrays.asList("Documentary", "Comedy"))); System.out.println("Success! Inserted document id: " + result.getInsertedId()); } catch (MongoException me) { System.err.println("Unable to insert due to an error: " + me); } } } }
예시를 실행하면 다음과 같이 값 필드에 삽입된 문서의 ObjectId가 포함된 출력이 표시됩니다.
Inserted document id: BsonObjectId{value=...}
이 페이지에 언급된 클래스 및 메서드에 대한 추가 정보는 다음 API 설명서를 참조하세요.