{i>BasePostProcessor<i}
public
abstract
class
BasePostProcessor
extends Object
implements
IPostProcessor
java.lang.Object | |
↳ | com.android.tradefed.postprocessor.BasePostProcessor |
IPostProcessor
dasar yang harus diperluas setiap implementasi. Pastikan postingan
metode pemrosesan dipanggil sebelum pelapor hasil akhir.
Ringkasan
Konstruktor publik | |
---|---|
BasePostProcessor()
|
Metode publik | |
---|---|
final
ITestInvocationListener
|
init(ITestInvocationListener listener)
Langkah inisialisasi pemroses postingan. |
final
void
|
invocationEnded(long elapsedTime)
Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil maupun karena beberapa 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 Benar jika seluruh objek dinonaktifkan (lewati penyiapan dan pemutusan). |
final
void
|
logAssociation(String dataName, LogFile logFile)
Dalam beberapa kasus, log harus terkait erat
dengan kasus pengujian, tetapi kesempatan untuk
jadi di Memperbarui pengaitan log-ke-pengujian. |
|
processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics,
Implementasikan metode ini untuk menggabungkan metrik dan log di semua pengujian. |
abstract
|
processRunMetricsAndLogs(
Terapkan metode ini untuk menghasilkan kumpulan metrik baru dari metrik yang ada dan log. |
|
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 pemroses postingan turunan untuk melakukan inisialisasi sebelum pengujian berjalan. |
final
void
|
testAssumptionFailure(TestDescription test, String trace)
Dipanggil saat pengujian atomik menandai bahwa kondisi tersebut mengasumsikan kondisi yang salah. |
final
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Dipanggil saat pengujian atomik menandai bahwa kondisi tersebut 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 individu. |
final
void
|
testFailed(TestDescription test, String trace)
Melaporkan kegagalan kasus pengujian individu. |
final
void
|
testIgnored(TestDescription test)
Dipanggil pada saat pengujian tidak akan dijalankan, umumnya karena metode pengujian dianotasi dengan {i>org.junit.Ignore<i}. |
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 berakhirnya uji coba. |
final
void
|
testRunFailed(FailureDescription failure)
Melaporkan pengujian yang gagal diselesaikan karena kegagalan yang dijelaskan oleh |
final
void
|
testRunFailed(String errorMessage)
Melaporkan pengujian yang gagal diselesaikan karena terjadi error fatal. |
final
void
|
testRunStarted(String runName, int testCount, int attemptNumber)
Melaporkan dimulainya pengujian. |
final
void
|
testRunStarted(String runName, int testCount)
Menguji callback run |
final
void
|
testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
Melaporkan dimulainya pengujian. |
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 dijalankan 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
{i>BasePostProcessor<i}
public BasePostProcessor ()
Metode publik
init
public final ITestInvocationListener init (ITestInvocationListener listener)
Langkah inisialisasi pemroses postingan. Dipastikan untuk dipanggil sebelum pengujian apa pun callback.
Parameter | |
---|---|
listener |
ITestInvocationListener |
Hasil | |
---|---|
ITestInvocationListener |
pemanggilanBerakhir
public final void invocationEnded (long elapsedTime)
Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil maupun karena beberapa error .
Akan otomatis dipanggil oleh framework TradeFederation.
Parameter | |
---|---|
elapsedTime |
long : waktu berlalu dari pemanggilan dalam md |
pemanggilanGagal
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 |
pemanggilanGagal
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 |
pemanggilanDilewati
public void invocationSkipped (SkipReason reason)
Melaporkan panggilan sebagai dilewati
Parameter | |
---|---|
reason |
SkipReason |
pemanggilanDimulai
public final void invocationStarted (IInvocationContext context)
Pemroses Pemanggilan untuk penerusan
Parameter | |
---|---|
context |
IInvocationContext : informasi tentang panggilan |
nonaktif
public final boolean isDisabled ()
Menampilkan Benar jika seluruh objek dinonaktifkan (lewati penyiapan dan pemutusan). Salah jika sebaliknya.
Hasil | |
---|---|
boolean |
logAssociation
public final void logAssociation (String dataName, LogFile logFile)
Dalam beberapa kasus, log harus terkait erat
dengan kasus pengujian, tetapi kesempatan untuk
jadi di testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
langsung
callback tidak mungkin dilakukan. Dengan demikian, callback ini memungkinkan untuk memberikan pengaitan yang kuat
secara eksplisit.
Memperbarui pengaitan log-ke-pengujian. Jika metode ini dipanggil selama pengujian, log mengikuti pengujian; jika tidak, data itu akan menjadi log run.
Parameter | |
---|---|
dataName |
String : Nama data |
logFile |
LogFile : LogFile yang dicatat sebelumnya dan harus dikaitkan dengan
kasus pengujian tertentu. |
processAllTestMetricsAndLogs
publicprocessAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)
Implementasikan metode ini untuk menggabungkan metrik dan log di semua pengujian. Metrik yang keluar dari metode ini akan dilaporkan sebagai metrik operasi. Hanya metrik yang baru dibuat yang seharusnya ditampilkan, dan dengan nama kunci unik (tidak diperbolehkan bertumbukan dengan kunci yang ada).
Parameter | |
---|---|
allTestMetrics |
ListMultimap : HashMultimap yang menyimpan metrik dari setiap pengujian yang dikelompokkan berdasarkan metrik
nama. |
allTestLogs |
: Peta yang menyimpan peta file log setiap pengujian yang dikunci dengan nama datanya,
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 yang ada dan log. Hanya metrik yang baru dibuat yang akan ditampilkan, dan dengan nama kunci unik (tidak bentrok dengan kunci yang ada diizinkan).
Parameter | |
---|---|
rawMetrics |
: Kumpulan metrik mentah yang tersedia untuk dijalankan. |
runLogs |
: Kumpulan file log untuk pengujian. |
Hasil | |
---|---|
|
Kumpulan metrik yang baru saja dibuat dari metrik yang dijalankan. |
processTestMetricsAndLogs
publicprocessTestMetricsAndLogs (TestDescription testDescription, testMetrics, testLogs)
Terapkan metode ini untuk memposting metrik dan log proses dari setiap pengujian. Hanya yang baru metrik yang dihasilkan harus ditampilkan, dan dengan nama kunci unik (tidak bertabrakan dengan {i>key<i} diizinkan).
Parameter | |
---|---|
testDescription |
TestDescription : Objek TestDescription yang mendeskripsikan pengujian. |
testMetrics |
: Kumpulan metrik dari pengujian. |
testLogs |
: Kumpulan file yang dicatat selama pengujian. |
Hasil | |
---|---|
|
Kumpulan metrik yang baru dibuat dari metrik pengujian. |
setLogSaver
public final void setLogSaver (ILogSaver logSaver)
Setel ILogSaver
untuk mengizinkan pengimplementasi menyimpan file.
Parameter | |
---|---|
logSaver |
ILogSaver : ILogSaver |
penyiapan
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 atomik menandai bahwa kondisi tersebut 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 atomik menandai bahwa kondisi tersebut 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))
yang memungkinkan kita 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, yang diukur melalui System.currentTimeMillis() |
testMetrics |
: ERROR(/Map) metrik yang ditampilkan |
testBerakhir
public final void testEnded (TestDescription test,testMetrics)
Melaporkan akhir eksekusi setiap kasus pengujian.
Jika testFailed(TestDescription, FailureDescription)
tidak dipanggil, pengujian ini lulus. Juga menampilkan kunci/nilai
metrik yang mungkin dimunculkan selama eksekusi kasus pengujian.
Parameter | |
---|---|
test |
TestDescription : mengidentifikasi pengujian |
testMetrics |
: ERROR(/Map) metrik yang ditampilkan |
pengujianGagal
public final void testFailed (TestDescription test, FailureDescription failure)
Melaporkan kegagalan kasus pengujian individu.
Akan dipanggil antara testStarted dan testEnded.
Parameter | |
---|---|
test |
TestDescription : mengidentifikasi pengujian |
failure |
FailureDescription : FailureDescription yang menjelaskan kegagalan dan konteksnya. |
pengujianGagal
public final void testFailed (TestDescription test, String trace)
Melaporkan kegagalan kasus pengujian individu.
Akan dipanggil antara testStarted dan testEnded.
Parameter | |
---|---|
test |
TestDescription : mengidentifikasi pengujian |
trace |
String : stack trace kegagalan |
testDiabaikan
public final void testIgnored (TestDescription test)
Dipanggil pada saat pengujian tidak akan dijalankan, umumnya karena metode pengujian dianotasi dengan {i>org.junit.Ignore<i}.
Parameter | |
---|---|
test |
TestDescription : mengidentifikasi pengujian |
Loguji
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. mis. "device_logcat". Catatan
dataName tidak boleh unik per pemanggilan. yaitu pengimplementasi harus mampu menangani
beberapa panggilan dengan dataName yang sama |
dataType |
LogDataType : LogDataType data |
dataStream |
InputStreamSource : InputStreamSource data. Pengimplementasi harus memanggil
createInputStream untuk mulai membaca data, dan memastikan untuk menutup hasil
InputStream setelah selesai. Pemanggil harus memastikan sumber data tetap ada
ada dan dapat diakses sampai metode {i>
testLog<i} 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. mis. "device_logcat". Catatan
dataName tidak boleh unik per pemanggilan. yaitu pengimplementasi harus mampu menangani
beberapa panggilan dengan dataName yang sama |
dataType |
LogDataType : LogDataType data |
dataStream |
InputStreamSource : InputStreamSource data. Pengimplementasi harus memanggil
createInputStream untuk mulai membaca data, dan memastikan untuk menutup hasil
InputStream setelah selesai. |
logFile |
LogFile : LogFile yang berisi metadata file yang disimpan. |
testModuleBerakhir
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. Alat ini hanya digunakan selama
berjalan yang menggunakan
modul: runner berbasis suite.
Parameter | |
---|---|
moduleContext |
IInvocationContext : IInvocationContext modul. |
testRunEnded
public final void testRunEnded (long elapsedTime,runMetrics)
Melaporkan berakhirnya uji coba. FIXME: Kita tidak dapat memiliki dua Peta<> antarmuka dengan jenis yang berbeda, jadi kita harus menggunakan HashMap di sini.
Parameter | |
---|---|
elapsedTime |
long : perangkat melaporkan waktu berlalu, dalam milidetik |
runMetrics |
: pasangan nilai kunci yang dilaporkan di akhir pengujian dengan Metric . |
{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)
Melaporkan pengujian yang gagal diselesaikan karena terjadi error fatal.
Parameter | |
---|---|
errorMessage |
String : String yang menjelaskan alasan kegagalan operasi. |
testRunStarted
public final void testRunStarted (String runName, int testCount, int attemptNumber)
Melaporkan dimulainya pengujian.
Parameter | |
---|---|
runName |
String : nama pengujian yang dijalankan |
testCount |
int : jumlah total pengujian dalam pengujian |
attemptNumber |
int : nomor pesanan, yang mengidentifikasi berbagai percobaan dari runName yang sama
yang berjalan beberapa kali. upayaNumber diindeks 0 dan akan bertambah setiap kali
terjadi proses baru. mis. Sebuah tes terperinci dilakukan sebanyak 3 kali, seharusnya memiliki total 4
berjalan di bawah runName yang sama dan percobaanNumber adalah dari 0 hingga 3. |
testRunStarted
public final void testRunStarted (String runName, int testCount)
Menguji callback run
Parameter | |
---|---|
runName |
String : nama pengujian yang dijalankan |
testCount |
int : jumlah total pengujian dalam pengujian |
testRunStarted
public final void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Melaporkan dimulainya pengujian.
Parameter | |
---|---|
runName |
String : nama pengujian yang dijalankan |
testCount |
int : jumlah total pengujian dalam pengujian |
attemptNumber |
int : nomor pesanan, yang mengidentifikasi berbagai percobaan dari runName yang sama
yang berjalan beberapa kali. upayaNumber diindeks 0 dan harus bertambah setiap kali
operasi baru terjadi. mis. Pengujian terperinci dilakukan sebanyak 3 kali, dengan total pengujian 4 kali
dengan runName yang sama dan percobaanNumber adalah dari 0 hingga 3. |
startTime |
long : waktu yang dimulai, diukur melalui System.currentTimeMillis() |
testRunBerhenti
public final void testRunStopped (long elapsedTime)
Melaporkan pengujian yang dihentikan sebelum selesai karena permintaan pengguna.
TODO: saat ini tidak digunakan, pertimbangkan untuk menghapusnya
Parameter | |
---|---|
elapsedTime |
long : perangkat melaporkan waktu berlalu, dalam milidetik |
pengujianDilewati
public final void testSkipped (TestDescription test, SkipReason reason)
Dipanggil saat pengujian dilewati dan tidak dijalankan karena alasan yang biasanya tidak diharapkan. Pengujian ini akan dicoba ulang untuk 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)
yang juga menentukan waktu pengujiannya
dimulai, dikombinasikan dengan ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
untuk pengukuran yang akurat.
Parameter | |
---|---|
test |
TestDescription : mengidentifikasi pengujian |
startTime |
long : waktu pengujian dimulai, yang diukur melalui System.currentTimeMillis() |
pengujianDimulai
public final void testStarted (TestDescription test)
Callback kasus pengujian
Parameter | |
---|---|
test |
TestDescription : mengidentifikasi pengujian |
Metode yang dilindungi
pembersihan
protected void cleanUp ()
getMetricType
protected MetricMeasurement.DataType getMetricType ()
Ganti metode ini untuk mengubah jenis metrik jika diperlukan. Secara default, metrik ditetapkan ke jenis data yang telah diproses.
Hasil | |
---|---|
MetricMeasurement.DataType |
getRunName
protected String getRunName ()
Hasil | |
---|---|
String |