BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

java.lang.Object
   ↳ com.android.tradefed.device.metric.BaseDeviceMetricCollector

Cách triển khai cơ bản của IMetricCollector cho phép bắt đầu và dừng thu thập trên onTestRunStart(DeviceMetricData) và onTestRunEnd(DeviceMetricData,Map).

Tóm tắt

Hằng số

String TEST_CASE_EXCLUDE_GROUP_OPTION

String TEST_CASE_INCLUDE_GROUP_OPTION

Hàm khởi tạo công khai

BaseDeviceMetricCollector()

Phương thức công khai

boolean doesModuleContainFailure()

Trả về true nếu mô-đun hiện tại có chứa trường hợp kiểm thử hoặc lần chạy kiểm thử nào bị lỗi.

void enableDefaultMetricCollection()

Cho phép các trình thu thập bật chế độ thu thập chỉ số mặc định.

void extraInit(IInvocationContext context, ITestInvocationListener listener)
IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel()
final List<IBuildInfo> getBuildInfos()

Trả về danh sách thông tin bản dựng có trong lệnh gọi.

final List<ITestDevice> getDevices()

Trả về danh sách các thiết bị có trong lệnh gọi.

File getFileFromTestArtifacts(String fileName)

Truy xuất tệp từ các cấu phần phần mềm kiểm thử hoặc cấu phần phần mềm mô-đun và lưu vào bộ nhớ đệm trong một bản đồ cho các lệnh gọi tiếp theo.

final ITestInvocationListener getInvocationListener()

Trả về ITestInvocationListener ban đầu nơi chúng tôi chuyển tiếp kết quả.

String getModuleName()
IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel()
final List<ITestDevice> getRealDevices()

Trả về tất cả các thiết bị không phải là thiết bị thay thế trong danh sách getDevices().

String getRunName()

Trả về tên của lần chạy thử mRunName kích hoạt bộ sưu tập.

String getTestName()

Trả về tên của kiểm thử mTestName kích hoạt trình thu thập.

final ITestInvocationListener init(IInvocationContext context, ITestInvocationListener listener)

Khởi chạy trình thu thập bằng ngữ cảnh hiện tại và nơi chuyển tiếp kết quả.

final void invocationEnded(long elapsedTime)

Báo cáo rằng lời gọi đã chấm dứt, cho dù thành công hay do một số điều kiện lỗi.

final void invocationFailed(FailureDescription failure)

Báo cáo một lệnh gọi chưa hoàn chỉnh do một số điều kiện lỗi.

final void invocationFailed(Throwable cause)

Báo cáo một lệnh gọi chưa hoàn chỉnh do một số điều kiện lỗi.

void invocationSkipped(SkipReason reason)

Báo cáo một lệnh gọi là đã bỏ qua

final void invocationStarted(IInvocationContext context)

Trình nghe lời gọi để chuyển tiếp

boolean isDefaultMetricCollectionEnabled()

Liệu trình thu thập có đang thu thập chỉ số trong quá trình thu thập chỉ số mặc định hay không.

final boolean isDisabled()

Trả về True nếu toàn bộ đối tượng bị vô hiệu hoá (bỏ qua cả quá trình thiết lập và huỷ).

boolean isDisabledReceiver()

IDeviceActionReceiver có bị vô hiệu hoá hay không.

final void logAssociation(String dataName, LogFile logFile)

Không sử dụng trong quá trình triển khai bộ thu thập chỉ số.

void onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)

Lệnh gọi lại khi một trường hợp kiểm thử không thành công do giả định không thành công.

void onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)

Lệnh gọi lại khi một trường hợp kiểm thử kết thúc.

void onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)

Lệnh gọi lại khi một trường hợp kiểm thử kết thúc.

void onTestFail(DeviceMetricData testData, TestDescription test)

Lệnh gọi lại khi một trường hợp kiểm thử không thành công.

void onTestModuleEnded()

Cho phép ghi lại sự kiện kết thúc mô-đun.

void onTestModuleStarted()

Cho phép ghi lại sự kiện mô-đun đã bắt đầu.

void onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)

Lệnh gọi lại khi một lần chạy thử nghiệm kết thúc.

void onTestRunFailed(DeviceMetricData testData, FailureDescription failure)

Lệnh gọi lại cho các sự kiện testRunFailed

void onTestRunStart(DeviceMetricData runData)

Lệnh gọi lại khi một lần chạy kiểm thử bắt đầu.

void onTestStart(DeviceMetricData testData)

Lệnh gọi lại khi một trường hợp kiểm thử bắt đầu.

void rebootEnded(ITestDevice device)

Nhận thông báo khi quá trình khởi động lại kết thúc trên thiết bị.

void rebootStarted(ITestDevice device)

Nhận thông báo khi quá trình khởi động lại bắt đầu trên thiết bị.

void setAlwaysOnCollectionLevel(IMetricCollector.MetricCollectionLevel level)

Đặt cấp độ mà trình thu thập sẽ thu thập nhật ký bất kể lỗi.

final void setDisable(boolean isDisabled)

Đặt xem có nên tắt đối tượng hay không.

void setDisableReceiver(boolean isDisabled)

Đặt xem có nên tắt IDeviceActionReceiver hay không.

final void setLogSaver(ILogSaver logSaver)

Không sử dụng trong quá trình triển khai bộ thu thập chỉ số.

void setModuleContainsFailure()

Đặt xem mô-đun có lỗi nào không (trường hợp kiểm thử, lần chạy kiểm thử).

void setOnFailureCollectionLevel(IMetricCollector.MetricCollectionLevel level)

Đặt cấp độ mà trình thu thập sẽ thu thập nhật ký trong trường hợp xảy ra lỗi.

final 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

final 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

final 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.

final 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ẻ.

final 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ẻ.

final 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ẻ.

final 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.

final void testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)

Cung cấp nhật ký hoặc dữ liệu gỡ lỗi được liên kết từ lệnh gọi kiểm thử.

final void testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

Không sử dụng trong quá trình triển khai bộ thu thập chỉ số.

final void testModuleEnded()

Báo cáo thời điểm kết thúc một lần chạy mô-đun.

final void testModuleStarted(IInvocationContext moduleContext)

Báo cáo thời điểm bắt đầu chạy một mô-đun.

final void testRunEnded(long elapsedTime, 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ử.

final 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.

final 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.

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

final void testRunStarted(String runName, int testCount)

Cuộc gọi lại chạy thử

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

final 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.

final 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.

final 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.

final void testStarted(TestDescription test)

Lệnh gọi lại trường hợp kiểm thử

Hằng số

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

Giá trị không đổi: "test-case-exclude-group"

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

Giá trị không đổi: "test-case-include-group"

Hàm khởi tạo công khai

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

Phương thức công khai

doesModuleContainFailure

public boolean doesModuleContainFailure ()

Trả về true nếu mô-đun hiện tại có chứa trường hợp kiểm thử hoặc lần chạy kiểm thử nào bị lỗi.

Giá trị trả về
boolean

enableDefaultMetricCollection

public void enableDefaultMetricCollection ()

Cho phép các trình thu thập bật chế độ thu thập chỉ số mặc định. Khi chế độ thu thập chỉ số mặc định được bật, bộ thu thập chỉ nên thu thập ở cấp thu thập được chỉ định.

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAlwaysOnCollectionLevel

public IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel ()

Giá trị trả về
IMetricCollector.MetricCollectionLevel

getBuildInfos

public final List<IBuildInfo> getBuildInfos ()

Trả về danh sách thông tin bản dựng có trong lệnh gọi.

Giá trị trả về
List<IBuildInfo>

getDevices

public final List<ITestDevice> getDevices ()

Trả về danh sách các thiết bị có trong lệnh gọi.

Giá trị trả về
List<ITestDevice>

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

Truy xuất tệp từ các cấu phần phần mềm kiểm thử hoặc cấu phần phần mềm mô-đun và lưu vào bộ nhớ đệm trong một bản đồ cho các lệnh gọi tiếp theo.

Tham số
fileName String: tên của tệp cần tra cứu trong các cấu phần phần mềm.
Giá trị trả về
File Tệp từ cấu phần phần mềm kiểm thử hoặc cấu phần phần mềm mô-đun. Trả về giá trị rỗng nếu không tìm thấy tệp.

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

Trả về ITestInvocationListener ban đầu nơi chúng tôi chuyển tiếp kết quả.

Giá trị trả về
ITestInvocationListener

getModuleName

public String getModuleName ()

Giá trị trả về
String

getOnFailureCollectionLevel

public IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel ()

Giá trị trả về
IMetricCollector.MetricCollectionLevel

getRealDevices

public final List<ITestDevice> getRealDevices ()

Trả về tất cả các thiết bị không phải là thiết bị thay thế trong danh sách getDevices().

Giá trị trả về
List<ITestDevice>

getRunName

public String getRunName ()

Trả về tên của lần chạy thử mRunName kích hoạt bộ sưu tập.

Giá trị trả về
String mRunName, tên của lần chạy kiểm thử hiện tại.

getTestName

public String getTestName ()

Trả về tên của kiểm thử mTestName kích hoạt trình thu thập.

Giá trị trả về
String mTestName, tên kiểm thử hiện tại.

init

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Khởi chạy trình thu thập bằng ngữ cảnh hiện tại và nơi chuyển tiếp kết quả. Chỉ được gọi một lần cho mỗi phiên bản và trình thu thập dự kiến sẽ cập nhật ngữ cảnh và trình nghe nội bộ của phiên bản đó. Init sẽ không bao giờ được gọi trong quá trình chạy thử mà luôn được gọi trước đó.

Đừng ghi đè trừ phi bạn biết mình đang làm gì.

Tham số
context IInvocationContext: IInvocationContext cho lời gọi đang diễn ra.
listener ITestInvocationListener: ITestInvocationListener nơi đặt kết quả.
Giá trị trả về
ITestInvocationListener trình nghe mới bao bọc trình nghe ban đầu.
Gửi
DeviceNotAvailableException

invocationEnded

public final void invocationEnded (long elapsedTime)

Báo cáo rằng lời gọi đã chấm dứt, cho dù thành công hay do một số điều kiện lỗi.

Sẽ được khung TradeFederation tự động gọi.

Tham số
elapsedTime long: thời gian đã trôi qua của lệnh gọi (tính bằng mili giây)

invocationFailed

public final void invocationFailed (FailureDescription failure)

Báo cáo một lệnh gọi chưa hoàn chỉnh do một số điều kiện lỗi.

Sẽ được khung TradeFederation tự động gọi.

Tham số
failure FailureDescription: FailureDescription mô tả nguyên nhân gây ra lỗi

invocationFailed

public final void invocationFailed (Throwable cause)

Báo cáo một lệnh gọi chưa hoàn chỉnh do một số điều kiện lỗi.

Sẽ được khung TradeFederation tự động gọi.

Tham số
cause Throwable: nguyên nhân Throwable gây ra lỗi

invocationSkipped

public void invocationSkipped (SkipReason reason)

Báo cáo một lệnh gọi là đã bỏ qua

Tham số
reason SkipReason

invocationStarted

public final void invocationStarted (IInvocationContext context)

Trình nghe lời gọi để chuyển tiếp

Tham số
context IInvocationContext: thông tin về lệnh gọi

isDefaultMetricCollectionEnabled

public boolean isDefaultMetricCollectionEnabled ()

Liệu trình thu thập có đang thu thập chỉ số trong quá trình thu thập chỉ số mặc định hay không.

Giá trị trả về
boolean

isDisabled

public final boolean isDisabled ()

Trả về True nếu toàn bộ đối tượng bị vô hiệu hoá (bỏ qua cả quá trình thiết lập và huỷ). Nếu không thì trả về giá trị false.

Giá trị trả về
boolean

isDisabledReceiver

public boolean isDisabledReceiver ()

IDeviceActionReceiver có bị vô hiệu hoá hay không.

Giá trị trả về
boolean trả về true nếu bị vô hiệu hoá, trả về false nếu không.

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

Không sử dụng trong quá trình triển khai bộ thu thập chỉ số. Đây là tính năng chuyển tiếp thuần tuý.

Tham số
dataName String: Tên của dữ liệu
logFile LogFile: LogFile đã được ghi nhật ký trước đó và phải được liên kết với trường hợp kiểm thử.

onTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Lệnh gọi lại khi một trường hợp kiểm thử không thành công do giả định không thành công.

Tham số
testData DeviceMetricData: DeviceMetricData chứa dữ liệu cho trường hợp kiểm thử.
test TestDescription: TestDescription của trường hợp kiểm thử đang diễn ra.
Gửi
DeviceNotAvailableException

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)

Lệnh gọi lại khi một trường hợp kiểm thử kết thúc. Đây là thời điểm dọn dẹp.

Tham số
testData DeviceMetricData: DeviceMetricData chứa dữ liệu cho trường hợp kiểm thử. Sẽ là cùng một đối tượng như trong onTestStart(DeviceMetricData).
currentTestCaseMetrics Map: bản đồ hiện tại của các chỉ số được truyền đến testEnded(TestDescription,Map).
Gửi
DeviceNotAvailableException

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, 
                TestDescription test)

Lệnh gọi lại khi một trường hợp kiểm thử kết thúc. Đây là thời điểm dọn dẹp.

Tham số
testData DeviceMetricData: DeviceMetricData chứa dữ liệu cho trường hợp kiểm thử. Sẽ là cùng một đối tượng như trong onTestStart(DeviceMetricData).
currentTestCaseMetrics Map: bản đồ hiện tại của các chỉ số được truyền đến testEnded(TestDescription,Map).
test TestDescription: TestDescription của trường hợp kiểm thử đang diễn ra.
Gửi
DeviceNotAvailableException

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Lệnh gọi lại khi một trường hợp kiểm thử không thành công.

Tham số
testData DeviceMetricData: DeviceMetricData chứa dữ liệu cho trường hợp kiểm thử.
test TestDescription: TestDescription của trường hợp kiểm thử đang diễn ra.
Gửi
DeviceNotAvailableException

onTestModuleEnded

public void onTestModuleEnded ()

Cho phép ghi lại sự kiện kết thúc mô-đun.

Gửi
DeviceNotAvailableException

onTestModuleStarted

public void onTestModuleStarted ()

Cho phép ghi lại sự kiện mô-đun đã bắt đầu.

Gửi
DeviceNotAvailableException

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                Map<String, MetricMeasurement.Metric> currentRunMetrics)

Lệnh gọi lại khi một lần chạy thử nghiệm kết thúc. Đây là thời điểm dọn dẹp.

Tham số
runData DeviceMetricData: DeviceMetricData chứa dữ liệu cho lần chạy. Sẽ là cùng một đối tượng như trong onTestRunStart(DeviceMetricData).
currentRunMetrics Map: bản đồ hiện tại của các chỉ số được truyền đến testRunEnded(long,Map).
Gửi
DeviceNotAvailableException

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Lệnh gọi lại cho các sự kiện testRunFailed

Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

Lệnh gọi lại khi một lần chạy kiểm thử bắt đầu.

Tham số
runData DeviceMetricData: DeviceMetricData chứa dữ liệu cho lần chạy.
Gửi
DeviceNotAvailableException

onTestStart

public void onTestStart (DeviceMetricData testData)

Lệnh gọi lại khi một trường hợp kiểm thử bắt đầu.

Tham số
testData DeviceMetricData: DeviceMetricData chứa dữ liệu cho trường hợp kiểm thử.
Gửi
DeviceNotAvailableException

rebootEnded

public void rebootEnded (ITestDevice device)

Nhận thông báo khi quá trình khởi động lại kết thúc trên thiết bị.

LƯU Ý: Các thiết bị nhận không nên khởi động lại trong lệnh gọi lại này. Mọi nỗ lực khởi động lại đều sẽ bị bỏ qua.

Tham số
device ITestDevice: ITestDevice nơi quá trình khởi động lại kết thúc.
Gửi
DeviceNotAvailableException

rebootStarted

public void rebootStarted (ITestDevice device)

Nhận thông báo khi quá trình khởi động lại bắt đầu trên thiết bị.

LƯU Ý: Các thiết bị nhận không nên khởi động lại trong lệnh gọi lại này. Mọi nỗ lực khởi động lại đều sẽ bị bỏ qua.

Tham số
device ITestDevice: ITestDevice nơi bắt đầu quá trình khởi động lại.
Gửi
DeviceNotAvailableException

setAlwaysOnCollectionLevel

public void setAlwaysOnCollectionLevel (IMetricCollector.MetricCollectionLevel level)

Đặt cấp độ mà trình thu thập sẽ thu thập nhật ký bất kể lỗi.

Cấp độ NULL sẽ không tạo ra bộ sưu tập.

Tham số
level IMetricCollector.MetricCollectionLevel: MetricCollectionLevel mà nhật ký sẽ được thu thập.

setDisable

public final void setDisable (boolean isDisabled)

Đặt xem có nên tắt đối tượng hay không. Tắt có nghĩa là bạn nên bỏ qua cả bước thiết lập và bước tháo dỡ. Có thể dùng để tắt một đối tượng theo mặc định trong hàm khởi tạo mặc định.

Tham số
isDisabled boolean: trạng thái mà đối tượng sẽ được đặt vào.

setDisableReceiver

public void setDisableReceiver (boolean isDisabled)

Đặt xem có nên tắt IDeviceActionReceiver hay không. Nếu bạn tắt, thì ứng dụng sẽ không được đăng ký với thiết bị để nhận các sự kiện thao tác trên thiết bị.

Tham số
isDisabled boolean

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Không sử dụng trong quá trình triển khai bộ thu thập chỉ số. Đây là tính năng chuyển tiếp thuần tuý.

Tham số
logSaver ILogSaver: ILogSaver

setModuleContainsFailure

public void setModuleContainsFailure ()

Đặt xem mô-đun có lỗi nào không (trường hợp kiểm thử, lần chạy kiểm thử).

setOnFailureCollectionLevel

public void setOnFailureCollectionLevel (IMetricCollector.MetricCollectionLevel level)

Đặt cấp độ mà trình thu thập sẽ thu thập nhật ký trong trường hợp xảy ra lỗi.

Cấp độ NULL sẽ không tạo ra bộ sưu tập.

Tham số
level IMetricCollector.MetricCollectionLevel: MetricCollectionLevel mà nhật ký sẽ được thu thập.

testAssumptionFailure

public final 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 final 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 final 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 final 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

testFailed

public final 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 final 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 final 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ử

testLog

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Cung cấp nhật ký hoặc dữ liệu gỡ lỗi được liên kết từ lệnh gọi kiểm thử.

Phải được gọi trước ERROR(ITestInvocationListener.invocationFailed(Throwable)/ITestInvocationListener#invocationFailed(java.lang.Throwable) ITestInvocationListener.invocationFailed(Throwable)) hoặc ERROR(/ITestInvocationListener#invocationEnded(long))

Khung TradeFederation sẽ tự động gọi phương thức này, cung cấp nhật ký máy chủ lưu trữ và nếu có thể, nhật ký logcat của thiết bị.

Tham số
dataName String: tên mô tả String của dữ liệu. Ví dụ: "device_logcat". Lưu ý: dataName có thể không phải là duy nhất cho mỗi lệnh gọi. tức là người triển khai phải có thể xử lý nhiều lệnh gọi có cùng dataName
dataType LogDataType: LogDataType của dữ liệu
dataStream InputStreamSource: InputStreamSource của dữ liệu. Người triển khai nên gọi createInputStream để bắt đầu đọc dữ liệu và đảm bảo đóng InputStream kết quả khi hoàn tất. Phương thức gọi phải đảm bảo nguồn dữ liệu vẫn hiện diện và có thể truy cập cho đến khi phương thức testLog hoàn tất.

testLogSaved

public final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Không sử dụng trong quá trình triển khai bộ thu thập chỉ số. Đây là tính năng chuyển tiếp thuần tuý.

Tham số
dataName String: tên mô tả String của dữ liệu. Ví dụ: "device_logcat". Lưu ý: dataName có thể không phải là duy nhất cho mỗi lệnh gọi. tức là người triển khai phải có thể xử lý nhiều lệnh gọi có cùng dataName
dataType LogDataType: LogDataType của dữ liệu
dataStream InputStreamSource: InputStreamSource của dữ liệu. Người triển khai nên gọi createInputStream để bắt đầu đọc dữ liệu và đảm bảo đóng InputStream kết quả khi hoàn tất.
logFile LogFile: LogFile chứa siêu dữ liệu của tệp đã lưu.

testModuleEnded

public final void testModuleEnded ()

Báo cáo thời điểm kết thúc một lần chạy mô-đun.

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

Báo cáo thời điểm bắt đầu chạy một mô-đun. Lệnh gọi lại này được liên kết với testModuleEnded() và không bắt buộc trong chuỗi. Thao tác này chỉ được dùng trong quá trình chạy sử dụng các mô-đun: trình chạy dựa trên bộ.

Tham số
moduleContext IInvocationContext: IInvocationContext của mô-đun.

testRunEnded

public final void testRunEnded (long elapsedTime, 
                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ố
elapsedTime 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.

testRunFailed

public final 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 final 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 final 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 final void testRunStarted (String runName, 
                int testCount)

Cuộc gọi lại chạy 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 final 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 final 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 final 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 final 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 final void testStarted (TestDescription test)

Lệnh gọi lại trường hợp kiểm thử

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