双重值的assertEquals的epsilon参数的含义

我有一个关于junit assertEquals来测试double值的问题。阅读API文档，我可以看到：

@Deprecated
public static void assertEquals(double expected, double actual)

不推荐使用。改用assertEquals（期望值翻倍，实际值翻倍，epsilon翻倍）

该epsilon值是什么意思？（Epsilon是希腊字母中的一个字母，对吗？）。

有人可以向我解释如何使用它吗？

Epsilon是两个数字可乘以的值。因此只要Math.abs(expected - actual) < epsilon

这是哪个版本的JUnit？我只看过delta，没看过epsilon-但这是附带问题！

从JUnit javadoc中：

delta-期望值与实际值之间的最大差额，对于这两个数字，仍然认为相等。

这可能有点过分，但是我通常使用很少的数字，例如

private static final double DELTA = 1e-15;

@Test
public void testDelta(){
    assertEquals(123.456, 123.456, DELTA);
}

如果您正在使用hamcrest断言，则可以只使用equalTo()带有两个双精度值的标准（它不使用增量）。但是，如果您想要一个增量，则可以使用closeTo()（请参阅javadoc），例如

private static final double DELTA = 1e-15;

@Test
public void testDelta(){
    assertThat(123.456, equalTo(123.456));
    assertThat(123.456, closeTo(123.456, DELTA));
}

仅供参考，即将来临的JUnit 5在两次加倍调用时也将使delta成为可选项assertEquals()。该实施（如果你有兴趣）为：

private static boolean doublesAreEqual(double value1, double value2) {
    return Double.doubleToLongBits(value1) == Double.doubleToLongBits(value2);
}

浮点计算不精确-通常存在舍入误差，以及由于表示而引起的误差。（例如，不能在二进制浮点数中精确表示0.1。）

因此，直接比较两个浮点值的相等性通常不是一个好主意，因为取决于它们的计算方式，它们可能相差很小。

在JUnit javadocs中被称为“ delta”，它描述了您可以容忍的差异值，以使它们仍然被视为相等。该值的大小完全取决于您要比较的值。比较双打时，通常使用期望值除以10 ^ 6。

事实是，由于浮点数固有的精度问题，两个double可能不完全相等。使用此增量值，您可以控制基于误差因子的相等性评估。

另外，某些浮点值可以具有可能影响结果的特殊值，例如NAN和-Infinity / + Infinity。

如果您确实打算比较两个双精度数是否相等，则最好将它们作为长整数进行比较

Assert.assertEquals(Double.doubleToLongBits(expected), Double.doubleToLongBits(result));

要么

Assert.assertEquals(0, Double.compareTo(expected, result));

可以考虑这些细微差别。

我没有深入研究有问题的Assert方法，但是我只能假定先前的方法已针对此类问题而弃用，而新方法确实将它们考虑在内。

Epsilon是expected和之间的区别actual，您可以接受认为相等的价值观。您可以设置.1例如。

请注意，如果您不进行数学运算，则声明确切的浮点值没有任何错误。例如：

public interface Foo {
    double getDefaultValue();
}

public class FooImpl implements Foo {
    public double getDefaultValue() { return Double.MIN_VALUE; }
}

在这种情况下，您要确保它确实是MIN_VALUE，而不是零或-MIN_VALUE或MIN_NORMAL或其他很小的值。你可以说

double defaultValue = new FooImpl().getDefaultValue();
assertEquals(Double.MIN_VALUE, defaultValue);

但这会给您一个过时的警告。为避免这种情况，您可以致电assertEquals(Object, Object)：

// really you just need one cast because of autoboxing, but let's be clear
assertEquals((Object)Double.MIN_VALUE, (Object)defaultValue);

而且，如果您真的想看起来很聪明：

assertEquals(
    Double.doubleToLongBits(Double.MIN_VALUE), 
    Double.doubleToLongBits(defaultValue)
);

或者，您可以只使用Hamcrest流利风格的断言：

// equivalent to assertEquals((Object)Double.MIN_VALUE, (Object)defaultValue);
assertThat(defaultValue, is(Double.MIN_VALUE));

但是，如果您要检查的值确实来自数学运算，请使用epsilon。

Assert.assertTrue(Math.abs(actual-expected) == 0)