ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Object
   ↳ com.android.tradefed.result.CollectingTestListener
     ↳ com.android.tradefed.invoker.ShardListener

ITestInvocationListener yang mengumpulkan hasil dari shard pemanggilan (alias pembagian pemanggilan untuk dijalankan secara paralel di beberapa resource), dan meneruskannya ke pemroses lain.

Ringkasan

Konstruktor publik

ShardListener(ITestInvocationListener main)

Buat ShardListener.

Metode publik

List<ITestInvocationListener> getUnderlyingResultReporter()
void invocationEnded(long elapsedTime)

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

void invocationFailed(FailureDescription failure)

Melaporkan pemanggilan yang tidak lengkap 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.

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,LogDataType,InputStreamSource,LogFile) langsung tidak memungkinkan.

void setSupportGranularResults(boolean enableGranularResults)
boolean supportGranularResults()

Menampilkan Benar jika pelapor mendukung hasil terperinci, salah jika tidak.

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

void testModuleStarted(IInvocationContext moduleContext)

Melaporkan awal modul yang berjalan.

void testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)

Melaporkan akhir eksekusi pengujian.

void testRunFailed(FailureDescription failure)

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

void testRunFailed(String failureMessage)

Uji coba laporan gagal diselesaikan karena terjadi error fatal.

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

Melaporkan dimulainya proses pengujian.

Konstruktor publik

ShardListener

public ShardListener (ITestInvocationListener main)

Buat ShardListener.

Parameter
main ITestInvocationListener: ITestInvocationListener hasil harus diteruskan. Untuk mencegah konflik dengan ShardListener lain, objek ini akan disinkronkan di main saat meneruskan hasil. Hasil hanya akan dikirim setelah shard pemanggilan selesai.

Metode publik

getUnderlyingResultReporter

public List<ITestInvocationListener> getUnderlyingResultReporter ()

Hasil
List<ITestInvocationListener>

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

Melaporkan pemanggilan yang tidak lengkap karena kondisi error tertentu.

Akan dipanggil secara otomatis oleh framework TradeFederation.

Parameter
failure FailureDescription: FailureDescription yang menjelaskan penyebab kegagalan

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: penyebab kegagalan Throwable

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

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,LogDataType,InputStreamSource,LogFile) langsung tidak memungkinkan. Dengan demikian, 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.

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

Parameter
enableGranularResults boolean

supportGranularResults

public boolean supportGranularResults ()

Menampilkan Benar jika pelapor mendukung hasil terperinci, salah jika tidak.

Hasil
boolean

testLog

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)/ITestInvocationListener#invocationFailed(java.lang.Throwable) ITestInvocationListener.invocationFailed(Throwable)) atau ERROR(/ITestInvocationListener#invocationEnded(long))

Framework TradeFederation akan otomatis memanggil metode ini, yang menyediakan log host dan jika berlaku, logcat perangkat.

Parameter
dataName String: nama deskriptif String data. Misalnya, "device_logcat". Catatan dataName mungkin tidak unik per pemanggilan. Artinya, pelaksana harus dapat menangani beberapa panggilan dengan dataName yang sama
dataType LogDataType: LogDataType data
dataStream InputStreamSource: InputStreamSource data. Pelaksana harus memanggil createInputStream untuk mulai membaca data, dan memastikan untuk menutup InputStream yang dihasilkan setelah selesai. Pemanggil harus memastikan sumber data tetap ada dan dapat diakses hingga metode testLog selesai.

testLogSaved

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

Parameter
dataName String

dataType LogDataType

dataStream InputStreamSource

logFile LogFile

testModuleEnded

public void testModuleEnded ()

Melaporkan akhir proses modul.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Melaporkan awal modul yang 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, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

Melaporkan akhir eksekusi pengujian. FIXME: Kita tidak dapat memiliki dua antarmuka Map<> dengan jenis yang berbeda, jadi kita harus menggunakan HashMap di sini.

Parameter
elapsedTime long: waktu berlalu yang dilaporkan perangkat, dalam milidetik
runMetrics HashMap: pasangan nilai kunci yang dilaporkan di akhir proses pengujian dengan Metric.

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

Uji coba laporan gagal diselesaikan karena terjadi error fatal.

Parameter
failureMessage String: String yang menjelaskan alasan kegagalan operasi.

testRunStarted

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

Melaporkan dimulainya proses pengujian.

Parameter
name String: nama uji coba
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 akan ada total 4 run dengan runName yang sama dan attemptNumber dari 0 hingga 3.
startTime long: waktu mulai eksekusi, diukur melalui System.currentTimeMillis()