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 agar berjalan di beberapa resource secara paralel), dan meneruskannya ke resource lainnya pemroses.

Ringkasan

Konstruktor publik

ShardListener(ITestInvocationListener main)

Buat ShardListener.

Metode publik

getUnderlyingResultReporter()
void invocationEnded(long elapsedTime)

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

void invocationFailed(FailureDescription failure)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.

void invocationFailed(Throwable cause)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.

void invocationSkipped(SkipReason reason)

Melaporkan panggilan sebagai dilewati

void invocationStarted(IInvocationContext context)

Melaporkan awal pemanggilan pengujian.

void logAssociation(String dataName, LogFile logFile)

Dalam beberapa kasus, log harus terkait erat dengan kasus pengujian, tetapi kesempatan untuk jadi di testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) langsung callback tidak mungkin dilakukan.

void setSupportGranularResults(boolean enableGranularResults)
boolean supportGranularResults()

Menampilkan Benar jika pelapor mendukung hasil terperinci, salah (false) jika tidak.

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

Memberikan data log atau debug terkait dari pemanggilan pengujian.

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

void testModuleEnded()

Melaporkan akhir dari proses modul yang dijalankan.

void testModuleStarted(IInvocationContext moduleContext)

Melaporkan awal modul yang berjalan.

void testRunEnded(long elapsedTime, runMetrics)

Melaporkan berakhirnya uji coba.

void testRunFailed(FailureDescription failure)

Melaporkan pengujian yang gagal diselesaikan karena kegagalan yang dijelaskan oleh FailureDescription.

void testRunFailed(String failureMessage)

Melaporkan pengujian yang gagal diselesaikan karena terjadi error fatal.

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

Melaporkan dimulainya pengujian.

Konstruktor publik

ShardListener

public ShardListener (ITestInvocationListener main)

Buat ShardListener.

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

Metode publik

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

Hasil

pemanggilanBerakhir

public void invocationEnded (long elapsedTime)

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

Akan otomatis dipanggil oleh framework TradeFederation.

Parameter
elapsedTime long: waktu berlalu dari pemanggilan dalam md

pemanggilanGagal

public void invocationFailed (FailureDescription failure)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.

Akan otomatis dipanggil oleh framework TradeFederation.

Parameter
failure FailureDescription: FailureDescription yang menjelaskan penyebab kegagalan

pemanggilanGagal

public void invocationFailed (Throwable cause)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.

Akan otomatis dipanggil oleh framework TradeFederation.

Parameter
cause Throwable: Throwable penyebab kegagalan

pemanggilanDilewati

public void invocationSkipped (SkipReason reason)

Melaporkan panggilan sebagai dilewati

Parameter
reason SkipReason

pemanggilanDimulai

public void invocationStarted (IInvocationContext context)

Melaporkan awal pemanggilan pengujian.

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

Parameter
context IInvocationContext: informasi tentang panggilan

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Dalam beberapa kasus, log harus terkait erat dengan kasus pengujian, tetapi kesempatan untuk jadi di testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) langsung callback tidak mungkin dilakukan. Dengan demikian, callback ini memungkinkan untuk memberikan pengaitan yang kuat secara eksplisit.

Parameter
dataName String: Nama data
logFile LogFile: LogFile yang dicatat sebelumnya dan harus dikaitkan dengan kasus pengujian tertentu.

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

Parameter
enableGranularResults boolean

dukunganGranularResults

public boolean supportGranularResults ()

Menampilkan Benar jika pelapor mendukung hasil terperinci, salah (false) jika tidak.

Hasil
boolean

Loguji

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

Memberikan data log atau debug terkait dari pemanggilan pengujian.

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

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

Parameter
dataName String: nama deskriptif String data. mis. "device_logcat". Catatan dataName tidak boleh unik per pemanggilan. yaitu pengimplementasi harus mampu menangani beberapa panggilan dengan dataName yang sama
dataType LogDataType: LogDataType data
dataStream InputStreamSource: InputStreamSource data. Pengimplementasi harus memanggil createInputStream untuk mulai membaca data, dan memastikan untuk menutup hasil InputStream setelah selesai. Pemanggil harus memastikan sumber data tetap ada ada dan dapat diakses sampai metode {i> testLog<i} 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 proses modul yang dijalankan.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Melaporkan awal modul yang berjalan. Callback ini dikaitkan dengan testModuleEnded() dan bersifat opsional dalam urutan. Alat ini hanya digunakan selama berjalan yang menggunakan modul: runner berbasis suite.

Parameter
moduleContext IInvocationContext: IInvocationContext modul.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Melaporkan berakhirnya uji coba. FIXME: Kita tidak dapat memiliki dua Peta<> antarmuka dengan jenis yang berbeda, jadi kita harus menggunakan HashMap di sini.

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

{i>testRunFailed<i}

public void testRunFailed (FailureDescription failure)

Melaporkan pengujian yang gagal diselesaikan karena kegagalan yang dijelaskan oleh FailureDescription.

Parameter
failure FailureDescription: FailureDescription yang menjelaskan kegagalan dan konteksnya.

{i>testRunFailed<i}

public void testRunFailed (String failureMessage)

Melaporkan pengujian yang 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 pengujian.

Parameter
name String: nama pengujian yang dijalankan
numTests int: jumlah total pengujian dalam pengujian
attemptNumber int: nomor pesanan, yang mengidentifikasi berbagai percobaan dari runName yang sama yang berjalan beberapa kali. upayaNumber diindeks 0 dan harus bertambah setiap kali operasi baru terjadi. mis. Pengujian terperinci dilakukan sebanyak 3 kali, dengan total pengujian 4 kali di bawah runName yang sama dan percobaanNumber adalah dari 0 hingga 3.
startTime long: waktu yang dimulai, diukur melalui System.currentTimeMillis()