NameMangleListener
public abstract class NameMangleListener
extends Object
implements ITestInvocationListener
java.lang.Objek | |
↳ | com.android.tradefed.result.NameMangleListener |
Pendengar proxy untuk menerjemahkan metode pengujian, kelas, dan nama paket saat hasilnya dilaporkan.
Ringkasan
Konstruktor publik | |
---|---|
NameMangleListener ( ITestInvocationListener listener) |
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 (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 saat tes atom menandai bahwa kondisi tersebut dianggap salah |
void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Melaporkan akhir eksekusi dari kasus uji individual. |
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 dianotasi dengan org.junit.Ignore. |
void | testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) Menyediakan data log atau debug terkait dari pemanggilan pengujian. |
void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) Melaporkan akhir uji coba. |
void | testRunFailed (String errorMessage) Uji coba laporan gagal diselesaikan karena kesalahan fatal. |
void | testRunStarted (String runName, int testCount) Melaporkan awal uji coba. |
void | testRunStopped (long elapsedTime) Uji coba laporan berhenti sebelum selesai karena permintaan pengguna. |
void | testStarted ( TestDescription test) Melaporkan awal kasus uji individu. |
Metode yang dilindungi | |
---|---|
TestDescription | mangleTestId ( TestDescription test) Metode ini dijalankan di semua |
String | mangleTestRunName (String name) Metode ini dijalankan pada semua nama uji coba yang diteruskan ke callback |
Konstruktor publik
NameMangleListener
public NameMangleListener (ITestInvocationListener listener)
Parameter | |
---|---|
listener | ITestInvocationListener |
Metode publik
getSummary
public TestSummary getSummary ()
Mengizinkan InvocationListener mengembalikan ringkasan.
Pengembalian | |
---|---|
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 dipanggil secara otomatis oleh kerangka kerja TradeFederation.Parameter | |
---|---|
elapsedTime | long : waktu berlalu dari doa dalam ms |
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 : ERROR(/Throwable) penyebab kegagalan |
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 |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
Dipanggil saat tes atom menandai bahwa kondisi tersebut dianggap salah
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
trace | String : tumpukan jejak kegagalan |
testEnded
public void testEnded (TestDescription test,testMetrics)
Melaporkan akhir eksekusi dari kasus uji individual.
Jika testFailed(TestDescription, FailureDescription)
tidak dipanggil, tes ini lulus. Juga menampilkan metrik kunci/nilai apa pun yang mungkin telah dikeluarkan selama eksekusi kasus pengujian.
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
testMetrics | ERROR(/Map) dari metrik yang dipancarkan |
testFailed
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 |
testIgnored
public void testIgnored (TestDescription test)
Dipanggil saat pengujian tidak akan dijalankan, umumnya karena metode pengujian dianotasi dengan org.junit.Ignore.
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
testLog
public void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
Menyediakan data log atau debug terkait dari pemanggilan pengujian.
Harus dipanggil sebelumERROR(/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 ERROR(/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. |
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 | Metric . |
testRunFailed
public void testRunFailed (String errorMessage)
Uji coba laporan gagal diselesaikan karena kesalahan fatal.
Parameter | |
---|---|
errorMessage | String : ERROR(/String) menjelaskan alasan untuk menjalankan kegagalan. |
testRunStarted
public void testRunStarted (String runName, int testCount)
Melaporkan awal uji coba.
Parameter | |
---|---|
runName | String : nama uji coba |
testCount | int : jumlah total pengujian dalam uji coba |
testRunStopped
public void testRunStopped (long elapsedTime)
Uji coba laporan berhenti sebelum selesai karena permintaan pengguna.
TODO: saat ini tidak digunakan, pertimbangkan untuk menghapus
Parameter | |
---|---|
elapsedTime | long : perangkat melaporkan waktu berlalu, dalam milidetik |
testStarted
public void testStarted (TestDescription test)
Melaporkan awal kasus uji individu. Antarmuka yang lebih lama, harus menggunakan testStarted(com.android.tradefed.result.TestDescription)
jika memungkinkan.
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
Metode yang dilindungi
mangleTestId
protected TestDescription mangleTestId (TestDescription test)
Metode ini dijalankan di semua TestDescription
yang diteruskan ke testStarted(com.android.tradefed.result.TestDescription)
, testFailed(com.android.tradefed.result.TestDescription, String)
, dan ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap))
callback. Metode tersebut harus mengembalikan TestDescription
yang mungkin berbeda yang akan diteruskan ke ITestInvocationListener
downstream yang ditentukan selama konstruksi.
Implementasinya harus berhati-hati agar tidak mengubah TestDescription
yang asli.
Implementasi default melewati pengidentifikasi yang masuk melalui tidak dimodifikasi.
Parameter | |
---|---|
test | TestDescription |
Pengembalian | |
---|---|
TestDescription |
mangleTestRunName
protected String mangleTestRunName (String name)
Metode ini dijalankan pada semua nama uji coba yang diteruskan ke callback testRunStarted(String, int)
. Metode harus mengembalikan nama uji coba yang mungkin berbeda yang akan diteruskan ke ITestInvocationListener
downstream yang ditentukan selama konstruksi.
Parameter | |
---|---|
name | String |
Pengembalian | |
---|---|
String |