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 Codecs.

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

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

MongoCollection<DataStorageRecord> collection = database.getCollection("data_storage_devices", DataStorageRecord.class);
// retrieve and print the records
List<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 as anotações que você pode usar para configurar o comportamento de serialização dos componentes de registro e fornece um exemplo para demonstrar o comportamento da anotação.

Você pode usar as seguintes anotações nos componentes do registro:

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 record
String 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 records
List<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.