Scala 对特征的命名约定

Question

假设我在 Scala 中有一个 trait

trait Connection {

  def init(name: String)
  def dispose
}

我想创建一个实现它的类。但我也想将其命名为Connection：

class Connection extends Connection {
  // ....
 }

这是行不通的。当然，我可以将trait 命名为不同的名称，但事实证明，Scala 中的命名约定说我应该将 trait 命名为普通类，这意味着没有任何前缀，我将在 C# 中使用它（IConnection where @987654327 @ 将是 interface)。

在这种特殊情况下，class 和 trait 的名称为 Connection 更合适。

还是我错过了 Scala 命名约定中的某些内容？

Answer 1

您将通用 API 提取到 Connection 特征中的事实本身意味着它将具有多个特定实现。这些实现当然会与一些更具体的实体相关，例如MySQL 或 H2 数据库。

根据您选择的应用架构，有几种方法可以解决您的问题：

1. 如果你将特定的实现保留在你得到的同一个命名空间中：

   • myApp.Connection

   • myApp.MySqlConnection

   • myApp.H2Connection

2. 但由于名称冗余（*Connection 部分），实际上不鼓励上述内容，建议引入新包，例如：

   • myApp.Connection

   • myApp.connections.MySql

   • myApp.connections.H2

   或

   • myApp.Connection

   • myApp.Connection.MySql

   • myApp.Connection.H2

   如果您选择将特定实现放在Connection 的伴随对象中。

3. 在更高级的架构方法中，您最终会得到具有私有包的特定实现：

   • myApp.Connection

   • myApp.mySql.Connection

   • myApp.h2.Connection

   即使在这里，尽管 Connection 名称冲突，但由于类型位于不同的包中，使用限定引用 (myApp.Connection) 或限定导入很容易解决：

   import myApp.{Connection => GeneralConnection} //or IConnection if you insist
   

Answer 2

这不是约定，但 scala.collection 中使用的东西是后缀 Like 用于特征：

• SeqLike：Seq[A] 类型序列的模板特征。
• MapLike：映射的模板特征，它将键与值相关联。

等等。

我猜这是他们说 Rectangle/Rectangular 的方式，其中这种关系 (Seq/SeqLike) 没有明确的命名。

Answer 3

在 Martin Odersky 的书中有一个示例，其中包含扩展特征 Rectangular 的类 Rectangle 和扩展特征 Ordered 的类 Rational。所以这里的模式似乎是对特征名称使用形容词，对类名称使用主题。因此，在您的情况下，它将是“类连接扩展连接”。至少我比“class ConnectionImpl extends Connection”更喜欢这个。

Answer 4

命名实现某些接口/特征的类的常见做法是将Impl添加为后缀（并且不要向接口/特征添加任何前缀/后缀）：

class ConnectionImpl extends Connection {
  // ....
}

为什么？因为在良好的代码中你 write functions against interfaces，所以你不会用那些 I 来污染你的函数：

def sendThings(conn: Connection) {


}

对比

def sendThings(conn: IConnection) {


}

如果你有多个实现，这当然应该是Connection trait、HttpConnection class1、JdbcConnection class2。