Pendengar Shard
public class ShardListener
extends CollectingTestListener
implements ISupportGranularResults
java.lang.Objek | ||
↳ | com.Android.tradefed.result.CollectingTestListener | |
↳ | com.android.tradefed.invoker.ShardListener |
ITestInvocationListener
yang mengumpulkan hasil dari pecahan doa (alias pemisahan doa untuk dijalankan pada beberapa sumber daya secara paralel), dan meneruskannya ke pendengar lain.
Ringkasan
Konstruktor publik | |
---|---|
ShardListener ( ITestInvocationListener main) Buat |
Metode publik | |
---|---|
getUnderlyingResultReporter () | |
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 uji, namun peluang untuk melakukannya secara langsung |
void | setSupportGranularResults (boolean enableGranularResults) |
boolean | supportGranularResults () Mengembalikan Benar jika pelapor mendukung hasil terperinci, salah jika sebaliknya. |
void | testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) Menyediakan data log atau debug terkait dari pemanggilan pengujian. |
void | testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) |
void | testModuleEnded () Melaporkan akhir dari pengoperasian modul. |
void | testModuleStarted ( IInvocationContext moduleContext) Melaporkan permulaan modul berjalan. |
void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) Melaporkan akhir uji coba. |
void | testRunFailed ( FailureDescription failure) Uji coba laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh |
void | testRunFailed (String failureMessage) Uji coba laporan gagal diselesaikan karena kesalahan fatal. |
void | testRunStarted (String name, int numTests, int attemptNumber, long startTime) Melaporkan dimulainya uji coba. |
Konstruktor publik
Pendengar Shard
public ShardListener (ITestInvocationListener main)
Buat ShardListener
.
Parameter | |
---|---|
main | ITestInvocationListener : ITestInvocationListener hasilnya harus diteruskan. Untuk mencegah tabrakan dengan ShardListener lainnya, objek ini akan disinkronkan di main saat meneruskan hasil. Dan hasilnya hanya akan dikirim setelah pecahan pemanggilan selesai. |
Metode publik
getUnderlyingResultReporter
publicgetUnderlyingResultReporter ()
Kembali | |
---|---|
doaBerakhir
public 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 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 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. |
setSupportGranularResults
public void setSupportGranularResults (boolean enableGranularResults)
Parameter | |
---|---|
enableGranularResults | boolean |
dukunganGranularResults
public boolean supportGranularResults ()
Mengembalikan Benar jika pelapor mendukung hasil terperinci, salah jika sebaliknya.
Kembali | |
---|---|
boolean |
tesLog
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 kerja TradeFederation akan secara otomatis memanggil metode ini, menyediakan log host dan jika berlaku, logcat perangkat.Parameter | |
---|---|
dataName | String : sebuah String yang merupakan nama deskriptif data. misalnya "device_logcat". Catatan dataName mungkin tidak unik per pemanggilan. yaitu pelaksana harus mampu menangani banyak panggilan dengan nama data yang sama |
dataType | LogDataType : LogDataType datanya |
dataStream | InputStreamSource : InputStreamSource 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. |
testLogDisimpan
public void testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
Parameter | |
---|---|
dataName | String |
dataType | LogDataType |
dataStream | InputStreamSource |
logFile | LogFile |
testModuleBerakhir
public void testModuleEnded ()
Melaporkan akhir dari pengoperasian modul.
testModuleStarted
public 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 void testRunEnded (long elapsedTime,runMetrics)
Melaporkan akhir uji coba. FIXME: Kami tidak dapat memiliki dua antarmuka Map<> dengan tipe berbeda, jadi kami harus menggunakan HashMap di sini.
Parameter | |
---|---|
elapsedTime | long : perangkat melaporkan waktu yang telah 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 yang menjelaskan kegagalan dan konteksnya. |
testRunFailed
public void testRunFailed (String failureMessage)
Uji coba laporan gagal diselesaikan karena kesalahan fatal.
Parameter | |
---|---|
failureMessage | String : String yang menjelaskan alasan kegagalan proses. |
tesRunStarted
public void testRunStarted (String name, int numTests, int attemptNumber, long startTime)
Melaporkan dimulainya uji coba.
Parameter | |
---|---|
name | String : nama uji coba |
numTests | 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() |