Formato de dados do documento: Registros

Visão geral

Neste guia, você aprenderá como armazenar e recuperar dados no driver Java do MongoDB usando registros Java. Os registros Java são um tipo de classe Java frequentemente usado para modelar dados e separar a lógica de negócios da representação de dados.

Serializar e desserializar um registro

O driver suporta nativamente a codificação e a decodificação de registros Java para operações de leitura e gravação do MongoDB usando o registro de codec padrão. O registro de codecs padrão é uma coleção de classes chamadas codecs que definem como converter tipos Java de codificação e decodificação. Saiba mais sobre codecs e o registro de codec padrão no guia sobre Codificar dados com codecs de tipo.

public record DataStorageRecord(        String productName,        double capacity) {}

MongoCollection<DataStorageRecord> collection = database.getCollection("data_storage_devices", DataStorageRecord.class);
// insert the recordcollection.insertOne(new DataStorageRecord("2TB SSD", 1.71));

MongoCollection<DataStorageRecord> collection = database.getCollection("data_storage_devices", DataStorageRecord.class);
// retrieve and print the recordsList<DataStorageRecord> records = new ArrayList<DataStorageRecord>();collection.find().into(records);records.forEach(System.out::println);

DataStorageRecord[productName=1TB SSD, capacity=1.71]

Especificar conversão de componente usando anotações

Esta seção descreve como configurar o comportamento de serialização dos componentes de registro usando anotações. Para obter uma lista completa das anotações compatíveis, consulte a documentação da API do pacote org.bson.codecs.pojo.annotations.

import org.bson.BsonType;import org.bson.codecs.pojo.annotations.BsonProperty;import org.bson.codecs.pojo.annotations.BsonId;import org.bson.codecs.pojo.annotations.BsonRepresentation;
public record NetworkDeviceRecord(        @BsonId()        @BsonRepresentation(BsonType.OBJECT_ID)        String deviceId,        String name,        @BsonProperty("type")        String deviceType        ){}

MongoCollection<NetworkDeviceRecord> collection = database.getCollection("network_devices", NetworkDeviceRecord.class);
// insert the recordString deviceId = new ObjectId().toHexString();collection.insertOne(new NetworkDeviceRecord(deviceId, "Enterprise Wi-fi", "router"));

{  _id: ObjectId("fedc..."),  name: 'Enterprise Wi-fi',  type: 'router'}

MongoCollection<NetworkDeviceRecord> collection = database.getCollection("network_devices", NetworkDeviceRecord.class);
// return all documents in the collection as recordsList<NetworkDeviceRecord> records = new ArrayList<NetworkDeviceRecord>();collection.find().into(records);records.forEach(System.out::println);

NetworkDeviceRecord[deviceId=fedc..., name=Enterprise Wi-fi, deviceType=router]

Operações com tipos recursivos

O driver aceita nativamente a codificação e decodificação de registros definidos recursivamente sem causar recursão no tempo de execução. Este suporte se estende a ciclos de vários tipos de registros em definições de tipo. O seguinte código fornece um exemplo de um design de registro recursivo:

public record RecordTree(        String content,        RecordTree left,        RecordTree right) {}

Você pode realizar operações de leitura e gravação em registros definidos recursivamente da mesma forma que faria com outros registros. O seguinte código mostra como você pode executar uma operação de localizar em uma coleção de RecordTree tipos:

MongoDatabase database = mongoClient.getDatabase("myDB");MongoCollection<RecordTree> collection = database.getCollection("myCollection", RecordTree.class);
Bson filter = Filters.eq("left.left.right.content", "Ikatere");collection.find(filter).forEach(doc -> System.out.println(doc));

RecordTree[content=Ranginui, left=RecordTree[content=..., left=RecordTree[content=..., right=RecordTree[content=Ikatere...]]

Recuperar o codec do registro

Você pode usar o RecordCodecProvider para recuperar o codec de registro. Use esta interface para personalizar o codec para codificar e decodificar objetos de registro Java de e para tipos BSON correspondentes, reduzindo código duplicado. Para saber mais sobre codecs e seu uso, consulte Codecs.

Não é possível criar um codec de registro diretamente, mas você pode utilizar o RecordCodecProvider para implementar o codec de registro em seu código. Para saber mais sobre o RecordCodecProvider, consulte a documentação da API.