Incluir o módulo de documento em seu modelo

Visão geral

Neste guia, você aprenderá sobre o módulo Mongoid::Document no Mongoid. O módulo Document é uma implementação Ruby de um documento MongoDB , que armazena dados em pares de campo e valor. Para saber mais sobre a terminologia, estrutura e limitações dos documentos MongoDB , consulte Documentos no manual do servidor.

Você deve incluir o módulo Mongoid::Document em qualquer classe que queira persistir no MongoDB. Ao incluir o módulo Document em sua classe de modelo, você pode usar seus métodos em instâncias da sua classe de modelo.

O código a seguir demonstra como incluir o módulo Document em uma classe de modelo Person de exemplo :

class Person
    include Mongoid::Document
    field :name, type: String
end

Você pode encontrar mais informações sobre o Document módulo na documentação da API.

Trabalhar com Documentos

Você pode armazenar instâncias de seus modelos diretamente em uma coleção ou pode incorporá-las em outras classes que usam o módulo Document. Quando você salva uma instância do Document no MongoDB, ela é convertida em um objeto BSON semelhante a um hash Ruby ou objeto JSON.

O seguinte código cria uma instância do modelo Person definido na seção anterior:

Person.create(name: 'Meena Kumar')

O documento aparece no MongoDB da seguinte forma:

{
  "_id": {
    "$oid": "673b6dce61700598c24a72b0"
  },
  "name": "Meena Kumar"
}

Observação

Campo _id

Quando você persiste uma instância de um modelo no banco de dados, o MongoDB adiciona automaticamente um campo _id que tem um valor único, mesmo que você não defina explicitamente esse campo em seu modelo.

Para saber mais sobre este campo, consulte a referência ObjectId no manual do servidor.

Informações adicionais

Para saber mais sobre os tipos de campo que você pode usar nos modelos Mongoid, consulte o guiade tipos de campo.

Para saber como acessar e alterar seus dados MongoDB , consulte os guias Interagir com dados.

Para saber mais sobre como modelar seus dados usando modelos Mongoid, consulte os guias Modele seus dados.

Voltar

Modele seus dados

Tipos de campo