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

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 ILogSaver untuk mengizinkan pelaksana menyimpan file.

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 ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) di mana kita dapat menentukan waktu berakhir secara langsung.

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

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

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

public  processAllTestMetricsAndLogs (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 : Peta yang menyimpan peta file log setiap pengujian yang dikunci berdasarkan nama datanya, menggunakan TestDescription setiap pengujian sebagai kunci.

Kembali
Kumpulan metrik yang baru dihasilkan dari semua metrik pengujian.

prosesRunMetricsAndLogs

public abstract  processRunMetricsAndLogs ( 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 : Kumpulan metrik mentah yang tersedia untuk dijalankan.

runLogs : Kumpulan file log untuk pengujian yang dijalankan.

Kembali
Kumpulan metrik yang baru dihasilkan dari metrik yang dijalankan.

prosesTestMetricsAndLogs

public  processTestMetricsAndLogs (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 : Kumpulan metrik dari pengujian.

testLogs : Kumpulan file yang dicatat selama pengujian.

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 : pasangan nilai kunci yang dilaporkan pada akhir uji coba dengan 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