ITestLifeCycleReceiver
public
interface
ITestLifeCycleReceiver
| com.android.tradefed.result.ITestLifeCycleReceiver |
Nhận thông báo về sự kiện trong quá trình chạy kiểm thử đo lường.
Theo mẫu org.junit.runner.notification.RunListener
Trình tự các lệnh gọi sẽ là:
- testRunStarted
- testStarted
- [testFailed]
- [testAssumptionFailure]
- [testIgnored]
- testEnded
- ....
- [testRunFailed]
- testRunEnded
Tóm tắt
Phương thức công khai | |
|---|---|
default
void
|
testAssumptionFailure(TestDescription test, String trace)
Được gọi khi một kiểm thử nguyên tử gắn cờ rằng kiểm thử đó giả định một điều kiện sai |
default
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Được gọi khi một kiểm thử nguyên tử gắn cờ rằng kiểm thử đó giả định một điều kiện sai |
default
void
|
testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)
Báo cáo thời điểm kết thúc quá trình thực thi của một trường hợp kiểm thử riêng lẻ. |
default
void
|
testEnded(TestDescription test, long endTime, Map<String, String> testMetrics)
Phương án thay thế cho |
default
void
|
testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)
Phương án thay thế cho |
default
void
|
testEnded(TestDescription test, Map<String, String> testMetrics)
Báo cáo thời điểm kết thúc quá trình thực thi của một trường hợp kiểm thử riêng lẻ. |
default
void
|
testFailed(TestDescription test, FailureDescription failure)
Báo cáo lỗi của một trường hợp kiểm thử riêng lẻ. |
default
void
|
testFailed(TestDescription test, String trace)
Báo cáo lỗi của một trường hợp kiểm thử riêng lẻ. |
default
void
|
testIgnored(TestDescription test)
Được gọi khi một quy trình kiểm thử sẽ không chạy, thường là do một phương thức kiểm thử được chú thích bằng org.junit.Ignore. |
default
void
|
testRunEnded(long elapsedTimeMillis, HashMap<String, MetricMeasurement.Metric> runMetrics)
Báo cáo thời điểm kết thúc một lần chạy kiểm thử. |
default
void
|
testRunEnded(long elapsedTimeMillis, Map<String, String> runMetrics)
Báo cáo thời điểm kết thúc một lần chạy kiểm thử. |
default
void
|
testRunFailed(FailureDescription failure)
Không hoàn tất được quá trình chạy thử báo cáo do lỗi được mô tả bằng |
default
void
|
testRunFailed(String errorMessage)
Không thể hoàn tất quá trình chạy thử báo cáo do gặp lỗi nghiêm trọng. |
default
void
|
testRunStarted(String runName, int testCount, int attemptNumber)
Báo cáo thời điểm bắt đầu một lần chạy kiểm thử. |
default
void
|
testRunStarted(String runName, int testCount)
Báo cáo thời điểm bắt đầu một lần chạy kiểm thử. |
default
void
|
testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
Báo cáo thời điểm bắt đầu một lần chạy kiểm thử. |
default
void
|
testRunStopped(long elapsedTime)
Chạy thử báo cáo bị dừng trước khi hoàn tất do người dùng yêu cầu. |
default
void
|
testSkipped(TestDescription test, SkipReason reason)
Được gọi khi một bài kiểm thử bị bỏ qua và không thực thi vì một lý do thường không mong muốn. |
default
void
|
testStarted(TestDescription test, long startTime)
Phương án thay thế cho |
default
void
|
testStarted(TestDescription test)
Báo cáo thời điểm bắt đầu một trường hợp kiểm thử riêng lẻ. |
Phương thức công khai
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
Được gọi khi một kiểm thử nguyên tử gắn cờ rằng kiểm thử đó giả định một điều kiện sai
| Tham số | |
|---|---|
test |
TestDescription: xác định kiểm thử |
trace |
String: dấu vết ngăn xếp của lỗi |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Được gọi khi một kiểm thử nguyên tử gắn cờ rằng kiểm thử đó giả định một điều kiện sai
| Tham số | |
|---|---|
test |
TestDescription: xác định kiểm thử |
failure |
FailureDescription: FailureDescription mô tả lỗi và ngữ cảnh của lỗi đó. |
testEnded
public void testEnded (TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)
Báo cáo thời điểm kết thúc quá trình thực thi của một trường hợp kiểm thử riêng lẻ.
Nếu testFailed(TestDescription, FailureDescription) không được gọi, thì kiểm thử này sẽ thành công. Cũng trả về mọi chỉ số khoá/giá trị có thể đã được phát trong quá trình thực thi trường hợp kiểm thử.
| Tham số | |
|---|---|
test |
TestDescription: xác định kiểm thử |
testMetrics |
HashMap: một Map của các chỉ số được phát ra |
testEnded
public void testEnded (TestDescription test, long endTime, Map<String, String> testMetrics)
Phương án thay thế cho testEnded(TestDescription,Map), trong đó chúng ta có thể chỉ định trực tiếp thời gian kết thúc. Kết hợp với testStarted(TestDescription,long) để đo lường chính xác.
| Tham số | |
|---|---|
test |
TestDescription: xác định kiểm thử |
endTime |
long: thời gian kết thúc kiểm thử, được đo bằng System.currentTimeMillis() |
testMetrics |
Map: một Map của các chỉ số được phát ra |
testEnded
public void testEnded (TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)
Phương án thay thế cho testEnded(TestDescription,Map), trong đó chúng ta có thể chỉ định trực tiếp thời gian kết thúc. Kết hợp với testStarted(TestDescription,long) để đo lường chính xác.
| Tham số | |
|---|---|
test |
TestDescription: xác định kiểm thử |
endTime |
long: thời gian kết thúc kiểm thử, được đo bằng System.currentTimeMillis() |
testMetrics |
HashMap: một Map của các chỉ số được phát ra |
testEnded
public void testEnded (TestDescription test, Map<String, String> testMetrics)
Báo cáo thời điểm kết thúc quá trình thực thi của một trường hợp kiểm thử riêng lẻ.
Nếu testFailed(TestDescription, FailureDescription) không được gọi, thì kiểm thử này sẽ thành công. Cũng trả về mọi chỉ số khoá/giá trị có thể đã được phát trong quá trình thực thi trường hợp kiểm thử.
| Tham số | |
|---|---|
test |
TestDescription: xác định kiểm thử |
testMetrics |
Map: một Map của các chỉ số được phát ra |
testFailed
public void testFailed (TestDescription test, FailureDescription failure)
Báo cáo lỗi của một trường hợp kiểm thử riêng lẻ.
Sẽ được gọi giữa testStarted và testEnded.
| Tham số | |
|---|---|
test |
TestDescription: xác định kiểm thử |
failure |
FailureDescription: FailureDescription mô tả lỗi và ngữ cảnh của lỗi đó. |
testFailed
public void testFailed (TestDescription test, String trace)
Báo cáo lỗi của một trường hợp kiểm thử riêng lẻ.
Sẽ được gọi giữa testStarted và testEnded.
| Tham số | |
|---|---|
test |
TestDescription: xác định kiểm thử |
trace |
String: dấu vết ngăn xếp của lỗi |
testIgnored
public void testIgnored (TestDescription test)
Được gọi khi một quy trình kiểm thử sẽ không chạy, thường là do một phương thức kiểm thử được chú thích bằng org.junit.Ignore.
| Tham số | |
|---|---|
test |
TestDescription: xác định kiểm thử |
testRunEnded
public void testRunEnded (long elapsedTimeMillis,
HashMap<String, MetricMeasurement.Metric> runMetrics)Báo cáo thời điểm kết thúc một lần chạy kiểm thử. FIXME: Chúng ta không thể có hai giao diện Map<> có kiểu khác nhau, vì vậy, chúng ta phải sử dụng HashMap ở đây.
| Tham số | |
|---|---|
elapsedTimeMillis |
long: thiết bị đã báo cáo thời gian đã trôi qua, tính bằng mili giây |
runMetrics |
HashMap: các cặp khoá-giá trị được báo cáo ở cuối một lần chạy kiểm thử bằng Metric. |
testRunEnded
public void testRunEnded (long elapsedTimeMillis,
Map<String, String> runMetrics)Báo cáo thời điểm kết thúc một lần chạy kiểm thử.
| Tham số | |
|---|---|
elapsedTimeMillis |
long: thiết bị đã báo cáo thời gian đã trôi qua, tính bằng mili giây |
runMetrics |
Map: các cặp khoá-giá trị được báo cáo ở cuối một lần chạy kiểm thử |
testRunFailed
public void testRunFailed (FailureDescription failure)
Không hoàn tất được quá trình chạy thử báo cáo do lỗi được mô tả bằng FailureDescription.
| Tham số | |
|---|---|
failure |
FailureDescription: FailureDescription mô tả lỗi và ngữ cảnh của lỗi đó. |
testRunFailed
public void testRunFailed (String errorMessage)
Không thể hoàn tất quá trình chạy thử báo cáo do gặp lỗi nghiêm trọng.
| Tham số | |
|---|---|
errorMessage |
String: String mô tả lý do khiến lần chạy không thành công. |
testRunStarted
public void testRunStarted (String runName,
int testCount,
int attemptNumber)Báo cáo thời điểm bắt đầu một lần chạy kiểm thử.
| Tham số | |
|---|---|
runName |
String: tên của lần chạy kiểm thử |
testCount |
int: tổng số kiểm thử trong lần chạy kiểm thử |
attemptNumber |
int: số thứ tự, xác định các lần thử khác nhau của cùng một runName chạy nhiều lần. attemptNumber được lập chỉ mục từ 0 và sẽ tăng lên mỗi khi có một lần chạy mới. Ví dụ: Một bài kiểm thử được thử lại chi tiết 3 lần, thì bài kiểm thử đó sẽ có tổng cộng 4 lần chạy trong cùng một runName và attemptNumber sẽ từ 0 đến 3. |
testRunStarted
public void testRunStarted (String runName,
int testCount)Báo cáo thời điểm bắt đầu một lần chạy kiểm thử.
| Tham số | |
|---|---|
runName |
String: tên của lần chạy kiểm thử |
testCount |
int: tổng số kiểm thử trong lần chạy kiểm thử |
testRunStarted
public void testRunStarted (String runName,
int testCount,
int attemptNumber,
long startTime)Báo cáo thời điểm bắt đầu một lần chạy kiểm thử.
| Tham số | |
|---|---|
runName |
String: tên của lần chạy kiểm thử |
testCount |
int: tổng số kiểm thử trong lần chạy kiểm thử |
attemptNumber |
int: số thứ tự, xác định các lần thử khác nhau của cùng một runName chạy nhiều lần. attemptNumber được lập chỉ mục từ 0 và sẽ tăng lên mỗi khi có một lần chạy mới. Ví dụ: Một bài kiểm thử được thử lại chi tiết 3 lần, thì bài kiểm thử đó sẽ có tổng cộng 4 lần chạy trong cùng một runName và attemptNumber sẽ từ 0 đến 3. |
startTime |
long: thời gian bắt đầu chạy, được đo bằng System.currentTimeMillis() |
testRunStopped
public void testRunStopped (long elapsedTime)
Chạy thử báo cáo bị dừng trước khi hoàn tất do người dùng yêu cầu.
TODO: currently unused, consider removing
| Tham số | |
|---|---|
elapsedTime |
long: thiết bị đã báo cáo thời gian đã trôi qua, tính bằng mili giây |
testSkipped
public void testSkipped (TestDescription test, SkipReason reason)
Được gọi khi một bài kiểm thử bị bỏ qua và không thực thi vì một lý do thường không mong muốn. Các kiểm thử này sẽ được thử lại để cố gắng thực hiện đúng cách.
| Tham số | |
|---|---|
test |
TestDescription: xác định kiểm thử |
reason |
SkipReason: SkipReason |
testStarted
public void testStarted (TestDescription test, long startTime)
Phương án thay thế cho testStarted(TestDescription), trong đó chúng ta cũng chỉ định thời điểm bắt đầu kiểm thử, kết hợp với testEnded(TestDescription,long,Map) để đo lường chính xác.
| Tham số | |
|---|---|
test |
TestDescription: xác định kiểm thử |
startTime |
long: thời gian bắt đầu kiểm thử, được đo bằng System.currentTimeMillis() |
testStarted
public void testStarted (TestDescription test)
Báo cáo thời điểm bắt đầu một trường hợp kiểm thử riêng lẻ. Giao diện cũ, nên dùng testStarted(TestDescription) bất cứ khi nào có thể.
| Tham số | |
|---|---|
test |
TestDescription: xác định kiểm thử |