ProtoResultReporter
public
abstract
class
ProtoResultReporter
extends Object
implements
ILogSaverListener,
ISupportGranularResults,
ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.proto.ProtoResultReporter |
Trình báo cáo kết quả tạo một protobuf TestRecord
với tất cả kết quả bên trong. Nên được mở rộng để xử lý việc cần làm với proto cuối cùng trong processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord)
.
Tóm tắt
Hàm khởi tạo công khai | |
---|---|
ProtoResultReporter()
|
Phương thức công khai | |
---|---|
final
void
|
invocationEnded(long elapsedTime)
Báo cáo rằng lệnh 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 chưa hoàn tất do một số điều kiện lỗi. |
void
|
invocationFailed(Throwable cause)
Báo cáo một lệnh gọi chưa hoàn tất 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 |
void
|
invocationStarted(IInvocationContext context)
Báo cáo thời điểm bắt đầu lệnh gọi kiểm thử. |
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 kiểm thử, nhưng không thể thực hiện việc này trên lệnh gọi lại |
void
|
processFinalInvocationLogs(TestRecordProto.TestRecord invocationLogs)
Sử dụng bản ghi lệnh gọi để gửi từng nhật ký cuối cùng của lệnh gọi. |
void
|
processFinalProto(TestRecordProto.TestRecord finalRecord)
Xử lý proto cuối cùng với tất cả kết quả. |
void
|
processStartInvocation(TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)
Xử lý proto bản ghi kiểm thử lệnh gọi một phần sau khi |
void
|
processTestCaseEnded(TestRecordProto.TestRecord testCaseRecord)
Xử lý proto bản ghi trường hợp kiểm thử đã hoàn tất sau khi |
void
|
processTestCaseStarted(TestRecordProto.TestRecord testCaseStartedRecord)
Xử lý proto bản ghi trường hợp kiểm thử một phần sau khi |
void
|
processTestModuleEnd(TestRecordProto.TestRecord moduleRecord)
Xử lý proto bản ghi mô-đun đã hoàn tất sau khi |
void
|
processTestModuleStarted(TestRecordProto.TestRecord moduleStartRecord)
Xử lý proto bản ghi mô-đun một phần sau khi |
void
|
processTestRunEnded(TestRecordProto.TestRecord runRecord, boolean moduleInProgress)
Xử lý proto bản ghi chạy đã hoàn tất sau khi |
void
|
processTestRunStarted(TestRecordProto.TestRecord runStartedRecord)
Xử lý proto bản ghi chạy kiểm 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, trả về false nếu không. |
final
void
|
testAssumptionFailure(TestDescription test, String trace)
Được gọi khi một kiểm thử nguyên tử gắn cờ giả định một điều kiện là sai |
final
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Được gọi khi một kiểm thử nguyên tử gắn cờ giả định một điều kiện là sai |
final
void
|
testEnded(TestDescription test, long endTime,
Thay thế |
void
|
testEnded(TestDescription test,
Báo cáo 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 chương 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
|
testModuleEnded()
Báo cáo kết thúc quá trình 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 elapsedTimeMillis,
Báo cáo kết thúc quá trình chạy kiểm thử. |
final
void
|
testRunFailed(FailureDescription failure)
Không thể hoàn tất quá trình chạy kiểm thử báo cáo do lỗi do |
final
void
|
testRunFailed(String errorMessage)
Không thể hoàn tất quá trình chạy kiểm thử báo cáo do lỗi nghiêm trọng. |
void
|
testRunStarted(String runName, int testCount, int attemptNumber)
Báo cáo thời điểm bắt đầu chạy kiểm thử. |
final
void
|
testRunStarted(String runName, int testCount)
Báo cáo thời điểm bắt đầu chạy kiểm thử. |
void
|
testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
Báo cáo thời điểm bắt đầu chạy kiểm thử. |
final
void
|
testSkipped(TestDescription test, SkipReason reason)
Được gọi khi một kiểm thử bị bỏ qua và không thực thi vì một lý do không thường xảy ra. |
final
void
|
testStarted(TestDescription test, long startTime)
Thay thế cho |
final
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 bảo vệ | |
---|---|
void
|
afterModuleEnd()
|
void
|
beforeModuleStart()
|
TestRecordProto.ChildReference
|
createModuleChildReference(TestRecordProto.TestRecord record)
Tạo tệp đối chiếu con cho một mô-đun. |
Hàm khởi tạo công khai
ProtoResultReporter
public ProtoResultReporter ()
Phương thức công khai
invocationEnded
public final void invocationEnded (long elapsedTime)
Báo cáo rằng lệnh 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 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 void invocationFailed (FailureDescription failure)
Báo cáo một lệnh gọi chưa hoàn tất 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 void invocationFailed (Throwable cause)
Báo cáo một lệnh gọi chưa hoàn tất 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 void invocationStarted (IInvocationContext context)
Báo cáo thời điểm bắt đầu lệnh gọi kiểm thử.
Sẽ được khung TradeFederation tự động gọi. Trình báo cáo cần ghi đè phương thức này để hỗ trợ báo cáo nhiều thiết bị.
Tham số | |
---|---|
context |
IInvocationContext : thông tin về lệnh gọi |
logAssociation
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 kiểm thử, nhưng không thể thực hiện việc này trên lệnh gọi lại testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
trực tiếp. Do đó, lệnh gọi lại này cho phép cung cấp một mối liên kết mạnh mẽ một cách rõ ràng.
Tham 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 kiểm thử. |
processFinalInvocationLogs
public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)
Sử dụng bản ghi lệnh gọi để gửi từng nhật ký cuối cùng của lệnh gọi.
Tham số | |
---|---|
invocationLogs |
TestRecordProto.TestRecord : Tệp proto đã hoàn tất đạ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ả kết quả.
Tham số | |
---|---|
finalRecord |
TestRecordProto.TestRecord : Tệp proto đã hoàn tất với tất cả kết quả gọi. |
processStartInvocation
public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)
Xử lý proto bản ghi kiểm thử lệnh gọi một phần sau khi invocationStarted(com.android.tradefed.invoker.IInvocationContext)
xảy ra.
Tham số | |
---|---|
invocationStartRecord |
TestRecordProto.TestRecord : Một phần proto được điền sau khi invocationStart. |
invocationContext |
IInvocationContext : Lệnh gọi IInvocationContext . |
processTestCaseEnded
public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)
Xử lý proto bản ghi trường hợp kiểm thử đã hoàn tất sau khi ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap))
xảy ra.
Tham số | |
---|---|
testCaseRecord |
TestRecordProto.TestRecord : Tệp proto đã hoàn tất đại diện cho một trường hợp kiểm thử. |
processTestCaseStarted
public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)
Xử lý proto bản ghi trường hợp kiểm thử một phần sau khi testStarted(com.android.tradefed.result.TestDescription, long)
xảy ra.
Tham số | |
---|---|
testCaseStartedRecord |
TestRecordProto.TestRecord : Một phần proto đại diện cho trường hợp kiểm thử. |
processTestModuleEnd
public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)
Xử lý proto bản ghi mô-đun đã hoàn tất sau khi testModuleEnded()
xảy ra.
Tham số | |
---|---|
moduleRecord |
TestRecordProto.TestRecord : Tệp proto đã hoàn tất đại diện cho mô-đun. |
processTestModuleStarted
public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)
Xử lý proto bản ghi mô-đun một phần sau khi testModuleStarted(com.android.tradefed.invoker.IInvocationContext)
xảy ra.
Tham số | |
---|---|
moduleStartRecord |
TestRecordProto.TestRecord : Một phần proto đại diện cho mô-đun. |
processTestRunEnded
public void processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress)
Xử lý proto bản ghi chạy đã hoàn tất sau khi ERROR(/#testRunEnded(long,HashMap))
xảy ra.
Tham số | |
---|---|
runRecord |
TestRecordProto.TestRecord : Tệp proto đã hoàn tất đại diện cho lần chạy. |
moduleInProgress |
boolean : liệu một mô-đun có đang hoạt động hay không. |
processTestRunStarted
public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)
Xử lý proto bản ghi chạy kiểm thử một phần sau khi testRunStarted(String, int)
xảy ra.
Tham số | |
---|---|
runStartedRecord |
TestRecordProto.TestRecord : Một phần proto đại diện cho lần chạy. |
setGranularResults
public void setGranularResults (boolean granularResults)
Tham số | |
---|---|
granularResults |
boolean |
setInlineRecordOfChildren
public void setInlineRecordOfChildren (boolean inline)
Tham số | |
---|---|
inline |
boolean |
supportGranularResults
public boolean supportGranularResults ()
Trả về True nếu trình báo cáo hỗ trợ kết quả chi tiết, trả về false nếu không.
Giá trị trả về | |
---|---|
boolean |
testAssumptionFailure
public final void testAssumptionFailure (TestDescription test, String trace)
Được gọi khi một kiểm thử nguyên tử gắn cờ giả định một điều kiện là 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ờ giả định một điều kiện là 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,testMetrics)
Thay thế ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
để chúng ta có thể chỉ định thời gian kết thúc trực tiếp. Kết hợp với testStarted(com.android.tradefed.result.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 lường thông qua System.currentTimeMillis() |
testMetrics |
: ERROR(/Map) của các chỉ số được phát ra |
testEnded
public void testEnded (TestDescription test,testMetrics)
Báo cáo 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 đã vượt qua. Ngoài ra, hàm này còn 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 |
TestDescription : xác định kiểm thử |
testMetrics |
: ERROR(/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 chương 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ử |
testModuleEnded
public final void testModuleEnded ()
Báo cáo kết thúc quá trình 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 trình tự. Tệp 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 elapsedTimeMillis,runMetrics)
Báo cáo kết thúc quá trình chạy kiểm thử.
Tham số | |
---|---|
elapsedTimeMillis |
long : thời gian đã trôi qua do thiết bị báo cáo, tính bằng mili giây |
runMetrics |
: 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 final void testRunFailed (FailureDescription failure)
Không thể hoàn tất quá trình chạy kiểm thử báo cáo do lỗi do FailureDescription
mô tả.
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 kiểm thử báo cáo do lỗi nghiêm trọng.
Tham số | |
---|---|
errorMessage |
String : String mô tả lý do không chạy được. |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber)
Báo cáo thời điểm bắt đầu chạy kiểm thử.
Tham số | |
---|---|
runName |
String : tên lần chạy kiểm thử |
testCount |
int : tổng số bài 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à phải tăng lên mỗi khi một lần chạy mới diễn ra. Ví dụ: Một kiểm thử được thử lại chi tiết 3 lần, thì tổng số lần chạy sẽ là 4 lần trong cùng một runName và attemptNumber sẽ từ 0 đến 3. |
testRunStarted
public final void testRunStarted (String runName, int testCount)
Báo cáo thời điểm bắt đầu chạy kiểm thử.
Tham số | |
---|---|
runName |
String : tên lần chạy kiểm thử |
testCount |
int : tổng số bài 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 chạy kiểm thử.
Tham số | |
---|---|
runName |
String : tên lần chạy kiểm thử |
testCount |
int : tổng số bài 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à phải tăng lên mỗi khi một lần chạy mới diễn ra. Ví dụ: Một kiểm thử được thử lại chi tiết 3 lần, thì tổng số lần chạy sẽ là 4 lần 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 lường thông qua System.currentTimeMillis() |
testSkipped
public final void testSkipped (TestDescription test, SkipReason reason)
Được gọi khi một kiểm thử bị bỏ qua và không thực thi vì một lý do không thường xảy ra. Các kiểm thử này sẽ được thử lại để cố gắng thực thi đú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)
Thay thế cho testStarted(com.android.tradefed.result.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 ERROR(/#testEnded(com.android.tradefed.result.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 lường thông qua System.currentTimeMillis() |
testStarted
public final 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 sử dụng testStarted(com.android.tradefed.result.TestDescription)
bất cứ khi nào có thể.
Tham số | |
---|---|
test |
TestDescription : xác định kiểm thử |
Phương thức được bảo vệ
afterModuleEnd
protected void afterModuleEnd ()
beforeModuleStart
protected void beforeModuleStart ()
createModuleChildReference
protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)
Tạo tệp đối chiếu con cho một mô-đun.
Tham số | |
---|---|
record |
TestRecordProto.TestRecord |
Trả về | |
---|---|
TestRecordProto.ChildReference |