ResultForwarder

public class ResultForwarder
extends Object implements ITestInvocationListener

java.lang.Objek
	com.android.tradefed.result.ResultForwarder

Subclass langsung yang diketahui FilteredResultForwarder , JarHostTest.HostTestListener , LogSaverResultForwarder , LogcatCrashResultForwarder , PythonBinaryHostTest.PythonForwarder , ResultAndLogForwarder , RetryResultForwarder , ShardMainResultTimeoutForwarder FilteredResultForwarder Varian dari ResultForwarder yang hanya memungkinkan daftar TestDescription yang diizinkan untuk dilaporkan. JarHostTest.HostTestListener Pembungkus pendengar yang meneruskan semua acara kecuali testRunStarted() dan testRunEnded() ke pendengar yang disematkan. LogSaverResultForwarder ResultForwarder untuk menyimpan log dengan penghemat file global. LogcatCrashResultForwarder Pendengar khusus: pada kegagalan (proses instrumentasi mogok) ia akan mencoba mengekstrak dari logcat kerusakan dan menambahkannya ke pesan kegagalan yang terkait dengan pengujian. PythonBinaryHostTest.PythonForwarder Result forwarder untuk mengganti nama run dengan nama biner. ResultAndLogForwarder Forwarder untuk hasil dan log peristiwa. Coba lagiResultForwarder Perpanjangan ResultForwarder yang selalu mendorong ke nomor upaya yang diberikan. ShardMainResultForwarder ResultForwarder yang menggabungkan hasil dari pemanggilan uji sharded. TestTimeoutEnforcer Pendengar yang memungkinkan untuk memeriksa waktu eksekusi kasus uji yang diberikan dan gagal jika melewati batas waktu yang diberikan.

Subclass tidak langsung yang diketahui GranularRetriableTestWrapper.StartEndCollector , RetryLogSaverResultForwarder GranularRetriableTestWrapper.StartEndCollector Pembantu kelas untuk menangkap awal dan akhir lari yang hilang. Coba lagiLogSaverResultForwarder Forwarder yang juga menangani passing saat kita mencoba.

---

ITestInvocationListener yang meneruskan hasil pemanggilan ke daftar pendengar lain.

Ringkasan

Konstruktor publik
ResultForwarder ( listeners) ResultForwarder ( listeners) Buat ResultForwarder .
ResultForwarder ( ITestInvocationListener... listeners) Konstruktor arg variabel alternatif untuk ResultForwarder .

Konstruktor yang dilindungi
ResultForwarder () Buat ResultForwarder dengan pengaturan pendengar yang ditangguhkan.

Metode publik
TestSummary	getSummary () Mengizinkan InvocationListener untuk mengembalikan ringkasan.
void	invocationEnded (long elapsedTime) Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil atau karena beberapa kondisi kesalahan.
void	invocationFailed ( FailureDescription failure) Melaporkan permintaan yang tidak lengkap karena beberapa kondisi kesalahan.
void	invocationFailed (Throwable cause) Melaporkan permintaan yang tidak lengkap karena beberapa kondisi kesalahan.
void	invocationStarted ( IInvocationContext context) Melaporkan awal pemanggilan tes.
void	testAssumptionFailure ( TestDescription test, String trace) Dipanggil ketika uji atom menandai bahwa ia mengasumsikan kondisi yang salah
void	testAssumptionFailure ( TestDescription test, FailureDescription failure) Dipanggil ketika uji atom menandai bahwa ia mengasumsikan kondisi yang salah
void	testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) Alternatif untuk ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) di mana kita dapat menentukan waktu akhir secara langsung.
void	testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Melaporkan akhir eksekusi kasus uji individu.
void	testFailed ( TestDescription test, FailureDescription failure) Melaporkan kegagalan kasus uji individu.
void	testFailed ( TestDescription test, String trace) Melaporkan kegagalan kasus uji individu.
void	testIgnored ( TestDescription test) Dipanggil saat pengujian tidak akan dijalankan, umumnya karena metode pengujian dijelaskan dengan org.junit.Ignore.
void	testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) Menyediakan log terkait atau data debug dari pemanggilan pengujian.
void	testModuleEnded () Melaporkan akhir dari modul yang dijalankan.
void	testModuleStarted ( IInvocationContext moduleContext) Melaporkan awal modul berjalan.
void	testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) Laporan akhir uji coba.
void	testRunFailed ( FailureDescription failure) Laporan uji coba gagal diselesaikan karena kegagalan yang dijelaskan oleh FailureDescription .
void	testRunFailed (String errorMessage) Laporan uji coba gagal diselesaikan karena kesalahan fatal.
void	testRunStarted (String runName, int testCount, int attemptNumber) Melaporkan dimulainya uji coba.
void	testRunStarted (String runName, int testCount) Melaporkan dimulainya uji coba.
void	testRunStarted (String runName, int testCount, int attemptNumber, long startTime) Melaporkan dimulainya uji coba.
void	testRunStopped (long elapsedTime) Melaporkan uji coba dihentikan sebelum selesai karena permintaan pengguna.
void	testStarted ( TestDescription test, long startTime) Alternatif untuk testStarted(com.android.tradefed.result.TestDescription) di mana kami juga menentukan kapan pengujian dimulai, dikombinasikan dengan ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) untuk pengukuran yang akurat .
void	testStarted ( TestDescription test) Melaporkan awal dari kasus uji individu.

Metode yang dilindungi
	getListeners () Dapatkan daftar pendengar.
void	setListeners ( listeners) setListeners ( listeners) Atur pendengar setelah konstruksi.
void	setListeners ( ITestInvocationListener... listeners) Atur pendengar setelah konstruksi.

Konstruktor publik

ResultForwarder

public ResultForwarder ( listeners)

Buat ResultForwarder .

Parameter
listeners	: ITestInvocationListener s yang sebenarnya untuk meneruskan hasil ke

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

Konstruktor arg variabel alternatif untuk ResultForwarder .

Parameter
listeners	ITestInvocationListener : ITestInvocationListener yang sebenarnya untuk meneruskan hasil ke

Konstruktor yang dilindungi

ResultForwarder

protected ResultForwarder ()

Buat ResultForwarder dengan pengaturan pendengar yang ditangguhkan. Ditujukan hanya untuk digunakan oleh subclass.

Metode publik

dapatkanRingkasan

public TestSummary getSummary ()

Mengizinkan InvocationListener untuk mengembalikan ringkasan.

Kembali
TestSummary	TestSummary meringkas proses, atau null

doaBerakhir

public void invocationEnded (long elapsedTime)

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

Akan secara otomatis dipanggil oleh kerangka TradeFederation.

Parameter
elapsedTime	long : waktu yang telah berlalu dari pemanggilan dalam ms

doa gagal

public void invocationFailed (FailureDescription failure)

Melaporkan permintaan yang tidak lengkap karena beberapa kondisi kesalahan.

Akan secara otomatis dipanggil oleh kerangka TradeFederation.

Parameter
failure	FailureDescription : FailureDescription yang menjelaskan penyebab kegagalan

doa gagal

public void invocationFailed (Throwable cause)

Melaporkan permintaan yang tidak lengkap karena beberapa kondisi kesalahan.

Akan secara otomatis dipanggil oleh kerangka TradeFederation.

Parameter
cause	Throwable : penyebab kegagalan Throwable

doaDimulai

public void invocationStarted (IInvocationContext context)

Melaporkan awal pemanggilan tes.

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

Parameter
context	IInvocationContext : informasi tentang pemanggilan

tesAsumsiKegagalan

public void testAssumptionFailure (TestDescription test, 
                String trace)

Dipanggil ketika uji atom menandai bahwa ia mengasumsikan kondisi yang salah

Parameter
test	TestDescription : mengidentifikasi tes
trace	String : tumpukan jejak kegagalan

tesAsumsiKegagalan

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Dipanggil ketika uji atom menandai bahwa ia mengasumsikan kondisi yang salah

Parameter
test	TestDescription : mengidentifikasi tes
failure	FailureDescription : FailureDescription menggambarkan kegagalan dan konteksnya.

tesBerakhir

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Alternatif untuk ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) di mana kita dapat menentukan waktu akhir secara langsung. Kombinasikan dengan testStarted(com.android.tradefed.result.TestDescription, long) untuk pengukuran yang akurat.

Parameter
test	TestDescription : mengidentifikasi tes
endTime	long : waktu tes berakhir, diukur melalui System.currentTimeMillis()
testMetrics	: sebuah ERROR(/Map) dari metrik yang dipancarkan

tesBerakhir

public void testEnded (TestDescription test, 
                 testMetrics)

Melaporkan akhir eksekusi kasus uji individu.

Jika testFailed(TestDescription, FailureDescription) tidak dipanggil, tes ini lulus. Juga mengembalikan metrik kunci/nilai apa pun yang mungkin telah dipancarkan selama eksekusi kasus uji.

Parameter
test	TestDescription : mengidentifikasi tes
testMetrics	: sebuah ERROR(/Map) dari metrik yang dipancarkan

tesGagal

public void testFailed (TestDescription test, 
                FailureDescription failure)

Melaporkan kegagalan kasus uji individu.

Akan dipanggil antara testStarted dan testEnded.

Parameter
test	TestDescription : mengidentifikasi tes
failure	FailureDescription : FailureDescription menggambarkan kegagalan dan konteksnya.

tesGagal

public void testFailed (TestDescription test, 
                String trace)

Melaporkan kegagalan kasus uji individu.

Akan dipanggil antara testStarted dan testEnded.

Parameter
test	TestDescription : mengidentifikasi tes
trace	String : tumpukan jejak kegagalan

tesDiabaikan

public void testIgnored (TestDescription test)

Dipanggil saat pengujian tidak akan dijalankan, umumnya karena metode pengujian dijelaskan dengan org.junit.Ignore.

Parameter
test	TestDescription : mengidentifikasi tes

tesLog

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

Menyediakan log terkait atau data debug dari pemanggilan pengujian.

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

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

Parameter
dataName	String : sebuah String nama deskriptif data. misalnya "device_logcat". Catatan dataName mungkin tidak unik per permintaan. yaitu pelaksana harus dapat menangani banyak panggilan dengan nama data 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.

testModuledEnd

public void testModuleEnded ()

Melaporkan akhir dari modul yang dijalankan.

testModuleDimulai

public void testModuleStarted (IInvocationContext moduleContext)

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

Parameter
moduleContext	IInvocationContext : IInvocationContext dari modul.

testRunEnd

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Laporan 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 yang telah berlalu, dalam milidetik
runMetrics	: pasangan nilai kunci yang dilaporkan di akhir uji coba dengan Metric .

testRunFailed

public void testRunFailed (FailureDescription failure)

Laporan uji coba gagal diselesaikan karena kegagalan yang dijelaskan oleh FailureDescription .

Parameter
failure	FailureDescription : FailureDescription menggambarkan kegagalan dan konteksnya.

testRunFailed

public void testRunFailed (String errorMessage)

Laporan uji coba gagal diselesaikan karena kesalahan fatal.

Parameter
errorMessage	String : String yang menjelaskan alasan kegagalan menjalankan.

testRunMulai

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

Melaporkan dimulainya uji coba.

Parameter
runName	String : nama uji coba
testCount	int : jumlah total tes dalam uji coba
attemptNumber	int : nomor urut, mengidentifikasi upaya berbeda dari runName yang sama yang dijalankan beberapa kali. TryNumber diindeks 0 dan harus bertambah setiap kali proses baru terjadi. misalnya Sebuah tes granular dicoba ulang 3 kali, harus memiliki 4 total berjalan di bawah runName yang sama dan tryNumber adalah dari 0 hingga 3.

testRunMulai

public void testRunStarted (String runName, 
                int testCount)

Melaporkan dimulainya uji coba.

Parameter
runName	String : nama uji coba
testCount	int : jumlah total tes dalam uji coba

testRunMulai

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Melaporkan dimulainya uji coba.

Parameter
runName	String : nama uji coba
testCount	int : jumlah total tes dalam uji coba
attemptNumber	int : nomor urut, mengidentifikasi upaya berbeda dari runName yang sama yang dijalankan beberapa kali. TryNumber diindeks 0 dan harus bertambah setiap kali proses baru terjadi. misalnya Sebuah tes granular dicoba ulang 3 kali, harus memiliki 4 total berjalan di bawah runName yang sama dan tryNumber adalah dari 0 hingga 3.
startTime	long : waktu run dimulai, diukur melalui System.currentTimeMillis()

testRunStopped

public void testRunStopped (long elapsedTime)

Melaporkan uji coba dihentikan sebelum selesai karena permintaan pengguna.

TODO: saat ini tidak digunakan, pertimbangkan untuk menghapus

Parameter
elapsedTime	long : perangkat melaporkan waktu yang telah berlalu, dalam milidetik

tesMulai

public void testStarted (TestDescription test, 
                long startTime)

Alternatif untuk testStarted(com.android.tradefed.result.TestDescription) di mana kami juga menentukan kapan pengujian dimulai, dikombinasikan dengan ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) untuk pengukuran yang akurat .

Parameter
test	TestDescription : mengidentifikasi tes
startTime	long : waktu tes dimulai, diukur melalui System.currentTimeMillis()

tesMulai

public void testStarted (TestDescription test)

Melaporkan awal kasus uji individu. Antarmuka yang lebih lama, harus menggunakan testStarted(com.android.tradefed.result.TestDescription) bila memungkinkan.

Parameter
test	TestDescription : mengidentifikasi tes

Metode yang dilindungi

getListeners

protected  getListeners ()

Dapatkan daftar pendengar. Ditujukan hanya untuk digunakan oleh subclass.

Kembali
	Daftar ITestInvocationListener s.

setListeners

protected void setListeners ( listeners)

Atur pendengar setelah konstruksi. Ditujukan hanya untuk digunakan oleh subclass.

Parameter
listeners	: ITestInvocationListener s yang sebenarnya untuk meneruskan hasil ke

setListeners

protected void setListeners (ITestInvocationListener... listeners)

Atur pendengar setelah konstruksi. Ditujukan hanya untuk digunakan oleh subclass.

Parameter
listeners	ITestInvocationListener : ITestInvocationListener yang sebenarnya untuk meneruskan hasil ke