класс ActiveSupport::Deprecation::DeprecatedConstantProxy

Родитель:: Модуль

DeprecatedConstantProxy преобразует константу в устаревшую. Он принимает имена старой (устаревшей) константы и новой константы (оба в строковом формате) и необязательно указатель на устаревание. Указатель на устаревание по умолчанию ActiveSupport::Deprecator если он не указан. Теперь устаревшая константа возвращает значение новой.

PLANETS = %w(mercury venus earth mars jupiter saturn uranus neptune pluto)

# (In a later update, the original implementation of `PLANETS` has been removed.)

PLANETS_POST_2006 = %w(mercury venus earth mars jupiter saturn uranus neptune)
PLANETS = ActiveSupport::Deprecation::DeprecatedConstantProxy.new('PLANETS', 'PLANETS_POST_2006')

PLANETS.map { |planet| planet.capitalize }
# => DEPRECATION WARNING: PLANETS is deprecated! Use PLANETS_POST_2006 instead.
     (Backtrace information…)
     ["Mercury", "Venus", "Earth", "Mars", "Jupiter", "Saturn", "Uranus", "Neptune"]

Публичные методы класса

new(*args, &block) Показать исходный код

# File activesupport/lib/active_support/deprecation/proxy_wrappers.rb, line 124
def self.new(*args, &block)
  object = args.first

  return object unless object
  super
end

Вызывает метод суперкласса

new(old_const, new_const, deprecator = ActiveSupport::Deprecation.instance, message: " Показать исходный код

# File activesupport/lib/active_support/deprecation/proxy_wrappers.rb, line 131
def initialize(old_const, new_const, deprecator = ActiveSupport::Deprecation.instance, message: "#{old_const} is deprecated! Use #{new_const} instead.")
  require "active_support/inflector/methods"

  @old_const = old_const
  @new_const = new_const
  @deprecator = deprecator
  @message = message
end

Публичные методы экземпляра

class() Показать исходный код

# File activesupport/lib/active_support/deprecation/proxy_wrappers.rb, line 153
def class
  target.class
end

Возвращает класс новой константы.

PLANETS_POST_2006 = %w(mercury venus earth mars jupiter saturn uranus neptune)
PLANETS = ActiveSupport::Deprecation::DeprecatedConstantProxy.new('PLANETS', 'PLANETS_POST_2006')
PLANETS.class # => Array

inspect() Показать исходный код

# File activesupport/lib/active_support/deprecation/proxy_wrappers.rb, line 144
def inspect
  target.inspect
end

Не выводить предупреждение об устаревании при inspect, так как test/unit и журналы ошибок полагаются на него для диагностики.