BasePostProcessor

public abstract class BasePostProcessor
extends Object implements IConfigurationReceiver, IPostProcessor

java.lang.Object
   ↳ com.android.tradefed.postprocessor.BasePostProcessor


IPostProcessor dasar yang harus diperluas oleh setiap penerapan. Pastikan metode pasca-pemrosesan dipanggil sebelum pelapor hasil akhir.

Ringkasan

Konstruktor publik

BasePostProcessor()

Metode publik

IConfiguration getConfiguration()
final ITestInvocationListener init(ITestInvocationListener listener)

Langkah inisialisasi post-processor.

final void invocationEnded(long elapsedTime)

Melaporkan bahwa pemanggilan telah dihentikan, baik berhasil maupun karena kondisi error tertentu.

final void invocationFailed(FailureDescription failure)

Melaporkan pemanggilan yang tidak lengkap karena kondisi error tertentu.

final void invocationFailed(Throwable cause)

Melaporkan pemanggilan yang tidak lengkap karena kondisi error tertentu.

void invocationSkipped(SkipReason reason)

Melaporkan pemanggilan sebagai dilewati

final void invocationStarted(IInvocationContext context)

Pemroses Pemanggilan untuk penerusan

final boolean isDisabled()

Menampilkan True jika seluruh objek dinonaktifkan (lewati penyiapan dan penguraian).

final void logAssociation(String dataName, LogFile logFile)

Dalam beberapa kasus, log harus dikaitkan secara kuat dengan kasus pengujian, tetapi peluang untuk melakukannya pada callback testLogSaved(String,LogDataType,InputStreamSource,LogFile) langsung tidak memungkinkan.

Memperbarui asosiasi log ke pengujian.

Map<String, MetricMeasurement.Metric.Builder> processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, Map<TestDescription, Map<String, LogFile>> allTestLogs)

Terapkan metode ini untuk menggabungkan metrik dan log di semua pengujian.

abstract Map<String, MetricMeasurement.Metric.Builder> processRunMetricsAndLogs(HashMap<String, MetricMeasurement.Metric> rawMetrics, Map<String, LogFile> runLogs)

Terapkan metode ini untuk menghasilkan serangkaian metrik baru dari metrik dan log yang ada.

Map<String, MetricMeasurement.Metric.Builder> processTestMetricsAndLogs(TestDescription testDescription, HashMap<String, MetricMeasurement.Metric> testMetrics, Map<String, LogFile> testLogs)

Terapkan metode ini untuk memproses metrik dan log dari setiap pengujian.

void setConfiguration(IConfiguration configuration)

Menyisipkan IConfiguration yang sedang digunakan.

final void setLogSaver(ILogSaver logSaver)

Tetapkan ILogSaver untuk mengizinkan pelaksana menyimpan file.

void setUp()

Ganti metode ini di pemroses pasca turunan untuk melakukan inisialisasi sebelum pengujian berjalan.

final void testAssumptionFailure(TestDescription test, String trace)

Dipanggil saat pengujian atomik menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah (false)

final void testAssumptionFailure(TestDescription test, FailureDescription failure)

Dipanggil saat pengujian atomik menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah (false)

final void testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)

Alternatif untuk testEnded(TestDescription,Map) tempat kita dapat menentukan waktu berakhir secara langsung.

final void testEnded(TestDescription test, Map<String, String> testMetrics)

Melaporkan akhir eksekusi kasus pengujian individu.

final void testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)

Melaporkan akhir eksekusi kasus pengujian individu.

final void testEnded(TestDescription test, long endTime, Map<String, String> testMetrics)

Alternatif untuk testEnded(TestDescription,Map) tempat kita dapat menentukan waktu berakhir secara langsung.

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

final void testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

Dipanggil saat log pengujian disimpan.

final void testModuleEnded()

Melaporkan akhir proses modul.

final void testModuleStarted(IInvocationContext moduleContext)

Melaporkan awal modul yang berjalan.

final void testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)

Melaporkan akhir eksekusi pengujian.

final void testRunEnded(long elapsedTime, Map<String, String> runMetrics)

Melaporkan akhir eksekusi pengujian.

final void testRunFailed(FailureDescription failure)

Operasi pengujian laporan gagal diselesaikan karena kegagalan yang dijelaskan oleh FailureDescription.

final void testRunFailed(String errorMessage)

Uji coba laporan gagal diselesaikan karena terjadi error fatal.

final void testRunStarted(String runName, int testCount, int attemptNumber)

Melaporkan dimulainya proses pengujian.

final void testRunStarted(String runName, int testCount)

Callback uji coba

final void testRunStarted(String runName, int testCount, int attemptNumber, long startTime)

Melaporkan dimulainya proses pengujian.

final void testRunStopped(long elapsedTime)

Uji coba laporan 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 testStarted(TestDescription) yang juga menentukan kapan pengujian dimulai, dikombinasikan dengan testEnded(TestDescription,long,Map) untuk pengukuran yang akurat.

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()
final String getStackTrace()
final boolean isTestFailed()

Konstruktor publik

BasePostProcessor

public BasePostProcessor ()

Metode publik

getConfiguration

public IConfiguration getConfiguration ()

Hasil
IConfiguration

init

public final ITestInvocationListener init (ITestInvocationListener listener)

Langkah inisialisasi post-processor. Dipastikan 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 kondisi error tertentu.

Akan dipanggil secara otomatis oleh framework TradeFederation.

Parameter
elapsedTime long: waktu yang berlalu dari pemanggilan dalam md

invocationFailed

public final void invocationFailed (FailureDescription failure)

Melaporkan pemanggilan yang tidak lengkap karena kondisi error tertentu.

Akan dipanggil secara otomatis oleh framework TradeFederation.

Parameter
failure FailureDescription: FailureDescription yang menjelaskan penyebab kegagalan

invocationFailed

public final void invocationFailed (Throwable cause)

Melaporkan pemanggilan yang tidak lengkap karena kondisi error tertentu.

Akan dipanggil secara otomatis oleh framework TradeFederation.

Parameter
cause Throwable: penyebab kegagalan Throwable

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 penguraian). Salah untuk sebaliknya.

Hasil
boolean

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

Dalam beberapa kasus, log harus dikaitkan secara kuat dengan kasus pengujian, tetapi peluang untuk melakukannya pada callback testLogSaved(String,LogDataType,InputStreamSource,LogFile) langsung tidak memungkinkan. Dengan demikian, callback ini memungkinkan untuk memberikan asosiasi yang kuat secara eksplisit.

Memperbarui asosiasi log ke pengujian. Jika metode ini dipanggil selama pengujian, log tersebut akan menjadi bagian dari pengujian; jika tidak, log tersebut akan menjadi log operasi.

Parameter
dataName String: Nama data

logFile LogFile: LogFile yang dicatat sebelumnya dan harus dikaitkan dengan kasus pengujian.

processAllTestMetricsAndLogs

public Map<String, MetricMeasurement.Metric.Builder> processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, 
                Map<TestDescription, Map<String, LogFile>> allTestLogs)

Terapkan 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 yang unik (tidak boleh ada konflik dengan kunci yang ada).

Parameter
allTestMetrics ListMultimap: HashMultimap yang menyimpan metrik dari setiap pengujian yang dikelompokkan menurut nama metrik.

allTestLogs Map: Peta yang menyimpan peta file log setiap pengujian yang dikelompokkan berdasarkan nama datanya, menggunakan TestDescription setiap pengujian sebagai kunci.

Hasil
Map<String, MetricMeasurement.Metric.Builder> Kumpulan metrik yang baru dibuat dari semua metrik pengujian.

processRunMetricsAndLogs

public abstract Map<String, MetricMeasurement.Metric.Builder> processRunMetricsAndLogs (HashMap<String, MetricMeasurement.Metric> rawMetrics, 
                Map<String, LogFile> runLogs)

Terapkan metode ini untuk menghasilkan serangkaian metrik baru dari metrik dan log yang ada. Hanya metrik yang baru dibuat yang harus ditampilkan, dan dengan nama kunci yang unik (tidak boleh ada konflik dengan kunci yang ada).

Parameter
rawMetrics HashMap: Kumpulan metrik mentah yang tersedia untuk proses.

runLogs Map: Kumpulan file log untuk uji coba.

Hasil
Map<String, MetricMeasurement.Metric.Builder> Kumpulan metrik yang baru dibuat dari metrik proses.

processTestMetricsAndLogs

public Map<String, MetricMeasurement.Metric.Builder> processTestMetricsAndLogs (TestDescription testDescription, 
                HashMap<String, MetricMeasurement.Metric> testMetrics, 
                Map<String, LogFile> testLogs)

Terapkan metode ini untuk memproses metrik dan log dari setiap pengujian. Hanya metrik yang baru dibuat yang harus ditampilkan, dan dengan nama kunci yang unik (tidak boleh ada konflik dengan kunci yang ada).

Parameter
testDescription TestDescription: Objek TestDescription yang menjelaskan pengujian.

testMetrics HashMap: Kumpulan metrik dari pengujian.

testLogs Map: Set file yang dicatat selama pengujian.

Hasil
Map<String, MetricMeasurement.Metric.Builder> Kumpulan metrik yang baru dibuat dari metrik pengujian.

setConfiguration

public void setConfiguration (IConfiguration configuration)

Menyisipkan IConfiguration yang sedang digunakan.

Parameter
configuration IConfiguration

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Tetapkan ILogSaver untuk mengizinkan pelaksana menyimpan file.

Parameter
logSaver ILogSaver: ILogSaver

setUp

public void setUp ()

Ganti metode ini di pemroses pasca turunan untuk melakukan inisialisasi sebelum pengujian berjalan.

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Dipanggil saat pengujian atomik menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah (false)

Parameter
test TestDescription: mengidentifikasi pengujian

trace String: stack trace kegagalan

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Dipanggil saat pengujian atomik menandai bahwa pengujian tersebut mengasumsikan kondisi yang salah (false)

Parameter
test TestDescription: mengidentifikasi pengujian

failure FailureDescription: FailureDescription yang menjelaskan kegagalan dan konteksnya.

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Alternatif untuk testEnded(TestDescription,Map) tempat kita dapat menentukan waktu berakhir secara langsung. Gabungkan dengan testStarted(TestDescription,long) untuk pengukuran yang akurat.

Parameter
test TestDescription: mengidentifikasi pengujian

endTime long: waktu berakhirnya pengujian, diukur melalui System.currentTimeMillis()

testMetrics HashMap: Map metrik yang dikeluarkan

testEnded

public final void testEnded (TestDescription test, 
                Map<String, String> testMetrics)

Melaporkan akhir eksekusi kasus pengujian individu.

Jika testFailed(TestDescription, FailureDescription) tidak dipanggil, pengujian ini lulus. Juga menampilkan metrik kunci/nilai yang mungkin telah dikeluarkan selama eksekusi kasus pengujian.

Parameter
test TestDescription: mengidentifikasi pengujian

testMetrics Map: Map metrik yang dikeluarkan

testEnded

public final void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Melaporkan akhir eksekusi kasus pengujian individu.

Jika testFailed(TestDescription, FailureDescription) tidak dipanggil, pengujian ini lulus. Juga menampilkan metrik kunci/nilai yang mungkin telah dikeluarkan selama eksekusi kasus pengujian.

Parameter
test TestDescription: mengidentifikasi pengujian

testMetrics HashMap: Map metrik yang dikeluarkan

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                Map<String, String> testMetrics)

Alternatif untuk testEnded(TestDescription,Map) tempat kita dapat menentukan waktu berakhir secara langsung. Gabungkan dengan testStarted(TestDescription,long) untuk pengukuran yang akurat.

Parameter
test TestDescription: mengidentifikasi pengujian

endTime long: waktu berakhirnya pengujian, diukur melalui System.currentTimeMillis()

testMetrics Map: Map metrik yang dikeluarkan

testFailed

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.

testFailed

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

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

Parameter
dataName String: nama deskriptif String data. Misalnya, "device_logcat". Catatan dataName mungkin tidak unik per pemanggilan. Artinya, pelaksana harus dapat menangani beberapa panggilan dengan dataName yang sama

dataType LogDataType: LogDataType data

dataStream InputStreamSource: InputStreamSource data. Pelaksana 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.

testLogSaved

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". Catatan dataName mungkin tidak unik per pemanggilan. Artinya, pelaksana harus dapat menangani beberapa panggilan dengan dataName yang sama

dataType LogDataType: LogDataType data

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 file yang disimpan.

testModuleEnded

public final void testModuleEnded ()

Melaporkan akhir proses modul.

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

Melaporkan awal modul yang berjalan. Callback ini terkait dengan testModuleEnded() dan bersifat opsional dalam urutan. Hanya digunakan selama menjalankan modul yang menggunakan runner berbasis rangkaian pengujian.

Parameter
moduleContext IInvocationContext: IInvocationContext modul.

testRunEnded

public final void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

Melaporkan akhir eksekusi pengujian. FIXME: Kita tidak dapat memiliki dua antarmuka Map<> dengan jenis yang berbeda, jadi kita harus menggunakan HashMap di sini.

Parameter
elapsedTime long: waktu berlalu yang dilaporkan perangkat, dalam milidetik

runMetrics HashMap: pasangan nilai kunci yang dilaporkan di akhir proses pengujian dengan Metric.

testRunEnded

public final void testRunEnded (long elapsedTime, 
                Map<String, String> runMetrics)

Melaporkan akhir eksekusi pengujian.

Parameter
elapsedTime long: waktu berlalu yang dilaporkan perangkat, dalam milidetik

runMetrics Map: pasangan nilai kunci yang dilaporkan di akhir proses pengujian

testRunFailed

public final void testRunFailed (FailureDescription failure)

Operasi pengujian 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 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 proses pengujian.

Parameter
runName String: nama uji coba

testCount int: jumlah total pengujian dalam operasi pengujian

attemptNumber int: nomor pesanan, yang mengidentifikasi berbagai upaya runName yang sama yang dijalankan beberapa kali. attemptNumber diindeks 0 dan harus bertambah setiap kali ada proses baru. Misalnya, pengujian dicoba ulang secara terperinci 3 kali, maka akan ada total 4 proses dalam runName yang sama dan attemptNumber-nya adalah dari 0 hingga 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Callback uji coba

Parameter
runName String: nama uji coba

testCount int: jumlah total pengujian dalam operasi pengujian

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Melaporkan dimulainya proses pengujian.

Parameter
runName String: nama uji coba

testCount int: jumlah total pengujian dalam operasi pengujian

attemptNumber int: nomor pesanan, yang mengidentifikasi berbagai upaya runName yang sama yang dijalankan beberapa kali. attemptNumber diindeks 0 dan harus bertambah setiap kali ada run baru. Misalnya, pengujian dicoba ulang secara terperinci 3 kali, maka akan ada total 4 run dengan runName yang sama dan attemptNumber dari 0 hingga 3.

startTime long: waktu mulai eksekusi, 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: waktu berlalu yang dilaporkan perangkat, dalam milidetik

testSkipped

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 lagi untuk mendapatkan eksekusi yang tepat.

Parameter
test TestDescription: mengidentifikasi pengujian

reason SkipReason: SkipReason

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

Alternatif untuk testStarted(TestDescription) yang juga menentukan kapan pengujian dimulai, dikombinasikan dengan testEnded(TestDescription,long,Map) untuk pengukuran yang akurat.

Parameter
test TestDescription: mengidentifikasi pengujian

startTime long: waktu dimulainya pengujian, 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 disetel ke jenis yang diproses.

Hasil
MetricMeasurement.DataType

getRunName

protected String getRunName ()

Hasil
String

getStackTrace

protected final String getStackTrace ()

Hasil
String

isTestFailed

protected final boolean isTestFailed ()

Hasil
boolean