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 dengan urutan yang benar.
Ringkasan
Konstruktor publik | |
---|---|
CollectingTestListener () |
Metode publik | |
---|---|
IBuildInfo | getBuildInfo () Metode ini sudah usang. mengandalkan |
TestRunResult | getCurrentRunResults () Mendapatkan hasil untuk uji coba saat ini. |
int | getExpectedTests () Mengembalikan jumlah hitungan tes yang diharapkan. |
IInvocationContext | getInvocationContext () Kembalikan konteks pemanggilan yang dilaporkan melalui |
getMergedTestRunResults () Kembalikan kumpulan hasil yang digabungkan untuk semua proses di berbagai upaya. | |
IInvocationContext | getModuleContextForRunResult (String testRunName) Mengembalikan |
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 diperhitungkan). |
int | getNumTestsInState (TestResult.TestStatus status) Mengembalikan jumlah pengujian dalam status tertentu untuk proses ini. |
int | getNumTotalTests () Mengembalikan jumlah total pengujian lengkap untuk semua proses. |
IBuildInfo | getPrimaryBuildInfo () Kembalikan info build utama yang dilaporkan melalui |
getRunResults () Metode ini sudah usang. Gunakan | |
TestRunResult | getTestRunAtAttempt (String testRunName, int attempt) Kembalikan |
int | getTestRunAttemptCount (String testRunName) Mengembalikan jumlah upaya untuk nama uji coba tertentu. |
getTestRunAttempts (String testRunName) Mendapatkan semua upaya untuk | |
getTestRunForAttempts (int attempt) Mendapatkan semua hasil untuk upaya tertentu. | |
getTestRunNames () Kembalikan semua nama untuk semua uji coba. | |
boolean | hasFailedTests () Mengembalikan jika pemanggilan memiliki tes yang gagal atau asumsi gagal. |
boolean | hasTestRunResultsForName (String testRunName) Mengembalikan apakah nama uji coba yang diberikan memiliki 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 penyiapan dan pembongkaran). |
void | logAssociation (String dataName, LogFile logFile) Dalam beberapa kasus, log harus sangat terkait dengan kasus pengujian, tetapi kesempatan untuk melakukannya langsung |
void | setBuildInfo ( IBuildInfo buildInfo) Metode ini sudah usang. Tidak perlu untuk pengujian lagi. |
void | setDisable (boolean isDisabled) Menetapkan apakah objek harus dinonaktifkan. |
void | setMergeStrategy ( MergeStrategy strategy) Mengatur |
void | testAssumptionFailure ( TestDescription test, String trace) Dipanggil saat tes atom menandai bahwa kondisi tersebut dianggap salah |
void | testAssumptionFailure ( TestDescription test, FailureDescription failure) Dipanggil saat tes atom menandai bahwa kondisi tersebut dianggap salah |
void | testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) Alternatif untuk |
void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Melaporkan akhir eksekusi dari 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 saat pengujian tidak akan dijalankan, umumnya karena metode pengujian dianotasi dengan org.junit.Ignore. |
void | testModuleEnded () Melaporkan akhir dari sebuah modul yang dijalankan. |
void | testModuleStarted ( IInvocationContext moduleContext) Melaporkan awal dari modul yang sedang 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 errorMessage) Uji coba laporan gagal diselesaikan karena kesalahan fatal. |
void | testRunStarted (String name, int numTests, int attemptNumber) Melaporkan awal uji coba. |
void | testRunStarted (String name, int numTests) Melaporkan awal uji coba. |
void | testRunStarted (String name, int numTests, int attemptNumber, long startTime) Melaporkan awal uji coba. |
void | testRunStopped (long elapsedTime) Uji coba laporan berhenti sebelum selesai karena permintaan pengguna. |
void | testStarted ( TestDescription test, long startTime) Alternatif untuk |
void | testStarted ( TestDescription test) Melaporkan awal kasus uji individu. |
Metode yang dilindungi | |
---|---|
final void | clearModuleLogFiles () Memungkinkan pembersihan file modul sehingga kita terhindar dari membawanya terlalu lama. |
final void | clearResultsForName (String testRunName) Memungkinkan untuk menghapus hasil untuk nama proses yang diberikan. |
void | setIsAggregrateMetrics (boolean aggregate) Alihkan opsi 'metrik gabungan' |
Konstruktor publik
MengumpulkanTestListener
public CollectingTestListener ()
Metode publik
getBuildInfo
public IBuildInfo getBuildInfo ()
Metode ini sudah usang.
mengandalkan IBuildInfo
dari getInvocationContext()
.
Mengembalikan info build.
Pengembalian | |
---|---|
IBuildInfo |
dapatkanCurrentRunResults
public TestRunResult getCurrentRunResults ()
Mendapatkan hasil untuk uji coba saat ini.
Perhatikan bahwa hasilnya mungkin tidak lengkap. Direkomendasikan untuk menguji nilai TestRunResult.isRunComplete()
dan/atau (@link TestRunResult#isRunFailure()} sebagaimana mestinya sebelum memproses hasilnya.
Pengembalian | |
---|---|
TestRunResult | TestRunResult mewakili data yang dikumpulkan selama uji coba terakhir |
getExpectedTests
public int getExpectedTests ()
Mengembalikan jumlah hitungan tes yang diharapkan. Bisa berbeda dari getNumTotalTests()
jika beberapa pengujian tidak berjalan.
Pengembalian | |
---|---|
int |
getInvocationContext
public IInvocationContext getInvocationContext ()
Kembalikan konteks pemanggilan yang dilaporkan melalui invocationStarted(com.android.tradefed.invoker.IInvocationContext)
Pengembalian | |
---|---|
IInvocationContext |
getMergedTestRunResults
publicgetMergedTestRunResults ()
Kembalikan kumpulan hasil yang digabungkan untuk semua proses di berbagai upaya.
Jika ada beberapa hasil, setiap uji coba digabungkan, dengan hasil uji terbaru menimpa hasil uji coba 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 upaya terakhir.
Pengembalian | |
---|---|
getModuleContextForRunResult
public IInvocationContext getModuleContextForRunResult (String testRunName)
Mengembalikan IInvocationContext
modul yang terkait dengan hasil.
Parameter | |
---|---|
testRunName | String : Nama yang diberikan oleh { testRunStarted(String, int) . |
Pengembalian | |
---|---|
IInvocationContext | IInvocationContext modul untuk nama uji coba yang diberikan null jika tidak ada hasil untuk nama tersebut. |
getModuleLogFiles
public MultiMap<String, LogFile> getModuleLogFiles ()
Mengembalikan salinan peta yang berisi semua file log yang terkait dengan modul
Pengembalian | |
---|---|
MultiMap <String, LogFile > |
getNonAssociatedLogFiles
public MultiMap<String, LogFile> getNonAssociatedLogFiles ()
Mengembalikan salinan peta yang berisi semua file log yang tidak terkait dengan uji coba atau modul.
Pengembalian | |
---|---|
MultiMap <String, LogFile > |
getNumAllFailedTestRuns
public int getNumAllFailedTestRuns ()
Mengembalikan jumlah total pengujian yang dijalankan dalam keadaan gagal
Pengembalian | |
---|---|
int |
getNumAllFailedTests
public int getNumAllFailedTests ()
Mengembalikan jumlah total pengujian dalam keadaan gagal (hanya gagal, kegagalan asumsi tidak diperhitungkan).
Pengembalian | |
---|---|
int |
getNumTestsInState
public int getNumTestsInState (TestResult.TestStatus status)
Mengembalikan jumlah pengujian dalam status tertentu untuk proses ini.
Parameter | |
---|---|
status | TestResult.TestStatus |
Pengembalian | |
---|---|
int |
getNumTotalTests
public int getNumTotalTests ()
Mengembalikan jumlah total pengujian lengkap untuk semua proses.
Pengembalian | |
---|---|
int |
getPrimaryBuildInfo
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).
Pengembalian | |
---|---|
IBuildInfo |
getRunResults
publicgetRunResults ()
Metode ini sudah usang.
Gunakan getMergedTestRunResults()
Mengembalikan hasil untuk semua uji coba.
Pengembalian | |
---|---|
getTestRunAttempt
public TestRunResult getTestRunAtAttempt (String testRunName, int attempt)
Kembalikan TestRunResult
untuk sekali percobaan.
Parameter | |
---|---|
testRunName | String : Nama yang diberikan oleh { testRunStarted(String, int) . |
attempt | int : ID percobaan. |
Pengembalian | |
---|---|
TestRunResult | TestRunResult untuk nama yang diberikan dan id percobaan atau null jika tidak ada. |
getTestRunAttemptCount
public int getTestRunAttemptCount (String testRunName)
Mengembalikan jumlah upaya untuk nama uji coba tertentu.
Parameter | |
---|---|
testRunName | String : Nama yang diberikan oleh { testRunStarted(String, int) . |
Pengembalian | |
---|---|
int |
getTestRunAttempts
publicgetTestRunAttempts (String testRunName)
Mendapatkan semua upaya untuk TestRunResult
dari uji coba yang diberikan.
Parameter | |
---|---|
testRunName | String : Nama yang diberikan oleh { testRunStarted(String, int) . |
Pengembalian | |
---|---|
Semua TestRunResult untuk uji coba tertentu, diurutkan berdasarkan percobaan. |
getTestRunForAttempts
publicgetTestRunForAttempts (int attempt)
Mendapatkan semua hasil untuk upaya tertentu.
Parameter | |
---|---|
attempt | int : Percobaan yang kita inginkan hasilnya. |
Pengembalian | |
---|---|
Semua TestRunResult untuk percobaan tertentu. |
getTestRunNames
publicgetTestRunNames ()
Kembalikan semua nama untuk semua uji coba.
Uji coba ini mungkin telah berjalan beberapa kali dengan percobaan yang berbeda.
Pengembalian | |
---|---|
hasFailedTests
public boolean hasFailedTests ()
Mengembalikan jika pemanggilan memiliki tes yang gagal atau asumsi gagal.
Pengembalian | |
---|---|
boolean |
hasTestRunResultsForName
public boolean hasTestRunResultsForName (String testRunName)
Mengembalikan apakah nama uji coba yang diberikan memiliki hasil.
Parameter | |
---|---|
testRunName | String : Nama yang diberikan oleh { testRunStarted(String, int) . |
Pengembalian | |
---|---|
boolean |
doaBerakhir
public void invocationEnded (long elapsedTime)
Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil atau karena beberapa kondisi kesalahan.
Akan dipanggil secara otomatis oleh kerangka kerja TradeFederation.Parameter | |
---|---|
elapsedTime | long : waktu berlalu dari doa dalam ms |
doa Gagal
public void invocationFailed (Throwable cause)
Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.
Akan dipanggil secara otomatis oleh kerangka kerja TradeFederation.Parameter | |
---|---|
cause | Throwable : Penyebab kegagalan Throwable |
invocationStarted
public void invocationStarted (IInvocationContext context)
Melaporkan awal pemanggilan pengujian.
Akan dipanggil secara otomatis oleh kerangka kerja TradeFederation. Pelapor perlu mengganti metode ini untuk mendukung pelaporan beberapa perangkat.
Parameter | |
---|---|
context | IInvocationContext : informasi tentang doa |
Dinonaktifkan
public boolean isDisabled ()
Mengembalikan True jika seluruh objek dinonaktifkan (lewati penyiapan dan pembongkaran). Salah sebaliknya.
Pengembalian | |
---|---|
boolean |
logAssociation
public void logAssociation (String dataName, LogFile logFile)
Dalam beberapa kasus, log harus sangat terkait dengan kasus pengujian, tetapi kesempatan untuk melakukannya langsung testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
panggilan balik tidak dimungkinkan. Dengan demikian, panggilan balik ini memungkinkan untuk memberikan asosiasi yang kuat secara eksplisit.
Parameter | |
---|---|
dataName | String : Nama data |
logFile | LogFile : LogFile yang telah dicatat sebelumnya dan harus dikaitkan dengan kasus uji. |
setBuildInfo
public void setBuildInfo (IBuildInfo buildInfo)
Metode ini sudah usang.
Tidak perlu untuk pengujian lagi.
Tetapkan info build. Seharusnya hanya digunakan untuk pengujian.
Parameter | |
---|---|
buildInfo | IBuildInfo |
setDisable
public void setDisable (boolean isDisabled)
Menetapkan 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 : status tempat objek harus diletakkan. |
setMergeStrategy
public void setMergeStrategy (MergeStrategy strategy)
Mengatur MergeStrategy
untuk digunakan saat menggabungkan hasil.
Parameter | |
---|---|
strategy | MergeStrategy |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
Dipanggil saat tes atom menandai bahwa kondisi tersebut dianggap salah
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
trace | String : tumpukan jejak kegagalan |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Dipanggil saat tes atom menandai bahwa kondisi tersebut dianggap salah
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
failure | FailureDescription : FailureDescription 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. Kombinasikan 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 dipancarkan |
testEnded
public void testEnded (TestDescription test,testMetrics)
Melaporkan akhir eksekusi dari kasus uji individu.
Jika testFailed(TestDescription, FailureDescription)
tidak dipanggil, tes ini lulus. Juga menampilkan metrik kunci/nilai apa pun yang mungkin telah dikeluarkan selama eksekusi kasus pengujian.
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
testMetrics | ERROR(/Map) dari metrik yang dipancarkan |
testFailed
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 menjelaskan kegagalan dan konteksnya. |
testFailed
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 |
testIgnored
public void testIgnored (TestDescription test)
Dipanggil saat pengujian tidak akan dijalankan, umumnya karena metode pengujian dianotasi dengan org.junit.Ignore.
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
testModuleEnded
public void testModuleEnded ()
Melaporkan akhir dari sebuah modul yang dijalankan.
testModuleStarted
public void testModuleStarted (IInvocationContext moduleContext)
Melaporkan awal dari modul yang sedang berjalan. Callback ini dikaitkan dengan testModuleEnded()
dan opsional dalam urutannya. Ini hanya digunakan selama menjalankan yang menggunakan modul: pelari berbasis suite.
Parameter | |
---|---|
moduleContext | IInvocationContext : IInvocationContext dari modul. |
testRunEnded
public void testRunEnded (long elapsedTime,runMetrics)
Melaporkan akhir uji coba. FIXME: Kami tidak dapat memiliki dua antarmuka Map<> dengan tipe yang berbeda, jadi kami harus menggunakan HashMap di sini.
Parameter | |
---|---|
elapsedTime | long : perangkat melaporkan waktu 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 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. |
testRunStarted
public void testRunStarted (String name, int numTests, int attemptNumber)
Melaporkan awal uji coba.
Parameter | |
---|---|
name | String : nama uji coba |
numTests | int : jumlah total pengujian dalam uji coba |
attemptNumber | int : nomor urut, mengidentifikasi upaya berbeda dari runName yang sama yang berjalan berkali-kali. tryNumber adalah 0-diindeks dan harus bertambah setiap kali proses baru terjadi. misalnya, pengujian diulang ulang sebanyak 3 kali, harus memiliki total 4 proses di bawah runName yang sama dan nomor percobaan dari 0 hingga 3. |
testRunStarted
public void testRunStarted (String name, int numTests)
Melaporkan awal uji coba.
Parameter | |
---|---|
name | String : nama uji coba |
numTests | int : jumlah total pengujian dalam uji coba |
testRunStarted
public void testRunStarted (String name, int numTests, int attemptNumber, long startTime)
Melaporkan awal uji coba.
Parameter | |
---|---|
name | String : nama uji coba |
numTests | int : jumlah total pengujian dalam uji coba |
attemptNumber | int : nomor urut, mengidentifikasi upaya berbeda dari runName yang sama yang berjalan berkali-kali. tryNumber adalah 0-diindeks dan harus bertambah setiap kali proses baru terjadi. misalnya, pengujian diulang ulang sebanyak 3 kali, harus memiliki total 4 proses di bawah runName yang sama dan nomor percobaan dari 0 hingga 3. |
startTime | long : waktu proses dimulai, diukur melalui System.currentTimeMillis() |
testRunStopped
public void testRunStopped (long elapsedTime)
Uji coba laporan berhenti sebelum selesai karena permintaan pengguna.
TODO: saat ini tidak digunakan, pertimbangkan untuk menghapus
Parameter | |
---|---|
elapsedTime | long : perangkat melaporkan waktu berlalu, dalam milidetik |
testStarted
public void testStarted (TestDescription test, long startTime)
Alternatif untuk testStarted(com.android.tradefed.result.TestDescription)
tempat kami 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() |
testStarted
public void testStarted (TestDescription test)
Melaporkan awal kasus uji individual. Antarmuka yang lebih lama, harus menggunakan testStarted(com.android.tradefed.result.TestDescription)
jika memungkinkan.
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
Metode yang dilindungi
clearModuleLogFiles
protected final void clearModuleLogFiles ()
Memungkinkan pembersihan file modul sehingga kita terhindar dari membawanya terlalu lama.
clearResultsForName
protected final void clearResultsForName (String testRunName)
Memungkinkan untuk menghapus hasil untuk nama proses yang diberikan. Seharusnya hanya digunakan dalam beberapa kasus seperti agregator hasil.
Parameter | |
---|---|
testRunName | String |
setIsAggregrateMetrics
protected void setIsAggregrateMetrics (boolean aggregate)
Alihkan opsi 'metrik gabungan'
Parameter | |
---|---|
aggregate | boolean |