{i>BasePostProcessor<i}
public
abstract
class
BasePostProcessor
extends Object
implements
IPostProcessor
java.lang.Object | |
↳ | com.android.tradefed.postprocessor.BasePostProcessor |
IPostProcessor
dasar yang harus diperluas oleh setiap implementasi. Pastikan metode
pascapemrosesan dipanggil sebelum pelapor hasil akhir.
Ringkasan
Konstruktor publik | |
---|---|
BasePostProcessor()
|
Metode publik | |
---|---|
final
ITestInvocationListener
|
init(ITestInvocationListener listener)
Langkah inisialisasi post-processor. |
final
void
|
invocationEnded(long elapsedTime)
Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil maupun karena beberapa kondisi error. |
final
void
|
invocationFailed(FailureDescription failure)
Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error. |
final
void
|
invocationFailed(Throwable cause)
Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi error. |
void
|
invocationSkipped(SkipReason reason)
Melaporkan panggilan sebagai dilewati |
final
void
|
invocationStarted(IInvocationContext context)
Pemroses Pemanggilan untuk penerusan |
final
boolean
|
isDisabled()
Menampilkan True jika seluruh objek dinonaktifkan (lewati penyiapan dan penghapusan). |
final
void
|
logAssociation(String dataName, LogFile logFile)
Dalam beberapa kasus, log harus berkaitan erat dengan kasus pengujian, tetapi peluang untuk melakukannya
pada callback Memperbarui pengaitan log-ke-pengujian. |
|
processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics,
Terapkan metode ini untuk menggabungkan metrik dan log di semua pengujian. |
abstract
|
processRunMetricsAndLogs(
Terapkan metode ini untuk menghasilkan kumpulan metrik baru dari metrik dan log yang ada. |
|
processTestMetricsAndLogs(TestDescription testDescription,
Terapkan metode ini untuk memposting metrik dan log proses dari setiap pengujian. |
final
void
|
setLogSaver(ILogSaver logSaver)
Setel |
void
|
setUp()
Ganti metode ini di post-processor turunan untuk melakukan inisialisasi sebelum pengujian dijalankan. |
final
void
|
testAssumptionFailure(TestDescription test, String trace)
Dipanggil saat pengujian atom menandai bahwa pengujian mengasumsikan kondisi yang salah |
final
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Dipanggil saat pengujian atom menandai bahwa pengujian mengasumsikan kondisi yang salah |
final
void
|
testEnded(TestDescription test, long endTime,
Alternatif untuk |
final
void
|
testEnded(TestDescription test,
Melaporkan akhir eksekusi setiap kasus pengujian. |
final
void
|
testFailed(TestDescription test, FailureDescription failure)
Melaporkan kegagalan kasus pengujian individual. |
final
void
|
testFailed(TestDescription test, String trace)
Melaporkan kegagalan kasus pengujian individu. |
final
void
|
testIgnored(TestDescription test)
Dipanggil saat pengujian tidak akan dijalankan, biasanya karena metode pengujian dianotasi dengan org.junit.Ignore. |
final
void
|
testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)
Gunakan metode ini untuk mencatat file dari implementasi PostProcessor. |
final
void
|
testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
Dipanggil saat log pengujian disimpan. |
final
void
|
testModuleEnded()
Melaporkan akhir dari proses modul yang dijalankan. |
final
void
|
testModuleStarted(IInvocationContext moduleContext)
Melaporkan awal modul yang berjalan. |
final
void
|
testRunEnded(long elapsedTime,
Melaporkan akhir pengujian yang dijalankan. |
final
void
|
testRunFailed(FailureDescription failure)
Pengujian laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh |
final
void
|
testRunFailed(String errorMessage)
Pengujian laporan yang dijalankan gagal diselesaikan karena error fatal. |
final
void
|
testRunStarted(String runName, int testCount, int attemptNumber)
Melaporkan awal pengujian yang dijalankan. |
final
void
|
testRunStarted(String runName, int testCount)
Menguji callback run |
final
void
|
testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
Melaporkan awal pengujian yang dijalankan. |
final
void
|
testRunStopped(long elapsedTime)
Melaporkan pengujian yang dihentikan sebelum selesai karena permintaan pengguna. |
final
void
|
testSkipped(TestDescription test, SkipReason reason)
Dipanggil saat pengujian dilewati dan tidak dieksekusi karena alasan yang biasanya tidak diharapkan. |
final
void
|
testStarted(TestDescription test, long startTime)
Alternatif untuk |
final
void
|
testStarted(TestDescription test)
Callback kasus pengujian |
Metode yang dilindungi | |
---|---|
void
|
cleanUp()
|
MetricMeasurement.DataType
|
getMetricType()
Ganti metode ini untuk mengubah jenis metrik jika diperlukan. |
String
|
getRunName()
|
Konstruktor publik
BasePostProcessor
public BasePostProcessor ()
Metode publik
init
public final ITestInvocationListener init (ITestInvocationListener listener)
Langkah inisialisasi post-processor. Dijamin akan dipanggil sebelum callback pengujian apa pun.
Parameter | |
---|---|
listener |
ITestInvocationListener |
Hasil | |
---|---|
ITestInvocationListener |
invocationEnded
public final 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 berlalu dari pemanggilan dalam md |
invocationFailed
public final 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 final 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 final void invocationStarted (IInvocationContext context)
Pemroses Pemanggilan untuk penerusan
Parameter | |
---|---|
context |
IInvocationContext : informasi tentang pemanggilan |
isDisabled
public final boolean isDisabled ()
Menampilkan True jika seluruh objek dinonaktifkan (lewati penyiapan dan penghapusan). Salah jika sebaliknya.
Hasil | |
---|---|
boolean |
logAssociation
public final void logAssociation (String dataName, LogFile logFile)
Dalam beberapa kasus, log harus berkaitan erat dengan kasus pengujian, tetapi peluang untuk melakukannya
pada callback testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
langsung tidak mungkin dilakukan. Dengan demikian, callback ini memungkinkan untuk memberikan pengaitan yang kuat
secara eksplisit.
Memperbarui pengaitan log-to-test. Jika metode ini dipanggil selama pengujian, log akan menjadi milik pengujian; jika tidak, log akan menjadi log operasi.
Parameter | |
---|---|
dataName |
String : Nama data |
logFile |
LogFile : LogFile yang dicatat sebelumnya dan harus dikaitkan dengan
kasus pengujian. |
processAllTestMetricsAndLogs
publicprocessAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)
Implementasikan metode ini untuk menggabungkan metrik dan log di semua pengujian. Metrik yang dihasilkan dari metode ini akan dilaporkan sebagai metrik run. Hanya metrik yang baru dibuat yang harus ditampilkan, dan dengan nama kunci unik (tidak ada tabrakan dengan kunci yang ada).
Parameter | |
---|---|
allTestMetrics |
ListMultimap : HashMultimap yang menyimpan metrik dari setiap pengujian yang dikelompokkan menurut nama metrik. |
allTestLogs |
: Peta yang menyimpan peta file log setiap pengujian yang dikunci dengan nama data mereka, menggunakan TestDescription setiap pengujian sebagai kunci. |
Hasil | |
---|---|
|
Kumpulan metrik yang baru dibuat dari semua metrik pengujian. |
processRunMetricsAndLogs
public abstractprocessRunMetricsAndLogs ( rawMetrics, runLogs)
Terapkan metode ini untuk menghasilkan kumpulan metrik baru dari metrik dan log yang ada. Hanya metrik yang baru dibuat yang akan ditampilkan, dan dengan nama kunci unik (tidak diizinkan terjadi tabrakan dengan kunci yang ada).
Parameter | |
---|---|
rawMetrics |
: Kumpulan metrik mentah yang tersedia untuk dijalankan. |
runLogs |
: Kumpulan file log untuk pengujian yang dijalankan. |
Hasil | |
---|---|
|
Kumpulan metrik yang baru dibuat dari metrik run. |
processTestMetricsAndLogs
publicprocessTestMetricsAndLogs (TestDescription testDescription, testMetrics, testLogs)
Terapkan metode ini untuk memproses metrik dan log pasca-pengujian dari setiap pengujian. Hanya metrik yang baru dihasilkan yang akan ditampilkan, dan dengan nama kunci unik (tidak ada tabrakan dengan kunci yang ada).
Parameter | |
---|---|
testDescription |
TestDescription : Objek TestDescription yang menjelaskan pengujian. |
testMetrics |
: Kumpulan metrik dari pengujian. |
testLogs |
: Kumpulan file yang dicatat ke dalam log selama pengujian. |
Hasil | |
---|---|
|
Kumpulan metrik yang baru dibuat dari metrik pengujian. |
setLogSaver
public final void setLogSaver (ILogSaver logSaver)
Tetapkan ILogSaver
untuk mengizinkan implementor menyimpan file.
Parameter | |
---|---|
logSaver |
ILogSaver : ILogSaver |
setUp
public void setUp ()
Ganti metode ini di pemroses postingan turunan untuk melakukan inisialisasi sebelum pengujian berjalan.
testAsumsiKegagalan
public final void testAssumptionFailure (TestDescription test, String trace)
Dipanggil saat pengujian atom menandai bahwa pengujian mengasumsikan kondisi yang salah
Parameter | |
---|---|
test |
TestDescription : mengidentifikasi pengujian |
trace |
String : stack trace kegagalan |
testAsumsiKegagalan
public final void testAssumptionFailure (TestDescription test, FailureDescription failure)
Dipanggil saat pengujian atom menandai bahwa pengujian mengasumsikan kondisi yang salah
Parameter | |
---|---|
test |
TestDescription : mengidentifikasi pengujian |
failure |
FailureDescription : FailureDescription yang menjelaskan kegagalan dan konteksnya. |
testBerakhir
public final 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 final void testEnded (TestDescription test,testMetrics)
Melaporkan akhir eksekusi setiap kasus pengujian.
Jika testFailed(TestDescription, FailureDescription)
tidak dipanggil, pengujian ini lulus. Juga menampilkan metrik kunci/nilai yang mungkin telah dimunculkan selama eksekusi kasus pengujian.
Parameter | |
---|---|
test |
TestDescription : mengidentifikasi pengujian |
testMetrics |
: ERROR(/Map) dari metrik yang dikeluarkan |
testFailed
public final 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 final 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 final 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 final void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
Gunakan metode ini untuk mencatat file dari implementasi PostProcessor.
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 hingga metode testLog selesai. |
testLogDisimpan
public final void testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
Dipanggil saat log pengujian disimpan.
Harus digunakan sebagai pengganti ITestInvocationListener#testLog(String, LogDataType,
InputStreamSource)
.
Parameter | |
---|---|
dataName |
String : nama deskriptif String data, misalnya "device_logcat". Perhatikan bahwa dataName tidak boleh unik per pemanggilan. Misalnya, 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. |
logFile |
LogFile : LogFile yang berisi metadata file yang disimpan. |
testModuleEnded
public final void testModuleEnded ()
Melaporkan akhir dari proses modul yang dijalankan.
testModuleStarted
public final void testModuleStarted (IInvocationContext moduleContext)
Melaporkan awal modul yang berjalan. Callback ini dikaitkan dengan testModuleEnded()
dan bersifat opsional dalam urutan. API ini hanya digunakan selama proses lari yang menggunakan modul: runner berbasis suite.
Parameter | |
---|---|
moduleContext |
IInvocationContext : IInvocationContext modul. |
testRunEnded
public final 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 |
{i>testRunFailed<i}
public final void testRunFailed (FailureDescription failure)
Melaporkan pengujian yang gagal diselesaikan karena kegagalan yang dijelaskan oleh FailureDescription
.
Parameter | |
---|---|
failure |
FailureDescription : FailureDescription yang menjelaskan kegagalan dan konteksnya. |
{i>testRunFailed<i}
public final void testRunFailed (String errorMessage)
Pengujian laporan yang dijalankan gagal diselesaikan karena error fatal.
Parameter | |
---|---|
errorMessage |
String : String yang menjelaskan alasan kegagalan operasi. |
testRunStarted
public final 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 pesanan, yang mengidentifikasi berbagai percobaan dari runName
sama yang dijalankan beberapa kali. upayaNumber diindeks 0 dan harus bertambah setiap kali
operasi baru terjadi. Misalnya, pengujian terperinci dicoba lagi 3 kali, harus memiliki 4 total
yang dijalankan dalam runName yang sama dan percobaanNumbernya adalah dari 0 hingga 3. |
testRunStarted
public final void testRunStarted (String runName, int testCount)
Menguji callback run
Parameter | |
---|---|
runName |
String : nama operasi pengujian |
testCount |
int : jumlah total pengujian dalam operasi pengujian |
testRunStarted
public final 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
dalam runName yang sama dan attemptNumber-nya adalah dari 0 hingga 3. |
startTime |
long : waktu mulai operasi, diukur melalui System.currentTimeMillis() |
testRunBerhenti
public final 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 |
testSkipped
public final 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 |
pengujianDimulai
public final 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 final void testStarted (TestDescription test)
Callback kasus pengujian
Parameter | |
---|---|
test |
TestDescription : mengidentifikasi pengujian |
Metode yang dilindungi
cleanUp
protected void cleanUp ()
getMetricType
protected MetricMeasurement.DataType getMetricType ()
Ganti metode ini untuk mengubah jenis metrik jika diperlukan. Secara default, metrik ditetapkan ke jenis yang diproses.
Hasil | |
---|---|
MetricMeasurement.DataType |
getRunName
protected String getRunName ()
Hasil | |
---|---|
String |