Halaman ini diterjemahkan oleh Cloud Translation API.

ShardListener

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 berjalan di 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`	`invocationStarted ( IInvocationContext context)` Melaporkan awal pemanggilan pengujian.
`void`	`logAssociation (String dataName, LogFile logFile)` Dalam beberapa kasus, log harus sangat terkait dengan kasus pengujian, tetapi kesempatan untuk melakukannya langsung `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` panggilan balik tidak dimungkinkan.
`void`	`setSupportGranularResults (boolean enableGranularResults)`
`boolean`	`supportGranularResults ()` Mengembalikan Benar jika pelapor mendukung hasil granular, 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 sebuah modul yang dijalankan.
`void`	`testModuleStarted ( IInvocationContext moduleContext)` Melaporkan awal dari modul yang sedang 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 awal uji coba.

Konstruktor publik

ShardListener

public ShardListener (ITestInvocationListener main)

Buat ShardListener .

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

Metode publik

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

Pengembalian

doaBerakhir

public void invocationEnded (long elapsedTime)

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

Akan dipanggil secara otomatis oleh kerangka kerja TradeFederation.

Parameter
`elapsedTime`	`long` : waktu berlalu dari doa dalam ms

doa Gagal

public void invocationFailed (FailureDescription failure)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.

Akan dipanggil secara otomatis oleh kerangka kerja TradeFederation.

Parameter
`failure`	`FailureDescription` : `FailureDescription` menjelaskan penyebab kegagalan

doa Gagal

public void invocationFailed (Throwable cause)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.

Akan dipanggil secara otomatis oleh kerangka kerja TradeFederation.

Parameter
`cause`	`Throwable` : Penyebab kegagalan yang `Throwable`

invocationStarted

public void invocationStarted (IInvocationContext context)

Melaporkan awal pemanggilan pengujian.

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

Parameter
`context`	`IInvocationContext` : informasi tentang doa

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

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

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

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

Parameter
`enableGranularResults`	`boolean`

supportGranularResults

public boolean supportGranularResults ()

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

Pengembalian
`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)) atau ERROR(/ITestInvocationListener#invocationEnded(long))

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

Parameter
`dataName`	`String` : nama deskriptif `String` dari data. misalnya "device_logcat". Catatan dataName mungkin tidak unik per pemanggilan. yaitu pelaksana harus dapat menangani banyak panggilan dengan dataName yang sama
`dataType`	`LogDataType` : `LogDataType` dari data
`dataStream`	`InputStreamSource` : `InputStreamSource` dari 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.

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 dari sebuah modul yang dijalankan.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Melaporkan awal dari modul yang sedang berjalan. Callback ini dikaitkan dengan testModuleEnded() dan opsional dalam urutannya. Ini hanya digunakan selama menjalankan yang menggunakan modul: pelari berbasis suite.

Parameter
`moduleContext`	`IInvocationContext` : `IInvocationContext` dari modul.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

Parameter
`elapsedTime`	`long` : perangkat melaporkan waktu berlalu, dalam milidetik
`runMetrics`	: key-value pair dilaporkan di 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` 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.

testRunStarted

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

Melaporkan awal uji coba.

Parameter
`name`	`String` : nama uji coba
`numTests`	`int` : jumlah total pengujian dalam uji coba
`attemptNumber`	`int` : nomor urut, mengidentifikasi upaya berbeda dari runName yang sama yang berjalan berkali-kali. tryNumber adalah 0-diindeks dan harus bertambah setiap kali proses baru terjadi. misalnya, pengujian diulang ulang sebanyak 3 kali, harus memiliki total 4 proses di bawah runName yang sama dan nomor percobaan dari 0 hingga 3.
`startTime`	`long` : waktu proses dimulai, diukur melalui `System.currentTimeMillis()`