CollectingTestListener

public class CollectingTestListener
extends Object implements IDisableable, ILogSaverListener, ITestInvocationListener

java.lang.Object
   ↳ com.android.tradefed.result.CollectingTestListener


ITestInvocationListener yang akan mengumpulkan semua hasil pengujian.

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 tidak digunakan lagi. mengandalkan IBuildInfo dari getInvocationContext().

TestRunResult getCurrentRunResults()

Mendapatkan hasil untuk pengujian saat ini.

int getExpectedTests()

Menampilkan jumlah pengujian yang diharapkan.

IInvocationContext getInvocationContext()

Menampilkan konteks panggilan yang dilaporkan melalui invocationStarted(com.android.tradefed.invoker.IInvocationContext)

getMergedTestRunResults()

Menampilkan kumpulan hasil gabungan untuk semua operasi dengan upaya yang berbeda.

IInvocationContext getModuleContextForRunResult(String testRunName)

Menampilkan IInvocationContext modul yang terkait dengan hasil.

MultiMap<String, LogFile> getModuleLogFiles()

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

MultiMap<String, LogFile> getNonAssociatedLogFiles()

Mengembalikan salinan peta yang berisi semua file yang dicatat dalam log yang tidak terkait dengan uji coba atau ruang lingkup modul ini.

int getNumAllFailedTestRuns()

Menampilkan jumlah total pengujian yang dijalankan dalam status kegagalan

int getNumAllFailedTests()

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

int getNumTestsInState(TestStatus status)

Menampilkan jumlah pengujian dalam status tertentu untuk operasi ini.

int getNumTestsInState(TestResult.TestStatus ddmlibStatus)

Untuk kompatibilitas dengan jenis status lama

int getNumTotalTests()

Menampilkan jumlah total pengujian yang telah selesai untuk semua operasi.

IBuildInfo getPrimaryBuildInfo()

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

getRunResults()

Metode ini tidak digunakan lagi. Gunakan getMergedTestRunResults()

TestRunResult getTestRunAtAttempt(String testRunName, int attempt)

Menampilkan TestRunResult untuk satu kali percobaan.

int getTestRunAttemptCount(String testRunName)

Menampilkan jumlah percobaan untuk nama pengujian yang ditentukan.

getTestRunAttempts(String testRunName)

Mendapatkan semua percobaan untuk TestRunResult dari pengujian tertentu.

getTestRunForAttempts(int attempt)

Mendapatkan semua hasil untuk percobaan tertentu.

getTestRunNames()

Menampilkan semua nama untuk semua pengujian yang dijalankan.

boolean hasFailedTests()

Menampilkan jika panggilan memiliki pengujian yang gagal atau asumsi gagal.

boolean hasTestRunResultsForName(String testRunName)

Menampilkan apakah nama pengujian yang diberikan memiliki hasil.

void invocationEnded(long elapsedTime)

Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil maupun karena beberapa error .

void invocationFailed(Throwable cause)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.

void invocationSkipped(SkipReason reason)

Melaporkan panggilan sebagai dilewati

void invocationStarted(IInvocationContext context)

Melaporkan awal pemanggilan pengujian.

boolean isDisabled()

Menampilkan Benar jika seluruh objek dinonaktifkan (lewati penyiapan dan pemutusan).

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.

void setBuildInfo(IBuildInfo buildInfo)

Metode ini tidak digunakan lagi. Tidak diperlukan untuk pengujian lagi.

void setDisable(boolean isDisabled)

Menetapkan apakah objek harus dinonaktifkan.

void setMergeStrategy(MergeStrategy strategy)

Menetapkan MergeStrategy yang akan digunakan saat menggabungkan hasil.

void testAssumptionFailure(TestDescription test, String trace)

Dipanggil saat pengujian atomik menandai bahwa kondisi tersebut mengasumsikan kondisi yang salah.

void testAssumptionFailure(TestDescription test, FailureDescription failure)

Dipanggil saat pengujian atomik menandai bahwa kondisi tersebut mengasumsikan kondisi yang salah.

void testEnded(TestDescription test, long endTime, testMetrics)

Alternatif untuk ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) yang memungkinkan kita menentukan waktu berakhir secara langsung.

void testEnded(TestDescription test, testMetrics)

Melaporkan akhir eksekusi setiap kasus pengujian.

void testFailed(TestDescription test, FailureDescription failure)

Melaporkan kegagalan kasus pengujian individu.

void testFailed(TestDescription test, String trace)

Melaporkan kegagalan kasus pengujian individu.

void testIgnored(TestDescription test)

Dipanggil pada saat pengujian tidak akan dijalankan, umumnya karena metode pengujian dianotasi dengan {i>org.junit.Ignore<i}.

void testModuleEnded()

Melaporkan akhir dari proses modul yang dijalankan.

void testModuleStarted(IInvocationContext moduleContext)

Melaporkan awal modul yang berjalan.

void testRunEnded(long elapsedTime, runMetrics)

Melaporkan berakhirnya uji coba.

void testRunFailed(FailureDescription failure)

Melaporkan pengujian yang gagal diselesaikan karena kegagalan yang dijelaskan oleh FailureDescription.

void testRunFailed(String errorMessage)

Melaporkan pengujian yang gagal diselesaikan karena terjadi error fatal.

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

Melaporkan dimulainya pengujian.

void testRunStarted(String name, int numTests)

Melaporkan dimulainya pengujian.

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

Melaporkan dimulainya pengujian.

void testRunStopped(long elapsedTime)

Melaporkan pengujian yang dihentikan sebelum selesai karena permintaan pengguna.

void testSkipped(TestDescription test, SkipReason reason)

Dipanggil saat pengujian dilewati dan tidak dijalankan karena alasan yang biasanya tidak diharapkan.

void testStarted(TestDescription test, 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.

void testStarted(TestDescription test)

Melaporkan awal kasus pengujian individual.

Metode yang dilindungi

final void clearModuleLogFiles()

Memungkinkan pembersihan file modul sehingga kita tidak membawanya terlalu lama.

final void clearResultsForName(String testRunName)

Memungkinkan penghapusan hasil untuk nama lari tertentu.

void setIsAggregrateMetrics(boolean aggregate)

Aktifkan/nonaktifkan 'metrik gabungan' opsi

Konstruktor publik

CollectingTestListener

public CollectingTestListener ()

Metode publik

getBuildInfo

public IBuildInfo getBuildInfo ()

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

Menampilkan info build.

Hasil
IBuildInfo

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

Mendapatkan hasil untuk pengujian saat ini.

Perlu diperhatikan bahwa hasilnya mungkin tidak lengkap. Sebaiknya uji nilai TestRunResult.isRunComplete() dan/atau (@link TestRunResult#isRunFailure()} yang sesuai sebelum memproses hasilnya.

Hasil
TestRunResult TestRunResult yang mewakili data yang dikumpulkan selama pengujian terakhir

getExpectedTests

public int getExpectedTests ()

Menampilkan jumlah pengujian yang diharapkan. Bisa berbeda dari getNumTotalTests() jika beberapa pengujian tidak berjalan.

Hasil
int

getInvocationContext

public IInvocationContext getInvocationContext ()

Menampilkan konteks panggilan yang dilaporkan melalui invocationStarted(com.android.tradefed.invoker.IInvocationContext)

Hasil
IInvocationContext

getMergedTestRunResults

public  getMergedTestRunResults ()

Menampilkan kumpulan hasil gabungan untuk semua operasi dengan upaya yang berbeda.

Jika ada beberapa hasil, setiap pengujian akan digabungkan, dengan hasil pengujian terbaru menimpa hasil pengujian dari pengujian sebelumnya. Operasi pengujian diurutkan berdasarkan jumlah percobaan.

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

Hasil

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

Menampilkan IInvocationContext modul yang terkait dengan hasil.

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

Hasil
IInvocationContext IInvocationContext modul untuk nama pengujian tertentu null jika tidak ada hasil untuk nama itu.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

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

Hasil
MultiMap<String, LogFile>

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

Mengembalikan salinan peta yang berisi semua file yang dicatat dalam log yang tidak terkait dengan uji coba atau ruang lingkup modul ini.

Hasil
MultiMap<String, LogFile>

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

Menampilkan jumlah total pengujian yang dijalankan dalam status kegagalan

Hasil
int

getNumAllFailedTests

public int getNumAllFailedTests ()

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

Hasil
int

getNumTestsInState

public int getNumTestsInState (TestStatus status)

Menampilkan jumlah pengujian dalam status tertentu untuk operasi ini.

Parameter
status TestStatus

Hasil
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

Untuk kompatibilitas dengan jenis status lama

Parameter
ddmlibStatus TestResult.TestStatus

Hasil
int

getNumTotalTests

public int getNumTotalTests ()

Menampilkan jumlah total pengujian yang telah selesai untuk semua operasi.

Hasil
int

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

Menampilkan info build utama yang dilaporkan melalui invocationStarted(com.android.tradefed.invoker.IInvocationContext). Build utama adalah build yang ditampilkan oleh build pertama penyedia build dari konfigurasi yang sedang berjalan. Menampilkan null jika tidak ada konteks (tidak ada build untuk kasus pengujian).

Hasil
IBuildInfo

getRunResults

public  getRunResults ()

Metode ini tidak digunakan lagi.
Gunakan getMergedTestRunResults()

Menampilkan hasil untuk semua pengujian yang dijalankan.

Hasil

getTestRunAtTry

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

Menampilkan TestRunResult untuk satu kali percobaan.

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

attempt int: ID upaya.

Hasil
TestRunResult TestRunResult untuk nama yang diberikan dan ID percobaan atau null jika nama tersebut tidak ada.

getTestRunTryCount

public int getTestRunAttemptCount (String testRunName)

Menampilkan jumlah percobaan untuk nama pengujian yang ditentukan.

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

Hasil
int

getTestRunTrys

public  getTestRunAttempts (String testRunName)

Mendapatkan semua percobaan untuk TestRunResult dari pengujian tertentu.

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

Hasil
Semua TestRunResult untuk pengujian tertentu, diurutkan berdasarkan percobaan.

getTestRunForPeringatan

public  getTestRunForAttempts (int attempt)

Mendapatkan semua hasil untuk percobaan tertentu.

Parameter
attempt int: Upaya yang kita inginkan hasilnya.

Hasil
Semua TestRunResult untuk percobaan tertentu.

getTestRunNames

public  getTestRunNames ()

Menampilkan semua nama untuk semua pengujian yang dijalankan.

Pengujian ini mungkin telah berjalan beberapa kali dengan upaya yang berbeda.

Hasil

hasFailedTests

public boolean hasFailedTests ()

Menampilkan jika panggilan memiliki pengujian yang gagal atau asumsi gagal.

Hasil
boolean

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

Menampilkan apakah nama pengujian yang diberikan memiliki hasil.

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

Hasil
boolean

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

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.

Akan otomatis dipanggil oleh framework TradeFederation.

Parameter
cause Throwable: Throwable penyebab kegagalan

pemanggilanDilewati

public void invocationSkipped (SkipReason reason)

Melaporkan panggilan sebagai dilewati

Parameter
reason SkipReason

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

nonaktif

public boolean isDisabled ()

Menampilkan Benar jika seluruh objek dinonaktifkan (lewati penyiapan dan pemutusan). Salah jika sebaliknya.

Hasil
boolean

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.

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

Metode ini tidak digunakan lagi.
Tidak diperlukan untuk pengujian lagi.

Tetapkan info build. Sebaiknya hanya digunakan untuk pengujian.

Parameter
buildInfo IBuildInfo

setelNonaktifkan

public void setDisable (boolean isDisabled)

Menetapkan apakah objek harus dinonaktifkan. Dinonaktifkan berarti langkah penyiapan dan pemutusan harus dilewati. Dapat digunakan untuk membuat objek dinonaktifkan secara default di default .

Parameter
isDisabled boolean: status tempat objek harus ditempatkan.

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

Menetapkan MergeStrategy yang akan digunakan saat menggabungkan hasil.

Parameter
strategy MergeStrategy

testAsumsiKegagalan

public void testAssumptionFailure (TestDescription test, 
                String trace)

Dipanggil saat pengujian atomik menandai bahwa kondisi tersebut mengasumsikan kondisi yang salah.

Parameter
test TestDescription: mengidentifikasi pengujian

trace String: stack trace kegagalan

testAsumsiKegagalan

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Dipanggil saat pengujian atomik menandai bahwa kondisi tersebut mengasumsikan kondisi yang salah.

Parameter
test TestDescription: mengidentifikasi pengujian

failure FailureDescription: FailureDescription yang menjelaskan kegagalan dan konteksnya.

testBerakhir

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

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
test TestDescription: mengidentifikasi pengujian

endTime long: waktu pengujian berakhir, yang diukur melalui System.currentTimeMillis()

testMetrics : ERROR(/Map) metrik yang ditampilkan

testBerakhir

public void testEnded (TestDescription test, 
                 testMetrics)

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
test TestDescription: mengidentifikasi pengujian

testMetrics : ERROR(/Map) metrik yang ditampilkan

pengujianGagal

public void testFailed (TestDescription test, 
                FailureDescription failure)

Melaporkan kegagalan kasus pengujian individu.

Akan dipanggil antara testStarted dan testEnded.

Parameter
test TestDescription: mengidentifikasi pengujian

failure FailureDescription: FailureDescription yang menjelaskan kegagalan dan konteksnya.

pengujianGagal

public void testFailed (TestDescription test, 
                String trace)

Melaporkan kegagalan kasus pengujian individu.

Akan dipanggil antara testStarted dan testEnded.

Parameter
test TestDescription: mengidentifikasi pengujian

trace String: stack trace kegagalan

testDiabaikan

public void testIgnored (TestDescription test)

Dipanggil pada saat pengujian tidak akan dijalankan, umumnya karena metode pengujian dianotasi dengan {i>org.junit.Ignore<i}.

Parameter
test TestDescription: mengidentifikasi pengujian

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 elapsedTime, 
                 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
elapsedTime 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 errorMessage)

Melaporkan pengujian yang gagal diselesaikan karena terjadi error fatal.

Parameter
errorMessage String: String yang menjelaskan alasan kegagalan operasi.

testRunStarted

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

Melaporkan dimulainya pengujian.

Parameter
name String: nama pengujian yang dijalankan

numTests 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 name, 
                int numTests)

Melaporkan dimulainya pengujian.

Parameter
name String: nama pengujian yang dijalankan

numTests int: jumlah total pengujian dalam pengujian

testRunStarted

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

Melaporkan dimulainya pengujian.

Parameter
name String: nama pengujian yang dijalankan

numTests 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 dengan runName yang sama dan percobaanNumber adalah dari 0 hingga 3.

startTime long: waktu yang dimulai, diukur melalui System.currentTimeMillis()

testRunBerhenti

public void testRunStopped (long elapsedTime)

Melaporkan pengujian yang dihentikan sebelum selesai karena permintaan pengguna.

TODO: saat ini tidak digunakan, pertimbangkan untuk menghapusnya

Parameter
elapsedTime long: perangkat melaporkan waktu berlalu, dalam milidetik

pengujianDilewati

public void testSkipped (TestDescription test, 
                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
test TestDescription: mengidentifikasi pengujian

reason SkipReason: SkipReason

pengujianDimulai

public void testStarted (TestDescription test, 
                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
test TestDescription: mengidentifikasi pengujian

startTime long: waktu pengujian dimulai, yang diukur melalui System.currentTimeMillis()

pengujianDimulai

public void testStarted (TestDescription test)

Melaporkan awal kasus pengujian individual. Antarmuka yang lebih lama, harus menggunakan testStarted(com.android.tradefed.result.TestDescription) jika memungkinkan.

Parameter
test TestDescription: mengidentifikasi pengujian

Metode yang dilindungi

{i>clearModuleLogFiles<i}

protected final void clearModuleLogFiles ()

Memungkinkan pembersihan file modul sehingga kita tidak membawanya terlalu lama.

clearResultsForName

protected final void clearResultsForName (String testRunName)

Memungkinkan penghapusan hasil untuk nama lari tertentu. Hanya boleh digunakan dalam kasus tertentu seperti agregator hasil.

Parameter
testRunName String

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

Aktifkan/nonaktifkan 'metrik gabungan' opsi

Parameter
aggregate boolean