diagnose

执行诊断操作

全页展开

语法

diagnose(diagnostic)

说明

示例

当诊断使用方（如单元测试框架）调用方法来计算诊断时，diagnose(diagnostic) 执行指定诊断的操作。

从 Diagnostic 类派生的类必须实现 diagnose 方法。当您为自定义诊断类实现此方法时，请在方法中设置 DiagnosticText 属性以使信息对诊断的使用方可用。

输入参数

全部展开

`diagnostic` — 诊断
`matlab.automation.diagnostics.Diagnostic` 对象

诊断，指定为 matlab.automation.diagnostics.Diagnostic 对象。

属性

Abstract true

要了解方法的属性，请参阅方法属性。

示例

全部展开

创建自定义诊断

创建提供活动进程状态的自定义诊断。定义诊断的类必须从 matlab.automation.diagnostics.Diagnostic 派生，实现 diagnose 方法，并设置 DiagnosticText 属性。

在当前文件夹的名为 ProcessStatusDiagnostic.m 的文件中，通过子类化 matlab.automation.diagnostics.Diagnostic 来创建 ProcessStatusDiagnostic 类。将以下元素添加到类：

HeaderText 属性 - 添加此属性以在诊断构造过程中自定义诊断文本。
ProcessStatusDiagnostic 方法 - 实现此构造函数方法以设置 HeaderText 属性。
diagnose 方法 - 实现此方法以编码诊断操作。访问进程状态信息，并使用此信息设置 DiagnosticText 属性。

classdef ProcessStatusDiagnostic < matlab.automation.diagnostics.Diagnostic
    properties (SetAccess=immutable)
        HeaderText
    end

    methods
        function diagnostic = ProcessStatusDiagnostic(header)
            arguments
                header (1,1) string = "Process Status Information"
            end
            diagnostic.HeaderText = header;
        end

        function diagnose(diagnostic)
            [~,processInfo] = system("ps");
            diagnostic.DiagnosticText = diagnostic.HeaderText + ...
                newline + processInfo;
        end
    end
end

创建一个供交互测试的测试用例。

testCase = matlab.unittest.TestCase.forInteractiveUse;

要在测试失败时显示自定义诊断信息，请将 ProcessStatusDiagnostic 对象传递给您的鉴定方法。

testCase.verifyFail(ProcessStatusDiagnostic)

Verification failed.
    ----------------
    Test Diagnostic:
    ----------------
    Process Status Information
          PID    PPID    PGID     WINPID   TTY         UID    STIME COMMAND
        22488       1   22488      22488  ?        2964717 10:24:31 /usr/bin/ps

创建 ProcessStatusDiagnostic 对象时，通过指定可选输入来自定义诊断文本。

testCase.verifyFail(ProcessStatusDiagnostic("Status of Active Processes"))

Verification failed.
    ----------------
    Test Diagnostic:
    ----------------
    Status of Active Processes
          PID    PPID    PGID     WINPID   TTY         UID    STIME COMMAND
        22828       1   22828      22828  ?        2964717 10:24:53 /usr/bin/ps