ResultForwarder

public class ResultForwarder
extends Object implements ITestInvocationListener

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

Subclass langsung yang dikenal FilteredResultForwarder, JarHostTest.HostTestListener, LogSaverResultForwarder, LogcatCrashResultForwarder, PythonBinaryHostTest.PythonForwarder, ResultAndLogForwarder, RetryResultForwarder, ShardMainResultForwarder, TestTimeoutEnforcer FilteredResultForwarder Varian ResultForwarder yang hanya mengizinkan daftar yang diizinkan TestDescription untuk dilaporkan.  JarHostTest.HostTestListener Pemroses wrapper yang meneruskan semua peristiwa kecuali testRunStarted() dan testRunEnded() ke pemroses tersemat.  LogSaverResultForwarder ResultForwarder untuk menyimpan log dengan file saver global.  LogcatCrashResultForwarder Pemroses khusus: jika terjadi kegagalan (proses instrumentasi mengalami error), pemroses akan mencoba mengekstrak error dari logcat dan menambahkannya ke pesan kegagalan yang terkait dengan pengujian.  PythonBinaryHostTest.PythonForwarder Pengirim hasil untuk mengganti nama operasi dengan nama biner.  ResultAndLogForwarder Pengirim untuk peristiwa log dan hasil.  RetryResultForwarder Ekstensi ResultForwarder yang selalu mendorong ke jumlah upaya tertentu.  ShardMainResultForwarder ResultForwarder yang menggabungkan hasil pemanggilan pengujian yang di-sharding.  TestTimeoutEnforcer Pemroses yang memungkinkan untuk memeriksa waktu eksekusi kasus pengujian tertentu dan membuatnya gagal jika melebihi waktu tunggu tertentu.

Subclass tidak langsung yang umum GranularRetriableTestWrapper.StartEndCollector, RetryLogSaverResultForwarder GranularRetriableTestWrapper.StartEndCollector Helper class untuk menangkap awal dan akhir run yang tidak ada.  RetryLogSaverResultForwarder Pengirim yang juga menangani penerusan upaya saat ini.

---

ITestInvocationListener yang meneruskan hasil pemanggilan ke daftar pemroses lain.

Ringkasan

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

Konstruktor yang dilindungi
ResultForwarder() Buat ResultForwarder dengan setelan pemroses yang ditangguhkan.

Metode publik
TestSummary	getSummary() Memungkinkan InvocationListener menampilkan ringkasan.
void	invocationEnded(long elapsedTime) Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil maupun karena beberapa kondisi error.
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	testAssumptionFailure(TestDescription test, String trace) Dipanggil saat pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah
void	testAssumptionFailure(TestDescription test, FailureDescription failure) Dipanggil saat pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah
void	testEnded(TestDescription test, long endTime, testMetrics) Alternatif untuk ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) tempat kita dapat menentukan waktu berakhir secara langsung.
void	testEnded(TestDescription test, testMetrics) Melaporkan akhir eksekusi setiap kasus pengujian.
void	testFailed(TestDescription test, FailureDescription failure) Melaporkan kegagalan kasus pengujian individual.
void	testFailed(TestDescription test, String trace) Melaporkan kegagalan kasus pengujian individual.
void	testIgnored(TestDescription test) Dipanggil saat pengujian tidak akan dijalankan, biasanya karena metode pengujian dianotasi dengan org.junit.Ignore.
void	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream) Memberikan data log atau debug terkait dari pemanggilan pengujian.
void	testModuleEnded() Melaporkan akhir proses modul.
void	testModuleStarted(IInvocationContext moduleContext) Melaporkan awal modul yang berjalan.
void	testRunEnded(long elapsedTime, runMetrics) Melaporkan akhir pengujian yang dijalankan.
void	testRunFailed(FailureDescription failure) Operasi pengujian laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh FailureDescription.
void	testRunFailed(String errorMessage) Pengujian laporan yang dijalankan gagal diselesaikan karena error fatal.
void	testRunStarted(String runName, int testCount, int attemptNumber) Melaporkan awal pengujian yang dijalankan.
void	testRunStarted(String runName, int testCount) Melaporkan awal pengujian yang dijalankan.
void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) Melaporkan awal pengujian yang dijalankan.
void	testRunStopped(long elapsedTime) Pengujian laporan berhenti sebelum selesai karena permintaan pengguna.
void	testSkipped(TestDescription test, SkipReason reason) Dipanggil saat pengujian dilewati dan tidak dieksekusi karena alasan yang biasanya tidak diharapkan.
void	testStarted(TestDescription test, long startTime) Alternatif untuk testStarted(com.android.tradefed.result.TestDescription) tempat kita juga menentukan kapan pengujian dimulai, digabungkan dengan ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) untuk pengukuran yang akurat.
void	testStarted(TestDescription test) Melaporkan awal setiap kasus pengujian.

Metode yang dilindungi
	getListeners() Mendapatkan daftar pemroses.
void	setListeners(ITestInvocationListener... listeners) Tetapkan pemroses setelah pembuatan.
void	setListeners( listeners) Tetapkan pemroses setelah pembuatan.

Konstruktor publik

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

Konstruktor arg variabel alternatif untuk ResultForwarder.

Parameter
listeners	ITestInvocationListener: ITestInvocationListener sebenarnya yang akan meneruskan hasil

ResultForwarder

public ResultForwarder ( listeners)

Buat ResultForwarder.

Parameter
listeners	: ITestInvocationListener sebenarnya yang akan meneruskan hasil

Konstruktor yang dilindungi

ResultForwarder

protected ResultForwarder ()

Buat ResultForwarder dengan setelan pemroses yang ditangguhkan. Hanya ditujukan untuk digunakan oleh subclass.

Metode publik

getSummary

public TestSummary getSummary ()

Memungkinkan InvocationListener menampilkan ringkasan.

Hasil
TestSummary	TestSummary yang meringkas operasi, atau null

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

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

Parameter
test	TestDescription: mengidentifikasi pengujian
trace	String: stack trace kegagalan

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

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

testEnded

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

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

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

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Melaporkan akhir eksekusi setiap kasus pengujian.

Jika testFailed(TestDescription, FailureDescription) tidak dipanggil, pengujian ini akan lulus. Juga menampilkan metrik kunci/nilai yang mungkin telah dikeluarkan selama eksekusi kasus pengujian.

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

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Melaporkan kegagalan kasus pengujian individual.

Akan dipanggil antara testStarted dan testEnded.

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

testFailed

public void testFailed (TestDescription test, 
                String trace)

Melaporkan kegagalan kasus pengujian individual.

Akan dipanggil antara testStarted dan testEnded.

Parameter
test	TestDescription: mengidentifikasi pengujian
trace	String: stack trace kegagalan

testIgnored

public void testIgnored (TestDescription test)

Dipanggil saat pengujian tidak akan dijalankan, biasanya karena metode pengujian dianotasi dengan org.junit.Ignore.

Parameter
test	TestDescription: mengidentifikasi pengujian

testLog

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

Memberikan data log atau debug terkait dari pemanggilan pengujian.

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

Framework TradeFederation akan otomatis memanggil metode ini, yang menyediakan log host dan jika berlaku, logcat perangkat.

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. Implementator harus memanggil createInputStream untuk mulai membaca data, dan memastikan untuk menutup InputStream yang dihasilkan setelah selesai. Pemanggil harus memastikan sumber data tetap ada dan dapat diakses hingga metode testLog selesai.

testModuleEnded

public void testModuleEnded ()

Melaporkan akhir proses modul.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

Parameter
moduleContext	IInvocationContext: IInvocationContext modul.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Melaporkan akhir pengujian yang dijalankan.

Parameter
elapsedTime	long: waktu berlalu yang dilaporkan perangkat, dalam milidetik
runMetrics	: pasangan nilai kunci yang dilaporkan di akhir pengujian

testRunFailed

public void testRunFailed (FailureDescription failure)

Operasi pengujian laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh FailureDescription.

Parameter
failure	FailureDescription: FailureDescription yang menjelaskan kegagalan dan konteksnya.

testRunFailed

public void testRunFailed (String errorMessage)

Pengujian laporan yang dijalankan gagal diselesaikan karena error fatal.

Parameter
errorMessage	String: String yang menjelaskan alasan kegagalan operasi.

testRunStarted

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

Melaporkan awal pengujian yang dijalankan.

Parameter
runName	String: nama operasi pengujian
testCount	int: jumlah total pengujian dalam operasi pengujian
attemptNumber	int: nomor urutan, yang mengidentifikasi berbagai upaya runName yang sama yang berjalan beberapa kali. attemptNumber diberi indeks 0 dan harus bertambah setiap kali operasi baru terjadi. Misalnya, pengujian dicoba ulang secara terperinci 3 kali, pengujian tersebut harus memiliki total 4 operasi di bawah runName yang sama dan attemptNumber-nya adalah dari 0 hingga 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Melaporkan awal pengujian yang dijalankan.

Parameter
runName	String: nama operasi pengujian
testCount	int: jumlah total pengujian dalam operasi pengujian

testRunStarted

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

Melaporkan awal pengujian yang dijalankan.

Parameter
runName	String: nama operasi pengujian
testCount	int: jumlah total pengujian dalam operasi pengujian
attemptNumber	int: nomor urutan, yang mengidentifikasi berbagai upaya runName yang sama yang berjalan beberapa kali. attemptNumber diberi indeks 0 dan harus bertambah setiap kali operasi baru terjadi. Misalnya, pengujian dicoba ulang secara terperinci 3 kali, pengujian tersebut harus memiliki total 4 operasi di bawah runName yang sama dan attemptNumber adalah dari 0 hingga 3.
startTime	long: waktu mulai operasi, diukur melalui System.currentTimeMillis()

testRunStopped

public void testRunStopped (long elapsedTime)

Pengujian laporan berhenti sebelum selesai karena permintaan pengguna.

TODO: currently unused, consider removing

Parameter
elapsedTime	long: waktu berlalu yang dilaporkan perangkat, dalam milidetik

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Dipanggil saat pengujian dilewati dan tidak dieksekusi karena alasan yang biasanya tidak diharapkan. Pengujian ini akan dicoba untuk dicoba lagi untuk mencoba mendapatkan eksekusi yang tepat.

Parameter
test	TestDescription: mengidentifikasi pengujian
reason	SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternatif untuk testStarted(com.android.tradefed.result.TestDescription) tempat kita juga menentukan kapan pengujian dimulai, digabungkan dengan ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) untuk pengukuran yang akurat.

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

testStarted

public void testStarted (TestDescription test)

Melaporkan awal setiap kasus pengujian. Antarmuka lama, harus menggunakan testStarted(com.android.tradefed.result.TestDescription) jika memungkinkan.

Parameter
test	TestDescription: mengidentifikasi pengujian

Metode yang dilindungi

getListeners

protected  getListeners ()

Mendapatkan daftar pemroses. Hanya ditujukan untuk digunakan oleh subclass.

Hasil
	Daftar ITestInvocationListener.

setListeners

protected void setListeners (ITestInvocationListener... listeners)

Tetapkan pemroses setelah pembuatan. Hanya ditujukan untuk digunakan oleh subclass.

Parameter
listeners	ITestInvocationListener: ITestInvocationListener sebenarnya yang akan meneruskan hasil

setListeners

protected void setListeners ( listeners)

Tetapkan pemroses setelah pembuatan. Hanya ditujukan untuk digunakan oleh subclass.

Parameter
listeners	: ITestInvocationListener sebenarnya yang akan meneruskan hasil