Main Content

createTestClassInstance

类: matlab.unittest.plugins.TestRunnerPlugin
命名空间: matlab.unittest.plugins

扩展类级别 TestCase 实例的创建

说明

示例

tc = createTestClassInstance(plugin,pluginData) 扩展类级别 TestCase 实例的创建,并返回修改后的 TestCase 实例。测试框架使用 TestCase 实例自定义属于同一测试类的运行测试。框架在 runTestClass 方法的作用域内计算此方法。

此方法的典型实现是将侦听程序添加到源自类级别实例的各种事件。因为 TestCase 类继承自 handle 类,所以通过从 createTestClassInstance 方法内调用 addlistener 方法来添加侦听程序。对于每个类,测试框架向任何具有 TestClassSetupTestClassTeardown 属性的方法传递该实例。

输入参数

全部展开

插件,指定为 matlab.unittest.plugins.TestRunnerPlugin 对象。

类级别 TestCase 创建信息,指定为 matlab.unittest.plugins.plugindata.TestContentCreationPluginData 对象。测试框架使用此信息来描述该插件的测试内容。

属性

Accessprotected

要了解方法的属性,请参阅方法属性

示例

全部展开

创建一个插件并覆盖 createTestClassInstance 方法以统计类级别假设失败的数量。

添加侦听程序以侦听假设失败。使用 captureClassLevelAssumptionFailureData 辅助方法填充 TestClassAssumptionFailureData 属性。

classdef ExamplePlugin < matlab.unittest.plugins.TestRunnerPlugin
    properties (SetAccess=private)
        TestClassAssumptionFailureData = {};
    end

    methods (Access=protected)
        function testCase = createTestClassInstance(plugin,pluginData)
            % Invoke super class method
            testCase = createTestClassInstance@ ...
                matlab.unittest.plugins.TestRunnerPlugin(plugin,pluginData);

            % Get the test class name
            instanceName = pluginData.Name;

            % Add a listener to capture assumption failures
            testCase.addlistener('AssumptionFailed',@(~,evd) ...
                plugin.captureClassLevelAssumptionFailureData(evd,instanceName))
        end
    end

    methods (Access=private)
        function captureClassLevelAssumptionFailureData(plugin,eventData,instanceName)
            plugin.TestClassAssumptionFailureData{end+1} = struct( ...
                'InstanceName',instanceName, ...
                'ActualValue' ,eventData.ActualValue, ...
                'Constraint'  ,eventData.Constraint, ...
                'Stack'       ,eventData.Stack);
        end
    end
end

版本历史记录

在 R2014a 中推出