Insira um documento
Você pode inserir um único documento em uma coleção usando o método insertOne() em um objeto MongoCollection. Para inserir um documento, crie um objeto Document que contenha os campos e valores que você deseja armazenar. Se você chamar o método insertOne() em uma coleção que ainda não existe, o servidor criará automaticamente para você.
Após uma inserção bem-sucedida, o insertOne() retorna uma instância de InsertOneResult. Você pode recuperar informações como o campo _id do documento inserido chamando o método getInsertedId() na instância InsertOneResult.
Se a sua operação de inserção falhar, o driver emitirá uma exceção. Para obter mais informações sobre os tipos de exceções geradas em condições específicas, consulte a documentação da API para insertOne(), cujo link está no final desta página.
Exemplo
O trecho a seguir insere um único documento na coleção movies.
Observação
Esse exemplo se conecta a uma instância do MongoDB usando um URI de conexão. Para saber mais sobre como se conectar à sua instância do MongoDB , consulte oguia de conexão .
// Inserts a sample document describing a movie by using the Java driver 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 { // Inserts a sample document describing a movie into the collection InsertOneResult result = collection.insertOne(new Document() .append("_id", new ObjectId()) .append("title", "Ski Bloopers") .append("genres", Arrays.asList("Documentary", "Comedy"))); // Prints the ID of the inserted document System.out.println("Success! Inserted document id: " + result.getInsertedId()); // Prints a message if any exceptions occur during the operation } catch (MongoException me) { System.err.println("Unable to insert due to an error: " + me); } } } }
Ao executar o exemplo, você deverá visualizar o resultado com o ObjectId do documento inserido no campo de valor que se assemelha ao seguinte:
Inserted document id: BsonObjectId{value=...}
Dica
Legacy API
Se você estiver usando a API herdada, consulte nossa página de perguntas frequentes para saber quais alterações devem ser feitas nesse exemplo de código.
Para obter mais informações sobre as classes e métodos mencionados nesta página, consulte a seguinte documentação da API: