Configuración de persistencia

Opciones de persistencia a nivel de modelo

Supongamos que quieres almacenar los documentos de tu modelo en una colección con un nombre diferente al pluralizado del nombre de la clase del modelo. Se puede usar la macro store_in para cambiar la colección, base de datos o cliente donde Mongoid almacena los documentos de un modelo. El siguiente ejemplo muestra cómo utilizar 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ías querer utilizar este patrón en una aplicación multiusuario, donde varios usuarios comparten acceso común a una aplicación. Mediante el uso de una lambda, puedes definir un contexto de persistencia basado en información que sea local para el hilo actual, de modo que los usuarios no puedan acceder a los datos de otros.

El siguiente ejemplo almacena los documentos en una base de datos determinada por una variable local para subprocesos:

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

Opciones de persistencia en tiempo de ejecución

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

Llama al método with en una clase de modelo o una instancia y pasa opciones que definan el contexto de persistencia. Puedes llamar al método with de dos formas:

• 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, utiliza un bloque para definir las operaciones que deseas ejecutar en el contexto especificado. El contexto que defines únicamente existe mientras el código en el bloque se ejecuta.

Por defecto, Mongoid almacena los documentos para 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 puedes pasar las opciones de configuración del método with para las operaciones de lectura o escritura. Las configuraciones solo se aplican 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. Luego utiliza el método with en el cliente para guardar en la base de datos music, estableciendo la opción de guardar w en 0 para que no requiera el acuse de recibo de guardar.

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

collection.with

Puedes anular las opciones :read y :write en una colección utilizando el método with. El siguiente ejemplo muestra cómo utilizar 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