20

从事最初的 Rails 项目，并使用Rubocop分析代码风格。这让我开始质疑 Ruby 的嵌套类在 Rails 上下文中是如何工作的。例如，在我的引擎中，我有一个模型：

# app/models/app_core/tenant.rb
module AppCore
  class Tenant < ActiveRecord::Base
  end
end

和一个控制器：

# app/controllers/app_core/tenant/members_controller.rb
module AppCore
  class Tenant::MembersController < ApplicationController
  end
end

在模型的情况下，模块与路径相同，类名与文件名相同。在控制器的情况下，路径的第二部分“租户”是类名的一部分。

Rubocop 告诉我应该在该Tenant::MembersController行中“使用嵌套类定义而不是紧凑样式”，所以如果我理解正确......

module AppCore  
  class Tenant
    class MembersController < ApplicationController
    end
  end
end

...这不应该有所作为。

现在，我的问题是我将 AppCore::Tenant 作为模型，但随后 AppCore::Tenant 看起来被重新打开，并且 MembersController 类作为嵌套类添加到其中。这是否意味着我的租户类将始终包含该嵌套类？我是否需要以不同的方式命名我的模型和控制器路由？这完全没问题，没有什么可担心的吗？不完全确定这意味着什么。

4

3 回答 3

24

一个细微的区别是您的范围不同，这可能会导致错误。在第一种情况下，将在 中查找常量AppCore，而在第二种情况下，将在 中查找常量AppCore::Tenant。如果您完全限定常量名称，那么它没有任何区别。

Foo = :problem

module A
  Foo = 42

  # looks up A::Foo because of lexical scope
  module B
    def self.foo
      Foo
    end
  end
end

# looks up ::Foo because of lexical scope
module A::C
  def self.foo
    Foo
  end
end

# Looks up A::Foo, fully qualified ... ok technically ::A::Foo is fully qualified, but meh.
module A::D
  def self.foo
    A::Foo
  end
end

A::B.foo # => 42
A::C.foo # => :problem
A::D.foo # => 42

如果您指的是AppCore::Tenant从内部定义的常量，MembersController那么它可能会对您产生影响。微妙但可能很重要，并且需要注意。当我有一个Util带有子模块的模块时，我在现实生活中遇到了这个问题String。我将一个方法移入Util其中，但它中断了，因为String在该方法内部现在称为Util::String. 之后我更改了一些命名约定。

您的Tenant模块将始终MembersController作为嵌套类。您可以参考代码库中的任何其他地方AppCore::Tenant::MembersController。如果您想要更好的分离，那么您应该以不同的方式命名您的模型类，或者将它们放在诸如AppCore::Model或类似的模块中。如果您使用 Rails，您将不得不打破一些约定，但所需的配置并不算太糟糕。

于 2014-06-24T17:47:32.817 回答
0

我知道您在询问技术细节，Sami 已经回答了这个问题。但我忍不住要问：

首先，您是否有特定的原因要...

  1. ...引入类似层次结构的“路径”？
  2. ...将控制器放在模型类中？

如果我觉得需要 1)，我可能会有简单的“容器”模块来呼应真实路径。也就是说，app/model/tenant.rb=>Model::Tenant和app/controller/members_controller.rb=> Controller::MembersController。

但坦率地说，我真的看不出它背后的原因。控制器已经很容易被XyzController约定发现。模型（大多数时候，我猜）很容易被它们的领域性质所识别。由于 ruby​​ 不需要甚至不建议将路径名与类名匹配（例如，与 Java 不同），一个清晰的 1 级命名约定对我来说会更有用。

子模块/子类层次结构对于 gem来说非常有用，或者说是必需的，它们的功能类似于命名空间以避免冲突。

2）（模型内的控制器）从根本上是错误的。控制器与模型非常不同，当然也不存在于其中。

于 2016-01-14T20:24:41.890 回答
0

如果您正在使用嵌套并想返回到顶级命名空间，您可以使用::.

def class user < ActiveRecord::Base 
   NAME = "Real User"
end

module SomeModule
    def class User 
       Name = "Fake User"
    end 
    module InnerModule
        class MyClass
            puts User.NAME # "Fake User"
            puts ::User.Name # "Real User" 
        end
    end
end
于 2017-08-02T18:15:59.197 回答