封装对象

Question

什么是包对象，与其说是概念，不如说是它们的用法？

我试图让一个示例工作，我工作的唯一形式如下：

package object investigations {
    val PackageObjectVal = "A package object val"
}

package investigations {

    object PackageObjectTest {
        def main(args: Array[String]) {
            println("Referencing a package object val: " + PackageObjectVal)
        }
    }
}

到目前为止我所做的观察是：

package object _root_ { ... }

是不允许的（这是合理的），

package object x.y { ... }

也是不允许的。

看来包对象必须在直接父包中声明，如果按照上面的方式编写，则需要大括号分隔的包声明形式。

它们常用吗？如果是这样，怎么办？

Answer 1

通常，您会将包对象放在与其对应的包中名为 package.scala 的单独文件中。您还可以使用嵌套包语法，但这很不寻常。

包对象的主要用例是当您使用包定义的 API 时，需要在包内部以及包外部的各个位置进行定义。下面是一个示例：

// file: foo/bar/package.scala

package foo

package object bar {

  // package wide constants:
  def BarVersionString = "1.0"

  // or type aliases
  type StringMap[+T] = Map[String,T]

  // can be used to emulate a package wide import
  // especially useful when wrapping a Java API
  type DateTime = org.joda.time.DateTime

  type JList[T] = java.util.List[T]

  // Define implicits needed to effectively use your API:
  implicit def a2b(a: A): B = // ...

}

现在，该包对象内的定义在整个包 foo.bar 中都可用。此外，当该包之外的人导入 foo.bar._ 时，定义也会被导入。

通过这种方式，您可以防止要求 API 客户端发出额外的导入来有效地使用您的库 - 例如，在 scala-swing 中，您需要编写

import swing._
import Swing._

才能拥有 onEDT 等所有优点以及来自 的隐式转换Tuple2 到 Dimension。

Answer 2

虽然莫里茨的答案是正确的，但需要注意的另一件事是包对象是对象。除此之外，这意味着您可以使用混合继承从特征构建它们。 Moritz 的示例可以写为

package object bar extends Versioning 
                          with JodaAliases 
                          with JavaAliases {

  // package wide constants:
  override val version = "1.0"

  // or type aliases
  type StringMap[+T] = Map[String,T]

  // Define implicits needed to effectively use your API:
  implicit def a2b(a: A): B = // ...

}

此处版本控制是一个抽象特征，它表示包对象必须具有“版本”方法，而 JodaAliases 和 JavaAliases 是包含方便的类型别名的具体特征。所有这些特征都可以被许多不同的包对象重用。

Answer 3

你可能会做比直接找到源头更糟糕的事情。 :)

https://lampsvn.epfl .ch/trac/scala/browser/scala/trunk/src/library/scala/package.scala

https://lampsvn.epfl.ch/trac/scala/browser/scala/trunk/src/library/scala/collection/immutable /package.scala

Answer 4

包对象的主要用例是当您使用包定义的 API 时，需要在包内部以及包外部的各个位置进行定义。

但 Scala 3 则不然，计划于 2020 年中期发布，基于 多蒂，如在这里：

顶级定义

各种定义都可以写在顶层。
不再需要包对象，将逐步淘汰。

package p 

type Labelled[T] = (String, T) 
val a: Labelled[Int] = ("count", 1) 
def b = a._2 
def hello(name: String) = println(i"hello, $name)