跳至內容 跳至搜尋

DeprecatedConstantProxy 將常數轉換為已棄用常數。它會取得舊（已棄用）常數和新常數的完整名稱（皆為字串形式）以及棄用器。已棄用的常數現在會傳回新常數的值。

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", ActiveSupport::Deprecation.new)

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"]
方法
A
C
E
I
N
P

類別公開方法

new(*args, **options, &block)

來源：顯示 | 在 GitHub 上 

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

  return object unless object
  super
end

new(old_const, new_const, deprecator = nil, message: "#{old_const} is deprecated! Use #{new_const} instead.")

來源：顯示 | 在 GitHub 上 

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

  @old_const = old_const
  @new_const = new_const
  ActiveSupport.deprecator.warn("DeprecatedConstantProxy without a deprecator is deprecated") unless deprecator
  @deprecator = deprecator || ActiveSupport::Deprecation._instance
  @message = message
end

執行個體公開方法

append_features(base)

來源：顯示 | 在 GitHub 上 

# File activesupport/lib/active_support/deprecation/proxy_wrappers.rb, line 161
def append_features(base)
  @deprecator.warn(@message, caller_locations)
  base.include(target)
end

class()

傳回新常數的類別。

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

來源：顯示 | 在 GitHub 上 

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

extended(base)

來源：顯示 | 在 GitHub 上 

# File activesupport/lib/active_support/deprecation/proxy_wrappers.rb, line 171
def extended(base)
  @deprecator.warn(@message, caller_locations)
  base.extend(target)
end

inspect()

在 inspect 中不提供不建議使用的警告，因為 test/unit 和錯誤記錄依賴它進行診斷。

來源：顯示 | 在 GitHub 上 

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

prepend_features(base)

來源：顯示 | 在 GitHub 上 

# File activesupport/lib/active_support/deprecation/proxy_wrappers.rb, line 166
def prepend_features(base)
  @deprecator.warn(@message, caller_locations)
  base.prepend(target)
end