《Effective Ruby:改善Ruby程序的48条建议》一第11条:通过在模块中嵌入代码来创建命名空间

简介:

本节书摘来自华章出版社《Effective Ruby:改善Ruby程序的48条建议》一书中的第2章,第2.6节,作者 [美]彼得 J.琼斯(Peter J. Jones),更多章节内容可以访问云栖社区“华章计算机”公众号查看

第11条:通过在模块中嵌入代码来创建命名空间

假设你正在做一个订购个性化笔记本(那种过时的纸质笔记本)的应用程序。客户能够在众多装订方式中选择,如使用金属钉针装订或使用传统的胶水装订。你决定创建一个类来表示装订类型,并将其他参数一同放在里面。然而很遗憾,事情并非计划的那样。下面的类定义有什么问题呢?
image

乍一看,似乎什么都是对的。这是没有语法错误的,但如果你在IRB中运行这个类,你会看到还真有点问题。当你执行这段代码来创建新的对象时,你会发现事实和预期不同。然而如果这段代码不是在定义一个类那它又做了些什么呢?这是个值得思考的问题。
如你所知,Ruby中的类是可变的——你能在任何时间增加和替换方法。创建类的语法和修改类是相同的。在本例中,你想创建的类的名字恰好已经被创建过了。Binding是Ruby核心类库中的一个类。上面的代码不是定义一个新类,而是打开了本就存在的Binding类并修改了它。与你想的显然不同。
任何卓越的软件早晚都会在运行中遇到问题。尤其是对库的作者来说。如果多个库中存在相同名字的类会发生什么呢?你如何同时使用两个这样的库呢?还好,几乎所有现代的通用语言都有解决这个问题的方式,包括Ruby。Ruby通过命名空间的作用域将名字进行分隔。
命名空间是一种保证常量唯一性的方式。其最基本的功能是创建作用域从而定义互不冲突的常量。由于类和模块的名字都是常量,因此命名空间能用来很好地隔离它们。
所有的核心Ruby类都存在于被称为“全局”的命名空间内。我们之后再说它的含义,现在只要知道这些名字代表的每个类都无需使用限定符即可使用就可以了。换句话说,如果你启动IRB并键入Array,意味着“类Array是在全局命名空间里的”。当你不加命名空间地定义类时,这个类就被放在了全局命名空间里。同时存在与已有名字发生冲突的风险。
创建一个新类并将其置于自定义命名空间是非常简单的,只要将类定义嵌入在一个模块中即可。
image

把类定义嵌入模块中使Binding类和核心类区别开来,就避免了同名造成的困扰。引用新类你需要引用模块名并使用“类路径分隔符”,也就是两个冒号:
image

使用模块创建命名空间不仅限于保护类,该技术也可以用来把其他常量和模块方法放入命名空间。你还能将模块嵌入其他模块中来创建任意深的命名空间。这在大型应用程序和库中作为代码隔离和模块化的一种方式。
使用命名空间时,常用的实践是在项目的文件系统上使用和命名空间一样的目录结构。比如,上述类的定义应该能在notebooks文件夹下的bindings.rb文件中找到。换句话说,名字Notebooks::Bindings映射着文件notebooks/bindings.rb。
有时在模块中的嵌入类非常烦琐并会导致不必要的缩进。存在一个替代语法可以在命名空间里创建类。但它仅在命名空间已经存在时有效,即如果用来创建命名空间的模块已经在前面定义过,那么你可以在类定义中直接使用模块名和类路径分隔符。
image

这种语法的类定义的典型应用场景是,你先在入口源文件中定义了命名空间模块,随后加载所有剩下的源文件。但是要小心,在没有预先定义命名空间时就尝试使用这种语法会导致一个NameError异常。Ruby如果找不到引用的常量就会引发这个异常。将常量嵌套在另一个常量中会为你在程序中如何限定常量带来一点复杂性,不过如果明白了Ruby如何搜索它们,就不会有这样的疑虑了。
Ruby使用两种技术寻找常量。第一种是,检查当前词法作用域和所有闭包词法作用域。(我们将在稍后探索词法作用域。)如果无法找到这个常量,Ruby将循着继承体系继续寻找。这就是为什么你可以在子类中使用父类定义的常量。如我们将要看到的,这也是为什么我们可以使用所谓的“全局”常量。
谈到命名空间,我们最关心的就是词法作用域,表示实际定义或引用常量的位置。看代码显然比读这些文字容易些,那么请看:
image

模块定义中创建了一个词法作用域。由于常量KEY和类Encrypt都定义在同一个词法作用域中,所以initialize方法能够在不加限定符(使用常量全路径)的情况下就使用常量KEY。明白词法作用域不同于模块创建的命名空间这一点非常重要。它与常量定义和使用的物理位置有关。如果我们稍做改变,你就可以看出其区别:
image

这一次命名空间和词法作用域都使用模块来定义,不过它们都在创建完常量KEY之后立即关闭了。类定义在正确的命名空间里,只是它并没有和KEY共享同一个词法作用域,因此不能不加限定符就使用它。因为Ruby在词法作用域或其继承体系中无法找到常量KEY,所以这段代码会引发NameError异常。修复这个问题很简单,只要引用常量时加上限定符即可:
image
这看起来有点古怪,不过它就是这么运行的。还有更奇怪的呢,既然常量已经加上了限定符,它却是在继承体系中被找到的而非词法作用域。常量SuperDumbCrypto可以被看作全局常量,但当它出现时,Ruby还没有全局命名空间。这时所有顶级常量都被存在Object类中。由于Ruby中几乎所有的东西都继承自Object,因此可以通过继承体系找到所有顶级常量。这就解释了为什么Ruby会在两个地方寻找它们:当前的词法作用域以及继承体系。
当使用命名空间时还有最后一处可能遇到的坑,如下代码所示:
image

上面的代码定义了Cluster::Array类,它需要用到顶级类Array。根据常量的检索规则,当前上下文中没有限定符的常量Array表示类Cluster::Array,而这并不是我们期望的。解决方法是:为常量Array加上限定符。由于这是顶级常量,我们知道它们被存储在类Object中,因此限定符常量的名字将是Object::Array。这看起来有点怪,因此Ruby允许我们简写为::Array。下面的代码就是我们想要的:
image

命名空间虽然增加了些许复杂性(对于不加限定符的常量)但这个特性是值得的。任何卓越的Ruby项目都必然会使用它,尤其是被打成gem包的库。我们预期这类库会把它们的常量放在和库名相匹配的命名空间里。通过创建和使用命名空间,能够和其他程序友好相处。
要点回顾
通过在模块中嵌入代码来创建命名空间。
让你的命名空间结构和目录结构相同。
如果使用时可能出现歧义,可使用“::”来限定顶级常量(比如,::Array)。

相关文章
|
7月前
|
Ruby
|
算法 测试技术 API
如何用Ruby语言提高代码的可读性和可维护性
在软件开发过程中,代码的可读性和可维护性是非常重要的因素。一旦代码变得难以理解和修改,就会导致开发速度变慢、bug增多以及团队合作效率下降。在本篇博客中,我们将探讨一些使用Ruby编程语言的技巧和最佳实践,以提高代码的可读性和可维护性。
92 1
|
7月前
|
JSON 监控 数据可视化
局域网管理软件的Ruby代码实践
使用Ruby进行局域网管理的实践,包括安装`net-ping`库进行设备扫描、利用`packetgen`监控流量、执行文件备份自动化任务和数据可视化,以及通过HTTP提交数据。示例代码展示了Ruby在局域网管理中的灵活性和效率。
306 5
|
4月前
|
开发者 数据库 虚拟化
Xamarin 应用性能优化策略大揭秘,从代码到界面再到数据访问,全面提升应用性能,快来围观!
【8月更文挑战第31天】在 Xamarin 跨平台移动应用开发中,性能优化至关重要。代码优化是基础,应避免不必要的计算与内存分配,如减少循环中的对象创建及合理使用数据结构。界面设计上需注意简化布局、减少特效并启用虚拟化以提升响应速度。数据访问方面,优化数据库查询和网络请求可显著改善性能。Xamarin Profiler 等工具还可帮助开发者实时监控并优化应用表现,从而打造流畅高效的用户体验。
55 0
|
4月前
|
开发者 UED Ruby
Ruby中的异常处理之谜:如何用异常与rescue让你的代码坚不可摧?
【8月更文挑战第31天】在软件开发中,错误处理对应用稳定性至关重要。作为动态、面向对象的语言,Ruby提供了丰富的错误处理机制,如异常与rescue。本文通过示例代码介绍了Ruby中的异常类型、异常链及rescue与else的使用,展示了如何优雅地处理各种错误情况,增强了程序的健壮性和用户体验。使用这些机制,开发者能更精准地识别并解决运行时问题,提升应用质量。随着Ruby生态的发展,错误处理的重要性将愈发凸显。
54 0
|
4月前
|
开发者 Ruby
神秘编程魔法惊现!Ruby 元编程究竟隐藏着怎样的力量?竟能让代码自我进化!
【8月更文挑战第31天】《Ruby元编程:让代码自我进化》介绍了Ruby元编程的魅力,通过动态修改代码结构和行为,实现代码自我进化。文章通过实例展示了如何使用`class_eval`动态添加属性和方法,以及通过别名修改现有方法。此外,还介绍了利用模块实现代码复用和扩展。元编程为开发者提供了极大的灵活性和创造力,使代码更加动态高效。
29 0
|
4月前
|
Ruby
Ruby游戏开发揭秘:如何用简单的代码构建你的第一个猜数字游戏?
【8月更文挑战第31天】在编程学习之旅中,开发简易游戏是理解基础概念如控制流程、输入输出及数据结构的好方法。本指南将带你从零开始,用 Ruby 构建一个猜数字游戏。游戏设计为让玩家猜一个 1-100 间的随机数。文中详细介绍了所需环境的搭建过程、代码编写步骤,包括初始化游戏、处理猜测、读取输入和启动游戏循环的核心逻辑。完成这些后,你不仅能拥有一个功能完备的游戏,还将掌握 Ruby 的基本语法与特性,为进一步探索编程世界打下坚实的基础。
41 0
|
4月前
|
测试技术 开发者 Ruby
Ruby领域特定语言(DSL)的神秘力量:如何让你的代码飞起来?
【8月更文挑战第31天】在软件开发领域,Ruby以简洁的语法和强大的表达能力著称,但面对复杂业务逻辑时,代码可能变得冗长难维护。此时,领域特定语言(DSL)成为解决问题的有效途径。DSL专为特定领域设计,使代码更贴近业务逻辑,提高可读性和可维护性。本文通过示例展示了如何在Ruby中开发DSL,包括使用解析器和宏功能创建一个简单的Web应用结构描述语言,并提出了定义清晰语法、避免滥用DSL等最佳实践,强调了测试与文档的重要性。
77 0
|
7月前
|
存储 JavaScript 编译器
这款国产中文编程火了!通过文言文编译生成Python、JS、Ruby代码!
这款国产中文编程火了!通过文言文编译生成Python、JS、Ruby代码!
260 0
|
7月前
|
Ruby
下一篇
无影云桌面