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 IBuildInfo dari getInvocationContext() .

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

getMergedTestRunResults ()

Kembalikan kumpulan hasil yang digabungkan untuk semua proses di berbagai upaya.

IInvocationContext getModuleContextForRunResult (String testRunName)

Mengembalikan IInvocationContext 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 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 invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

getRunResults ()

Metode ini sudah usang. Gunakan getMergedTestRunResults()

TestRunResult getTestRunAtAttempt (String testRunName, int attempt)

Kembalikan TestRunResult untuk sekali percobaan.

int getTestRunAttemptCount (String testRunName)

Mengembalikan jumlah upaya untuk nama uji coba tertentu.

getTestRunAttempts (String testRunName)

Mendapatkan semua upaya untuk TestRunResult dari uji coba yang diberikan.

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 testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) panggilan balik tidak dimungkinkan.

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 MergeStrategy untuk digunakan saat menggabungkan hasil.

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 ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) tempat kita dapat menentukan waktu berakhir secara langsung.

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

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

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

public  getMergedTestRunResults ()

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

public  getRunResults ()

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

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

public  getTestRunForAttempts (int attempt)

Mendapatkan semua hasil untuk upaya tertentu.

Parameter
attempt int : Percobaan yang kita inginkan hasilnya.

Pengembalian
Semua TestRunResult untuk percobaan tertentu.

getTestRunNames

public  getTestRunNames ()

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 : key-value pair dilaporkan di 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 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