SubprosesResultsReporter
public class SubprocessResultsReporter
extends Object
implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults
java.lang.Objek | |
↳ | com.android.tradefed.result.SubprocessResultsReporter |
Mengimplementasikan ITestInvocationListener
untuk ditetapkan sebagai result_reporter dan meneruskan dari subproses hasil pengujian, pengujian berjalan, pemanggilan pengujian.
Ringkasan
Konstruktor publik | |
---|---|
SubprocessResultsReporter () |
Metode publik | |
---|---|
void | close () |
TestSummary | getSummary () Mengizinkan InvocationListener mengembalikan ringkasan. |
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. |
void | invocationStarted ( IInvocationContext context) Melaporkan awal pemanggilan pengujian. |
void | logAssociation (String dataName, LogFile logFile) Dalam beberapa kasus, log harus sangat terkait dengan kasus pengujian, tetapi kesempatan untuk melakukannya langsung |
void | printEvent (String key, Object event) Pembantu untuk mencetak kunci acara dan kemudian objek json. |
void | setOutputTestLog (boolean outputTestLog) Menyetel apakah kita harus mengeluarkan pengujian yang dicatat atau tidak. |
boolean | supportGranularResults () Mengembalikan Benar jika pelapor mendukung hasil granular, salah jika sebaliknya. |
void | testAssumptionFailure ( TestDescription testId, String trace) Dipanggil saat tes atom menandai bahwa kondisi tersebut dianggap salah |
void | testAssumptionFailure ( TestDescription testId, FailureDescription failure) Dipanggil saat tes atom menandai bahwa kondisi tersebut dianggap salah |
void | testEnded ( TestDescription testId, long endTime, metrics) testEnded ( TestDescription testId, long endTime, metrics) Alternatif untuk |
void | testEnded ( TestDescription testId, metrics) testEnded ( TestDescription testId, metrics) Melaporkan akhir eksekusi dari kasus uji individual. |
void | testFailed ( TestDescription testId, FailureDescription failure) Melaporkan kegagalan kasus uji individu. |
void | testFailed ( TestDescription testId, String reason) Melaporkan kegagalan kasus uji individu. |
void | testIgnored ( TestDescription testId) Dipanggil saat pengujian tidak akan dijalankan, umumnya karena metode pengujian dianotasi dengan org.junit.Ignore. |
void | testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) Menyediakan data log atau debug terkait dari pemanggilan pengujian. |
void | testModuleEnded () Melaporkan akhir dari sebuah modul yang dijalankan. |
void | testModuleStarted ( IInvocationContext moduleContext) Melaporkan awal dari modul yang sedang berjalan. |
void | testRunEnded (long time, runMetrics) testRunEnded (long time, runMetrics) Melaporkan akhir uji coba. |
void | testRunFailed ( FailureDescription failure) Uji coba laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh |
void | testRunFailed (String reason) Uji coba laporan gagal diselesaikan karena kesalahan fatal. |
void | testRunStarted (String runName, int testCount, int attemptNumber) Melaporkan awal uji coba. |
void | testRunStarted (String runName, int testCount) Melaporkan awal uji coba. |
void | testRunStarted (String runName, int testCount, int attemptNumber, long startTime) Melaporkan awal uji coba. |
void | testRunStopped (long arg0) Uji coba laporan berhenti sebelum selesai karena permintaan pengguna. |
void | testStarted ( TestDescription testId, long startTime) Alternatif untuk |
void | testStarted ( TestDescription testId) Melaporkan awal kasus uji individual. |
Konstruktor publik
SubprosesResultsReporter
public SubprocessResultsReporter ()
Metode publik
menutup
public void close ()
getSummary
public TestSummary getSummary ()
Mengizinkan InvocationListener mengembalikan ringkasan.
Pengembalian | |
---|---|
TestSummary | TestSummary meringkas proses, atau null |
doaBerakhir
public void invocationEnded (long elapsedTime)
Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil atau karena beberapa kondisi kesalahan.
Akan dipanggil secara otomatis oleh kerangka kerja TradeFederation.Parameter | |
---|---|
elapsedTime | long : waktu berlalu dari doa dalam ms |
doa Gagal
public void invocationFailed (FailureDescription failure)
Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.
Akan dipanggil secara otomatis oleh kerangka kerja TradeFederation.
Parameter | |
---|---|
failure | FailureDescription : FailureDescription menjelaskan penyebab kegagalan |
doa Gagal
public void invocationFailed (Throwable cause)
Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.
Akan dipanggil secara otomatis oleh kerangka kerja TradeFederation.Parameter | |
---|---|
cause | Throwable : Penyebab kegagalan Throwable |
invocationStarted
public void invocationStarted (IInvocationContext context)
Melaporkan awal pemanggilan pengujian.
Akan dipanggil secara otomatis oleh kerangka kerja TradeFederation. Pelapor perlu mengganti metode ini untuk mendukung pelaporan beberapa perangkat.
Parameter | |
---|---|
context | IInvocationContext : informasi tentang doa |
logAssociation
public void logAssociation (String dataName, LogFile logFile)
Dalam beberapa kasus, log harus sangat terkait dengan kasus pengujian, tetapi kesempatan untuk melakukannya langsung testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
panggilan balik tidak dimungkinkan. Dengan demikian, panggilan balik ini memungkinkan untuk memberikan asosiasi yang kuat secara eksplisit.
Parameter | |
---|---|
dataName | String : Nama data |
logFile | LogFile : LogFile yang telah dicatat sebelumnya dan harus dikaitkan dengan kasus uji. |
printEvent
public void printEvent (String key, Object event)
Pembantu untuk mencetak kunci acara dan kemudian objek json.
Parameter | |
---|---|
key | String |
event | Object |
setOutputTestLog
public void setOutputTestLog (boolean outputTestLog)
Menyetel apakah kita harus mengeluarkan pengujian yang dicatat atau tidak.
Parameter | |
---|---|
outputTestLog | boolean |
supportGranularResults
public boolean supportGranularResults ()
Mengembalikan Benar jika pelapor mendukung hasil granular, salah jika sebaliknya.
Pengembalian | |
---|---|
boolean |
testAssumptionFailure
public void testAssumptionFailure (TestDescription testId, String trace)
Dipanggil saat tes atom menandai bahwa kondisi tersebut dianggap salah
Parameter | |
---|---|
testId | TestDescription : mengidentifikasi tes |
trace | String : tumpukan jejak kegagalan |
testAssumptionFailure
public void testAssumptionFailure (TestDescription testId, FailureDescription failure)
Dipanggil saat tes atom menandai bahwa kondisi tersebut dianggap salah
Parameter | |
---|---|
testId | TestDescription : mengidentifikasi tes |
failure | FailureDescription : FailureDescription menjelaskan kegagalan dan konteksnya. |
testEnded
public void testEnded (TestDescription testId, long endTime,metrics)
Alternatif untuk ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
tempat kita dapat menentukan waktu berakhir secara langsung. Kombinasikan dengan testStarted(com.android.tradefed.result.TestDescription, long)
untuk pengukuran yang akurat.
Parameter | |
---|---|
testId | TestDescription : mengidentifikasi tes |
endTime | long : waktu pengujian berakhir, diukur melalui System.currentTimeMillis() |
metrics | ERROR(/Map) dari metrik yang dipancarkan |
testEnded
public void testEnded (TestDescription testId,metrics)
Melaporkan akhir eksekusi dari kasus uji individual.
Jika testFailed(TestDescription, FailureDescription)
tidak dipanggil, tes ini lulus. Juga menampilkan metrik kunci/nilai apa pun yang mungkin telah dikeluarkan selama eksekusi kasus pengujian.
Parameter | |
---|---|
testId | TestDescription : mengidentifikasi tes |
metrics | ERROR(/Map) dari metrik yang dipancarkan |
testFailed
public void testFailed (TestDescription testId, FailureDescription failure)
Melaporkan kegagalan kasus uji individu.
Akan dipanggil antara testStarted dan testEnded.
Parameter | |
---|---|
testId | TestDescription : mengidentifikasi tes |
failure | FailureDescription : FailureDescription menjelaskan kegagalan dan konteksnya. |
testFailed
public void testFailed (TestDescription testId, String reason)
Melaporkan kegagalan kasus uji individu.
Akan dipanggil antara testStarted dan testEnded.
Parameter | |
---|---|
testId | TestDescription : mengidentifikasi tes |
reason | String : tumpukan jejak 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 tes |
testLog
public void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
Menyediakan data log atau debug terkait dari pemanggilan pengujian.
Harus dipanggil sebelumERROR(/ITestInvocationListener#invocationFailed(Throwable))
atau ERROR(/ITestInvocationListener#invocationEnded(long))
Kerangka TradeFederation akan secara otomatis memanggil metode ini, memberikan log host dan jika berlaku, logcat perangkat.Parameter | |
---|---|
dataName | String : nama deskriptif String dari data. misalnya "device_logcat". Catatan dataName mungkin tidak unik per pemanggilan. yaitu pelaksana harus dapat menangani banyak panggilan dengan dataName yang sama |
dataType | LogDataType : LogDataType dari data |
dataStream | InputStreamSource : InputStreamSource dari data. Pelaksana harus memanggil createInputStream untuk mulai membaca data, dan memastikan untuk menutup InputStream yang dihasilkan setelah selesai. Penelepon harus memastikan sumber data tetap ada dan dapat diakses hingga metode testLog selesai. |
testModuleEnded
public void testModuleEnded ()
Melaporkan akhir dari sebuah modul yang dijalankan.
testModuleStarted
public void testModuleStarted (IInvocationContext moduleContext)
Melaporkan awal dari modul yang sedang berjalan. Callback ini dikaitkan dengan testModuleEnded()
dan opsional dalam urutannya. Ini hanya digunakan selama menjalankan yang menggunakan modul: pelari berbasis suite.
Parameter | |
---|---|
moduleContext | IInvocationContext : IInvocationContext dari modul. |
testRunEnded
public void testRunEnded (long time,runMetrics)
Melaporkan akhir uji coba. FIXME: Kami tidak dapat memiliki dua antarmuka Map<> dengan tipe yang berbeda, jadi kami harus menggunakan HashMap di sini.
Parameter | |
---|---|
time | long : perangkat melaporkan waktu berlalu, dalam milidetik |
runMetrics | Metric . |
testRunFailed
public void testRunFailed (FailureDescription failure)
Uji coba laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh FailureDescription
.
Parameter | |
---|---|
failure | FailureDescription : FailureDescription menjelaskan kegagalan dan konteksnya. |
testRunFailed
public void testRunFailed (String reason)
Uji coba laporan gagal diselesaikan karena kesalahan fatal.
Parameter | |
---|---|
reason | String : String yang menjelaskan alasan kegagalan proses. |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber)
Melaporkan awal uji coba.
Parameter | |
---|---|
runName | String : nama uji coba |
testCount | int : jumlah total pengujian dalam uji coba |
attemptNumber | int : nomor urut, mengidentifikasi upaya berbeda dari runName yang sama yang berjalan berkali-kali. tryNumber adalah 0-diindeks dan harus bertambah setiap kali proses baru terjadi. misalnya, pengujian diulang ulang sebanyak 3 kali, harus memiliki total 4 proses di bawah runName yang sama dan nomor percobaan dari 0 hingga 3. |
testRunStarted
public void testRunStarted (String runName, int testCount)
Melaporkan awal uji coba.
Parameter | |
---|---|
runName | String : nama uji coba |
testCount | int : jumlah total pengujian dalam uji coba |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Melaporkan awal uji coba.
Parameter | |
---|---|
runName | String : nama uji coba |
testCount | int : jumlah total pengujian dalam uji coba |
attemptNumber | int : nomor urut, mengidentifikasi upaya berbeda dari runName yang sama yang berjalan berkali-kali. tryNumber adalah 0-diindeks dan harus bertambah setiap kali proses baru terjadi. misalnya, pengujian diulang ulang sebanyak 3 kali, harus memiliki total 4 proses di bawah runName yang sama dan nomor percobaan dari 0 hingga 3. |
startTime | long : waktu proses dimulai, diukur melalui System.currentTimeMillis() |
testRunStopped
public void testRunStopped (long arg0)
Uji coba laporan berhenti sebelum selesai karena permintaan pengguna.
TODO: saat ini tidak digunakan, pertimbangkan untuk menghapus
Parameter | |
---|---|
arg0 | long : perangkat melaporkan waktu berlalu, dalam milidetik |
testStarted
public void testStarted (TestDescription testId, long startTime)
Alternatif untuk testStarted(com.android.tradefed.result.TestDescription)
tempat kami juga menentukan kapan pengujian dimulai, dikombinasikan dengan ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
untuk pengukuran yang akurat .
Parameter | |
---|---|
testId | TestDescription : mengidentifikasi tes |
startTime | long : waktu pengujian dimulai, diukur melalui System.currentTimeMillis() |
testStarted
public void testStarted (TestDescription testId)
Melaporkan awal kasus uji individual. Antarmuka yang lebih lama, harus menggunakan testStarted(com.android.tradefed.result.TestDescription)
jika memungkinkan.
Parameter | |
---|---|
testId | TestDescription : mengidentifikasi tes |