Módulo: Mongoid::Deprecable Private

Incluido en:
Mongoid
Definido en:
lib/mongoid/deprecable.rb

Overview

Este módulo forma parte de una API privada. Debe evitar su uso siempre que sea posible, ya que podría eliminarse o modificarse en el futuro.

Agrega la capacidad de declarar desusos específicos de Mongoid.

Colapso del resumen del método de instancia

Detalles del método de instancia

#deprecate(módulo_objetivo, *descriptores_del_método) ⇒ Objeto

Este método forma parte de una API privada. Debe evitarlo si es posible, ya que podría eliminarse o modificarse en el futuro.

Declara que los métodos están obsoletos.

Ejemplos:

Dejar obsoleto un método.

Mongoid.deprecate(Cat, :meow); Cat.new.meow
#=> Mongoid.logger.warn("meow is deprecated and will be removed from Mongoid 8.0")

Dejar obsoleto un método y declarar el método de reemplazo.

Mongoid.deprecate(Cat, meow: :speak); Cat.new.meow
#=> Mongoid.logger.warn("meow is deprecated and will be removed from Mongoid 8.0 (use speak instead)")

Desaprobar un método y dar instrucciones para reemplazarlo.

Mongoid.deprecate(Cat, meow: 'eat :catnip instead'); Cat.new.meow
#=> Mongoid.logger.warn("meow is deprecated and will be removed from Mongoid 8.0 (eat :catnip instead)")

Parámetros:

  • target_module (Módulo)

    El padre que contiene el método.

  • *descriptores_de_método ([ Símbolo | Hash<Símbolo, [ Símbolo | String ]> ]...)

    Los métodos para descontinuar, con instrucciones de reemplazo opcionales.



30
31
32
33
# Archivo 'lib/mongoid/deprecable.rb', línea 30

def desaprobar(target_module, *descriptores de método)
  @_deprecator ||= Mongoid::Obsolescencia.Nuevo
  @_deprecator.métodos obsoletos(target_module, *descriptores de método)
end