Penerus Hasil

public class ResultForwarder
extends Object implements ITestInvocationListener

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

Subkelas langsung yang diketahui FilteredResultForwarder , JarHostTest.HostTestListener , LogSaverResultForwarder , LogcatCrashResultForwarder , PythonBinaryHostTest.PythonForwarder , ResultAndLogForwarder , RetryResultForwarder , ShardMainResultForwarder , TestTimeoutEnforcer FilteredResultForwarder Varian ResultForwarder yang hanya mengizinkan daftar TestDescription yang diizinkan untuk dilaporkan. JarHostTest.HostTestListener Pemroses pembungkus yang meneruskan semua peristiwa kecuali testRunStarted() dan testRunEnded() ke pendengar yang tersemat. LogSaverResultForwarder ResultForwarder untuk menyimpan log dengan penghemat file global. LogcatCrashResultForwarder Pendengar khusus: jika terjadi kegagalan (proses instrumentasi terhenti), ia akan mencoba mengekstrak kerusakan dari logcat dan menambahkannya ke pesan kegagalan yang terkait dengan pengujian. PythonBinaryHostTest.PythonForwarder Penerus hasil untuk mengganti nama proses dengan nama biner. HasilDanLogForwarder Forwarder untuk hasil dan mencatat peristiwa. Coba lagiResultForwarder Perpanjangan dari ResultForwarder yang selalu mendorong ke nomor percobaan tertentu. ShardMainResultForwarder ResultForwarder yang menggabungkan hasil pemanggilan pengujian yang dipecah. TestTimeoutEnforcer Listener yang memungkinkan untuk memeriksa waktu eksekusi kasus pengujian tertentu dan menggagalkannya jika melebihi batas waktu tertentu.

Subkelas 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 upaya yang sedang kita lakukan.

---

ITestInvocationListener yang meneruskan hasil pemanggilan ke daftar pendengar lainnya.

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 mengembalikan ringkasan.
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	testAssumptionFailure ( TestDescription test, String trace) Dipanggil ketika pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah
void	testAssumptionFailure ( TestDescription test, FailureDescription failure) Dipanggil ketika pengujian atom menandai bahwa pengujian tersebut 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 berakhir secara langsung.
void	testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Melaporkan akhir eksekusi kasus uji individual.
void	testFailed ( TestDescription test, FailureDescription failure) Melaporkan kegagalan kasus uji individual.
void	testFailed ( TestDescription test, String trace) Melaporkan kegagalan kasus uji individual.
void	testIgnored ( TestDescription test) Dipanggil ketika pengujian tidak akan dijalankan, umumnya karena metode pengujian dianotasi dengan org.junit.Ignore.
void	testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) Menyediakan data log atau debug terkait dari pemanggilan pengujian.
void	testModuleEnded () Melaporkan akhir dari pengoperasian modul.
void	testModuleStarted ( IInvocationContext moduleContext) Melaporkan permulaan modul 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 errorMessage) Uji coba laporan 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) Uji coba laporan dihentikan sebelum selesai karena permintaan pengguna.
void	testStarted ( TestDescription test, long startTime) Alternatif untuk testStarted(com.android.tradefed.result.TestDescription) yang 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 permulaan kasus uji individual.

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

Konstruktor publik

Penerus Hasil

public ResultForwarder ( listeners)

Buat ResultForwarder .

Parameter
listeners	: ITestInvocationListener asli yang akan meneruskan hasil

Penerus Hasil

public ResultForwarder (ITestInvocationListener... listeners)

Konstruktor arg variabel alternatif untuk ResultForwarder .

Parameter
listeners	ITestInvocationListener : ITestInvocationListener asli yang akan meneruskan hasil

Konstruktor yang dilindungi

Penerus Hasil

protected ResultForwarder ()

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

Metode publik

dapatkan Ringkasan

public TestSummary getSummary ()

Mengizinkan InvocationListener mengembalikan ringkasan.

Kembali
TestSummary	TestSummary yang merangkum 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 pemanggilan yang telah berlalu dalam ms

doaGagal

public void invocationFailed (FailureDescription failure)

Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.

Akan secara otomatis dipanggil oleh kerangka TradeFederation.

Parameter
failure	FailureDescription : FailureDescription yang menjelaskan penyebab kegagalan

doaGagal

public void invocationFailed (Throwable cause)

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

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

Parameter
context	IInvocationContext : informasi tentang pemanggilan

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Dipanggil ketika pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Dipanggil ketika pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah

Parameter
test	TestDescription : mengidentifikasi tes
failure	FailureDescription : FailureDescription yang menjelaskan 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 berakhir secara langsung. Gabungkan dengan testStarted(com.android.tradefed.result.TestDescription, long) untuk pengukuran yang akurat.

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

tesBerakhir

public void testEnded (TestDescription test, 
                 testMetrics)

Melaporkan akhir eksekusi kasus uji individual.

Jika testFailed(TestDescription, FailureDescription) tidak dipanggil, pengujian ini berhasil. Juga mengembalikan metrik kunci/nilai apa pun yang mungkin telah dikeluarkan selama eksekusi kasus pengujian.

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

tesGagal

public void testFailed (TestDescription test, 
                FailureDescription failure)

Melaporkan kegagalan kasus uji individual.

Akan dipanggil antara testStarted dan testEnded.

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

tesGagal

public void testFailed (TestDescription test, 
                String trace)

Melaporkan kegagalan kasus uji individual.

Akan dipanggil antara testStarted dan testEnded.

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

tesIgnored

public void testIgnored (TestDescription test)

Dipanggil ketika pengujian tidak akan dijalankan, umumnya karena metode pengujian dianotasi dengan org.junit.Ignore.

Parameter
test	TestDescription : mengidentifikasi tes

tesLog

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 kerja TradeFederation akan secara otomatis memanggil metode ini, menyediakan log host dan jika berlaku, logcat perangkat.

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

testModuleBerakhir

public void testModuleEnded ()

Melaporkan akhir dari pengoperasian modul.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

Parameter
moduleContext	IInvocationContext : IInvocationContext modul.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Melaporkan akhir uji coba. FIXME: Kami tidak dapat memiliki dua antarmuka Map<> dengan tipe 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 pada 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 yang menjelaskan kegagalan dan konteksnya.

testRunFailed

public void testRunFailed (String errorMessage)

Uji coba laporan gagal diselesaikan karena kesalahan fatal.

Parameter
errorMessage	String : String yang menjelaskan alasan kegagalan proses.

tesRunStarted

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

Melaporkan dimulainya uji coba.

Parameter
runName	String : nama uji coba
testCount	int : jumlah total pengujian dalam pengujian yang dijalankan
attemptNumber	int : nomor pesanan, mengidentifikasi upaya berbeda dari runName yang sama yang dijalankan beberapa kali. AttemptNumber diindeks 0 dan harus bertambah setiap kali proses baru terjadi. misalnya Sebuah tes diuji ulang secara granular sebanyak 3 kali, tes tersebut harus memiliki total 4 kali proses dengan runName yang sama dan nomor percobaannya adalah dari 0 hingga 3.

tesRunStarted

public void testRunStarted (String runName, 
                int testCount)

Melaporkan dimulainya uji coba.

Parameter
runName	String : nama uji coba
testCount	int : jumlah total pengujian dalam pengujian yang dijalankan

tesRunStarted

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 pengujian dalam pengujian yang dijalankan
attemptNumber	int : nomor pesanan, mengidentifikasi upaya berbeda dari runName yang sama yang dijalankan beberapa kali. AttemptNumber diindeks 0 dan harus bertambah setiap kali proses baru terjadi. misalnya Sebuah tes diuji ulang secara granular sebanyak 3 kali, tes tersebut harus memiliki total 4 kali proses dengan runName yang sama dan nomor percobaannya adalah dari 0 hingga 3.
startTime	long : waktu dimulainya proses, diukur melalui System.currentTimeMillis()

testRunStopped

public void testRunStopped (long elapsedTime)

Uji coba laporan dihentikan sebelum selesai karena permintaan pengguna.

TODO: saat ini tidak digunakan, pertimbangkan untuk menghapusnya

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

tesDimulai

public void testStarted (TestDescription test, 
                long startTime)

Alternatif untuk testStarted(com.android.tradefed.result.TestDescription) yang 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 pengujian dimulai, diukur melalui System.currentTimeMillis()

tesDimulai

public void testStarted (TestDescription test)

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

Parameter
test	TestDescription : mengidentifikasi tes

Metode yang dilindungi

dapatkan Pendengar

protected  getListeners ()

Dapatkan daftar pendengar. Ditujukan hanya untuk digunakan oleh subkelas.

Kembali
	Daftar ITestInvocationListener s.

setListeners

protected void setListeners (ITestInvocationListener... listeners)

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

Parameter
listeners	ITestInvocationListener : ITestInvocationListener asli yang akan meneruskan hasil

setListeners

protected void setListeners ( listeners)

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

Parameter
listeners	: ITestInvocationListener asli yang akan meneruskan hasil