NamaMangleListener
public
abstract
class
NameMangleListener
extends Object
implements
ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.NameMangleListener |
Pemroses proxy untuk menerjemahkan nama metode, class, dan paket pengujian saat hasil dilaporkan.
Ringkasan
Konstruktor publik | |
---|---|
NameMangleListener(ITestInvocationListener listener)
|
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(Throwable cause)
Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error. |
void
|
invocationStarted(IInvocationContext context)
Melaporkan awal pemanggilan pengujian. |
void
|
testAssumptionFailure(TestDescription test, String trace)
Dipanggil saat pengujian atomik menandai bahwa kondisi tersebut mengasumsikan kondisi yang salah. |
void
|
testEnded(TestDescription test,
Melaporkan akhir eksekusi setiap kasus pengujian. |
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
|
testRunEnded(long elapsedTime,
Melaporkan akhir pengujian yang dijalankan. |
void
|
testRunFailed(String errorMessage)
Pengujian laporan yang dijalankan gagal diselesaikan karena error fatal. |
void
|
testRunStarted(String runName, int testCount)
Melaporkan awal pengujian yang dijalankan. |
void
|
testRunStopped(long elapsedTime)
Pengujian laporan berhenti sebelum selesai karena permintaan pengguna. |
void
|
testStarted(TestDescription test)
Melaporkan awal setiap kasus pengujian. |
Metode yang dilindungi | |
---|---|
TestDescription
|
mangleTestId(TestDescription test)
Metode ini dijalankan di semua |
String
|
mangleTestRunName(String name)
Metode ini dijalankan pada semua nama pengujian yang diteruskan ke callback |
Konstruktor publik
NameMangleListener
public NameMangleListener (ITestInvocationListener listener)
Parameter | |
---|---|
listener |
ITestInvocationListener |
Metode publik
getSummary
public TestSummary getSummary ()
Memungkinkan InvocationListener menampilkan ringkasan.
Hasil | |
---|---|
TestSummary |
TestSummary yang meringkas operasi, atau null |
pemanggilanBerakhir
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 |
pemanggilanGagal
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 |
invocationStarted
public void invocationStarted (IInvocationContext context)
Melaporkan awal pemanggilan pengujian.
Akan otomatis dipanggil oleh framework TradeFederation. Pelapor harus mengganti metode ini untuk mendukung pelaporan beberapa perangkat.
Parameter | |
---|---|
context |
IInvocationContext : informasi tentang pemanggilan |
testAsumsiKegagalan
public void testAssumptionFailure (TestDescription test, String trace)
Dipanggil saat pengujian atomik menandai bahwa kondisi tersebut mengasumsikan kondisi yang salah.
Parameter | |
---|---|
test |
TestDescription : mengidentifikasi pengujian |
trace |
String : stack trace kegagalan |
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, String trace)
Melaporkan kegagalan kasus pengujian individual.
Akan dipanggil antara testStarted dan testEnded.
Parameter | |
---|---|
test |
TestDescription : mengidentifikasi pengujian |
trace |
String : stack trace kegagalan |
testDiabaikan
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. Implementer 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 sampai metode testLog selesai. |
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 (String errorMessage)
Melaporkan pengujian yang gagal diselesaikan karena terjadi error fatal.
Parameter | |
---|---|
errorMessage |
String : String yang menjelaskan alasan kegagalan operasi. |
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 |
testRunStopped
public void testRunStopped (long elapsedTime)
Pengujian laporan berhenti sebelum selesai karena permintaan pengguna.
TODO: currently unused, consider removing
Parameter | |
---|---|
elapsedTime |
long : perangkat melaporkan waktu berlalu, dalam milidetik |
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
mangleTestId
protected TestDescription mangleTestId (TestDescription test)
Metode ini dijalankan di semua TestDescription
yang diteruskan ke callback testStarted(com.android.tradefed.result.TestDescription)
, testFailed(com.android.tradefed.result.TestDescription, String)
, dan ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap))
. Metode ini akan menampilkan
TestDescription
yang mungkin berbeda yang akan diteruskan ke ITestInvocationListener
downstream yang ditentukan selama konstruksi.
Implementasi harus berhati-hati agar tidak mengubah TestDescription
asli.
Penerapan default meneruskan ID yang masuk melalui ID yang tidak diubah.
Parameter | |
---|---|
test |
TestDescription |
Hasil | |
---|---|
TestDescription |
{i>mangleTestRunName<i}
protected String mangleTestRunName (String name)
Metode ini dijalankan pada semua nama pengujian yang dijalankan yang diteruskan ke
callback testRunStarted(String, int)
. Metode ini akan menampilkan nama pengujian yang mungkin berbeda
yang akan diteruskan ke ITestInvocationListener
downstream yang
ditentukan selama konstruksi.
Implementasi harus berhati-hati agar tidak mengubah nama operasi asli.
Implementasi default meneruskan nama pengujian yang masuk tanpa diubah.
Parameter | |
---|---|
name |
String |
Hasil | |
---|---|
String |