Configuração de persistência

Opções de persistência em nível de modelo

Suponha que você queira armazenar os documentos do seu modelo em uma coleção com um nome diferente da forma pluralizada do nome da classe do modelo. Você pode usar a macro store_in para alterar a coleção, banco de dados ou cliente onde o Mongoid armazena os documentos de um modelo. O exemplo a seguir mostra como usar a macro store_in para armazenar documentos da classe Person em uma coleção chamada citizens no banco de dados other em um cliente chamado analytics:

class Person
  include Mongoid::Document
  store_in collection: "citizens", database: "other", client: "analytics"
end

A macro store_in também pode aceitar uma função Lambda. Isso é útil se você quiser definir um contexto de persistência com valores que não podem usar uma string constante.

Talvez você queira usar esse padrão em um aplicação multilocatário, em que vários usuários compartilham acesso comum a um aplicação. Ao usar um Lambda, você pode definir um contexto de persistência com base em informações locais do thread atual para que os usuários não possam acessar os dados uns dos outros.

O exemplo a seguir armazena documentos em um banco de dados determinado por uma variável thread-local:

class Band
  include Mongoid::Document
  store_in database: ->{ Thread.current[:database] }
end

Opções de persistência de tempo de execução

Você pode usar o método with em uma classe ou instância de modelo para alterar a configuração de persistência de um modelo para um grupo de operações durante o tempo de execução.

Chame o método with em uma classe ou instância de modelo e passe opções que definem um contexto de persistência. Você pode chamar o método with de duas maneiras:

• with(context, options): context é uma instância de Mongoid::PersistenceContext e options é um Hash que representa um conjunto personalizável de opções.

• with(options): options é um Hash que representa um conjunto personalizável de opções.

Em seguida, utilize um bloco para definir as operações que deseja executar no contexto especificado. O contexto que você define existe somente enquanto o código no bloco é executado.

Por padrão, o Mongoid armazena documentos para a classe Band em uma coleção chamada bands. O exemplo de código a seguir usa o método with para usar temporariamente um cliente, um banco de dados e uma coleção diferentes para executar operações nos documentos da classe Band:

class Band
  include Mongoid::Document
  field :name, type: String
  field :likes, type: Integer
end
# Creates document in 'bands' collection in 'music-non-stop' database within
# default cluster
Band.with(database: "music-non-stop") do |band_class|
  band_class.create(name: "Medusa and the Polyps")
end
# Deletes all documents in 'artists' collection within default database
Band.with(collection: "artists") do |band_class|
  band_class.delete_all
end
band = Band.new(name: "Japanese Breakfast")
# Perform operations on tertiary cluster
band.with(client: :tertiary) do |band_object|
  band_object.save!
    
  band.save!
end

Você também pode passar as opções de configuração do método with para operações de leitura ou escrita. As configurações se aplicam apenas ao tipo de operação especificado.

O exemplo a seguir usa o método with para especificar o uso do nó secundário para todas as operações de leitura dentro do bloco.

Band.with(read: {mode: :secondary}) do
  Band.count
  # This write operation runs in the 
  # new persistence context, but is 
  # not affected by the read preference.
  Band.create(name: "Metallica")
end

class BandsController < ApplicationController
  before_action :switch_database
  after_action :reset_database
  private
  def switch_database
    I18n.locale = params[:locale] || I18n.default_locale
    Mongoid.override_database("my_db_name_#{I18n.locale}")
  end
  def reset_database
    Mongoid.override_database(nil)
  end
end

mongo_client.with

O exemplo de código a seguir acessa o cliente usado pela classe de modelo Band . Em seguida, ele usa o método with no cliente para escrever no banco de dados music , definindo a opção de gravação w como 0 para não exigir confirmação de gravação.

Band.mongo_client.with(write: { w: 0 }, database: "music") do |client|
  client[:artists].find(...)
end

collection.with

Você pode substituir as opções :read e :write em uma coleção utilizando o método with. O exemplo a seguir mostra como usar o método with para definir a opção de gravação w como 0:

Band.collection.with(write: { w: 0 }) do |collection|
  collection[:artists].find(...)
end