多虚拟机测试

支持同时在多个 JVM 中运行应用程序（具有main方法的对象）和ScalaTest测试。对于多个系统相互通信的集成测试很有用。

安装程序

多 JVM 测试是一个sbt插件，可以在 https://github.com/sbt/sbt-multi-jvm 中找到。要在项目中配置它，应执行以下步骤：

  1. 将它作为插件添加到你的project/plugins.sbt中：
  1. addSbtPlugin("com.typesafe.sbt" % "sbt-multi-jvm" % "0.4.0")
  1. 通过启用MultiJvmPlugin并设置MultiJvm配置，将多 JVM 测试添加到build.sbt 或project/Build.scala。
  1. lazy val root = (project in file("."))
  2.   .enablePlugins(MultiJvmPlugin)
  3.   .configs(MultiJvm)

请注意，默认情况下，MultiJvm测试源位于src/multi-jvm/...，而不是位于src/test/....。

下面是一个使用sbt-multi-jvm插件的「示例项目」。

运行测试

多 JVM 任务类似于常规任务：test、testOnly和run，但在多 JVM 配置下。

因此，在 Akka 中，要运行akka-remote项目使用中的所有多 JVM 测试（在sbt提示下）：

  1. akka-remote-tests/multi-jvm:test

或者可以先切换到akka-remote-tests项目，然后运行测试：

  1. project akka-remote-tests
  2. multi-jvm:test

要运行单个测试，请使用testOnly：

  1. multi-jvm:testOnly akka.remote.RandomRoutedRemoteActor

可以列出多个测试名称以运行多个特定测试。sbt中的制表符使完成测试名称变得容易。

也可以使用testOnly指定 JVM 选项，方法是在测试名称和--之后包含这些选项。例如：

  1. multi-jvm:testOnly akka.remote.RandomRoutedRemoteActor -- -Dsome.option=something

创建应用程序测试

通过命名约定，可以发现并组合这些测试。MultiJvm测试源位于src/multi-jvm/...。使用以下模式命名测试：

  1. {TestName}MultiJvm{NodeName}

也就是说，每个测试的名称中间都有MultiJvm。前面的部分将测试/应用程序分组在一起，使用一个将一起运行的TestName。后面的部分NodeName是每个分叉的 JVM 的一个区别名称。

因此，要创建一个名为Sample的 3 节点测试，可以创建三个应用程序，如下所示：

  1. package sample
  3. object SampleMultiJvmNode1 {
  4.   def main(args: Array[String]) {
  5.     println("Hello from node 1")
  6.   }
  7. }
  9. object SampleMultiJvmNode2 {
  10.   def main(args: Array[String]) {
  11.     println("Hello from node 2")
  12.   }
  13. }
  15. object SampleMultiJvmNode3 {
  16.   def main(args: Array[String]) {
  17.     println("Hello from node 3")
  18.   }
  19. }

当你在sbt提示下调用multi-jvm:run sample.Sample时，将生成三个 JVM，每个节点一个。它看起来像这样：

  1. > multi-jvm:run sample.Sample
  2. ...
  3. [info] * sample.Sample
  4. [JVM-1] Hello from node 1
  5. [JVM-2] Hello from node 2
  6. [JVM-3] Hello from node 3
  7. [success] Total time: ...

更改默认值

你可以为分叉（forked）的 JVM 指定 JVM 选项：

  1. jvmOptions in MultiJvm := Seq("-Xmx256M")

你可以通过向项目中添加以下配置来更改多 JVM 测试源目录的名称：

  1. unmanagedSourceDirectories in MultiJvm :=
  2.    Seq(baseDirectory(_ / "src/some_directory_here")).join.value

你可以更改MultiJvm标识符。例如，要将其更改为ClusterTest，请使用multiJvmMarker设置：

  1. multiJvmMarker in MultiJvm := "ClusterTest"

你的测试现在应该命名为{TestName}ClusterTest{NodeName}。

JVM 实例的配置

你可以为每个生成的 JVM 定义特定的 JVM 选项。通过在测试中创建一个后缀为.opts的文件，并将其放在与测试相同的目录中，可以做到这一点。

例如，要将 JVM 选项-Dakka.remote.port=9991和-Xmx256m送到SampleMultiJvmNode1，让我们创建三个*.opts文件并将这些选项添加到它们中。用空格分隔多个选项。

  • SampleMultiJvmNode1.opts：
  1. -Dakka.remote.port=9991 -Xmx256m
  • SampleMultiJvmNode2.opts：
  1. -Dakka.remote.port=9992 -Xmx256m
  • SampleMultiJvmNode3.opts：
  1. -Dakka.remote.port=9993 -Xmx256m

ScalaTest

还支持创建ScalaTest测试，而不是应用程序。要做到这一点，请使用与上面相同的命名约定，但要使用main方法创建ScalaTest套件，而不是对象。你需要在classpath上有ScalaTest。这里有一个类似于上面的例子，但是使用ScalaTest：

  1. package sample
  3. import org.scalatest.WordSpec
  4. import org.scalatest.matchers.MustMatchers
  6. class SpecMultiJvmNode1 extends WordSpec with MustMatchers {
  7.   "A node" should {
  8.     "be able to say hello" in {
  9.       val message = "Hello from node 1"
  10.       message must be("Hello from node 1")
  11.     }
  12.   }
  13. }
  15. class SpecMultiJvmNode2 extends WordSpec with MustMatchers {
  16.   "A node" should {
  17.     "be able to say hello" in {
  18.       val message = "Hello from node 2"
  19.       message must be("Hello from node 2")
  20.     }
  21.   }
  22. }

为了运行这些测试，你可以在sbt提示下调用multi-jvm:testOnly sample.Spec。

多节点添加

还对SbtMultiJvm插件进行了一些添加，以适应「可能更改」模块的「多节点测试」，如该部分所述。

英文原文链接：Multi JVM Testing.