ProtoResultReporter
public abstract class ProtoResultReporter
extends Object
implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults
java.lang.Objek | |
↳ | com.android.tradefed.result.proto.ProtoResultReporter |
Pelapor hasil membuat protobuf TestRecord
dengan semua hasil di dalamnya. Harus diperluas untuk menangani apa yang harus dilakukan dengan proto akhir di processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord)
.
Ringkasan
Konstruktor publik | |
---|---|
ProtoResultReporter () |
Metode publik | |
---|---|
final void | invocationEnded (long elapsedTime) Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil atau karena beberapa kondisi kesalahan. |
void | invocationFailed ( FailureDescription failure) Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan. |
void | invocationFailed (Throwable cause) Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan. |
final void | invocationStarted ( IInvocationContext context) Melaporkan awal pemanggilan pengujian. |
final void | logAssociation (String dataName, LogFile logFile) Dalam beberapa kasus, log harus sangat terkait dengan kasus uji, namun peluang untuk melakukannya secara langsung |
void | processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs) Gunakan catatan pemanggilan untuk mengirim satu per satu semua log terakhir pemanggilan. |
void | processFinalProto (TestRecordProto.TestRecord finalRecord) Penanganan proto akhir dengan semua hasil. |
void | processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext) Penanganan proto catatan pengujian pemanggilan parsial setelah |
void | processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord) Penanganan proto rekaman kasus uji yang diselesaikan setelah |
void | processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord) Penanganan proto rekaman kasus uji parsial setelah |
void | processTestModuleEnd (TestRecordProto.TestRecord moduleRecord) Penanganan proto rekaman modul yang diselesaikan setelah |
void | processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord) Penanganan proto rekaman modul parsial setelah |
void | processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress) Penanganan proto rekaman proses yang diselesaikan setelah |
void | processTestRunStarted (TestRecordProto.TestRecord runStartedRecord) Penanganan proto rekaman uji coba parsial setelah |
void | setGranularResults (boolean granularResults) |
void | setInlineRecordOfChildren (boolean inline) |
boolean | supportGranularResults () Mengembalikan Benar jika pelapor mendukung hasil terperinci, salah jika sebaliknya. |
final void | testAssumptionFailure ( TestDescription test, String trace) Dipanggil ketika pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah |
final void | testAssumptionFailure ( TestDescription test, FailureDescription failure) Dipanggil ketika pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah |
final void | testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) Alternatif untuk |
void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Melaporkan akhir eksekusi kasus uji individual. |
final void | testFailed ( TestDescription test, FailureDescription failure) Melaporkan kegagalan kasus uji individual. |
final void | testFailed ( TestDescription test, String trace) Melaporkan kegagalan kasus uji individual. |
final void | testIgnored ( TestDescription test) Dipanggil ketika pengujian tidak akan dijalankan, umumnya karena metode pengujian dianotasi dengan org.junit.Ignore. |
final void | testModuleEnded () Melaporkan akhir dari pengoperasian modul. |
final void | testModuleStarted ( IInvocationContext moduleContext) Melaporkan permulaan modul berjalan. |
final void | testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics) Melaporkan akhir uji coba. |
final void | testRunFailed ( FailureDescription failure) Uji coba laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh |
final void | testRunFailed (String errorMessage) Uji coba laporan gagal diselesaikan karena kesalahan fatal. |
void | testRunStarted (String runName, int testCount, int attemptNumber) Melaporkan dimulainya uji coba. |
final void | testRunStarted (String runName, int testCount) Melaporkan dimulainya uji coba. |
void | testRunStarted (String runName, int testCount, int attemptNumber, long startTime) Melaporkan dimulainya uji coba. |
final void | testStarted ( TestDescription test, long startTime) Alternatif untuk |
final void | testStarted ( TestDescription test) Melaporkan permulaan kasus uji individual. |
Metode yang dilindungi | |
---|---|
TestRecordProto.ChildReference | createModuleChildReference (TestRecordProto.TestRecord record) Membuat referensi anak untuk sebuah modul. |
Konstruktor publik
ProtoResultReporter
public ProtoResultReporter ()
Metode publik
doaBerakhir
public final void invocationEnded (long elapsedTime)
Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil atau karena beberapa kondisi kesalahan.
Akan secara otomatis dipanggil oleh kerangka TradeFederation.Parameter | |
---|---|
elapsedTime | long : waktu pemanggilan yang telah berlalu dalam ms |
doaGagal
public void invocationFailed (FailureDescription failure)
Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.
Akan secara otomatis dipanggil oleh kerangka TradeFederation.
Parameter | |
---|---|
failure | FailureDescription : FailureDescription yang menjelaskan penyebab kegagalan |
doaGagal
public void invocationFailed (Throwable cause)
Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.
Akan secara otomatis dipanggil oleh kerangka TradeFederation.Parameter | |
---|---|
cause | Throwable : penyebab kegagalan Throwable |
doaDimulai
public final void invocationStarted (IInvocationContext context)
Melaporkan awal pemanggilan pengujian.
Akan secara otomatis dipanggil oleh kerangka TradeFederation. Reporter perlu mengganti metode ini untuk mendukung pelaporan beberapa perangkat.
Parameter | |
---|---|
context | IInvocationContext : informasi tentang pemanggilan |
logAssociation
public final void logAssociation (String dataName, LogFile logFile)
Dalam beberapa kasus, log harus sangat terkait dengan kasus uji, namun peluang untuk melakukannya secara langsung testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
Panggilan balik testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
tidak dimungkinkan. Dengan demikian, panggilan balik ini memungkinkan untuk memberikan asosiasi yang kuat secara eksplisit.
Parameter | |
---|---|
dataName | String : Nama datanya |
logFile | LogFile : LogFile yang telah dicatat sebelumnya dan harus dikaitkan dengan kasus uji. |
prosesFinalInvocationLogs
public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)
Gunakan catatan pemanggilan untuk mengirim satu per satu semua log terakhir pemanggilan.
Parameter | |
---|---|
invocationLogs | TestRecordProto.TestRecord : Proto final yang mewakili pemanggilan. |
prosesFinalProto
public void processFinalProto (TestRecordProto.TestRecord finalRecord)
Penanganan proto akhir dengan semua hasil.
Parameter | |
---|---|
finalRecord | TestRecordProto.TestRecord : Proto yang diselesaikan dengan semua hasil pemanggilan. |
prosesMulaiInvokasi
public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)
Penanganan proto catatan pengujian pemanggilan parsial setelah invocationStarted(com.android.tradefed.invoker.IInvocationContext)
terjadi.
Parameter | |
---|---|
invocationStartRecord | TestRecordProto.TestRecord : Sebagian proto diisi setelah invocationStart. |
invocationContext | IInvocationContext : Doa IInvocationContext . |
prosesTestCaseBerakhir
public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)
Penanganan proto rekaman kasus uji yang diselesaikan setelah ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap))
terjadi.
Parameter | |
---|---|
testCaseRecord | TestRecordProto.TestRecord : Proto final yang mewakili kasus uji. |
prosesTestCaseStarted
public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)
Penanganan proto rekaman kasus uji parsial setelah testStarted(com.android.tradefed.result.TestDescription, long)
terjadi.
Parameter | |
---|---|
testCaseStartedRecord | TestRecordProto.TestRecord : Proto parsial yang mewakili kasus uji. |
prosesTestModuleEnd
public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)
Penanganan proto rekaman modul yang diselesaikan setelah testModuleEnded()
terjadi.
Parameter | |
---|---|
moduleRecord | TestRecordProto.TestRecord : Proto final yang mewakili modul. |
prosesTestModuleDimulai
public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)
Penanganan proto rekaman modul parsial setelah testModuleStarted(com.android.tradefed.invoker.IInvocationContext)
terjadi.
Parameter | |
---|---|
moduleStartRecord | TestRecordProto.TestRecord : Proto parsial yang mewakili modul. |
prosesTestRunEnded
public void processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress)
Penanganan proto rekaman proses yang diselesaikan setelah ERROR(/#testRunEnded(long,HashMap))
terjadi.
Parameter | |
---|---|
runRecord | TestRecordProto.TestRecord : Proto final yang mewakili proses. |
moduleInProgress | boolean : apakah suatu modul sedang berlangsung atau tidak. |
prosesTestRunStarted
public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)
Penanganan proto rekaman uji coba parsial setelah testRunStarted(String, int)
terjadi.
Parameter | |
---|---|
runStartedRecord | TestRecordProto.TestRecord : Proto parsial yang mewakili proses. |
setGranularResults
public void setGranularResults (boolean granularResults)
Parameter | |
---|---|
granularResults | boolean |
setInlineRecordOfChildren
public void setInlineRecordOfChildren (boolean inline)
Parameter | |
---|---|
inline | boolean |
dukunganGranularResults
public boolean supportGranularResults ()
Mengembalikan Benar jika pelapor mendukung hasil terperinci, salah jika sebaliknya.
Kembali | |
---|---|
boolean |
testAssumptionFailure
public final void testAssumptionFailure (TestDescription test, String trace)
Dipanggil ketika pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
trace | String : tumpukan jejak kegagalan |
testAssumptionFailure
public final void testAssumptionFailure (TestDescription test, FailureDescription failure)
Dipanggil ketika pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
failure | FailureDescription : FailureDescription yang menjelaskan kegagalan dan konteksnya. |
tesBerakhir
public final void testEnded (TestDescription test, long endTime,testMetrics)
Alternatif untuk ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
di mana kita dapat menentukan waktu berakhir secara langsung. Gabungkan dengan testStarted(com.android.tradefed.result.TestDescription, long)
untuk pengukuran yang akurat.
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
endTime | long : waktu pengujian berakhir, diukur melalui System.currentTimeMillis() |
testMetrics | ERROR(/Map) dari metrik yang dikeluarkan |
tesBerakhir
public void testEnded (TestDescription test,testMetrics)
Melaporkan akhir eksekusi kasus uji individual.
Jika testFailed(TestDescription, FailureDescription)
tidak dipanggil, pengujian ini berhasil. Juga mengembalikan metrik kunci/nilai apa pun yang mungkin telah dikeluarkan selama eksekusi kasus pengujian.
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
testMetrics | ERROR(/Map) dari metrik yang dikeluarkan |
tesGagal
public final void testFailed (TestDescription test, FailureDescription failure)
Melaporkan kegagalan kasus uji individual.
Akan dipanggil antara testStarted dan testEnded.
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
failure | FailureDescription : FailureDescription yang menjelaskan kegagalan dan konteksnya. |
tesGagal
public final void testFailed (TestDescription test, String trace)
Melaporkan kegagalan kasus uji individual.
Akan dipanggil antara testStarted dan testEnded.
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
trace | String : tumpukan jejak kegagalan |
tesIgnored
public final void testIgnored (TestDescription test)
Dipanggil ketika pengujian tidak akan dijalankan, umumnya karena metode pengujian dianotasi dengan org.junit.Ignore.
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
testModuleBerakhir
public final void testModuleEnded ()
Melaporkan akhir dari pengoperasian modul.
testModuleStarted
public final void testModuleStarted (IInvocationContext moduleContext)
Melaporkan permulaan modul berjalan. Callback ini dikaitkan dengan testModuleEnded()
dan bersifat opsional dalam urutannya. Ini hanya digunakan selama proses yang menggunakan modul: pelari berbasis suite.
Parameter | |
---|---|
moduleContext | IInvocationContext : IInvocationContext modul. |
testRunEnded
public final void testRunEnded (long elapsedTimeMillis,runMetrics)
Melaporkan akhir uji coba. FIXME: Kami tidak dapat memiliki dua antarmuka Map<> dengan tipe berbeda, jadi kami harus menggunakan HashMap di sini.
Parameter | |
---|---|
elapsedTimeMillis | long : perangkat melaporkan waktu yang telah berlalu, dalam milidetik |
runMetrics | Metric . |
testRunFailed
public final void testRunFailed (FailureDescription failure)
Uji coba laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh FailureDescription
.
Parameter | |
---|---|
failure | FailureDescription : FailureDescription yang menjelaskan kegagalan dan konteksnya. |
testRunFailed
public final void testRunFailed (String errorMessage)
Uji coba laporan gagal diselesaikan karena kesalahan fatal.
Parameter | |
---|---|
errorMessage | String : String yang menjelaskan alasan kegagalan proses. |
tesRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber)
Melaporkan dimulainya uji coba.
Parameter | |
---|---|
runName | String : nama uji coba |
testCount | int : jumlah total pengujian dalam pengujian yang dijalankan |
attemptNumber | int : nomor pesanan, mengidentifikasi upaya berbeda dari runName yang sama yang dijalankan beberapa kali. AttemptNumber diindeks 0 dan harus bertambah setiap kali proses baru terjadi. misalnya Sebuah tes diuji ulang secara granular sebanyak 3 kali, tes tersebut harus memiliki total 4 kali proses dengan runName yang sama dan nomor percobaannya adalah dari 0 hingga 3. |
tesRunStarted
public final void testRunStarted (String runName, int testCount)
Melaporkan dimulainya uji coba.
Parameter | |
---|---|
runName | String : nama uji coba |
testCount | int : jumlah total pengujian dalam pengujian yang dijalankan |
tesRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Melaporkan dimulainya uji coba.
Parameter | |
---|---|
runName | String : nama uji coba |
testCount | int : jumlah total pengujian dalam pengujian yang dijalankan |
attemptNumber | int : nomor pesanan, mengidentifikasi upaya berbeda dari runName yang sama yang dijalankan beberapa kali. AttemptNumber diindeks 0 dan harus bertambah setiap kali proses baru terjadi. misalnya Sebuah tes diuji ulang secara granular sebanyak 3 kali, tes tersebut harus memiliki total 4 kali proses dengan runName yang sama dan nomor percobaannya adalah dari 0 hingga 3. |
startTime | long : waktu dimulainya proses, diukur melalui System.currentTimeMillis() |
tesDimulai
public final void testStarted (TestDescription test, long startTime)
Alternatif untuk testStarted(com.android.tradefed.result.TestDescription)
yang juga menentukan kapan pengujian dimulai, dikombinasikan dengan ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
untuk pengukuran yang akurat .
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
startTime | long : waktu pengujian dimulai, diukur melalui System.currentTimeMillis() |
tesDimulai
public final void testStarted (TestDescription test)
Melaporkan permulaan kasus uji individual. Antarmuka yang lebih lama, harus menggunakan testStarted(com.android.tradefed.result.TestDescription)
bila memungkinkan.
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
Metode yang dilindungi
createModuleChildReference
protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)
Membuat referensi anak untuk sebuah modul.
Parameter | |
---|---|
record | TestRecordProto.TestRecord |
Kembali | |
---|---|
TestRecordProto.ChildReference |