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-sharding. Metode ini hanya melaporkan penyelesaian pemanggilan ke pemroses setelah semua pemanggilan yang di-shard selesai.

Class ini tidak aman untuk thread. Klien diharapkan akan mengunci class ini saat mengirim hasil pengujian, untuk mencegah callback pemanggilan dipanggil secara tidak berurutan.

Ringkasan

Konstruktor publik
ShardMainResultForwarder( listeners, int expectedShards) Buat ShardMainResultForwarder.

Metode publik
	getListeners() Mendapatkan daftar pemroses.
void	invocationEnded(long elapsedTime) Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil maupun karena beberapa kondisi error.
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 beberapa kondisi error.
void	invocationFailed(Throwable cause) Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error.
void	invocationSkipped(SkipReason reason) Melaporkan pemanggilan sebagai dilewati
void	invocationStarted(IInvocationContext context) Melaporkan awal 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, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) langsung 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 ( listeners, 
                int expectedShards)

Buat ShardMainResultForwarder.

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

Metode publik

getListeners

public  getListeners ()

Mendapatkan daftar pemroses. Hanya ditujukan untuk digunakan oleh subclass.

Hasil
	Daftar ITestInvocationListener.

invocationEnded

public void invocationEnded (long elapsedTime)

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

Akan otomatis dipanggil oleh framework TradeFederation.

Parameter
elapsedTime	long: waktu yang berlalu dari 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 beberapa kondisi error.

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 beberapa kondisi error.

Akan otomatis dipanggil oleh framework TradeFederation.

Parameter
cause	Throwable: Throwable penyebab kegagalan

invocationSkipped

public void invocationSkipped (SkipReason reason)

Melaporkan pemanggilan sebagai dilewati

Parameter
reason	SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

Melaporkan awal pemanggilan pengujian.

Akan otomatis dipanggil oleh framework TradeFederation. Pelapor 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 dikaitkan secara kuat dengan kasus pengujian, tetapi peluang untuk melakukannya pada callback testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) langsung tidak memungkinkan. 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.

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 bahwa 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. Implementer harus memanggil createInputStream untuk mulai membaca data, dan memastikan untuk menutup InputStream yang dihasilkan setelah selesai.
logFile	LogFile: LogFile yang berisi metadata file yang disimpan.