Prosesor BasePost
public abstract class BasePostProcessor
extends Object
implements IPostProcessor
java.lang.Objek | |
↳ | com.Android.tradefed.postprocessor.BasePostProcessor |
IPostProcessor
dasar yang harus diperluas oleh setiap implementasi. Pastikan bahwa metode pemrosesan pasca 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 atau karena beberapa kondisi kesalahan. |
final void | invocationFailed ( FailureDescription failure) Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan. |
final void | invocationFailed (Throwable cause) Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan. |
void | invocationSkipped ( SkipReason reason) Melaporkan pemanggilan yang dilewati |
final void | invocationStarted ( IInvocationContext context) Pendengar Doa untuk meneruskan |
final boolean | isDisabled () Mengembalikan True jika seluruh objek dinonaktifkan (lewati pengaturan dan pembongkaran). |
final void | logAssociation (String dataName, LogFile logFile) Dalam beberapa kasus, log harus sangat terkait dengan kasus uji, namun peluang untuk melakukannya secara langsung Memperbarui asosiasi log-to-test. |
processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs) processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs) Terapkan metode ini untuk menggabungkan metrik dan log di semua pengujian. | |
abstract | processRunMetricsAndLogs ( rawMetrics, runLogs) processRunMetricsAndLogs ( rawMetrics, runLogs) processRunMetricsAndLogs ( rawMetrics, runLogs) Terapkan metode ini untuk menghasilkan serangkaian metrik baru dari metrik dan log yang ada. |
processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs) processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs) processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs) Terapkan metode ini untuk memposting metrik proses dan log dari setiap pengujian. | |
final void | setLogSaver ( ILogSaver logSaver) Atur |
void | setUp () Ganti metode ini di pemroses pos anak untuk menginisialisasi sebelum pengujian dijalankan. |
final void | testAssumptionFailure ( TestDescription test, String trace) Dipanggil ketika pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah |
final void | testAssumptionFailure ( TestDescription test, FailureDescription failure) Dipanggil ketika pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah |
final void | testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) Alternatif untuk |
final void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Melaporkan akhir eksekusi kasus uji individual. |
final void | testFailed ( TestDescription test, FailureDescription failure) Melaporkan kegagalan kasus uji individual. |
final void | testFailed ( TestDescription test, String trace) Melaporkan kegagalan kasus uji individual. |
final void | testIgnored ( TestDescription test) Dipanggil ketika pengujian tidak akan dijalankan, umumnya 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 ketika log pengujian disimpan. |
final void | testModuleEnded () Melaporkan akhir dari pengoperasian modul. |
final void | testModuleStarted ( IInvocationContext moduleContext) Melaporkan permulaan modul berjalan. |
final void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) Melaporkan akhir uji coba. |
final void | testRunFailed ( FailureDescription failure) Uji coba laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh |
final void | testRunFailed (String errorMessage) Uji coba laporan gagal diselesaikan karena kesalahan fatal. |
final void | testRunStarted (String runName, int testCount, int attemptNumber) Melaporkan dimulainya uji coba. |
final void | testRunStarted (String runName, int testCount) Uji coba callback |
final void | testRunStarted (String runName, int testCount, int attemptNumber, long startTime) Melaporkan dimulainya uji coba. |
final void | testRunStopped (long elapsedTime) Uji coba laporan dihentikan sebelum selesai karena permintaan pengguna. |
final void | testSkipped ( TestDescription test, SkipReason reason) Dipanggil ketika 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 uji |
Metode yang dilindungi | |
---|---|
MetricMeasurement.DataType | getMetricType () Ganti metode ini untuk mengubah jenis metrik jika diperlukan. |
String | getRunName () |
Konstruktor publik
Prosesor BasePost
public BasePostProcessor ()
Metode publik
inisiasi
public final ITestInvocationListener init (ITestInvocationListener listener)
Langkah inisialisasi post processor. Dipastikan untuk dipanggil sebelum panggilan balik tes apa pun.
Parameter | |
---|---|
listener | ITestInvocationListener |
Kembali | |
---|---|
ITestInvocationListener |
doaBerakhir
public final void invocationEnded (long elapsedTime)
Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil atau karena beberapa kondisi kesalahan.
Akan secara otomatis dipanggil oleh kerangka TradeFederation.Parameter | |
---|---|
elapsedTime | long : waktu pemanggilan yang telah berlalu dalam ms |
doaGagal
public final void invocationFailed (FailureDescription failure)
Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.
Akan secara otomatis dipanggil oleh kerangka TradeFederation.
Parameter | |
---|---|
failure | FailureDescription : FailureDescription yang menjelaskan penyebab kegagalan |
doaGagal
public final void invocationFailed (Throwable cause)
Melaporkan pemanggilan yang tidak lengkap karena beberapa kondisi kesalahan.
Akan secara otomatis dipanggil oleh kerangka TradeFederation.Parameter | |
---|---|
cause | Throwable : penyebab kegagalan Throwable |
doaDilewatkan
public void invocationSkipped (SkipReason reason)
Melaporkan pemanggilan yang dilewati
Parameter | |
---|---|
reason | SkipReason |
doaDimulai
public final void invocationStarted (IInvocationContext context)
Pendengar Doa untuk meneruskan
Parameter | |
---|---|
context | IInvocationContext : informasi tentang pemanggilan |
dinonaktifkan
public final boolean isDisabled ()
Mengembalikan True jika seluruh objek dinonaktifkan (lewati pengaturan dan pembongkaran). Salah jika tidak.
Kembali | |
---|---|
boolean |
logAssociation
public final void logAssociation (String dataName, LogFile logFile)
Dalam beberapa kasus, log harus sangat terkait dengan kasus uji, namun peluang untuk melakukannya secara langsung testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
Panggilan balik testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
tidak dimungkinkan. Dengan demikian, panggilan balik ini memungkinkan untuk memberikan asosiasi yang kuat secara eksplisit.
Memperbarui asosiasi log-to-test. Jika metode ini dipanggil selama pengujian, maka log tersebut termasuk dalam pengujian; jika tidak, itu akan menjadi log yang dijalankan.
Parameter | |
---|---|
dataName | String : Nama datanya |
logFile | LogFile : LogFile yang telah dicatat sebelumnya dan harus dikaitkan dengan kasus uji. |
prosesAllTestMetricsAndLogs
publicprocessAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)
Terapkan metode ini untuk menggabungkan metrik dan log di semua pengujian. Metrik yang dihasilkan dari metode ini akan dijadikan reporter sebagai metrik yang dijalankan. Hanya metrik yang baru dibuat yang harus dikembalikan, dan dengan nama kunci unik (benturan dengan kunci yang ada tidak diperbolehkan).
Parameter | |
---|---|
allTestMetrics | ListMultimap : HashMultimap yang menyimpan metrik dari setiap pengujian yang dikelompokkan berdasarkan nama metrik. |
allTestLogs | TestDescription setiap pengujian sebagai kunci. |
Kembali | |
---|---|
Kumpulan metrik yang baru dihasilkan dari semua metrik pengujian. |
prosesRunMetricsAndLogs
public abstractprocessRunMetricsAndLogs ( rawMetrics, runLogs)
Terapkan metode ini untuk menghasilkan serangkaian metrik baru dari metrik dan log yang ada. Hanya metrik yang baru dibuat yang harus dikembalikan, dan dengan nama kunci unik (benturan dengan kunci yang ada tidak diperbolehkan).
Parameter | |
---|---|
rawMetrics | |
runLogs |
Kembali | |
---|---|
Kumpulan metrik yang baru dihasilkan dari metrik yang dijalankan. |
prosesTestMetricsAndLogs
publicprocessTestMetricsAndLogs (TestDescription testDescription, testMetrics, testLogs)
Terapkan metode ini untuk memposting metrik proses dan log dari setiap pengujian. Hanya metrik yang baru dibuat yang harus dikembalikan, dan dengan nama kunci unik (benturan dengan kunci yang ada tidak diperbolehkan).
Parameter | |
---|---|
testDescription | TestDescription : Objek TestDescription yang mendeskripsikan pengujian. |
testMetrics | |
testLogs |
Kembali | |
---|---|
Kumpulan metrik yang baru dihasilkan dari metrik pengujian. |
setLogSaver
public final void setLogSaver (ILogSaver logSaver)
Atur ILogSaver
untuk mengizinkan pelaksana menyimpan file.
Parameter | |
---|---|
logSaver | ILogSaver : ILogSaver |
mempersiapkan
public void setUp ()
Ganti metode ini di pemroses pos anak untuk menginisialisasi sebelum pengujian dijalankan.
testAssumptionFailure
public final void testAssumptionFailure (TestDescription test, String trace)
Dipanggil ketika pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
trace | String : tumpukan jejak kegagalan |
testAssumptionFailure
public final void testAssumptionFailure (TestDescription test, FailureDescription failure)
Dipanggil ketika pengujian atom menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
failure | FailureDescription : FailureDescription yang menjelaskan kegagalan dan konteksnya. |
tesBerakhir
public final void testEnded (TestDescription test, long endTime,testMetrics)
Alternatif untuk ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
di mana kita dapat menentukan waktu berakhir secara langsung. Gabungkan dengan testStarted(com.android.tradefed.result.TestDescription, long)
untuk pengukuran yang akurat.
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
endTime | long : waktu pengujian berakhir, diukur melalui System.currentTimeMillis() |
testMetrics | ERROR(/Map) dari metrik yang dikeluarkan |
tesBerakhir
public final void testEnded (TestDescription test,testMetrics)
Melaporkan akhir eksekusi kasus uji individual.
Jika testFailed(TestDescription, FailureDescription)
tidak dipanggil, pengujian ini berhasil. Juga mengembalikan metrik kunci/nilai apa pun yang mungkin telah dikeluarkan selama eksekusi kasus pengujian.
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
testMetrics | ERROR(/Map) dari metrik yang dikeluarkan |
tesGagal
public final void testFailed (TestDescription test, FailureDescription failure)
Melaporkan kegagalan kasus uji individual.
Akan dipanggil antara testStarted dan testEnded.
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
failure | FailureDescription : FailureDescription yang menjelaskan kegagalan dan konteksnya. |
tesGagal
public final void testFailed (TestDescription test, String trace)
Melaporkan kegagalan kasus uji individual.
Akan dipanggil antara testStarted dan testEnded.
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
trace | String : tumpukan jejak kegagalan |
tesIgnored
public final void testIgnored (TestDescription test)
Dipanggil ketika pengujian tidak akan dijalankan, umumnya karena metode pengujian dianotasi dengan org.junit.Ignore.
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
tesLog
public final void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
Gunakan metode ini untuk mencatat file dari implementasi PostProcessor.
Parameter | |
---|---|
dataName | String : sebuah String yang merupakan nama deskriptif data. misalnya "device_logcat". Catatan dataName mungkin tidak unik per pemanggilan. yaitu pelaksana harus mampu menangani banyak panggilan dengan nama data yang sama |
dataType | LogDataType : LogDataType datanya |
dataStream | InputStreamSource : InputStreamSource 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. |
testLogDisimpan
public final void testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
Dipanggil ketika log pengujian disimpan.
Harus digunakan sebagai pengganti ITestInvocationListener#testLog(String, LogDataType, InputStreamSource)
.
Parameter | |
---|---|
dataName | String : sebuah String yang merupakan nama deskriptif data. misalnya "device_logcat". Catatan dataName mungkin tidak unik per pemanggilan. yaitu pelaksana harus mampu menangani banyak panggilan dengan nama data yang sama |
dataType | LogDataType : LogDataType datanya |
dataStream | InputStreamSource : InputStreamSource data. Pelaksana harus memanggil createInputStream untuk mulai membaca data, dan memastikan untuk menutup InputStream yang dihasilkan setelah selesai. |
logFile | LogFile : LogFile yang berisi meta data dari file yang disimpan. |
testModuleBerakhir
public final void testModuleEnded ()
Melaporkan akhir dari pengoperasian modul.
testModuleStarted
public final void testModuleStarted (IInvocationContext moduleContext)
Melaporkan permulaan modul berjalan. Callback ini dikaitkan dengan testModuleEnded()
dan bersifat opsional dalam urutannya. Ini hanya digunakan selama proses yang menggunakan modul: pelari berbasis suite.
Parameter | |
---|---|
moduleContext | IInvocationContext : IInvocationContext modul. |
testRunEnded
public final void testRunEnded (long elapsedTime,runMetrics)
Melaporkan akhir uji coba. FIXME: Kami tidak dapat memiliki dua antarmuka Map<> dengan tipe berbeda, jadi kami harus menggunakan HashMap di sini.
Parameter | |
---|---|
elapsedTime | long : perangkat melaporkan waktu yang telah berlalu, dalam milidetik |
runMetrics | Metric . |
testRunFailed
public final void testRunFailed (FailureDescription failure)
Uji coba laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh FailureDescription
.
Parameter | |
---|---|
failure | FailureDescription : FailureDescription yang menjelaskan kegagalan dan konteksnya. |
testRunFailed
public final void testRunFailed (String errorMessage)
Uji coba laporan gagal diselesaikan karena kesalahan fatal.
Parameter | |
---|---|
errorMessage | String : String yang menjelaskan alasan kegagalan proses. |
tesRunStarted
public final void testRunStarted (String runName, int testCount, int attemptNumber)
Melaporkan dimulainya uji coba.
Parameter | |
---|---|
runName | String : nama uji coba |
testCount | int : jumlah total pengujian dalam pengujian yang dijalankan |
attemptNumber | int : nomor pesanan, mengidentifikasi upaya berbeda dari runName yang sama yang dijalankan beberapa kali. AttemptNumber diindeks 0 dan harus bertambah setiap kali proses baru terjadi. misalnya Sebuah tes diuji ulang secara granular sebanyak 3 kali, tes tersebut harus memiliki total 4 kali proses dengan runName yang sama dan nomor percobaannya adalah dari 0 hingga 3. |
tesRunStarted
public final void testRunStarted (String runName, int testCount)
Uji coba callback
Parameter | |
---|---|
runName | String : nama uji coba |
testCount | int : jumlah total pengujian dalam pengujian yang dijalankan |
tesRunStarted
public final void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Melaporkan dimulainya uji coba.
Parameter | |
---|---|
runName | String : nama uji coba |
testCount | int : jumlah total pengujian dalam pengujian yang dijalankan |
attemptNumber | int : nomor pesanan, mengidentifikasi upaya berbeda dari runName yang sama yang dijalankan beberapa kali. AttemptNumber diindeks 0 dan harus bertambah setiap kali proses baru terjadi. misalnya Sebuah tes diuji ulang secara granular sebanyak 3 kali, tes tersebut harus memiliki total 4 kali proses dengan runName yang sama dan nomor percobaannya adalah dari 0 hingga 3. |
startTime | long : waktu dimulainya proses, diukur melalui System.currentTimeMillis() |
testRunStopped
public final void testRunStopped (long elapsedTime)
Uji coba laporan dihentikan sebelum selesai karena permintaan pengguna.
TODO: saat ini tidak digunakan, pertimbangkan untuk menghapusnya
Parameter | |
---|---|
elapsedTime | long : perangkat melaporkan waktu yang telah berlalu, dalam milidetik |
tes dilewati
public final void testSkipped (TestDescription test, SkipReason reason)
Dipanggil ketika pengujian dilewati dan tidak dijalankan karena alasan yang biasanya tidak diharapkan. Pengujian ini akan dicoba untuk dicoba ulang untuk mencoba mendapatkan eksekusi yang tepat.
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
reason | SkipReason : SkipReason |
tesDimulai
public final void testStarted (TestDescription test, long startTime)
Alternatif untuk testStarted(com.android.tradefed.result.TestDescription)
yang juga menentukan kapan pengujian dimulai, dikombinasikan dengan ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
untuk pengukuran yang akurat .
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
startTime | long : waktu pengujian dimulai, diukur melalui System.currentTimeMillis() |
tesDimulai
public final void testStarted (TestDescription test)
Callback kasus uji
Parameter | |
---|---|
test | TestDescription : mengidentifikasi tes |
Metode yang dilindungi
dapatkanMetricType
protected MetricMeasurement.DataType getMetricType ()
Ganti metode ini untuk mengubah jenis metrik jika diperlukan. Secara default, metrik disetel ke jenis yang diproses.
Kembali | |
---|---|
MetricMeasurement.DataType |
dapatkanRunName
protected String getRunName ()
Kembali | |
---|---|
String |