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 proses 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 proses di berbagai percobaan.

IInvocationContext getModuleContextForRunResult(String testRunName)

Menampilkan IInvocationContext modul yang terkait dengan hasil.

MultiMap<String, LogFile> getModuleLogFiles()

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

MultiMap<String, LogFile> getNonAssociatedLogFiles()

Menampilkan salinan peta yang berisi semua file yang dicatat dan tidak terkait dengan proses pengujian atau modul.

int getNumAllFailedTestRuns()

Menampilkan jumlah total eksekusi pengujian dalam status gagal

int getNumAllFailedTests()

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

int getNumTestsInState(TestStatus status)

Menampilkan jumlah pengujian dalam status tertentu untuk proses ini.

int getNumTestsInState(TestResult.TestStatus ddmlibStatus)

Untuk kompatibilitas dengan jenis status yang lebih lama

int getNumTotalTests()

Menampilkan jumlah total pengujian yang selesai untuk semua proses.

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

int getTestRunAttemptCount(String testRunName)

Menampilkan jumlah upaya untuk nama run pengujian tertentu.

getTestRunAttempts(String testRunName)

Mendapatkan semua upaya untuk TestRunResult dari operasi pengujian tertentu.

getTestRunForAttempts(int attempt)

Mendapatkan semua hasil untuk percobaan tertentu.

getTestRunNames()

Menampilkan semua nama untuk semua proses pengujian.

boolean hasFailedTests()

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

boolean hasTestRunResultsForName(String testRunName)

Menampilkan apakah nama proses pengujian tertentu memiliki hasil.

void invocationEnded(long elapsedTime)

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

void invocationFailed(Throwable cause)

Melaporkan pemanggilan yang tidak lengkap karena kondisi error tertentu.

void invocationSkipped(SkipReason reason)

Melaporkan pemanggilan sebagai dilewati

void invocationStarted(IInvocationContext context)

Melaporkan dimulainya pemanggilan pengujian.

boolean isDisabled()

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

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.

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 atomik menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah

void testAssumptionFailure(TestDescription test, FailureDescription failure)

Dipanggil saat pengujian atomik menandai bahwa pengujian 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 berakhir secara langsung.

void testEnded(TestDescription test, testMetrics)

Melaporkan akhir eksekusi kasus pengujian individual.

void testFailed(TestDescription test, FailureDescription failure)

Melaporkan kegagalan kasus pengujian individual.

void testFailed(TestDescription test, String trace)

Melaporkan kegagalan kasus pengujian individual.

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

void testRunEnded(long elapsedTime, runMetrics)

Melaporkan akhir proses pengujian.

void testRunFailed(FailureDescription failure)

Operasi pengujian laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh FailureDescription.

void testRunFailed(String errorMessage)

Uji coba laporan gagal diselesaikan karena terjadi error fatal.

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

Melaporkan dimulainya proses pengujian.

void testRunStarted(String name, int numTests)

Melaporkan dimulainya proses pengujian.

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

Melaporkan dimulainya proses pengujian.

void testRunStopped(long elapsedTime)

Uji coba laporan 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 kapan pengujian dimulai, dikombinasikan dengan ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) untuk pengukuran yang akurat.

void testStarted(TestDescription test)

Melaporkan dimulainya kasus pengujian individual.

Metode yang dilindungi

final void clearModuleLogFiles()

Memungkinkan pembersihan file modul sehingga kita tidak perlu membawanya terlalu lama.

final void clearResultsForName(String testRunName)

Memungkinkan untuk menghapus hasil untuk nama proses tertentu.

final void clearTestRunResults()

Memungkinkan untuk menghapus semua hasil uji coba sehingga kita tidak perlu menyimpannya terlalu lama.

void setIsAggregrateMetrics(boolean aggregate)

Aktifkan/nonaktifkan opsi 'gabungkan metrik'

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 proses pengujian saat ini.

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

Hasil
TestRunResult TestRunResult yang merepresentasikan data yang dikumpulkan selama uji coba terakhir

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 proses di berbagai percobaan.

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

Metrik untuk upaya yang sama akan digabungkan berdasarkan preferensi yang ditetapkan oleh aggregate-metrics. Metrik akhir akan menjadi metrik 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 run pengujian tertentu null jika tidak ada hasil untuk nama tersebut.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

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

Hasil
MultiMap<String, LogFile>

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

Menampilkan salinan peta yang berisi semua file yang dicatat dan tidak terkait dengan proses pengujian atau modul.

Hasil
MultiMap<String, LogFile>

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

Menampilkan jumlah total eksekusi pengujian dalam status gagal

Hasil
int

getNumAllFailedTests

public int getNumAllFailedTests ()

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

Hasil
int

getNumTestsInState

public int getNumTestsInState (TestStatus status)

Menampilkan jumlah pengujian dalam status tertentu untuk proses 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 proses.

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 proses pengujian.

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

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

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

Menampilkan jumlah upaya untuk nama run pengujian tertentu.

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

Hasil
int

getTestRunAttempts

public  getTestRunAttempts (String testRunName)

Mendapatkan semua upaya untuk TestRunResult dari operasi pengujian tertentu.

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

Hasil
Semua TestRunResult untuk uji coba tertentu, diurutkan berdasarkan upaya.

getTestRunForAttempts

public  getTestRunForAttempts (int attempt)

Mendapatkan semua hasil untuk percobaan tertentu.

Parameter
attempt int: Upaya yang ingin kita peroleh hasilnya.

Hasil
Semua TestRunResult untuk upaya tertentu.

getTestRunNames

public  getTestRunNames ()

Menampilkan semua nama untuk semua proses pengujian.

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

Hasil

hasFailedTests

public boolean hasFailedTests ()

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

Hasil
boolean

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

Menampilkan apakah nama proses pengujian tertentu 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 kondisi error tertentu.

Akan dipanggil secara otomatis oleh framework TradeFederation.

Parameter
elapsedTime long: waktu yang berlalu dari pemanggilan dalam md

invocationFailed

public void invocationFailed (Throwable cause)

Melaporkan pemanggilan yang tidak lengkap karena kondisi error tertentu.

Akan dipanggil secara otomatis oleh framework TradeFederation.

Parameter
cause Throwable: Throwable penyebab kegagalan

invocationSkipped

public void invocationSkipped (SkipReason reason)

Melaporkan pemanggilan sebagai dilewati

Parameter
reason SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

Melaporkan dimulainya pemanggilan pengujian.

Akan dipanggil secara otomatis oleh framework TradeFederation. Pelapor perlu mengganti metode ini untuk mendukung pelaporan dari beberapa perangkat.

Parameter
context IInvocationContext: informasi tentang pemanggilan

isDisabled

public boolean isDisabled ()

Menampilkan True jika seluruh objek dinonaktifkan (lewati penyiapan dan penguraian). Salah untuk sebaliknya.

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. Oleh karena itu, callback ini memungkinkan untuk memberikan asosiasi yang kuat secara eksplisit.

Parameter
dataName String: Nama data

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

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

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

Menetapkan info build. Sebaiknya hanya digunakan untuk pengujian.

Parameter
buildInfo IBuildInfo

setDisable

public void setDisable (boolean isDisabled)

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

Parameter
isDisabled boolean: status yang harus dimasukkan 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 atomik menandai bahwa pengujian tersebut 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 atomik menandai bahwa pengujian tersebut 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 berakhir secara langsung. Gabungkan dengan testStarted(com.android.tradefed.result.TestDescription, long) untuk pengukuran yang akurat.

Parameter
test TestDescription: mengidentifikasi pengujian

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

testMetrics : ERROR(/Map) metrik yang dikeluarkan

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Melaporkan akhir eksekusi kasus pengujian individual.

Jika testFailed(TestDescription, FailureDescription) tidak dipanggil, pengujian ini lulus. Juga menampilkan metrik key/value yang mungkin telah dikeluarkan selama eksekusi kasus pengujian.

Parameter
test TestDescription: mengidentifikasi pengujian

testMetrics : ERROR(/Map) metrik yang dikeluarkan

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Melaporkan kegagalan kasus pengujian individual.

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

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

testModuleEnded

public void testModuleEnded ()

Melaporkan akhir proses modul.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Melaporkan awal modul berjalan. Callback ini terkait dengan testModuleEnded() dan bersifat opsional dalam urutan. Hanya digunakan selama menjalankan modul yang menggunakan runner berbasis rangkaian pengujian.

Parameter
moduleContext IInvocationContext: IInvocationContext modul.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Melaporkan akhir proses pengujian.

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

runMetrics : pasangan nilai kunci yang dilaporkan di akhir proses pengujian

testRunFailed

public void testRunFailed (FailureDescription failure)

Operasi pengujian 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 terjadi error fatal.

Parameter
errorMessage String: String yang menjelaskan alasan kegagalan operasi.

testRunStarted

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

Melaporkan dimulainya proses pengujian.

Parameter
name String: nama operasi pengujian

numTests int: jumlah total pengujian dalam operasi pengujian

attemptNumber int: nomor pesanan, yang mengidentifikasi berbagai upaya runName yang sama yang dijalankan beberapa kali. attemptNumber diindeks 0 dan harus bertambah setiap kali ada run baru. Misalnya, pengujian dicoba ulang secara terperinci 3 kali, maka totalnya harus ada 4 run dalam runName yang sama dan attemptNumber-nya adalah dari 0 hingga 3.

testRunStarted

public void testRunStarted (String name, 
                int numTests)

Melaporkan dimulainya proses pengujian.

Parameter
name String: nama operasi pengujian

numTests int: jumlah total pengujian dalam operasi pengujian

testRunStarted

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

Melaporkan dimulainya proses pengujian.

Parameter
name String: nama operasi pengujian

numTests int: jumlah total pengujian dalam operasi pengujian

attemptNumber int: nomor pesanan, yang mengidentifikasi berbagai upaya runName yang sama yang dijalankan beberapa kali. attemptNumber diindeks 0 dan harus bertambah setiap kali ada run baru. Misalnya, pengujian dicoba ulang secara terperinci 3 kali, sehingga total ada 4 run dengan runName yang sama dan attemptNumber dari 0 hingga 3.

startTime long: waktu mulai eksekusi, 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: 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 lagi untuk mendapatkan eksekusi yang tepat.

Parameter
test TestDescription: mengidentifikasi pengujian

reason SkipReason: SkipReason

testStarted

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 pengujian

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

testStarted

public void testStarted (TestDescription test)

Melaporkan dimulainya kasus pengujian individual. Antarmuka lama, sebaiknya gunakan testStarted(com.android.tradefed.result.TestDescription) jika memungkinkan.

Parameter
test TestDescription: mengidentifikasi pengujian

Metode yang dilindungi

clearModuleLogFiles

protected final void clearModuleLogFiles ()

Memungkinkan pembersihan file modul sehingga kita tidak perlu membawanya terlalu lama.

clearResultsForName

protected final void clearResultsForName (String testRunName)

Memungkinkan untuk menghapus hasil untuk nama proses tertentu. Hanya boleh digunakan dalam beberapa kasus seperti penggabung hasil.

Parameter
testRunName String

clearTestRunResults

protected final void clearTestRunResults ()

Memungkinkan untuk menghapus semua hasil uji coba sehingga kita tidak perlu menyimpannya terlalu lama.

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

Aktifkan/nonaktifkan opsi 'gabungkan metrik'

Parameter
aggregate boolean