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 pemanggilan yang dilaporkan melalui invocationStarted(com.android.tradefed.invoker.IInvocationContext)

getMergedTestRunResults()

Menampilkan kumpulan hasil gabungan untuk semua operasi yang dijalankan di berbagai upaya.

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

Menampilkan salinan peta yang berisi semua file yang dicatat ke dalam log yang tidak terkait dengan pengujian atau modul.

int getNumAllFailedTestRuns()

Menampilkan jumlah total pengujian yang dijalankan dalam status kegagalan

int getNumAllFailedTests()

Menampilkan jumlah total pengujian dalam status kegagalan (hanya gagal, kegagalan asumsi tidak diperhitungkan).

int getNumTestsInState(TestStatus status)

Menampilkan jumlah pengujian dalam status tertentu untuk operasi ini.

int getNumTestsInState(TestResult.TestStatus ddmlibStatus)

Untuk kompatibilitas dengan jenis status yang lebih lama

int getNumTotalTests()

Menampilkan jumlah total pengujian yang lengkap untuk semua operasi.

IBuildInfo getPrimaryBuildInfo()

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

getRunResults()

Metode ini tidak digunakan lagi. Menggunakan getMergedTestRunResults()

TestRunResult getTestRunAtAttempt(String testRunName, int attempt)

Menampilkan TestRunResult untuk satu upaya.

int getTestRunAttemptCount(String testRunName)

Menampilkan jumlah upaya untuk nama pengujian yang dijalankan.

getTestRunAttempts(String testRunName)

Mendapatkan semua upaya untuk TestRunResult dari pengujian tertentu yang dijalankan.

getTestRunForAttempts(int attempt)

Mendapatkan semua hasil untuk upaya tertentu.

getTestRunNames()

Menampilkan semua nama untuk semua pengujian yang dijalankan.

boolean hasFailedTests()

Menampilkan apakah pemanggilan memiliki pengujian yang gagal atau asumsi yang gagal.

boolean hasTestRunResultsForName(String testRunName)

Menampilkan apakah nama pengujian yang dijalankan memiliki hasil.

void invocationEnded(long elapsedTime)

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

void invocationFailed(Throwable cause)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.

void invocationSkipped(SkipReason reason)

Melaporkan pemanggilan sebagai dilewati

void invocationStarted(IInvocationContext context)

Melaporkan awal pemanggilan pengujian.

boolean isDisabled()

Menampilkan True jika seluruh objek dinonaktifkan (lewati penyiapan dan penghapusan).

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.

void setBuildInfo(IBuildInfo buildInfo)

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

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 atom menandai bahwa pengujian 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)) tempat kita dapat menentukan waktu akhir 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 saat pengujian tidak akan dijalankan, biasanya karena metode pengujian dianotasi dengan org.junit.Ignore.

void testModuleEnded()

Melaporkan akhir proses modul.

void testModuleStarted(IInvocationContext moduleContext)

Melaporkan awal modul yang berjalan.

void testRunEnded(long elapsedTime, runMetrics)

Melaporkan akhir pengujian yang dijalankan.

void testRunFailed(FailureDescription failure)

Pengujian laporan 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 awal pengujian yang dijalankan.

void testRunStarted(String name, int numTests)

Melaporkan awal pengujian yang dijalankan.

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

Melaporkan awal pengujian yang dijalankan.

void testRunStopped(long elapsedTime)

Pengujian laporan berhenti 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 kapan pengujian dimulai, yang digabungkan 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 untuk menghapus hasil untuk nama run tertentu.

void setIsAggregrateMetrics(boolean aggregate)

Aktifkan/nonaktifkan opsi 'metrik gabungan'

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 yang sedang berjalan.

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

Hasil
TestRunResult TestRunResult yang mewakili data yang dikumpulkan selama pengujian terakhir dijalankan

getExpectedTests

public int getExpectedTests ()

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

Hasil
int

getInvocationContext

public IInvocationContext getInvocationContext ()

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

Hasil
IInvocationContext

getMergedTestRunResults

public  getMergedTestRunResults ()

Menampilkan kumpulan hasil gabungan untuk semua operasi yang dijalankan di berbagai upaya.

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

Metrik untuk upaya 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 yang dijalankan null jika tidak ada hasil untuk nama tersebut.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

Menampilkan salinan peta yang berisi semua file yang dicatat ke dalam log yang terkait dengan modul

Hasil
MultiMap<String, LogFile>

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

Menampilkan salinan peta yang berisi semua file yang dicatat dalam log yang tidak terkait dengan pengujian yang dijalankan atau modul.

Hasil
MultiMap<String, LogFile>

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

Menampilkan jumlah total pengujian yang berjalan dalam status kegagalan

Hasil
int

getNumAllFailedTests

public int getNumAllFailedTests ()

Menampilkan jumlah total pengujian dalam status kegagalan (hanya gagal, kegagalan asumsi tidak 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 yang lebih lama

Parameter
ddmlibStatus TestResult.TestStatus

Hasil
int

getNumTotalTests

public int getNumTotalTests ()

Menampilkan jumlah total pengujian yang 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 penyedia build pertama 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

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

Menampilkan TestRunResult untuk satu upaya.

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 tidak ada.

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

Menampilkan jumlah upaya untuk nama pengujian yang dijalankan.

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.

getTestRunForAttempts

public  getTestRunForAttempts (int attempt)

Mendapatkan semua hasil untuk upaya tertentu.

Parameter
attempt int: Upaya yang ingin kita dapatkan hasilnya.

Hasil
Semua TestRunResult untuk percobaan tertentu.

getTestRunNames

public  getTestRunNames ()

Menampilkan semua nama untuk semua pengujian yang dijalankan.

Pengujian ini mungkin telah dijalankan 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

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 berlalu dari pemanggilan dalam md

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

pemanggilanDilewati

public void invocationSkipped (SkipReason reason)

Melaporkan pemanggilan sebagai dilewati

Parameter
reason SkipReason

pemanggilanDimulai

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

isDisabled

public boolean isDisabled ()

Menampilkan True jika seluruh objek dinonaktifkan (lewati penyiapan dan penghapusan). Salah jika tidak.

Hasil
boolean

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Dalam beberapa kasus, log harus dikaitkan secara kuat 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 memungkinkan. Dengan demikian, callback ini memungkinkan untuk memberikan pengaitan yang kuat secara eksplisit.

Parameter
dataName String: Nama data

logFile LogFile: LogFile yang dicatat sebelumnya ke dalam log dan harus dikaitkan dengan kasus pengujian.

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

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

Setel info build. Hanya boleh digunakan untuk pengujian.

Parameter
buildInfo IBuildInfo

setDisable

public void setDisable (boolean isDisabled)

Menetapkan apakah objek harus dinonaktifkan. Dinonaktifkan berarti langkah penyiapan dan penghapusan harus dilewati. Dapat digunakan untuk membuat objek dinonaktifkan secara default dalam konstruktor default.

Parameter
isDisabled boolean: status yang harus diberikan ke objek.

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

Menetapkan MergeStrategy yang akan digunakan saat menggabungkan hasil.

Parameter
strategy MergeStrategy

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Dipanggil saat pengujian atom menandai bahwa pengujian mengasumsikan kondisi yang salah

Parameter
test TestDescription: mengidentifikasi pengujian

trace String: stack trace kegagalan

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Dipanggil saat pengujian atom menandai bahwa pengujian mengasumsikan kondisi yang salah

Parameter
test TestDescription: mengidentifikasi pengujian

failure FailureDescription: FailureDescription yang menjelaskan kegagalan dan konteksnya.

testEnded

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

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

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

testMetrics : ERROR(/Map) dari metrik yang dikeluarkan

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Melaporkan akhir eksekusi setiap kasus pengujian.

Jika testFailed(TestDescription, FailureDescription) tidak dipanggil, pengujian ini akan lulus. Juga menampilkan metrik kunci/nilai yang mungkin telah dimunculkan selama eksekusi kasus pengujian.

Parameter
test TestDescription: mengidentifikasi pengujian

testMetrics : ERROR(/Map) dari metrik yang dikeluarkan

testFailed

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.

testFailed

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

testIgnored

public void testIgnored (TestDescription test)

Dipanggil saat pengujian tidak akan dijalankan, biasanya karena metode pengujian dianotasi dengan org.junit.Ignore.

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. Ini hanya digunakan selama operasi yang menggunakan modul: runner berbasis suite.

Parameter
moduleContext IInvocationContext: IInvocationContext modul.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Melaporkan berakhirnya uji coba.

Parameter
elapsedTime long: perangkat melaporkan waktu berlalu, 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 errorMessage)

Pengujian laporan yang dijalankan gagal diselesaikan karena error fatal.

Parameter
errorMessage String: String yang menjelaskan alasan kegagalan operasi.

testRunStarted

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

Melaporkan awal pengujian yang dijalankan.

Parameter
name String: nama pengujian yang dijalankan

numTests int: jumlah total pengujian dalam operasi pengujian

attemptNumber int: nomor pesanan, yang mengidentifikasi berbagai percobaan dari runName sama yang dijalankan beberapa kali. upayaNumber diindeks 0 dan harus bertambah setiap kali operasi baru terjadi. Misalnya, pengujian terperinci dicoba lagi 3 kali, harus memiliki 4 total yang dijalankan dalam runName yang sama dan percobaanNumbernya adalah dari 0 hingga 3.

testRunStarted

public void testRunStarted (String name, 
                int numTests)

Melaporkan awal pengujian yang dijalankan.

Parameter
name String: nama pengujian yang dijalankan

numTests int: jumlah total pengujian dalam operasi pengujian

testRunStarted

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

Melaporkan awal pengujian yang dijalankan.

Parameter
name String: nama pengujian yang dijalankan

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

testRunStopped

public void testRunStopped (long elapsedTime)

Pengujian laporan berhenti sebelum selesai karena permintaan pengguna.

TODO: currently unused, consider removing

Parameter
elapsedTime long: waktu berlalu yang dilaporkan perangkat, dalam milidetik

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Dipanggil saat pengujian dilewati dan tidak dijalankan karena alasan yang biasanya tidak diharapkan. Pengujian ini akan dicoba untuk dicoba lagi untuk mencoba 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 kapan pengujian dimulai, yang digabungkan dengan ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) untuk pengukuran yang akurat.

Parameter
test TestDescription: mengidentifikasi pengujian

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

pengujianDimulai

public void testStarted (TestDescription test)

Melaporkan awal setiap kasus pengujian. Antarmuka 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 untuk menghapus hasil untuk nama run tertentu. Hanya boleh digunakan dalam beberapa kasus seperti agregator hasil.

Parameter
testRunName String

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

Mengaktifkan/menonaktifkan opsi 'metrik gabungan'

Parameter
aggregate boolean