47

System.Diagnostics.Contracts.ContractException 在我的测试项目中不可访问。请注意,这段代码纯粹是我自己在弄乱我闪亮的 Visual Studio 新副本,但我想知道我做错了什么。

我用的是专业版的VS,所以没有静态检查。为了仍然使用代码契约(我喜欢),我认为我的方法可以工作的唯一方法是捕获运行时抛出的异常,但我认为这不可能。

测试方法

[TestMethod, ExpectedException(typeof(System.Diagnostics.Contracts.ContractException))]
public void returning_a_value_less_than_one_throws_exception()
{
    var person = new Person();
    person.Number();
}

方法

public int Number()
{
    Contract.Ensures(Contract.Result<int>() >= 0);
    return -1;
}

错误

错误 1 ​​'System.Diagnostics.Contracts.ContractException' 不可访问
由于其防护等级。

编辑

经过一番思考,我得出了评论中讨论的结论,以及以下内容。给定一个方法,如果它有一个可以用代码合同形式表达的要求,我会这样写测试。

[TestMethod]
[ExpectedException(typeof(ArgumentException))]
public void value_input_must_be_greater_than_zero()
{
    // Arrange
    var person = new Person();
    // Act
    person.Number(-1);
}

这将确保合约是代码的一部分,并且不会被删除。然而,这将要求代码合同实际抛出指定的异常。然而,在某些情况下,这不是必需的。

4

4 回答 4

70

这是故意的-尽管测试时会有些痛苦。

关键是在生产代码中你永远不应该想要捕获合约异常。它表明您的代码中存在错误,因此您不应该期望任何意外异常,您可能希望在调用堆栈的顶部捕获这些异常,以便您可以继续下一个请求。基本上,您不应该将合同例外视为可以“处理”的例外。

现在,为了测试这很痛苦……但是你真的想测试你的合同吗?这不是有点像测试编译器阻止您将 a 传递string给具有int参数的方法吗?您已经声明了合同,可以适当地记录它,并适当地执行(无论如何,基于设置)。

如果你确实想测试合约异常,你可以Exception在测试中捕获一个bare并检查它的全名,或者你可以弄乱这个Contract.ContractFailed事件。我希望单元测试框架会随着时间的推移对此提供内置支持——但要实现这一点需要一点时间。与此同时,您可能希望有一个实用方法来预期违反合同。一种可能的实现:

const string ContractExceptionName =
    "System.Diagnostics.Contracts.__ContractsRuntime.ContractException";

public static void ExpectContractFailure(Action action)
{
    try
    {
        action();
        Assert.Fail("Expected contract failure");
    }
    catch (Exception e)
    {
        if (e.GetType().FullName != ContractExceptionName)
        {
            throw;
        }
        // Correct exception was thrown. Fine.
    }
}
于 2010-04-14T18:32:57.690 回答
8

编辑:我进行了转换,不再使用下面的 ExpectedException 或此属性,而是编写了一些扩展方法:

AssertEx.Throws<T>(Action action);
AssertEx.ThrowsExact<T>(Action action);
AssertEx.ContractFailure(Action action);

这些使我能够更准确地了解引发异常的位置。

ContractFailure 方法示例:

    [SuppressMessage("Microsoft.Design", "CA1031:DoNotCatchGeneralExceptionTypes", Justification = "Cannot catch ContractException")]
    public static void ContractFailure(Action operation)
    {
        try
        {
            operation();
        }
        catch (Exception ex)
        {
            if (ex.GetType().FullName == "System.Diagnostics.Contracts.__ContractsRuntime+ContractException")
                return;

            throw;
        }

        Assert.Fail("Operation did not result in a code contract failure");
    }

我为 MSTest 创建了一个属性,其行为类似于 ExpectedExceptionAttribute:

public sealed class ExpectContractFailureAttribute : ExpectedExceptionBaseAttribute
{
    const string ContractExceptionName = "System.Diagnostics.Contracts.__ContractsRuntime+ContractException";

    protected override void Verify(Exception exception)
    {
        if (exception.GetType().FullName != ContractExceptionName)
        {
            base.RethrowIfAssertException(exception);
            throw new Exception(
                string.Format(
                    CultureInfo.InvariantCulture,
                    "Test method {0}.{1} threw exception {2}, but contract exception was expected. Exception message: {3}",
                    base.TestContext.FullyQualifiedTestClassName,
                    base.TestContext.TestName,
                    exception.GetType().FullName,
                    exception.Message
                )
            );
        }
    }
}

这可以类似地使用:

    [TestMethod, ExpectContractFailure]
    public void Test_Constructor2_NullArg()
    {
        IEnumerable arg = null;

        MyClass mc = new MyClass(arg);
    }
于 2011-08-05T07:17:22.350 回答
2

在 vs2010 rtm 中,全名已更改为“System.Diagnostics.Contracts.__ContractsRuntime+ContractException”。高温高压

于 2010-05-14T16:55:28.080 回答
1

尽管这个问题已经过时了,并且已经提供了答案,但我觉得我有一个很好的解决方案,可以让事情变得简单易读。最后,它允许我们在先决条件下编写测试,如下所示:

[Test]
public void Test()
{
    Assert.That(FailingPrecondition, Violates.Precondition);
}

public void FailingPrecondition() {
    Contracts.Require(false);
}

好的,所以我们的想法是为代码契约重写器提供一个自定义契约运行时类。这可以在“自定义重写器方法”下的程序集属性中设置(参见代码合同用户手册第 7.7 节):

1

记得也要检查Call-site Requires Checking

自定义类看起来像这样:

public static class TestFailureMethods
{
    public static void Requires(bool condition, string userMessage, string conditionText)
    {
        if (!condition)
        {
            throw new PreconditionException(userMessage, conditionText);
        }
    }

    public static void Requires<TException>(bool condition, string userMessage, string conditionText) where TException : Exception
    {
        if (!condition)
        {
            throw new PreconditionException(userMessage, conditionText, typeof(TException));
        }
    }
}

使用自定义PreconditionException类(它没有任何花哨的东西!)。我们还添加了一个小助手类:

public static class Violates
{
    public static ExactTypeConstraint Precondition => Throws.TypeOf<PreconditionException>();
}

如上所示,这使我们能够编写简单、易读的前置条件违规测试。

于 2016-01-16T20:02:29.757 回答