Pendengar Shard

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Objek
com.Android.tradefed.result.CollectingTestListener
com.android.tradefed.invoker.ShardListener


ITestInvocationListener yang mengumpulkan hasil dari pecahan doa (alias pemisahan doa untuk dijalankan pada beberapa sumber daya secara paralel), dan meneruskannya ke pendengar lain.

Ringkasan

Konstruktor publik

ShardListener ( ITestInvocationListener main)

Buat ShardListener .

Metode publik

getUnderlyingResultReporter ()
void invocationEnded (long elapsedTime)

Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil atau karena beberapa kondisi kesalahan.

void invocationFailed ( FailureDescription failure)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.

void invocationFailed (Throwable cause)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.

void invocationSkipped ( SkipReason reason)

Melaporkan pemanggilan yang dilewati

void invocationStarted ( IInvocationContext context)

Melaporkan awal pemanggilan pengujian.

void logAssociation (String dataName, LogFile logFile)

Dalam beberapa kasus, log harus sangat terkait dengan kasus uji, namun peluang untuk melakukannya secara langsung testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) Panggilan balik testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) tidak dimungkinkan.

void setSupportGranularResults (boolean enableGranularResults)
boolean supportGranularResults ()

Mengembalikan Benar jika pelapor mendukung hasil terperinci, salah jika sebaliknya.

void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)

Menyediakan data log atau debug terkait dari pemanggilan pengujian.

void testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

void testModuleEnded ()

Melaporkan akhir dari pengoperasian modul.

void testModuleStarted ( IInvocationContext moduleContext)

Melaporkan permulaan modul 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 failureMessage)

Uji coba laporan gagal diselesaikan karena kesalahan fatal.

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

Melaporkan dimulainya uji coba.

Konstruktor publik

Pendengar Shard

public ShardListener (ITestInvocationListener main)

Buat ShardListener .

Parameter
main ITestInvocationListener : ITestInvocationListener hasilnya harus diteruskan. Untuk mencegah tabrakan dengan ShardListener lainnya, objek ini akan disinkronkan di main saat meneruskan hasil. Dan hasilnya hanya akan dikirim setelah pecahan pemanggilan selesai.

Metode publik

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

Kembali

doaBerakhir

public void invocationEnded (long elapsedTime)

Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil atau karena beberapa kondisi kesalahan.

Akan secara otomatis dipanggil oleh kerangka TradeFederation.

Parameter
elapsedTime long : waktu pemanggilan yang telah berlalu dalam ms

doaGagal

public void invocationFailed (FailureDescription failure)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.

Akan secara otomatis dipanggil oleh kerangka TradeFederation.

Parameter
failure FailureDescription : FailureDescription yang menjelaskan penyebab kegagalan

doaGagal

public void invocationFailed (Throwable cause)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.

Akan secara otomatis dipanggil oleh kerangka TradeFederation.

Parameter
cause Throwable : penyebab kegagalan Throwable

doaDilewatkan

public void invocationSkipped (SkipReason reason)

Melaporkan pemanggilan yang dilewati

Parameter
reason SkipReason

doaDimulai

public void invocationStarted (IInvocationContext context)

Melaporkan awal pemanggilan pengujian.

Akan secara otomatis dipanggil oleh kerangka TradeFederation. Reporter perlu mengganti metode ini untuk mendukung pelaporan beberapa perangkat.

Parameter
context IInvocationContext : informasi tentang pemanggilan

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Dalam beberapa kasus, log harus sangat terkait dengan kasus uji, namun peluang untuk melakukannya secara langsung testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) Panggilan balik testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) tidak dimungkinkan. Dengan demikian, panggilan balik ini memungkinkan untuk memberikan asosiasi yang kuat secara eksplisit.

Parameter
dataName String : Nama datanya

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

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

Parameter
enableGranularResults boolean

dukunganGranularResults

public boolean supportGranularResults ()

Mengembalikan Benar jika pelapor mendukung hasil terperinci, salah jika sebaliknya.

Kembali
boolean

tesLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Menyediakan data log atau debug terkait dari pemanggilan pengujian.

Harus dipanggil sebelum ERROR(/ITestInvocationListener#invocationFailed(Throwable)) atau ERROR(/ITestInvocationListener#invocationEnded(long))

Kerangka kerja TradeFederation akan secara otomatis memanggil metode ini, menyediakan log host dan jika berlaku, logcat perangkat.

Parameter
dataName String : sebuah String yang merupakan nama deskriptif data. misalnya "device_logcat". Catatan dataName mungkin tidak unik per pemanggilan. yaitu pelaksana harus mampu menangani banyak panggilan dengan nama data yang sama

dataType LogDataType : LogDataType datanya

dataStream InputStreamSource : InputStreamSource data. Pelaksana harus memanggil createInputStream untuk mulai membaca data, dan memastikan untuk menutup InputStream yang dihasilkan setelah selesai. Penelepon harus memastikan sumber data tetap ada dan dapat diakses hingga metode testLog selesai.

testLogDisimpan

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Parameter
dataName String

dataType LogDataType

dataStream InputStreamSource

logFile LogFile

testModuleBerakhir

public void testModuleEnded ()

Melaporkan akhir dari pengoperasian modul.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Melaporkan permulaan modul berjalan. Callback ini dikaitkan dengan testModuleEnded() dan bersifat opsional dalam urutannya. Ini hanya digunakan selama proses yang menggunakan modul: pelari berbasis suite.

Parameter
moduleContext IInvocationContext : IInvocationContext modul.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Melaporkan akhir uji coba. FIXME: Kami tidak dapat memiliki dua antarmuka Map<> dengan tipe berbeda, jadi kami harus menggunakan HashMap di sini.

Parameter
elapsedTime long : perangkat melaporkan waktu yang telah berlalu, dalam milidetik

runMetrics : pasangan nilai kunci yang dilaporkan pada 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 yang menjelaskan kegagalan dan konteksnya.

testRunFailed

public void testRunFailed (String failureMessage)

Uji coba laporan gagal diselesaikan karena kesalahan fatal.

Parameter
failureMessage String : String yang menjelaskan alasan kegagalan proses.

tesRunStarted

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

Melaporkan dimulainya uji coba.

Parameter
name String : nama uji coba

numTests int : jumlah total pengujian dalam pengujian yang dijalankan

attemptNumber int : nomor pesanan, mengidentifikasi upaya berbeda dari runName yang sama yang dijalankan beberapa kali. AttemptNumber diindeks 0 dan harus bertambah setiap kali proses baru terjadi. misalnya Sebuah tes diuji ulang secara granular sebanyak 3 kali, tes tersebut harus memiliki total 4 kali proses dengan runName yang sama dan nomor percobaannya adalah dari 0 hingga 3.

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