ProtoResultReporter
public abstract class ProtoResultReporter
extends Object
implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults
java.lang.Object | |
↳ | com.android.tradefed.result.proto.ProtoResultReporter |
Người báo cáo kết quả xây dựng một protobuf TestRecord
với tất cả các kết quả bên trong. Nên được mở rộng để xử lý những việc cần làm với proto cuối cùng trong processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord)
.
Bản tóm tắt
nhà thầu công cộng | |
---|---|
ProtoResultReporter () |
Phương thức công khai | |
---|---|
final void | invocationEnded (long elapsedTime) Báo cáo rằng lời gọi đã kết thúc, cho dù thành công hay do một số điều kiện lỗi. |
void | invocationFailed ( FailureDescription failure) Báo cáo một lệnh gọi không đầy đủ do một số điều kiện lỗi. |
void | invocationFailed (Throwable cause) Báo cáo một lệnh gọi không đầy đủ do một số điều kiện lỗi. |
final void | invocationStarted ( IInvocationContext context) Báo cáo bắt đầu yêu cầu thử nghiệm. |
final void | logAssociation (String dataName, LogFile logFile) Trong một số trường hợp, nhật ký phải được liên kết chặt chẽ với một trường hợp thử nghiệm, nhưng cơ hội để làm như vậy trên |
void | processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs) Sử dụng bản ghi lời gọi để gửi lần lượt tất cả nhật ký cuối cùng của lời gọi. |
void | processFinalProto (TestRecordProto.TestRecord finalRecord) Xử lý proto cuối cùng với tất cả các kết quả. |
void | processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext) Xử lý proto bản ghi kiểm tra yêu cầu một phần sau khi xảy ra |
void | processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord) Xử lý proto bản ghi trường hợp thử nghiệm đã hoàn thành sau khi Xảy ra |
void | processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord) Xử lý nguyên bản bản ghi trường hợp thử nghiệm một phần sau khi |
void | processTestModuleEnd (TestRecordProto.TestRecord moduleRecord) Xử lý nguyên mẫu bản ghi mô-đun đã hoàn thiện sau khi |
void | processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord) Xử lý proto bản ghi một phần mô-đun sau khi |
void | processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress) Xử lý nguyên mẫu bản ghi chạy đã hoàn thành sau khi Xảy ra |
void | processTestRunStarted (TestRecordProto.TestRecord runStartedRecord) Xử lý proto bản ghi chạy thử một phần sau khi |
void | setGranularResults (boolean granularResults) |
void | setInlineRecordOfChildren (boolean inline) |
boolean | supportGranularResults () Trả về True nếu trình báo cáo hỗ trợ kết quả chi tiết, ngược lại là false. |
final void | testAssumptionFailure ( TestDescription test, String trace) Được gọi khi một thử nghiệm nguyên tử báo hiệu rằng nó giả định một điều kiện sai |
final void | testAssumptionFailure ( TestDescription test, FailureDescription failure) Được gọi khi một thử nghiệm nguyên tử báo hiệu rằng nó giả định một điều kiện sai |
final void | testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) Thay thế cho |
void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Báo cáo kết thúc thực hiện của một trường hợp thử nghiệm riêng lẻ. |
final void | testFailed ( TestDescription test, FailureDescription failure) Báo cáo sự thất bại của một trường hợp thử nghiệm cá nhân. |
final void | testFailed ( TestDescription test, String trace) Báo cáo sự thất bại của một trường hợp thử nghiệm cá nhân. |
final void | testIgnored ( TestDescription test) Được gọi khi không chạy thử nghiệm, thường là do phương pháp thử nghiệm được chú thích bằng org.junit.Ignore. |
final void | testModuleEnded () Báo cáo kết thúc chạy mô-đun. |
final void | testModuleStarted ( IInvocationContext moduleContext) Báo cáo sự khởi đầu của một mô-đun đang chạy. |
final void | testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics) Báo cáo kết thúc chạy thử. |
final void | testRunFailed ( FailureDescription failure) Báo cáo chạy thử nghiệm không thể hoàn thành do lỗi được mô tả bởi |
final void | testRunFailed (String errorMessage) Báo cáo chạy thử nghiệm không thể hoàn thành do một lỗi nghiêm trọng. |
void | testRunStarted (String runName, int testCount, int attemptNumber) Báo cáo bắt đầu chạy thử. |
final void | testRunStarted (String runName, int testCount) Báo cáo bắt đầu chạy thử. |
void | testRunStarted (String runName, int testCount, int attemptNumber, long startTime) Báo cáo bắt đầu chạy thử. |
final void | testStarted ( TestDescription test, long startTime) Thay thế cho |
final void | testStarted ( TestDescription test) Báo cáo sự bắt đầu của một trường hợp thử nghiệm cá nhân. |
phương pháp được bảo vệ | |
---|---|
TestRecordProto.ChildReference | createModuleChildReference (TestRecordProto.TestRecord record) Tạo một tham chiếu con cho một mô-đun. |
nhà thầu công cộng
ProtoResultReporter
public ProtoResultReporter ()
Phương thức công khai
lời gọiĐã kết thúc
public final void invocationEnded (long elapsedTime)
Báo cáo rằng lời gọi đã kết thúc, cho dù thành công hay do một số điều kiện lỗi.
Sẽ được gọi tự động bởi khung TradeFederation.Thông số | |
---|---|
elapsedTime | long : thời gian đã trôi qua của lời gọi tính bằng ms |
lời gọiThất bại
public void invocationFailed (FailureDescription failure)
Báo cáo một lệnh gọi không đầy đủ do một số điều kiện lỗi.
Sẽ được gọi tự động bởi khung TradeFederation.
Thông số | |
---|---|
failure | FailureDescription : FailureDescription mô tả nguyên nhân lỗi |
lời gọiThất bại
public void invocationFailed (Throwable cause)
Báo cáo một lệnh gọi không đầy đủ do một số điều kiện lỗi.
Sẽ được gọi tự động bởi khung TradeFederation.Thông số | |
---|---|
cause | Throwable : nguyên nhân ERROR(/Throwable) gây ra lỗi |
lời gọiBắt đầu
public final void invocationStarted (IInvocationContext context)
Báo cáo bắt đầu yêu cầu thử nghiệm.
Sẽ được gọi tự động bởi khung TradeFederation. Người báo cáo cần ghi đè phương thức này để hỗ trợ báo cáo trên nhiều thiết bị.
Thông số | |
---|---|
context | IInvocationContext : thông tin về lời gọi |
đăng nhập hiệp hội
public final void logAssociation (String dataName, LogFile logFile)
Trong một số trường hợp, nhật ký phải được liên kết chặt chẽ với một trường hợp thử nghiệm, nhưng cơ hội để làm như vậy trên testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
không thể gọi lại testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
. Do đó, cuộc gọi lại này cho phép cung cấp một liên kết mạnh mẽ một cách rõ ràng.
Thông số | |
---|---|
dataName | String : Tên của dữ liệu |
logFile | LogFile : LogFile đã được ghi lại trước đó và phải được liên kết với trường hợp thử nghiệm. |
processFinalInvocationLogs
public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)
Sử dụng bản ghi lời gọi để gửi lần lượt tất cả nhật ký cuối cùng của lời gọi.
Thông số | |
---|---|
invocationLogs | TestRecordProto.TestRecord : Proto hoàn thiện đại diện cho lệnh gọi. |
processFinalProto
public void processFinalProto (TestRecordProto.TestRecord finalRecord)
Xử lý proto cuối cùng với tất cả các kết quả.
Thông số | |
---|---|
finalRecord | TestRecordProto.TestRecord : Proto đã hoàn thiện với tất cả các kết quả gọi. |
quá trìnhBắt đầuYêu cầu
public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)
Xử lý proto bản ghi kiểm tra yêu cầu một phần sau khi xảy ra invocationStarted(com.android.tradefed.invoker.IInvocationContext)
.
Thông số | |
---|---|
invocationStartRecord | TestRecordProto.TestRecord : Proto một phần được điền sau lệnh gọiStart. |
invocationContext | IInvocationContext : Lời gọi IInvocationContext . |
quá trìnhTestCaseĐã kết thúc
public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)
Xử lý proto bản ghi trường hợp thử nghiệm đã hoàn thành sau khi Xảy ra ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap))
.
Thông số | |
---|---|
testCaseRecord | TestRecordProto.TestRecord : Proto hoàn chỉnh đại diện cho một trường hợp thử nghiệm. |
quá trìnhTestCaseBắt đầu
public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)
Xử lý nguyên bản bản ghi trường hợp thử nghiệm một phần sau khi testStarted(com.android.tradefed.result.TestDescription, long)
xảy ra.
Thông số | |
---|---|
testCaseStartedRecord | TestRecordProto.TestRecord : Proto một phần đại diện cho trường hợp thử nghiệm. |
processTestModuleEnd
public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)
Xử lý nguyên mẫu bản ghi mô-đun đã hoàn thiện sau khi testModuleEnded()
xảy ra.
Thông số | |
---|---|
moduleRecord | TestRecordProto.TestRecord : Proto hoàn thiện đại diện cho mô-đun. |
processTestModuleStarted
public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)
Xử lý proto bản ghi một phần mô-đun sau khi testModuleStarted(com.android.tradefed.invoker.IInvocationContext)
xảy ra.
Thông số | |
---|---|
moduleStartRecord | TestRecordProto.TestRecord : Proto một phần đại diện cho mô-đun. |
processTestRunEnded
public void processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress)
Xử lý nguyên mẫu bản ghi chạy đã hoàn thành sau khi Xảy ra ERROR(/#testRunEnded(long,HashMap))
.
Thông số | |
---|---|
runRecord | TestRecordProto.TestRecord : Proto hoàn thiện đại diện cho quá trình chạy. |
moduleInProgress | boolean : có hay không một mô-đun đang được tiến hành. |
quá trìnhTestRunBắt đầu
public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)
Xử lý proto bản ghi chạy thử một phần sau khi testRunStarted(String, int)
xảy ra.
Thông số | |
---|---|
runStartedRecord | TestRecordProto.TestRecord : Proto một phần đại diện cho quá trình chạy. |
setGranularResults
public void setGranularResults (boolean granularResults)
Thông số | |
---|---|
granularResults | boolean |
setInlineRecordOfTrẻ em
public void setInlineRecordOfChildren (boolean inline)
Thông số | |
---|---|
inline | boolean |
hỗ trợGranularResults
public boolean supportGranularResults ()
Trả về True nếu trình báo cáo hỗ trợ kết quả chi tiết, ngược lại là false.
trả lại | |
---|---|
boolean |
kiểm traGiả địnhThất bại
public final void testAssumptionFailure (TestDescription test, String trace)
Được gọi khi một thử nghiệm nguyên tử báo hiệu rằng nó giả định một điều kiện sai
Thông số | |
---|---|
test | TestDescription : xác định bài kiểm tra |
trace | String : dấu vết ngăn xếp của lỗi |
kiểm traGiả địnhThất bại
public final void testAssumptionFailure (TestDescription test, FailureDescription failure)
Được gọi khi một thử nghiệm nguyên tử báo hiệu rằng nó giả định một điều kiện sai
Thông số | |
---|---|
test | TestDescription : xác định bài kiểm tra |
failure | FailureDescription : FailureDescription mô tả lỗi và bối cảnh của nó. |
thử nghiệmĐã kết thúc
public final void testEnded (TestDescription test, long endTime,testMetrics)
Thay thế cho ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
nơi chúng tôi có thể chỉ định trực tiếp thời gian kết thúc. Kết hợp với testStarted(com.android.tradefed.result.TestDescription, long)
để đo lường chính xác.
Thông số | |
---|---|
test | TestDescription : xác định bài kiểm tra |
endTime | long : thời gian thử nghiệm kết thúc, được đo thông qua ERROR(/System#currentTimeMillis()) |
testMetrics | ERROR(/Map) của các chỉ số được phát ra |
thử nghiệmĐã kết thúc
public void testEnded (TestDescription test,testMetrics)
Báo cáo kết thúc thực hiện của một trường hợp thử nghiệm riêng lẻ.
Nếu testFailed(TestDescription, FailureDescription)
không được gọi, thì thử nghiệm này đã vượt qua. Đồng thời trả về bất kỳ số liệu khóa/giá trị nào có thể đã được đưa ra trong quá trình thực thi trường hợp thử nghiệm.
Thông số | |
---|---|
test | TestDescription : xác định bài kiểm tra |
testMetrics | ERROR(/Map) của các chỉ số được phát ra |
thử nghiệm thất bại
public final void testFailed (TestDescription test, FailureDescription failure)
Báo cáo sự thất bại của một trường hợp thử nghiệm cá nhân.
Sẽ được gọi giữa testStarted và testEnded.
Thông số | |
---|---|
test | TestDescription : xác định bài kiểm tra |
failure | FailureDescription : FailureDescription mô tả lỗi và bối cảnh của nó. |
thử nghiệm thất bại
public final void testFailed (TestDescription test, String trace)
Báo cáo sự thất bại của một trường hợp thử nghiệm cá nhân.
Sẽ được gọi giữa testStarted và testEnded.
Thông số | |
---|---|
test | TestDescription : xác định bài kiểm tra |
trace | String : dấu vết ngăn xếp của lỗi |
kiểm traBỏ qua
public final void testIgnored (TestDescription test)
Được gọi khi không chạy thử nghiệm, thường là do phương pháp thử nghiệm được chú thích bằng org.junit.Ignore.
Thông số | |
---|---|
test | TestDescription : xác định bài kiểm tra |
testModuleEnded
public final void testModuleEnded ()
Báo cáo kết thúc chạy mô-đun.
testModuleBắt đầu
public final void testModuleStarted (IInvocationContext moduleContext)
Báo cáo sự khởi đầu của một mô-đun đang chạy. Cuộc gọi lại này được liên kết với testModuleEnded()
và là tùy chọn trong trình tự. Nó chỉ được sử dụng trong quá trình chạy sử dụng các mô-đun: người chạy dựa trên bộ.
Thông số | |
---|---|
moduleContext | IInvocationContext : IInvocationContext của mô-đun. |
testRunEnded
public final void testRunEnded (long elapsedTimeMillis,runMetrics)
Báo cáo kết thúc chạy thử. KHẮC PHỤC: Chúng tôi không thể có hai giao diện Map<> với loại khác nhau, vì vậy chúng tôi phải sử dụng HashMap tại đây.
Thông số | |
---|---|
elapsedTimeMillis | long : thiết bị báo cáo thời gian đã trôi qua, tính bằng mili giây |
runMetrics | Metric . |
testRunThất bại
public final void testRunFailed (FailureDescription failure)
Báo cáo chạy thử nghiệm không thể hoàn thành do lỗi được mô tả bởi FailureDescription
.
Thông số | |
---|---|
failure | FailureDescription : FailureDescription mô tả lỗi và bối cảnh của nó. |
testRunThất bại
public final void testRunFailed (String errorMessage)
Báo cáo chạy thử nghiệm không thể hoàn thành do một lỗi nghiêm trọng.
Thông số | |
---|---|
errorMessage | String : ERROR(/String) mô tả lý do chạy không thành công. |
testRunBắt đầu
public void testRunStarted (String runName, int testCount, int attemptNumber)
Báo cáo bắt đầu chạy thử.
Thông số | |
---|---|
runName | String : tên chạy thử nghiệm |
testCount | int : tổng số bài kiểm tra trong quá trình chạy 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. Cố gắngNumber được lập chỉ mục 0 và sẽ tăng lên mỗi khi một lần chạy mới diễn ra. ví dụ: Một bài kiểm tra được thử lại chi tiết 3 lần, nó phải có tổng cộng 4 lần chạy dưới cùng một tên chạy và số lần thử là từ 0 đến 3. |
testRunBắt đầu
public final void testRunStarted (String runName, int testCount)
Báo cáo bắt đầu chạy thử.
Thông số | |
---|---|
runName | String : tên chạy thử nghiệm |
testCount | int : tổng số bài kiểm tra trong quá trình chạy thử |
testRunBắt đầu
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Báo cáo bắt đầu chạy thử.
Thông số | |
---|---|
runName | String : tên chạy thử nghiệm |
testCount | int : tổng số bài kiểm tra trong quá trình chạy 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. Cố gắngNumber được lập chỉ mục 0 và sẽ tăng lên mỗi khi một lần chạy mới diễn ra. ví dụ: Một bài kiểm tra được thử lại chi tiết 3 lần, nó phải có tổng cộng 4 lần chạy dưới cùng một tên chạy và số lần thử là từ 0 đến 3. |
startTime | long : thời gian bắt đầu chạy, được đo thông qua ERROR(/System#currentTimeMillis()) |
thử nghiệmBắt đầu
public final void testStarted (TestDescription test, long startTime)
Thay thế cho testStarted(com.android.tradefed.result.TestDescription)
trong đó chúng tôi cũng chỉ định thời điểm bắt đầu thử nghiệm, kết hợp với ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
để đo lường chính xác .
Thông số | |
---|---|
test | TestDescription : xác định bài kiểm tra |
startTime | long : thời gian bắt đầu kiểm tra, được đo thông qua ERROR(/System#currentTimeMillis()) |
thử nghiệmBắt đầu
public final void testStarted (TestDescription test)
Báo cáo sự bắt đầu của một trường hợp thử nghiệm cá nhân. Giao diện cũ hơn, nên sử dụng testStarted(com.android.tradefed.result.TestDescription)
bất cứ khi nào có thể.
Thông số | |
---|---|
test | TestDescription : xác định bài kiểm tra |
phương pháp được bảo vệ
tạoModuleChildReference
protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)
Tạo một tham chiếu con cho một mô-đun.
Thông số | |
---|---|
record | TestRecordProto.TestRecord |
trả lại | |
---|---|
TestRecordProto.ChildReference |