SubprocessResultsReporter
public
class
SubprocessResultsReporter
extends Object
implements
ILogSaverListener,
ISupportGranularResults,
ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.SubprocessResultsReporter |
Menerapkan ITestInvocationListener
untuk ditentukan sebagai result_reporter dan diteruskan dari
subproses hasil pengujian, pengujian
yang berjalan, dan pemanggilan pengujian.
Ringkasan
Konstruktor publik | |
---|---|
SubprocessResultsReporter()
|
Metode publik | |
---|---|
void
|
close()
|
TestSummary
|
getSummary()
Mengizinkan InvocationListener menampilkan ringkasan. |
void
|
invocationEnded(long elapsedTime)
Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil maupun karena beberapa error . |
void
|
invocationFailed(FailureDescription failure)
Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error. |
void
|
invocationFailed(Throwable cause)
Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error. |
void
|
invocationStarted(IInvocationContext context)
Melaporkan awal pemanggilan pengujian. |
void
|
logAssociation(String dataName, LogFile logFile)
Dalam beberapa kasus, log harus terkait erat
dengan kasus pengujian, tetapi kesempatan untuk
jadi di |
void
|
printEvent(String key, Object event)
Bantuan untuk mencetak kunci peristiwa, lalu objek json. |
void
|
setOutputTestLog(boolean outputTestLog)
Menetapkan apakah kita harus menghasilkan output pengujian dalam log atau tidak. |
boolean
|
supportGranularResults()
Menampilkan Benar jika pelapor mendukung hasil terperinci, salah (false) jika tidak. |
void
|
testAssumptionFailure(TestDescription testId, String trace)
Dipanggil saat pengujian atomik menandai bahwa kondisi tersebut mengasumsikan kondisi yang salah. |
void
|
testAssumptionFailure(TestDescription testId, FailureDescription failure)
Dipanggil saat pengujian atomik menandai bahwa kondisi tersebut mengasumsikan kondisi yang salah. |
void
|
testEnded(TestDescription testId, long endTime,
Alternatif untuk |
void
|
testEnded(TestDescription testId,
Melaporkan akhir eksekusi setiap kasus pengujian. |
void
|
testFailed(TestDescription testId, FailureDescription failure)
Melaporkan kegagalan kasus pengujian individu. |
void
|
testFailed(TestDescription testId, String reason)
Melaporkan kegagalan kasus pengujian individu. |
void
|
testIgnored(TestDescription testId)
Dipanggil pada saat pengujian tidak akan dijalankan, umumnya karena metode pengujian dianotasi dengan {i>org.junit.Ignore<i}. |
void
|
testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)
Memberikan data log atau debug terkait dari pemanggilan pengujian. |
void
|
testModuleEnded()
Melaporkan akhir dari proses modul yang dijalankan. |
void
|
testModuleStarted(IInvocationContext moduleContext)
Melaporkan awal modul yang berjalan. |
void
|
testRunEnded(long time,
Melaporkan berakhirnya uji coba. |
void
|
testRunFailed(FailureDescription failure)
Melaporkan pengujian yang gagal diselesaikan karena kegagalan yang dijelaskan oleh |
void
|
testRunFailed(String reason)
Melaporkan pengujian yang gagal diselesaikan karena terjadi error fatal. |
void
|
testRunStarted(String runName, int testCount, int attemptNumber)
Melaporkan dimulainya pengujian. |
void
|
testRunStarted(String runName, int testCount)
Melaporkan dimulainya pengujian. |
void
|
testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
Melaporkan dimulainya pengujian. |
void
|
testRunStopped(long arg0)
Melaporkan pengujian yang dihentikan sebelum selesai karena permintaan pengguna. |
void
|
testSkipped(TestDescription testId, SkipReason reason)
Dipanggil saat pengujian dilewati dan tidak dijalankan karena alasan yang biasanya tidak diharapkan. |
void
|
testStarted(TestDescription testId, long startTime)
Alternatif untuk |
void
|
testStarted(TestDescription testId)
Melaporkan awal kasus pengujian individual. |
Konstruktor publik
SubprocessResultsReporter
public SubprocessResultsReporter ()
Metode publik
tutup
public void close ()
getSummary
public TestSummary getSummary ()
Mengizinkan InvocationListener menampilkan ringkasan.
Hasil | |
---|---|
TestSummary |
TestSummary yang meringkas operasi, atau null |
pemanggilanBerakhir
public void invocationEnded (long elapsedTime)
Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil maupun karena beberapa error .
Akan otomatis dipanggil oleh framework TradeFederation.
Parameter | |
---|---|
elapsedTime |
long : waktu berlalu dari pemanggilan dalam md |
pemanggilanGagal
public void invocationFailed (FailureDescription failure)
Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.
Akan otomatis dipanggil oleh framework TradeFederation.
Parameter | |
---|---|
failure |
FailureDescription : FailureDescription yang menjelaskan penyebab kegagalan |
pemanggilanGagal
public void invocationFailed (Throwable cause)
Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.
Akan otomatis dipanggil oleh framework TradeFederation.
Parameter | |
---|---|
cause |
Throwable : Throwable penyebab kegagalan |
pemanggilanDimulai
public void invocationStarted (IInvocationContext context)
Melaporkan awal pemanggilan pengujian.
Akan otomatis dipanggil oleh framework TradeFederation. Pelapor harus mengganti metode ini untuk mendukung pelaporan beberapa perangkat.
Parameter | |
---|---|
context |
IInvocationContext : informasi tentang panggilan |
logAssociation
public void logAssociation (String dataName, LogFile logFile)
Dalam beberapa kasus, log harus terkait erat
dengan kasus pengujian, tetapi kesempatan untuk
jadi di testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
langsung
callback tidak mungkin dilakukan. Dengan demikian, callback ini memungkinkan untuk memberikan pengaitan yang kuat
secara eksplisit.
Parameter | |
---|---|
dataName |
String : Nama data |
logFile |
LogFile : LogFile yang dicatat sebelumnya dan harus dikaitkan dengan
kasus pengujian tertentu. |
printEvent
public void printEvent (String key, Object event)
Bantuan untuk mencetak kunci peristiwa, lalu objek json.
Parameter | |
---|---|
key |
String |
event |
Object |
setOutputTestLog
public void setOutputTestLog (boolean outputTestLog)
Menetapkan apakah kita harus menghasilkan output pengujian dalam log atau tidak.
Parameter | |
---|---|
outputTestLog |
boolean |
dukunganGranularResults
public boolean supportGranularResults ()
Menampilkan Benar jika pelapor mendukung hasil terperinci, salah (false) jika tidak.
Hasil | |
---|---|
boolean |
testAsumsiKegagalan
public void testAssumptionFailure (TestDescription testId, String trace)
Dipanggil saat pengujian atomik menandai bahwa kondisi tersebut mengasumsikan kondisi yang salah.
Parameter | |
---|---|
testId |
TestDescription : mengidentifikasi pengujian |
trace |
String : stack trace kegagalan |
testAsumsiKegagalan
public void testAssumptionFailure (TestDescription testId, FailureDescription failure)
Dipanggil saat pengujian atomik menandai bahwa kondisi tersebut mengasumsikan kondisi yang salah.
Parameter | |
---|---|
testId |
TestDescription : mengidentifikasi pengujian |
failure |
FailureDescription : FailureDescription yang menjelaskan kegagalan dan konteksnya. |
testBerakhir
public void testEnded (TestDescription testId, long endTime,metrics)
Alternatif untuk ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
yang memungkinkan kita menentukan waktu berakhir
secara langsung. Gabungkan dengan testStarted(com.android.tradefed.result.TestDescription, long)
untuk pengukuran yang akurat.
Parameter | |
---|---|
testId |
TestDescription : mengidentifikasi pengujian |
endTime |
long : waktu pengujian berakhir, yang diukur melalui System.currentTimeMillis() |
metrics |
: ERROR(/Map) metrik yang ditampilkan |
testBerakhir
public void testEnded (TestDescription testId,metrics)
Melaporkan akhir eksekusi setiap kasus pengujian.
Jika testFailed(TestDescription, FailureDescription)
tidak dipanggil, pengujian ini lulus. Juga menampilkan kunci/nilai
metrik yang mungkin dimunculkan selama eksekusi kasus pengujian.
Parameter | |
---|---|
testId |
TestDescription : mengidentifikasi pengujian |
metrics |
: ERROR(/Map) metrik yang ditampilkan |
pengujianGagal
public void testFailed (TestDescription testId, FailureDescription failure)
Melaporkan kegagalan kasus pengujian individu.
Akan dipanggil antara testStarted dan testEnded.
Parameter | |
---|---|
testId |
TestDescription : mengidentifikasi pengujian |
failure |
FailureDescription : FailureDescription yang menjelaskan kegagalan dan konteksnya. |
pengujianGagal
public void testFailed (TestDescription testId, String reason)
Melaporkan kegagalan kasus pengujian individu.
Akan dipanggil antara testStarted dan testEnded.
Parameter | |
---|---|
testId |
TestDescription : mengidentifikasi pengujian |
reason |
String : stack trace kegagalan |
testDiabaikan
public void testIgnored (TestDescription testId)
Dipanggil pada saat pengujian tidak akan dijalankan, umumnya karena metode pengujian dianotasi dengan {i>org.junit.Ignore<i}.
Parameter | |
---|---|
testId |
TestDescription : mengidentifikasi pengujian |
Loguji
public void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
Memberikan data log atau debug terkait dari pemanggilan pengujian.
Harus dipanggil sebelum ERROR(/ITestInvocationListener#invocationFailed(Throwable))
atau
ERROR(/ITestInvocationListener#invocationEnded(long))
Framework TradeFederation akan otomatis memanggil metode ini, yang menyediakan log host dan jika ada, logcat perangkat.
Parameter | |
---|---|
dataName |
String : nama deskriptif String data. mis. "device_logcat". Catatan
dataName tidak boleh unik per pemanggilan. yaitu pengimplementasi harus mampu menangani
beberapa panggilan dengan dataName yang sama |
dataType |
LogDataType : LogDataType data |
dataStream |
InputStreamSource : InputStreamSource data. Pengimplementasi harus memanggil
createInputStream untuk mulai membaca data, dan memastikan untuk menutup hasil
InputStream setelah selesai. Pemanggil harus memastikan sumber data tetap ada
ada dan dapat diakses sampai metode {i>
testLog<i} selesai. |
testModuleBerakhir
public void testModuleEnded ()
Melaporkan akhir dari proses modul yang dijalankan.
testModuleStarted
public void testModuleStarted (IInvocationContext moduleContext)
Melaporkan awal modul yang berjalan. Callback ini dikaitkan dengan testModuleEnded()
dan bersifat opsional dalam urutan. Alat ini hanya digunakan selama
berjalan yang menggunakan
modul: runner berbasis suite.
Parameter | |
---|---|
moduleContext |
IInvocationContext : IInvocationContext modul. |
testRunEnded
public void testRunEnded (long time,runMetrics)
Melaporkan berakhirnya uji coba. FIXME: Kita tidak dapat memiliki dua Peta<> antarmuka dengan jenis yang berbeda, jadi kita harus menggunakan HashMap di sini.
Parameter | |
---|---|
time |
long : perangkat melaporkan waktu berlalu, dalam milidetik |
runMetrics |
: pasangan nilai kunci yang dilaporkan di akhir pengujian dengan Metric . |
{i>testRunFailed<i}
public void testRunFailed (FailureDescription failure)
Melaporkan pengujian yang gagal diselesaikan karena kegagalan yang dijelaskan oleh FailureDescription
.
Parameter | |
---|---|
failure |
FailureDescription : FailureDescription yang menjelaskan kegagalan dan konteksnya. |
{i>testRunFailed<i}
public void testRunFailed (String reason)
Melaporkan pengujian yang gagal diselesaikan karena terjadi error fatal.
Parameter | |
---|---|
reason |
String : String yang menjelaskan alasan kegagalan operasi. |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber)
Melaporkan dimulainya pengujian.
Parameter | |
---|---|
runName |
String : nama pengujian yang dijalankan |
testCount |
int : jumlah total pengujian dalam pengujian |
attemptNumber |
int : nomor pesanan, yang mengidentifikasi berbagai percobaan dari runName yang sama
yang berjalan beberapa kali. upayaNumber diindeks 0 dan akan bertambah setiap kali
terjadi proses baru. mis. Sebuah tes terperinci dilakukan sebanyak 3 kali, seharusnya memiliki total 4
berjalan di bawah runName yang sama dan percobaanNumber adalah dari 0 hingga 3. |
testRunStarted
public void testRunStarted (String runName, int testCount)
Melaporkan dimulainya pengujian.
Parameter | |
---|---|
runName |
String : nama pengujian yang dijalankan |
testCount |
int : jumlah total pengujian dalam pengujian |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Melaporkan dimulainya pengujian.
Parameter | |
---|---|
runName |
String : nama pengujian yang dijalankan |
testCount |
int : jumlah total pengujian dalam pengujian |
attemptNumber |
int : nomor pesanan, yang mengidentifikasi berbagai percobaan dari runName yang sama
yang berjalan beberapa kali. upayaNumber diindeks 0 dan harus bertambah setiap kali
operasi baru terjadi. mis. Pengujian terperinci dilakukan sebanyak 3 kali, dengan total pengujian 4 kali
di bawah runName yang sama dan percobaanNumber adalah dari 0 hingga 3. |
startTime |
long : waktu yang dimulai, diukur melalui System.currentTimeMillis() |
testRunBerhenti
public void testRunStopped (long arg0)
Melaporkan pengujian yang dihentikan sebelum selesai karena permintaan pengguna.
TODO: saat ini tidak digunakan, pertimbangkan untuk menghapusnya
Parameter | |
---|---|
arg0 |
long : perangkat melaporkan waktu berlalu, dalam milidetik |
pengujianDilewati
public void testSkipped (TestDescription testId, SkipReason reason)
Dipanggil saat pengujian dilewati dan tidak dijalankan karena alasan yang biasanya tidak diharapkan. Pengujian ini akan dicoba ulang untuk mendapatkan eksekusi yang tepat.
Parameter | |
---|---|
testId |
TestDescription : mengidentifikasi pengujian |
reason |
SkipReason : SkipReason |
pengujianDimulai
public void testStarted (TestDescription testId, long startTime)
Alternatif untuk testStarted(com.android.tradefed.result.TestDescription)
yang juga menentukan waktu pengujiannya
dimulai, dikombinasikan dengan ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
untuk pengukuran yang akurat.
Parameter | |
---|---|
testId |
TestDescription : mengidentifikasi pengujian |
startTime |
long : waktu pengujian dimulai, yang diukur melalui System.currentTimeMillis() |
pengujianDimulai
public void testStarted (TestDescription testId)
Melaporkan awal kasus pengujian individual. Antarmuka yang lebih lama, harus menggunakan testStarted(com.android.tradefed.result.TestDescription)
jika memungkinkan.
Parameter | |
---|---|
testId |
TestDescription : mengidentifikasi pengujian |