ITestRunListener

public interface ITestRunListener

com.android.ddmlib.testrunner.ITestRunListener

Nhận thông báo về sự kiện trong các lần 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

abstract void testAssumptionFailure(TestIdentifier test, String trace)

Được gọi khi một kiểm thử nguyên tử gắn cờ rằng kiểm thử này giả định một điều kiện là sai

abstract void testEnded(TestIdentifier 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ẻ.

abstract void testFailed(TestIdentifier test, String trace)

Báo cáo lỗi của một trường hợp kiểm thử riêng lẻ.

abstract void testIgnored(TestIdentifier test)

Được gọi khi một 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.

abstract void testRunEnded(long elapsedTime, Map<String, String> runMetrics)

Báo cáo thời điểm kết thúc lần chạy kiểm thử.

abstract void testRunFailed(String errorMessage)

Báo cáo rằng lần chạy kiểm thử không hoàn tất do lỗi nghiêm trọng.

abstract 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ử.

abstract void testRunStopped(long elapsedTime)

Phương thức này không được dùng nữa. Lệnh gọi lại này sẽ không bao giờ được gọi. Sẽ bị xoá.

abstract void testStarted(TestIdentifier 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 abstract void testAssumptionFailure (TestIdentifier test, 
                String trace)

Được gọi khi một kiểm thử nguyên tử gắn cờ rằng kiểm thử này giả định một điều kiện là sai

Tham số
test TestIdentifier: xác định kiểm thử
trace String: dấu vết ngăn xếp của lỗi

testEnded

public abstract void testEnded (TestIdentifier 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(TestIdentifier, String) không được gọi, thì kiểm thử này đã vượt qua. Cũng trả về mọi chỉ số khoá/giá trị có thể đã được phát ra trong quá trình thực thi trường hợp kiểm thử.

Tham số
test TestIdentifier: xác định kiểm thử
testMetrics Map: Map của các chỉ số được phát ra trong quá trình thực thi trường hợp kiểm thử bằng android.app.Instrumentation#sendStatus. Thứ tự chèn được giữ nguyên trừ phi bạn phát ra cùng một khoá nhiều lần. Xin lưu ý rằng các khoá tiêu chuẩn được xác định trong IInstrumentationResultParser.StatusKeys sẽ bị lọc ra khỏi Map này. Ddmlib có thể thêm các chỉ số kiểm thử bổ sung được xác định trong IInstrumentationResultParser.StatusKeys.

testFailed

public abstract void testFailed (TestIdentifier 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 TestIdentifier: xác định kiểm thử
trace String: dấu vết ngăn xếp của lỗi

testIgnored

public abstract void testIgnored (TestIdentifier test)

Được gọi khi một 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 TestIdentifier: xác định kiểm thử

testRunEnded

public abstract void testRunEnded (long elapsedTime, 
                Map<String, String> runMetrics)

Báo cáo thời điểm kết thúc lần chạy kiểm thử.

Tham số
elapsedTime long: thời gian đã trôi qua được thiết bị báo cáo, tính bằng mili giây
runMetrics Map: Map của các chỉ số được phát ra trong quá trình thực thi trường hợp kiểm thử bằng android.app.Instrumentation#addResults. Thứ tự chèn được giữ nguyên trừ phi bạn phát ra cùng một khoá nhiều lần. Xin lưu ý rằng các khoá tiêu chuẩn được xác định trong IInstrumentationResultParser.StatusKeys sẽ bị lọc ra khỏi Map này. Ddmlib có thể thêm các chỉ số kiểm thử bổ sung được xác định trong IInstrumentationResultParser.StatusKeys.

testRunFailed

public abstract void testRunFailed (String errorMessage)

Báo cáo rằng lần chạy kiểm thử không hoàn tất do 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 abstract 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ử

testRunStopped

public abstract void testRunStopped (long elapsedTime)

Phương thức này không được dùng nữa.
Lệnh gọi lại này sẽ không bao giờ được gọi. Sẽ bị xoá.

Báo cáo rằng lần chạy kiểm thử đã dừng trước khi hoàn tất do yêu cầu của người dùng.

Tham số
elapsedTime long: thời gian đã trôi qua được thiết bị báo cáo, tính bằng mili giây

testStarted

public abstract void testStarted (TestIdentifier test)

Báo cáo thời điểm bắt đầu một trường hợp kiểm thử riêng lẻ.

Tham số
test TestIdentifier: xác định kiểm thử