ShardMainResultForwarder

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object
↳ com.android.tradefed.result.ResultForwarder
  ↳ com.android.tradefed.invoker.ShardMainResultForwarder

ResultForwarder yang menggabungkan hasil pemanggilan pengujian yang di-shard. Laporan ini hanya melaporkan penyelesaian pemanggilan ke pemroses setelah semua pemanggilan yang di-shard selesai.

Class ini tidak aman untuk thread. Klien diharapkan mengunci class ini saat mengirim hasil pengujian, untuk mencegah callback pemanggilan dipanggil di luar urutan.

Ringkasan

Konstruktor publik

ShardMainResultForwarder(List<ITestInvocationListener> listeners, int expectedShards)

Buat ShardMainResultForwarder.

Metode publik

List<ITestInvocationListener> getListeners()

Lihat daftar pemroses.

void invocationEnded(long elapsedTime)

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

void invocationEnded(long elapsedTime, IInvocationContext context)

Callback yang lebih mendetail untuk membedakan shard mana yang selesai.

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 sangat terkait dengan kasus pengujian, tetapi peluang untuk melakukannyalah pada callback langsung testLogSaved(String,LogDataType,InputStreamSource,LogFile) tidak memungkinkan.

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

Hanya teruskan testLog, bukan menyimpan log terlebih dahulu.

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

Dipanggil saat log pengujian disimpan.

Konstruktor publik

ShardMainResultForwarder

public ShardMainResultForwarder (List<ITestInvocationListener> listeners, 
                int expectedShards)

Buat ShardMainResultForwarder.

Parameter
listeners List: daftar ITestInvocationListener untuk meneruskan hasil saat semua shard selesai
expectedShards int: jumlah shard

Metode publik

getListeners

public List<ITestInvocationListener> getListeners ()

Lihat daftar pemroses.

Hasil
List<ITestInvocationListener> Daftar ITestInvocationListener.

invocationEnded

public void invocationEnded (long elapsedTime)

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

Akan otomatis dipanggil oleh framework TradeFederation.

Parameter
elapsedTime long: waktu berlalu pemanggilan dalam md

invocationEnded

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

Callback yang lebih mendetail untuk membedakan shard mana yang selesai.

Parameter
elapsedTime long

context IInvocationContext

invocationFailed

public void invocationFailed (FailureDescription failure)

Melaporkan pemanggilan yang tidak lengkap karena kondisi error tertentu.

Akan otomatis dipanggil 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 otomatis dipanggil oleh framework TradeFederation.

Parameter
cause Throwable: penyebab Throwable kegagalan

invocationSkipped

public void invocationSkipped (SkipReason reason)

Melaporkan pemanggilan sebagai dilewati

Parameter
reason SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

Melaporkan dimulainya pemanggilan pengujian.

Akan otomatis dipanggil oleh framework TradeFederation. Reporter harus 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 pengujian, tetapi peluang untuk melakukannyalah pada callback langsung testLogSaved(String,LogDataType,InputStreamSource,LogFile) tidak memungkinkan. Oleh karena itu, callback ini memungkinkan untuk memberikan hubungan yang kuat secara eksplisit.

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

testLogForward

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

Hanya teruskan testLog, bukan menyimpan log terlebih dahulu.

Parameter
dataName String

dataType LogDataType

dataStream InputStreamSource

testLogSaved

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

Dipanggil saat log pengujian disimpan.

Harus digunakan sebagai pengganti ITestInvocationListener.testLog(String,LogDataType,InputStreamSource).

Parameter
dataName String: nama deskriptif String data. Misalnya, "device_logcat". Perhatikan dataName mungkin tidak unik per pemanggilan. Artinya, pengimplementasi harus dapat 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 InputStream yang dihasilkan saat selesai.
logFile LogFile: LogFile yang berisi data meta file yang disimpan.