matlab.unittest.qualifications.Verifiable 类

产生软失败条件的验证

描述

Verifiable 类提供用于生成软失败条件的验证。除了对失败执行的操作外，Verifiable 类与 matlab.unittest.qualifications 包中的其他验证类的工作方式相同。

确认失败时，Verifiable 类会通知测试框架这次失败，在其中包含有关这次失败的所有诊断信息，但仍会继续执行当前运行的测试，而不会引发异常。如果确认点处的失败对于剩余的测试内容不构成重大影响，此行为会很有用。通常，您会将确认作为四阶段测试的主要验证手段。使用假设、断言和致命断言等其他验证类型来测试是否违反先决条件或测试安装是否正确。

由于验证不会引发异常，因此即使出现测试失败的情形，依然会完成所有的测试内容。此行为有助于您了解如何关闭一部分软件以满足测试套件要求。引发异常的验证类型不能提供此类信息，因为一旦引发异常，便会保留一定数量的未达代码或未执行代码。确认还为失败条件下的测试提供了更大的测试范围。但是，在您过度使用确认时，它们便可能在单一失败下产生过多的噪声。如果失败会导致后面的验证点发生失败，请改用断言或致命断言。

matlab.unittest.qualifications.Verifiable 类是 handle 类。

方法

全部展开

公共方法

一般用途

`verifyEqual`	确认值等于指定值
`verifyFail`	生成无条件的确认失败
`verifyFalse`	确认值为 false
`verifyNotEqual`	确认值不等于指定值
`verifyNotSameHandle`	验证两个句柄数组是否不同
`verifyReturnsTrue`	验证函数返回 true
`verifySameHandle`	验证两个句柄数组是否相同
`verifyThat`	验证值满足指定的约束
`verifyTrue`	确认值为 true

错误和警告

`verifyError`	确认函数遇到指定异常
`verifyWarning`	验证函数发出指定的警告
`verifyWarningFree`	确认函数未发出警告

不相等性

`verifyGreaterThan`	确认值大于指定值
`verifyGreaterThanOrEqual`	确认值大于或等于指定值
`verifyLessThan`	确认值小于指定值
`verifyLessThanOrEqual`	确认值小于或等于指定值

数组大小

`verifyEmpty`	确认值为空
`verifyLength`	确认值具有指定长度
`verifyNotEmpty`	确认值不为空
`verifyNumElements`	确认值具有指定的元素计数
`verifySize`	确认值具有指定大小

类型

`verifyClass`	验证指定值的类
`verifyInstanceOf`	验证值是指定类的实例

字符串

`verifyMatches`	确认字符串与指定的正则表达式匹配
`verifySubstring`	验证值包含指定的字符串

事件

事件名称触发器事件数据事件属性

事件名称	触发器	事件数据	事件属性
`VerificationFailed`	验证失败时触发。`QualificationEventData` 对象传递给侦听程序回调函数。	`matlab.unittest.qualifications.QualificationEventData`	`NotifyAccess: private` `ListenAccess: public`
`VerificationPassed`	通过验证时触发。`QualificationEventData` 对象传递给侦听程序回调函数。	`matlab.unittest.qualifications.QualificationEventData`	`NotifyAccess: private` `ListenAccess: public`

VerificationFailed

验证失败时触发。QualificationEventData 对象传递给侦听程序回调函数。

matlab.unittest.qualifications.QualificationEventData

NotifyAccess: private

ListenAccess: public

VerificationPassed

通过验证时触发。QualificationEventData 对象传递给侦听程序回调函数。

matlab.unittest.qualifications.QualificationEventData

NotifyAccess: private

ListenAccess: public

示例

全部折叠

测试表示多项式的类

打开实时脚本

使用验证来测试 DocPolynom 类，该类在 MATLAB® 中表示多项式。有关该类的详细信息以及查看类代码，请参阅Representing Polynomials with Classes。

在当前文件夹内一个名为 DocPolynom.m 的文件中创建 DocPolynom 类。要测试 DocPolynom 类的不同方法，请在当前文件夹内另一个名为 DocPolynomTest.m 的文件中创建 DocPolynomTest 类。在 DocPolynomTest 类中定义三个 Test 方法：

testConstructor 方法 - 使用 verifyClass 测试 DocPolynom 类构造函数。
testAddition 方法 - 使用 verifyEqual 来测试 DocPolynom 对象的相加性。
testMultiplication 方法 - 使用 verifyEqual 来测试 DocPolynom 对象的相乘性。

classdef DocPolynomTest < matlab.unittest.TestCase
    properties
        TextToDisplay = "Equation under test: "
    end

    methods (Test)
        function testConstructor(testCase)
            p = DocPolynom([1 0 1]);
            testCase.verifyClass(p,?DocPolynom)
        end

        function testAddition(testCase)
            p1 = DocPolynom([1 0 1]);
            p2 = DocPolynom([5 2]);
            actual = p1 + p2;
            expected = DocPolynom([1 5 3]);
            diagnostic = [testCase.TextToDisplay ...
                "(x^2 + 1) + (5*x + 2) = x^2 + 5*x + 3"];
            testCase.verifyEqual(actual,expected,diagnostic)
        end

        function testMultiplication(testCase)
            p1 = DocPolynom([1 0 3]);
            p2 = DocPolynom([5 2]);
            actual = p1 * p2;
            expected = DocPolynom([5 2 15 6]);
            diagnostic = [testCase.TextToDisplay ...
                "(x^2 + 3) * (5*x + 2) = 5*x^3 + 2*x^2 + 15*x + 6"];
            testCase.verifyEqual(actual,expected,diagnostic)
        end
    end
end

在 DocPolynomTest 类中运行测试。在此示例中，所有测试都通过。

runtests("DocPolynomTest")

Running DocPolynomTest
...
Done DocPolynomTest
__________

ans = 
  1×3 TestResult array with properties:

    Name
    Passed
    Failed
    Incomplete
    Duration
    Details

Totals:
   3 Passed, 0 Failed, 0 Incomplete.
   0.26915 seconds testing time.