Trình báo cáo kết quả Proto

public abstract class ProtoResultReporter
extends Object implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults

java.lang.Object
com.android.tradefed.result.proto.ProtoResultReporter


Trình 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 xây dựng công cộng

ProtoResultReporter ()

Phương pháp công khai

final void invocationEnded (long elapsedTime)

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

void invocationFailed ( FailureDescription failure)

Báo cáo lệnh gọi không đầy đủ do một số tình trạng lỗi.

void invocationFailed (Throwable cause)

Báo cáo lệnh gọi không đầy đủ do một số tình trạng lỗi.

void invocationSkipped ( SkipReason reason)

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

final void invocationStarted ( IInvocationContext context)

Báo cáo sự bắt đầu của lệnh gọi 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 các trường hợp thử nghiệm, nhưng cơ hội thực hiện điều đó 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) .

void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

Sử dụng bản ghi lệnh gọi để gửi từng bản ghi tất cả nhật ký cuối cùng của lệnh gọi.

void processFinalProto (TestRecordProto.TestRecord finalRecord)

Xử lý nguyên mẫu cuối cùng với tất cả các kết quả.

void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)

Việc xử lý nguyên bản bản ghi kiểm tra lệnh gọi một phần sau khi invocationStarted(com.android.tradefed.invoker.IInvocationContext) xảy ra.

void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Việc xử lý nguyên mẫu bản ghi trường hợp thử nghiệm cuối cùng sau khi xảy ra ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) .

void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Việc xử lý nguyên mẫu bản ghi trường hợp thử nghiệm một phần sau khi xảy ra testStarted(com.android.tradefed.result.TestDescription, long) .

void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Xử lý nguyên mẫu bản ghi mô-đun đã hoàn thiện sau khi xảy ra testModuleEnded() .

void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

Việc xử lý nguyên mẫu bản ghi mô-đun một phần sau khi xảy ra testModuleStarted(com.android.tradefed.invoker.IInvocationContext) .

void processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress)

Việc xử lý nguyên mẫu bản ghi lần chạy cuối cùng sau khi xảy ra ERROR(/#testRunEnded(long,HashMap)) .

void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Việc xử lý nguyên mẫu bản ghi chạy thử nghiệm một phần sau khi xảy ra testRunStarted(String, int) .

void setGranularResults (boolean granularResults)
void setInlineRecordOfChildren (boolean inline)
boolean supportGranularResults ()

Trả về Đúng nếu trình báo cáo hỗ trợ kết quả chi tiết, nếu không thì trả về sai.

final void testAssumptionFailure ( TestDescription test, String trace)

Được gọi khi một bài kiểm tra nguyên tử đánh dấ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 bài kiểm tra nguyên tử đánh dấ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 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.

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 riêng lẻ.

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 riêng lẻ.

final void testIgnored ( TestDescription test)

Được gọi khi thử nghiệm không được chạy, thường là do phương thức 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ự bắt đầ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 quá trình chạy thử.

final void testRunFailed ( FailureDescription failure)

Báo cáo chạy thử không hoàn thành do lỗi được mô tả bởi FailureDescription .

final void testRunFailed (String errorMessage)

Báo cáo không hoàn tất quá trình chạy thử do có lỗi nghiêm trọng.

void testRunStarted (String runName, int testCount, int attemptNumber)

Báo cáo việc bắt đầu chạy thử.

final void testRunStarted (String runName, int testCount)

Báo cáo việc bắt đầu chạy thử.

void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)

Báo cáo việc bắt đầu chạy thử.

final void testSkipped ( TestDescription test, SkipReason reason)

Được gọi khi một bài kiểm thử bị bỏ qua và không được thực thi vì một lý do thường không được mong đợi.

final void testStarted ( TestDescription test, long startTime)

Giải pháp 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 .

final void testStarted ( TestDescription test)

Báo cáo sự bắt đầu của một trường hợp thử nghiệm riêng lẻ.

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 xây dựng công cộng

Trình báo cáo kết quả Proto

public ProtoResultReporter ()

Phương pháp công khai

lời mờiĐã kết thúc

public final void invocationEnded (long elapsedTime)

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

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

Thông số
elapsedTime long : thời gian trôi qua của lệnh gọi tính bằng ms

lời gọi không thành công

public void invocationFailed (FailureDescription failure)

Báo cáo lệnh gọi không đầy đủ do một số tình trạng lỗi.

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

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

lời gọi không thành công

public void invocationFailed (Throwable cause)

Báo cáo lệnh gọi không đầy đủ do một số tình trạng lỗi.

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

Thông số
cause Throwable : nguyên nhân Throwable của sự cố

lời mờiBỏ qua

public void invocationSkipped (SkipReason reason)

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

Thông số
reason SkipReason

lời gọiBắt đầu

public final void invocationStarted (IInvocationContext context)

Báo cáo sự bắt đầu của lệnh gọi thử nghiệm.

Sẽ được khung TradeFederation gọi tự động. Người báo cáo cần ghi đè phương pháp 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

logHiệ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 các trường hợp thử nghiệm, nhưng cơ hội thực hiện điều đó 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 đó, lệnh 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 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.

quá trìnhFinalInvocationNhật ký

public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

Sử dụng bản ghi lệnh gọi để gửi từng bản ghi tất cả nhật ký cuối cùng của lệnh gọi.

Thông số
invocationLogs TestRecordProto.TestRecord : Proto cuối cùng thể hiện lệnh gọi.

quá trìnhFinalProto

public void processFinalProto (TestRecordProto.TestRecord finalRecord)

Xử lý nguyên mẫu cuối cùng với tất cả các kết quả.

Thông số
finalRecord TestRecordProto.TestRecord : Proto cuối cùng với tất cả các kết quả gọi.

quá trìnhBắt đầuInvocation

public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, 
                IInvocationContext invocationContext)

Việc xử lý nguyên bản bản ghi kiểm tra lệnh gọi một phần sau khi invocationStarted(com.android.tradefed.invoker.IInvocationContext) xảy ra.

Thông số
invocationStartRecord TestRecordProto.TestRecord : Proto một phần được điền sau lệnh gọiStart.

invocationContext IInvocationContext : Lệnh gọi IInvocationContext .

quá trìnhTestCaseĐã kết thúc

public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Việc xử lý nguyên mẫu bản ghi trường hợp thử nghiệm cuối cùng sau khi xảy ra ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) .

Thông số
testCaseRecord TestRecordProto.TestRecord : Proto cuối cùng đại diện cho một trường hợp thử nghiệm.

quá trìnhTestCaseBắt đầu

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Việc xử lý nguyên mẫu bản ghi trường hợp thử nghiệm một phần sau khi xảy ra testStarted(com.android.tradefed.result.TestDescription, long) .

Thông số
testCaseStartedRecord TestRecordProto.TestRecord : Proto một phần đại diện cho trường hợp thử nghiệm.

quá trìnhKiểm traModuleEnd

public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Xử lý nguyên mẫu bản ghi mô-đun đã hoàn thiện sau khi xảy ra testModuleEnded() .

Thông số
moduleRecord TestRecordProto.TestRecord : Proto cuối cùng đại diện cho mô-đun.

quá trìnhTestModuleBắt đầu

public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

Việc xử lý nguyên mẫu bản ghi mô-đun một phần sau khi xảy ra testModuleStarted(com.android.tradefed.invoker.IInvocationContext) .

Thông số
moduleStartRecord TestRecordProto.TestRecord : Proto một phần đại diện cho mô-đun.

quá trìnhTestRunĐã kết thúc

public void processTestRunEnded (TestRecordProto.TestRecord runRecord, 
                boolean moduleInProgress)

Việc xử lý nguyên mẫu bản ghi lần chạy cuối cùng sau khi xảy ra ERROR(/#testRunEnded(long,HashMap)) .

Thông số
runRecord TestRecordProto.TestRecord : Proto cuối cùng thể hiện lần chạy.

moduleInProgress boolean : mô-đun có đang được tiến hành hay không.

quá trìnhTestRunStarted

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Việc xử lý nguyên mẫu bản ghi chạy thử nghiệm một phần sau khi xảy ra testRunStarted(String, int) .

Thông số
runStartedRecord TestRecordProto.TestRecord : Proto một phần thể hiện lần chạy.

setGranularResults

public void setGranularResults (boolean granularResults)

Thông số
granularResults boolean

setInlineRecordOfChildren

public void setInlineRecordOfChildren (boolean inline)

Thông số
inline boolean

hỗ trợGranularKết quả

public boolean supportGranularResults ()

Trả về Đúng nếu trình báo cáo hỗ trợ kết quả chi tiết, nếu không thì trả về sai.

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 bài kiểm tra nguyên tử đánh dấ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 lỗi của ngăn xếp

kiểm traGiả địnhThất bại

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Được gọi khi một bài kiểm tra nguyên tử đánh dấ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ó.

kiểm traĐã 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 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 System.currentTimeMillis()

testMetrics : ERROR(/Map) của số liệu được phát ra

kiểm traĐã 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 đã đạt. Đồng thời trả về bất kỳ số liệu khóa/giá trị nào có thể được phát ra trong quá trình thực thi trường hợp kiểm thử.

Thông số
test TestDescription : xác định bài kiểm tra

testMetrics : ERROR(/Map) của số liệu đượ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 riêng lẻ.

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 riêng lẻ.

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 lỗi của ngăn xếp

kiểm traBỏ qua

public final void testIgnored (TestDescription test)

Được gọi khi thử nghiệm không được chạy, thường là do phương thức 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

testModuleĐã kết thúc

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ự bắt đầ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 chuỗi. Nó chỉ được sử dụng trong quá trình chạy sử dụng các mô-đun: bộ chạy dựa trên bộ.

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

thử nghiệmChạyĐã kết thúc

public final void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Báo cáo kết thúc quá trình chạy thử. CỐ ĐỊNH: 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 : các cặp khóa-giá trị được báo cáo khi kết thúc quá trình chạy thử nghiệm với Metric .

thử nghiệm Chạy không thành công

public final void testRunFailed (FailureDescription failure)

Báo cáo chạy thử không 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ó.

thử nghiệm Chạy không thành công

public final void testRunFailed (String errorMessage)

Báo cáo không hoàn tất quá trình chạy thử do có lỗi nghiêm trọng.

Thông số
errorMessage String : String mô tả lý do chạy thất bại.

thử nghiệmChạyBắt đầu

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

Báo cáo việc bắt đầu chạy thử.

Thông số
runName String : tên chạy thử

testCount int : tổng số bài kiểm tra trong lần 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. Số lần thử được lập chỉ mục bằng 0 và sẽ tăng lên mỗi lần chạy mới. ví dụ: Một thử nghiệm được thử lại chi tiết 3 lần, nó phải có tổng cộng 4 lần chạy với cùng một runName và số lần thử là từ 0 đến 3.

thử nghiệmChạyBắt đầu

public final void testRunStarted (String runName, 
                int testCount)

Báo cáo việc bắt đầu chạy thử.

Thông số
runName String : tên chạy thử

testCount int : tổng số bài kiểm tra trong lần chạy thử

thử nghiệmChạyBắt đầu

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Báo cáo việc bắt đầu chạy thử.

Thông số
runName String : tên chạy thử

testCount int : tổng số bài kiểm tra trong lần 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. Số lần thử được lập chỉ mục bằng 0 và sẽ tăng lên mỗi lần chạy mới. ví dụ: Một thử nghiệm được thử lại chi tiết 3 lần, nó phải có tổng cộng 4 lần chạy với cùng một runName 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 System.currentTimeMillis()

kiểm traBỏ qua

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 được thực thi vì một lý do thường không được mong đợi. Các thử nghiệm này sẽ được thử lại để cố gắng thực thi đúng cách.

Thông số
test TestDescription : xác định bài kiểm tra

reason SkipReason : SkipReason

thử nghiệmBắt đầu

public final void testStarted (TestDescription test, 
                long startTime)

Giải pháp 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 thử nghiệm bắt đầu, được đo thông qua 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 riêng lẻ. 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ệ

createModuleChildReference

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