在Rails中弃用整个模型

Question

我正在从Rails 2.x到3.x重写/重构客户端的遗留应用程序.作为重构的一部分,我还想从我们的本地语言中的模型/方法转向纯粹的英语代码库.

这涉及为几乎每个功能编写新方法.我通过这样做解决方法:

def english_method
  # ...
end

def native_method
  warn 'DEPRECATED, please use #english_method'
  english_method
end

这适用于方法,并帮助我跟踪旧方法仍在使用的地方,而不会破坏任何代码.

然而,对于类(模型),我一直在做:

class NativeClass < EnglishClass
  # DEPRECATED, Please use EnglishClass
end

class EnglishClass
  # ...
end

这个"工作",无论什么时候NativeClass被调用,应用程序都会继续工作,但我没有在日志中收到任何消息,通知我应用程序的一部分仍在调用NativeClass.

如何确保每次"触摸" NativeClass实际上都会导致写入日志错误？

我试过(除了认为"可能这样有效"之外),这样做:

class NativeClass < EnglishClass
  -> { ActiveSupport::Deprecation.warn 'Native model is deprecated in favor of English' }
end

但那(显然？)没有用.我认为每次NativeClass调用lambda都会延迟加载,但是我对lambdas的理解仍然有些浅薄,所以我可能会在这里弄错.

有关如何弃用整个类并在触摸时向我的日志发送警告消息的任何线索？

其他"最佳实践"和/或弃用解决方案是受欢迎的,但我不确定它是否是SO的有效问题(我不想冒这个问题关闭这个问题的风险).

Answer 1

您最好单独弃用每个方法。这可以通过使用 Rails 的 deprecate 方法并向其传递您想要弃用的方法列表来轻松完成。类中定义的方法列表可通过将 false 传递给来获得public_instance_methods

class NativeClass < EnglishClass
  def method1
  end

  def method2
  end

  deprecate *public_instance_methods(false)
end

请注意，它需要在最后一个公共方法之后声明。