如何为组合集合定义LoneElement与Emptiness？兼顾封装性

这问题我之前也碰到过，ScalaTest确实没直接提供在伴生对象外定义自定义断言的“官方一键式”方法，但好在有几种优雅的内联实现方式，完全不用破坏封装，也不用改生产代码——核心思路就是把对Foo#foos的访问封装在测试专属的断言逻辑里，让测试代码不用直接触碰内部字段。

方法一：内联自定义Matcher（语义化最强） #

这种方式最贴合ScalaTest的风格，你可以在测试类里直接定义针对Foo的专属Matcher，既语义清晰，又完全封装了内部字段的访问：

import org.scalatest.matchers.must.Matchers
import org.scalatest.wordspec.AnyWordSpec

// 假设你的生产代码是这样（foos可以是私有或公有，这里用私有模拟严格封装）
case class Foo private (foos: List[String])
object Foo {
  def empty: Foo = Foo(Nil)
  def single(s: String): Foo = Foo(List(s))
}

class FooSpec extends AnyWordSpec with Matchers {

  // 内联定义针对Foo的空值断言Matcher
  private val beEmptyFoo: Matcher[Foo] = new Matcher[Foo] {
    override def apply(foo: Foo): MatchResult = MatchResult(
      foo.foos.isEmpty,
      s"预期Foo为空，但实际包含元素：${foo.foos}",
      "Foo为空，符合预期"
    )
  }

  // 内联定义针对Foo的单个元素断言Matcher
  private def haveLoneElement(expected: String): Matcher[Foo] = new Matcher[Foo] {
    override def apply(foo: Foo): MatchResult = MatchResult(
      foo.foos == List(expected),
      s"预期Foo仅包含元素'$expected'，但实际包含：${foo.foos}",
      s"Foo仅包含元素'$expected'，符合预期"
    )
  }

  "Foo" should {
    "通过empty方法创建时为空" in {
      Foo.empty must beEmptyFoo
    }

    "通过single方法创建时仅包含指定元素" in {
      Foo.single("hello") must haveLoneElement("hello")
    }
  }
}

如果觉得自定义Matcher有点繁琐，还可以用compose简化——直接复用ScalaTest已有的集合Matcher，把Foo转换成内部集合再断言：

private val beEmptyFoo = be(empty) compose { foo: Foo => foo.foos }
private def haveLoneElement(expected: String) = 
  (have(size(1)) and contain(expected)) compose { foo: Foo => foo.foos }

方法二：测试内联隐式转换（最简洁） #

如果你想直接复用ScalaTest所有的集合断言，不想写自定义Matcher，可以在测试类里定义一个仅在测试生效的隐式转换，把Foo转换成它内部的集合：

import org.scalatest.matchers.must.Matchers
import org.scalatest.wordspec.AnyWordSpec

class FooSpec extends AnyWordSpec with Matchers {

  // 仅在当前测试类生效的隐式转换，封装对foos的访问
  implicit def fooToInnerCollection(foo: Foo): List[String] = foo.foos

  "Foo" should {
    "通过empty方法创建时为空" in {
      Foo.empty mustBe empty
    }

    "通过single方法创建时仅包含指定元素" in {
      Foo.single("world") must contain only "world"
    }
  }
}

这种方式的好处是零额外代码，直接用ScalaTest自带的empty、contain only等断言，完全不用关心Foo的内部结构——测试代码看起来就像直接对集合断言一样，但实际已经封装了内部字段的访问。

两种方式的选择 #

• 如果你追求测试代码的语义化（比如让断言读起来像自然语言），选自定义Matcher；
• 如果你想快速复用ScalaTest的所有集合断言，不想额外编写Matcher，选隐式转换。

两种方式都完全符合你的需求：不用修改生产代码，不破坏封装，而且都是在测试类内联实现。

内容的提问来源于stack exchange，提问作者erip