Configuración de persistencia

Opciones de persistencia a nivel de modelo

Supongamos que desea almacenar los documentos de su modelo en una colección con un nombre distinto al plural de la clase del modelo. Puede usar la macro store_in para cambiar la colección, la base de datos o el cliente donde Mongoid almacena los documentos de un modelo. El siguiente ejemplo muestra cómo usar la macro store_in para almacenar documentos de la clase Person en una colección llamada citizens en la base de datos other dentro de un cliente llamado analytics:

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

La macro store_in también puede aceptar una función lambda. Esto resulta útil si desea definir un contexto de persistencia con valores que no puedan usar una string constante.

Podría ser útil usar este patrón en una aplicación multiusuario, donde varios usuarios comparten acceso a una aplicación. Mediante una expresión lambda, se puede definir un contexto de persistencia basado en información local del hilo actual, de modo que los usuarios no puedan acceder a los datos de los demás.

El siguiente ejemplo almacena documentos en una base de datos determinada por una variable local del hilo:

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

Opciones de persistencia en tiempo de ejecución

Puede utilizar el método with en una clase o instancia de modelo para cambiar la configuración de persistencia de un modelo para un grupo de operaciones durante el tiempo de ejecución.

Invoque el método with en una clase o instancia de modelo y pase opciones que definan un contexto de persistencia. Puede invocar el método with de dos maneras:

• with(context, options): context es una instancia de Mongoid::PersistenceContext y options es un hash que representa un conjunto personalizable de opciones.

• with(options): options es un hash que representa un conjunto personalizable de opciones.

Luego, use un bloque para definir las operaciones que desea ejecutar en el contexto especificado. El contexto definido solo existe mientras se ejecuta el código del bloque.

De forma predeterminada, Mongoid almacena los documentos de la clase Band en una colección llamada bands. El siguiente ejemplo de código utiliza el método with para usar temporalmente un cliente, una base de datos y una colección diferentes para realizar operaciones en los documentos de la clase 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

También puede pasar las opciones de configuración del método with para operaciones de lectura o escritura. Las configuraciones se aplican únicamente al tipo de operación especificado.

El siguiente ejemplo utiliza el método with para especificar el uso del nodo secundario para todas las operaciones de lectura dentro del bloque.

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

El siguiente ejemplo de código accede al cliente utilizado por la clase de modelo Band. A continuación, utiliza el método with del cliente para escribir en la base de datos music, estableciendo la opción de escritura w en 0 para no requerir confirmación de escritura.

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

collection.with

Puede anular las opciones :read y :write en una colección mediante el método with. El siguiente ejemplo muestra cómo usar el método with para establecer la opción de escritura w en 0:

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