MengumpulkanTestListener

public class CollectingTestListener
extends Object implements ITestInvocationListener , ILogSaverListener , IDisableable

java.lang.Objek
com.Android.tradefed.result.CollectingTestListener


ITestInvocationListener yang akan mengumpulkan semua hasil tes.

Meskipun struktur data yang digunakan dalam objek ini aman untuk thread, callback ITestInvocationListener harus dipanggil dalam urutan yang benar.

Ringkasan

Konstruktor publik

CollectingTestListener ()

Metode publik

IBuildInfo getBuildInfo ()

Metode ini sudah tidak digunakan lagi. mengandalkan IBuildInfo dari getInvocationContext() .

TestRunResult getCurrentRunResults ()

Mendapatkan hasil untuk pengujian yang dijalankan saat ini.

int getExpectedTests ()

Mengembalikan jumlah jumlah tes yang diharapkan.

IInvocationContext getInvocationContext ()

Kembalikan konteks pemanggilan yang dilaporkan melalui invocationStarted(com.android.tradefed.invoker.IInvocationContext)

getMergedTestRunResults ()

Mengembalikan kumpulan hasil gabungan untuk semua proses pada upaya yang berbeda.

IInvocationContext getModuleContextForRunResult (String testRunName)

Mengembalikan IInvocationContext dari modul yang terkait dengan hasil.

MultiMap <String, LogFile > getModuleLogFiles ()

Mengembalikan salinan peta yang berisi semua file log yang terkait dengan modul

MultiMap <String, LogFile > getNonAssociatedLogFiles ()

Mengembalikan salinan peta yang berisi semua file log yang tidak terkait dengan uji coba atau modul.

int getNumAllFailedTestRuns ()

Mengembalikan jumlah total pengujian yang dijalankan dalam keadaan gagal

int getNumAllFailedTests ()

Mengembalikan jumlah total pengujian dalam keadaan gagal (hanya gagal, kegagalan asumsi tidak dihitung).

int getNumTestsInState (TestResult.TestStatus status)

Mengembalikan jumlah pengujian dalam status tertentu untuk proses ini.

int getNumTotalTests ()

Mengembalikan jumlah total pengujian yang diselesaikan untuk semua proses.

IBuildInfo getPrimaryBuildInfo ()

Kembalikan info build utama yang dilaporkan melalui invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

getRunResults ()

Metode ini sudah tidak digunakan lagi. Gunakan getMergedTestRunResults()

TestRunResult getTestRunAtAttempt (String testRunName, int attempt)

Kembalikan TestRunResult untuk satu upaya.

int getTestRunAttemptCount (String testRunName)

Mengembalikan jumlah percobaan untuk nama uji coba tertentu.

getTestRunAttempts (String testRunName)

Mendapatkan semua upaya untuk TestRunResult dari pengujian yang dijalankan.

getTestRunForAttempts (int attempt)

Mendapatkan semua hasil untuk upaya tertentu.

getTestRunNames ()

Kembalikan semua nama untuk semua pengujian yang dijalankan.

boolean hasFailedTests ()

Mengembalikan jika pemanggilan mengalami kegagalan atau pengujian asumsi gagal.

boolean hasTestRunResultsForName (String testRunName)

Mengembalikan apakah nama pengujian yang dijalankan memberikan hasil.

void invocationEnded (long elapsedTime)

Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil atau 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.

boolean isDisabled ()

Mengembalikan True jika seluruh objek dinonaktifkan (lewati pengaturan dan pembongkaran).

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.

void setBuildInfo ( IBuildInfo buildInfo)

Metode ini sudah tidak digunakan lagi. Tidak perlu lagi melakukan pengujian.

void setDisable (boolean isDisabled)

Menyetel apakah objek harus dinonaktifkan.

void setMergeStrategy ( MergeStrategy strategy)

Menyetel MergeStrategy yang akan digunakan saat menggabungkan hasil.

void testAssumptionFailure ( TestDescription test, String trace)

Dipanggil ketika pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah

void testAssumptionFailure ( TestDescription test, FailureDescription failure)

Dipanggil ketika pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah

void testEnded ( TestDescription test, long endTime, testMetrics) 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.

void testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics)

Melaporkan akhir eksekusi kasus uji individual.

void testFailed ( TestDescription test, FailureDescription failure)

Melaporkan kegagalan kasus uji individual.

void testFailed ( TestDescription test, String trace)

Melaporkan kegagalan kasus uji individual.

void testIgnored ( TestDescription test)

Dipanggil ketika pengujian tidak akan dijalankan, umumnya karena metode pengujian dianotasi dengan org.junit.Ignore.

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 FailureDescription .

void testRunFailed (String errorMessage)

Uji coba laporan gagal diselesaikan karena kesalahan fatal.

void testRunStarted (String name, int numTests, int attemptNumber)

Melaporkan dimulainya uji coba.

void testRunStarted (String name, int numTests)

Melaporkan dimulainya uji coba.

void testRunStarted (String name, int numTests, int attemptNumber, long startTime)

Melaporkan dimulainya uji coba.

void testRunStopped (long elapsedTime)

Uji coba laporan dihentikan sebelum selesai karena permintaan pengguna.

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 .

void testStarted ( TestDescription test)

Melaporkan permulaan kasus uji individual.

Metode yang dilindungi

final void clearModuleLogFiles ()

Memungkinkan pembersihan file modul sehingga kami menghindari membawanya terlalu lama.

final void clearResultsForName (String testRunName)

Memungkinkan untuk menghapus hasil untuk nama proses tertentu.

void setIsAggregrateMetrics (boolean aggregate)

Alihkan opsi 'metrik agregat'

Konstruktor publik

MengumpulkanTestListener

public CollectingTestListener ()

Metode publik

dapatkanBuildInfo

public IBuildInfo getBuildInfo ()

Metode ini sudah tidak digunakan lagi.
mengandalkan IBuildInfo dari getInvocationContext() .

Mengembalikan info build.

Kembali
IBuildInfo

dapatkanCurrentRunResults

public TestRunResult getCurrentRunResults ()

Mendapatkan hasil untuk pengujian yang dijalankan saat ini.

Perhatikan bahwa hasilnya mungkin tidak lengkap. Disarankan untuk menguji nilai TestRunResult.isRunComplete() dan/atau (@link TestRunResult#isRunFailure()} yang sesuai sebelum memproses hasilnya.

Kembali
TestRunResult TestRunResult mewakili data yang dikumpulkan selama pengujian terakhir dijalankan

dapatkan Tes yang Diharapkan

public int getExpectedTests ()

Mengembalikan jumlah jumlah tes yang diharapkan. Bisa berbeda dari getNumTotalTests() jika beberapa pengujian tidak dijalankan.

Kembali
int

getInvocationContext

public IInvocationContext getInvocationContext ()

Kembalikan konteks pemanggilan yang dilaporkan melalui invocationStarted(com.android.tradefed.invoker.IInvocationContext)

Kembali
IInvocationContext

dapatkanMergedTestRunResults

public  getMergedTestRunResults ()

Mengembalikan kumpulan hasil gabungan untuk semua proses pada upaya yang berbeda.

Jika terdapat beberapa hasil, setiap pengujian yang dijalankan akan digabungkan, dan hasil pengujian terbaru akan menimpa hasil pengujian dari pengujian yang dijalankan sebelumnya. Uji coba diurutkan berdasarkan nomor percobaan.

Metrik untuk upaya yang sama akan digabungkan berdasarkan preferensi yang ditetapkan oleh aggregate-metrics . Metrik terakhir akan menjadi metrik dari upaya terakhir.

Kembali

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

Mengembalikan IInvocationContext dari modul yang terkait dengan hasil.

Parameter
testRunName String : Nama yang diberikan oleh { testRunStarted(String, int) .

Kembali
IInvocationContext IInvocationContext modul untuk nama uji coba tertentu null jika tidak ada hasil untuk nama tersebut.

dapatkanModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

Mengembalikan salinan peta yang berisi semua file log yang terkait dengan modul

Kembali
MultiMap <String, LogFile >

dapatkanNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

Mengembalikan salinan peta yang berisi semua file log yang tidak terkait dengan uji coba atau modul.

Kembali
MultiMap <String, LogFile >

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

Mengembalikan jumlah total pengujian yang dijalankan dalam keadaan gagal

Kembali
int

dapatkanNumAllFailedTests

public int getNumAllFailedTests ()

Mengembalikan jumlah total pengujian dalam keadaan gagal (hanya gagal, kegagalan asumsi tidak dihitung).

Kembali
int

dapatkanNumTestsInState

public int getNumTestsInState (TestResult.TestStatus status)

Mengembalikan jumlah pengujian dalam status tertentu untuk proses ini.

Parameter
status TestResult.TestStatus

Kembali
int

dapatkanNumTotalTests

public int getNumTotalTests ()

Mengembalikan jumlah total pengujian yang diselesaikan untuk semua proses.

Kembali
int

dapatkanPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

Kembalikan info build utama yang dilaporkan melalui invocationStarted(com.android.tradefed.invoker.IInvocationContext) . Build primer adalah build yang dikembalikan oleh penyedia build pertama dari konfigurasi yang sedang berjalan. Mengembalikan null jika tidak ada konteks (tidak ada build untuk menguji kasus).

Kembali
IBuildInfo

getRunResults

public  getRunResults ()

Metode ini sudah tidak digunakan lagi.
Gunakan getMergedTestRunResults()

Mengembalikan hasil untuk semua pengujian yang dijalankan.

Kembali

dapatkanTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

Kembalikan TestRunResult untuk satu upaya.

Parameter
testRunName String : Nama yang diberikan oleh { testRunStarted(String, int) .

attempt int : Id upaya.

Kembali
TestRunResult TestRunResult untuk nama yang diberikan dan id percobaan atau null jika tidak ada.

dapatkanTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

Mengembalikan jumlah percobaan untuk nama uji coba tertentu.

Parameter
testRunName String : Nama yang diberikan oleh { testRunStarted(String, int) .

Kembali
int

dapatkanTestRunAttempts

public  getTestRunAttempts (String testRunName)

Mendapatkan semua upaya untuk TestRunResult dari pengujian yang dijalankan.

Parameter
testRunName String : Nama yang diberikan oleh { testRunStarted(String, int) .

Kembali
Semua TestRunResult untuk pengujian yang dijalankan, diurutkan berdasarkan upaya.

dapatkanTestRunForAttempts

public  getTestRunForAttempts (int attempt)

Mendapatkan semua hasil untuk upaya tertentu.

Parameter
attempt int : Upaya yang kita inginkan hasilnya.

Kembali
Semua TestRunResult untuk upaya tertentu.

dapatkanTestRunNames

public  getTestRunNames ()

Kembalikan semua nama untuk semua pengujian yang dijalankan.

Uji coba ini mungkin telah dijalankan beberapa kali dengan upaya berbeda.

Kembali

hasFailedTests

public boolean hasFailedTests ()

Mengembalikan jika pemanggilan mengalami kegagalan atau pengujian asumsi gagal.

Kembali
boolean

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

Mengembalikan apakah nama pengujian yang dijalankan memberikan hasil.

Parameter
testRunName String : Nama yang diberikan oleh { testRunStarted(String, int) .

Kembali
boolean

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 (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

dinonaktifkan

public boolean isDisabled ()

Mengembalikan True jika seluruh objek dinonaktifkan (lewati pengaturan dan pembongkaran). Salah jika tidak.

Kembali
boolean

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.

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

Metode ini sudah tidak digunakan lagi.
Tidak perlu lagi melakukan pengujian.

Atur info build. Sebaiknya hanya digunakan untuk pengujian.

Parameter
buildInfo IBuildInfo

setDisable

public void setDisable (boolean isDisabled)

Menyetel apakah objek harus dinonaktifkan. Dinonaktifkan berarti langkah penyiapan dan pembongkaran harus dilewati. Dapat digunakan untuk membuat objek dinonaktifkan secara default di konstruktor default.

Parameter
isDisabled boolean : keadaan objek harus dimasukkan.

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

Menyetel MergeStrategy yang akan digunakan saat menggabungkan hasil.

Parameter
strategy MergeStrategy

testAssumptionFailure

public 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 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 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 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 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 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 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 : pasangan nilai kunci yang dilaporkan pada akhir uji coba dengan 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 errorMessage)

Uji coba laporan gagal diselesaikan karena kesalahan fatal.

Parameter
errorMessage String : String yang menjelaskan alasan kegagalan proses.

tesRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber)

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.

tesRunStarted

public void testRunStarted (String name, 
                int numTests)

Melaporkan dimulainya uji coba.

Parameter
name String : nama uji coba

numTests int : jumlah total pengujian dalam pengujian yang dijalankan

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()

testRunStopped

public void testRunStopped (long elapsedTime)

Uji coba laporan dihentikan sebelum selesai karena permintaan pengguna.

TODO: saat ini tidak digunakan, pertimbangkan untuk menghapusnya

Parameter
elapsedTime long : perangkat melaporkan waktu yang telah berlalu, dalam milidetik

tesDimulai

public 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 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

clearModuleLogFiles

protected final void clearModuleLogFiles ()

Memungkinkan pembersihan file modul sehingga kami menghindari membawanya terlalu lama.

hapusHasilUntukNama

protected final void clearResultsForName (String testRunName)

Memungkinkan untuk menghapus hasil untuk nama proses tertentu. Sebaiknya hanya digunakan dalam beberapa kasus seperti agregator hasil.

Parameter
testRunName String

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

Alihkan opsi 'metrik agregat'

Parameter
aggregate boolean