SubprocessResultsReporter
public
class
SubprocessResultsReporter
extends Object
implements
ILogSaverListener,
ISupportGranularResults,
ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.SubprocessResultsReporter |
Mengimplementasikan ITestInvocationListener
untuk ditentukan sebagai result_reporter dan meneruskan dari
subproses hasil pengujian, pengujian berjalan, pemanggilan pengujian.
Ringkasan
Konstruktor publik | |
---|---|
SubprocessResultsReporter()
|
Metode publik | |
---|---|
void
|
close()
|
TestSummary
|
getSummary()
Memungkinkan InvocationListener menampilkan ringkasan. |
void
|
invocationEnded(long elapsedTime)
Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil maupun karena beberapa kondisi 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 dikaitkan secara kuat dengan kasus pengujian, tetapi peluang untuk melakukannya
pada callback |
void
|
printEvent(String key, Object event)
Helper 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 jika tidak. |
void
|
testAssumptionFailure(TestDescription testId, String trace)
Dipanggil saat pengujian atom menandai bahwa pengujian mengasumsikan kondisi yang salah |
void
|
testAssumptionFailure(TestDescription testId, FailureDescription failure)
Dipanggil saat pengujian atom menandai bahwa pengujian 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 individual. |
void
|
testFailed(TestDescription testId, String reason)
Melaporkan kegagalan kasus pengujian individual. |
void
|
testIgnored(TestDescription testId)
Dipanggil saat pengujian tidak akan dijalankan, biasanya karena metode pengujian dianotasi dengan org.junit.Ignore. |
void
|
testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)
Memberikan data log atau debug terkait dari pemanggilan pengujian. |
void
|
testModuleEnded()
Melaporkan akhir proses modul. |
void
|
testModuleStarted(IInvocationContext moduleContext)
Melaporkan awal modul yang berjalan. |
void
|
testRunEnded(long time,
Melaporkan akhir pengujian yang dijalankan. |
void
|
testRunFailed(FailureDescription failure)
Pengujian laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh |
void
|
testRunFailed(String reason)
Pengujian laporan yang dijalankan gagal diselesaikan karena error fatal. |
void
|
testRunStarted(String runName, int testCount, int attemptNumber)
Melaporkan dimulainya pengujian. |
void
|
testRunStarted(String runName, int testCount)
Melaporkan awal pengujian yang dijalankan. |
void
|
testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
Melaporkan awal pengujian yang dijalankan. |
void
|
testRunStopped(long arg0)
Pengujian laporan berhenti sebelum selesai karena permintaan pengguna. |
void
|
testSkipped(TestDescription testId, SkipReason reason)
Dipanggil saat pengujian dilewati dan tidak dieksekusi karena alasan yang biasanya tidak diharapkan. |
void
|
testStarted(TestDescription testId, long startTime)
Alternatif untuk |
void
|
testStarted(TestDescription testId)
Melaporkan awal setiap kasus pengujian. |
Konstruktor publik
SubprocessResultsReporter
public SubprocessResultsReporter ()
Metode publik
tutup
public void close ()
getSummary
public TestSummary getSummary ()
Memungkinkan InvocationListener menampilkan ringkasan.
Hasil | |
---|---|
TestSummary |
TestSummary yang meringkas operasi, atau null |
invocationEnded
public void invocationEnded (long elapsedTime)
Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil maupun karena beberapa kondisi error.
Akan otomatis dipanggil oleh framework TradeFederation.
Parameter | |
---|---|
elapsedTime |
long : waktu yang berlalu dari pemanggilan dalam md |
invocationFailed
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 |
invocationFailed
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 |
invocationStarted
public void invocationStarted (IInvocationContext context)
Melaporkan awal pemanggilan pengujian.
Akan otomatis dipanggil oleh framework TradeFederation. Pelapor perlu mengganti metode ini untuk mendukung pelaporan beberapa perangkat.
Parameter | |
---|---|
context |
IInvocationContext : informasi tentang pemanggilan |
logAssociation
public void logAssociation (String dataName, LogFile logFile)
Dalam beberapa kasus, log harus berkaitan erat dengan kasus pengujian, tetapi peluang untuk melakukannya
pada callback testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
langsung 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. |
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 menampilkan pengujian yang dicatat ke dalam log atau tidak.
Parameter | |
---|---|
outputTestLog |
boolean |
supportGranularResults
public boolean supportGranularResults ()
Menampilkan Benar jika pelapor mendukung hasil terperinci, salah jika tidak.
Hasil | |
---|---|
boolean |
testAssumptionFailure
public void testAssumptionFailure (TestDescription testId, String trace)
Dipanggil saat pengujian atom menandai bahwa pengujian mengasumsikan kondisi yang salah
Parameter | |
---|---|
testId |
TestDescription : mengidentifikasi pengujian |
trace |
String : stack trace kegagalan |
testAssumptionFailure
public void testAssumptionFailure (TestDescription testId, FailureDescription failure)
Dipanggil saat pengujian atom menandai bahwa pengujian 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))
tempat kita dapat menentukan waktu akhir
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, diukur melalui System.currentTimeMillis() |
metrics |
: ERROR(/Map) dari metrik yang dikeluarkan |
testEnded
public void testEnded (TestDescription testId,metrics)
Melaporkan akhir eksekusi setiap kasus pengujian.
Jika testFailed(TestDescription, FailureDescription)
tidak dipanggil, pengujian ini akan lulus. Juga menampilkan metrik kunci/nilai
yang mungkin telah dikeluarkan 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 individual.
Akan dipanggil antara testStarted dan testEnded.
Parameter | |
---|---|
testId |
TestDescription : mengidentifikasi pengujian |
failure |
FailureDescription : FailureDescription yang menjelaskan kegagalan dan konteksnya. |
testFailed
public void testFailed (TestDescription testId, String reason)
Melaporkan kegagalan kasus pengujian individual.
Akan dipanggil antara testStarted dan testEnded.
Parameter | |
---|---|
testId |
TestDescription : mengidentifikasi pengujian |
reason |
String : stack trace kegagalan |
testIgnored
public void testIgnored (TestDescription testId)
Dipanggil saat pengujian tidak akan dijalankan, umumnya karena metode pengujian dianotasi dengan org.junit.Ignore.
Parameter | |
---|---|
testId |
TestDescription : mengidentifikasi pengujian |
testLog
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 berlaku, logcat perangkat.
Parameter | |
---|---|
dataName |
String : nama deskriptif String data, misalnya "device_logcat". Perhatikan bahwa dataName tidak boleh unik per pemanggilan. Misalnya, pengimplementasi harus dapat menangani beberapa panggilan dengan dataName yang sama |
dataType |
LogDataType : LogDataType data |
dataStream |
InputStreamSource : InputStreamSource data. Implementasi harus memanggil createInputStream untuk mulai membaca data, dan memastikan untuk menutup InputStream yang dihasilkan setelah selesai. Pemanggil harus memastikan sumber data tetap
ada dan dapat diakses hingga metode testLog selesai. |
testModuleEnded
public void testModuleEnded ()
Melaporkan akhir proses modul.
testModuleStarted
public void testModuleStarted (IInvocationContext moduleContext)
Melaporkan awal modul yang berjalan. Callback ini dikaitkan dengan testModuleEnded()
dan bersifat opsional dalam urutan. Ini hanya digunakan selama operasi yang menggunakan
modul: runner berbasis suite.
Parameter | |
---|---|
moduleContext |
IInvocationContext : IInvocationContext modul. |
testRunEnded
public void testRunEnded (long time,runMetrics)
Melaporkan berakhirnya uji coba.
Parameter | |
---|---|
time |
long : waktu berlalu yang dilaporkan perangkat, dalam milidetik |
runMetrics |
: pasangan nilai kunci yang dilaporkan di akhir pengujian |
testRunFailed
public void testRunFailed (FailureDescription failure)
Pengujian laporan 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)
Pengujian laporan yang dijalankan gagal diselesaikan karena error fatal.
Parameter | |
---|---|
reason |
String : String yang menjelaskan alasan kegagalan operasi. |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber)
Melaporkan awal pengujian yang dijalankan.
Parameter | |
---|---|
runName |
String : nama operasi pengujian |
testCount |
int : jumlah total pengujian dalam operasi pengujian |
attemptNumber |
int : nomor urutan, yang mengidentifikasi berbagai upaya runName yang sama
yang berjalan beberapa kali. attemptNumber diberi indeks 0 dan harus bertambah setiap kali
operasi baru terjadi. Misalnya, pengujian dicoba ulang secara terperinci 3 kali, pengujian tersebut harus memiliki total
operasi 4 kali dalam runName yang sama dan attemptNumber adalah dari 0 hingga 3. |
testRunStarted
public void testRunStarted (String runName, int testCount)
Melaporkan awal pengujian yang dijalankan.
Parameter | |
---|---|
runName |
String : nama operasi pengujian |
testCount |
int : jumlah total pengujian dalam operasi pengujian |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Melaporkan awal pengujian yang dijalankan.
Parameter | |
---|---|
runName |
String : nama operasi pengujian |
testCount |
int : jumlah total pengujian dalam operasi pengujian |
attemptNumber |
int : nomor urutan, yang mengidentifikasi berbagai upaya runName yang sama
yang berjalan beberapa kali. attemptNumber diberi indeks 0 dan harus bertambah setiap kali
operasi baru terjadi. Misalnya, pengujian dicoba ulang secara terperinci 3 kali, pengujian tersebut harus memiliki total 4 operasi
dalam runName yang sama dan attemptNumber-nya adalah dari 0 hingga 3. |
startTime |
long : waktu mulai operasi, diukur melalui System.currentTimeMillis() |
testRunBerhenti
public void testRunStopped (long arg0)
Melaporkan pengujian yang dihentikan sebelum selesai karena permintaan pengguna.
TODO: currently unused, consider removing
Parameter | |
---|---|
arg0 |
long : waktu berlalu yang dilaporkan perangkat, dalam milidetik |
testSkipped
public void testSkipped (TestDescription testId, SkipReason reason)
Dipanggil saat pengujian dilewati dan tidak dieksekusi karena alasan yang biasanya tidak diharapkan. Pengujian ini akan dicoba untuk dicoba lagi untuk mencoba mendapatkan eksekusi yang tepat.
Parameter | |
---|---|
testId |
TestDescription : mengidentifikasi pengujian |
reason |
SkipReason : SkipReason |
testStarted
public void testStarted (TestDescription testId, long startTime)
Alternatif untuk testStarted(com.android.tradefed.result.TestDescription)
tempat kita juga menentukan kapan pengujian dimulai, digabungkan 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() |
testStarted
public void testStarted (TestDescription testId)
Melaporkan awal kasus pengujian individual. Antarmuka lama, harus menggunakan testStarted(com.android.tradefed.result.TestDescription)
jika memungkinkan.
Parameter | |
---|---|
testId |
TestDescription : mengidentifikasi pengujian |