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, testMetrics)

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, runMetrics)

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 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)).

String mangleTestRunName(String name)

Metode ini dijalankan pada semua nama pengujian yang diteruskan ke callback testRunStarted(String, int).

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