matlab.unittest.qualifications.FatalAssertable class

Пакет: matlab.unittest.qualifications

Проверка, чтобы прервать выполнение теста

Описание

The FatalAssertable класс предоставляет проверку типа «» qualification «», чтобы прервать выполнение теста. Помимо действий, выполненных для отказов, FatalAssertable класс работает так же, как matlab.unittest проверки.

На критическое утверждение отказа, FatalAssertable класс информирует среду тестирования о отказе путем выдачи FatalAssertionFailedException. Тестовая среда затем отображает диагностическую информацию для отказа и прекращает весь сеанс тестирования. Это полезно, когда тестируемое программное обеспечение содержит так много ошибок, что нет смысла продолжать сеанс тестирования. Кроме того, вы можете использовать критические утверждения в отключении фиксатора, чтобы гарантировать правильное восстановление состояния фиксатора. Если он не восстановлен, сеанс полной проверки прерывается и указывает, чтобы перезапустить MATLAB^® прежде чем вы возобновите тестирование. Это позволяет более поздним тестам запускаться в согласованном состоянии MATLAB. Если можно восстановить фиксатор и сделать его Устойчивостью к исключениям для отказов, используйте вместо этого утверждения.

Критические утверждения предотвращают ложные непройденные тесты из-за отказа фундаментального теста. Они также предотвращают ложные непройденные тесты, когда предыдущий тест не смог восстановить испытательные стенды. Если среда тестирования не может правильно разорвать фиксаторы, перезапустите MATLAB, чтобы убедиться, что проверка может возобновиться в чистом состоянии.

Методы

fatalAssertClass	Фатально утвердите точный класс заданного значения
fatalAssertEmpty	Значение Fatal assert пусто
fatalAssertEqual	Значение fatal assert равно заданному значению
fatalAssertError	Функция Fatal assert выдает указанное исключение
fatalAssertFail	Создание безусловных критических утверждений отказа
fatalAssertFalse	Значение fatal assert ложно
fatalAssertGreaterThanOrEqual	Значение fatal assert больше или равно заданному значению
fatalAssertInstanceOf	Значение fatal assert является объектом заданного типа
fatalAssertLength	Значение fatal assert имеет заданную длину
fatalAssertLessThan	Значение fatal assert меньше заданного значения
fatalAssertLessThanOrEqual	Значение fatal assert меньше или равно заданному значению
fatalAssertMatches	Строка Fatal assert соответствует заданному регулярному выражению
fatalAssertNotEmpty	Значение fatal assert не пустое
fatalAssertNotEqual	Значение fatal assert не равно заданному значению
fatalAssertNotSameHandle	Значение fatal assert не является указанным образцом.
fatalAssertNumElements	Значение Fatal assert имеет заданное количество элементов
fatalAssertReturnsTrue	Функция fatal assert возвращает true при оценке
fatalAssertSameHandle	Два значения Fatal assert являются указателями на один и тот же образец
fatalAssertSize	Значение fatal assert имеет заданный размер
fatalAssertSubstring	Строка Fatal assert содержит указанную строку
fatalAssertThat	Значение фатального утверждения соответствует заданному ограничению
fatalAssertTrue	Значение Fatal assert равно true
fatalAssertWarning	Функция Fatal assert выдает указанные предупреждения
fatalAssertWarningFree	Функция Fatal assert не выдает предупреждений

События

`FatalAssertionFailed`	Срабатывает после непрохождения критических утверждений. A `QualificationEventData` объект передается в функции обратного вызова прослушивателя.
`FatalAssertionPassed`	Срабатывает при прохождении критических утверждений. A `QualificationEventData` объект передается в функции обратного вызова прослушивателя.

Копировать семантику

Указатель. Чтобы узнать, как классы handle влияют на операции копирования, см. раздел «Копирование объектов».

Примеры

свернуть все

Написание функции помощника с использованием критических утверждений

В результате критического утверждения» остальная часть текущего метода тестирования становится недопустимой, поскольку состояние не подлежит восстановлению. A helper function является функцией в TestCase класс, но не расположенный ни в одном из methods оператор блока. Выполнение этих функций не контролируется matlab.unittest среда.

Добавьте DocPolynomSaveLoadTest.m файл в папку по пути MATLAB. Обратитесь к функции helper, cleanUpTemporaryFolder, в DocPolynomSaveLoadTest тест.

Файл определения класса DocPolynomSaveLoadTest

classdef DocPolynomSaveLoadTest < matlab.unittest.TestCase 
    
    methods (TestClassSetup) 
        function addDocPolynomClassToPath(testCase) 
            origPath = path; 
            testCase.addTeardown(@path, origPath); 
            addpath(fullfile(matlabroot, ... 
                'help', 'techdoc', 'matlab_oop', 'examples')); 
        end 
    end 
     
    methods (Test) 
        function testSaveLoad(testCase) 
             
            import matlab.unittest.diagnostics.Diagnostic; 
             
            %% Phase 1: Setup 
            % Create a temporary working folder 
            tempFolder = tempname; 
            [success, message] = mkdir(tempFolder); 
            testCase.assertTrue(success, ... 
                Diagnostic.join('Could not create temporary folder.',... 
                message)); 
            testCase.addTeardown(@() testCase.cleanUpTemporaryFolder(...
                tempFolder)); 
             
            % Change to the temporay folder and register the 
            % teardown, which restores the original folder 
            origFolder = pwd; 
            testCase.addTeardown(@cd, origFolder); 
            cd(tempFolder); 
             
            %% Phase 2: Exercise 
            % Save the instance to a mat file. 
            p = DocPolynom([1, 0, 1]); 
            save('DocPolynomFile', 'p'); 
             
            % Validate Precondition. Save resulted in valid .mat file 
            testCase.assertEqual(exist('DocPolynomFile.mat','file'),... 
                2, Diagnostic.join(...
                'mat file was not saved correctly.',@() dir(pwd))); 
             
            loaded = load('DocPolynomFile'); 
             
             
            %% Phase 3: Verify             
            testCase.verifyEqual(loaded.p, p,...
                'Loaded polynom did not equal original polynom.');
             
             
            %% Phase 4: Teardown 
            % Done inline via calls to addTeardown at the points
            % at which the state was changed. 

             
        end 
    end 
     
    methods(Access=private) 
        function cleanUpTemporaryFolder(testCase,tempFolder)
            % Clean up the temporary folder and fatally assert
            % that it was correctly cleaned up.
             
            import matlab.unittest.diagnostics.Diagnostic; 
             
            [success, message] = rmdir(tempFolder, 's'); 
            testCase.fatalAssertTrue(success, ... 
                Diagnostic.join('Could not remove temporary folder.',... 
                message)); 
        end 
    end 
             
end

Сделайте cleanUpTemporaryFolder выполнять функцию helper путем размещения ее внутри отдельного methods блок.

methods(Access=private) 
    function cleanUpTemporaryFolder(testCase, tempFolder) 
        % code 
    end 
end

Используйте fatalAssertTrue метод для тестирования rmdir success аргумент для ошибок. Если происходит критическое утверждение, тестовый запуск прекращается.

function cleanUpTemporaryFolder(testCase, tempFolder) 
     
    import matlab.unittest.diagnostics.Diagnostic
     
    [success, message] = rmdir(tempFolder, 's'); 
    testCase.fatalAssertTrue(success, ... 
        Diagnostic.join('Could not remove the temporary folder.',... 
        message))
end

Если rmdir функция не работает, этот тест не смог восстановить состояние MATLAB и машины при начальном запуске. Прерывание препятствует непрохождению последующих тестов, поскольку этот тест оставляет MATLAB в неожиданном состоянии.

Подробнее о

расширить все

Устойчивость к исключениям

Содержание теста exception safe, когда все фиксатором разрывы выполняются с addTeardown или через соответствующие деструкторы объектов, когда происходит отказ. Это гарантирует, что отказ не влияет на последующую проверку из-за устаревших фиксаторов.

Этот код не является безопасным исключением. После отказа утверждения среда тестирования не закрывает рисунок.

% Not exception safe
f = figure;
testCase.fatalAssertEqual(actual, expected)
close(f)

Этот код безопасен, потому что среда тестирования закрывает рисунок во всех случаях.

% Exception safe
f = figure;
testCase.addTeardown(@close, f)
testCase.fatalAssertEqual(actual, expected)

Однако срыв фиксатора с помощью addTeardown не гарантирует, что код безопасен для исключений. Этот код показывает отказ в fatalAssertEqual.

% Not exception safe
f = figure;
testCase.fatalAssertEqual(actual, expected);
testCase.addTeardown(@close, f)

См. также

Темы

Таблица верификаций, утверждений и других квалификаций

Введенный в R2013a

Документация