1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
// Copyright (c) 2011 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROME_BROWSER_DIAGNOSTICS_DIAGNOSTICS_TEST_H_
#define CHROME_BROWSER_DIAGNOSTICS_DIAGNOSTICS_TEST_H_
#include "base/compiler_specific.h"
#include "chrome/browser/diagnostics/diagnostics_model.h"
namespace base {
class FilePath;
}
namespace diagnostics {
// Represents a single diagnostic test and encapsulates the common
// functionality across platforms as well.
// It also implements the TestInfo interface providing the storage
// for the outcome of the test.
// Specific tests need (minimally) only to:
// 1- override ExecuteImpl() to implement the test.
// 2- call RecordStopFailure() or RecordFailure() or RecordSuccess()
// at the end of the test.
// 3- Optionally call observer->OnProgress() if the test is long.
// 4- Optionally call observer->OnSkipped() if the test cannot be run.
class DiagnosticsTest : public DiagnosticsModel::TestInfo {
public:
// |id| is a parse-able ASCII ID string that uniquely identifies the test. It
// should only have letters, numbers and underscores in it (and no spaces).
// |title| is the human readable string that says what the objective of the
// test is.
DiagnosticsTest(const std::string& id, const std::string& title);
virtual ~DiagnosticsTest();
// Runs the test. Returning false signals that no more tests should be run.
// The actual outcome of the test should be set using the RecordXX functions.
bool Execute(DiagnosticsModel::Observer* observer, DiagnosticsModel* model,
size_t index);
void RecordStopFailure(int outcome_code, const std::string& additional_info) {
RecordOutcome(
outcome_code, additional_info, DiagnosticsModel::TEST_FAIL_STOP);
}
void RecordFailure(int outcome_code, const std::string& additional_info) {
RecordOutcome(
outcome_code, additional_info, DiagnosticsModel::TEST_FAIL_CONTINUE);
}
void RecordSuccess(const std::string& additional_info) {
RecordOutcome(0, additional_info, DiagnosticsModel::TEST_OK);
}
void RecordOutcome(int outcome_code,
const std::string& additional_info,
DiagnosticsModel::TestResult result);
static base::FilePath GetUserDefaultProfileDir();
// DiagnosticsModel::TestInfo overrides
virtual std::string GetId() const OVERRIDE;
virtual std::string GetTitle() const OVERRIDE;
virtual DiagnosticsModel::TestResult GetResult() const OVERRIDE;
virtual std::string GetAdditionalInfo() const OVERRIDE;
virtual int GetOutcomeCode() const OVERRIDE;
virtual base::Time GetStartTime() const OVERRIDE;
virtual base::Time GetEndTime() const OVERRIDE;
protected:
// Derived classes override this method do perform the actual test.
virtual bool ExecuteImpl(DiagnosticsModel::Observer* observer) = 0;
const std::string id_;
const std::string title_;
std::string additional_info_;
int outcome_code_;
DiagnosticsModel::TestResult result_;
base::Time start_time_;
base::Time end_time_;
};
} // namespace diagnostics
#endif // CHROME_BROWSER_DIAGNOSTICS_DIAGNOSTICS_TEST_H_
|
