Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Halaman ini diterjemahkan oleh Cloud Translation API.

{i>BasePostProcessor<i}

public abstract class BasePostProcessor
extends Object implements IPostProcessor

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

Subclass langsung yang dikenal

AggregatePostProcessor, AveragePostProcessor, BluetoothConnectionSuccessRatePostProcessor, MetricFilePostProcessor, PerfettoGenericPostProcessor, StatsdGenericPostProcessor

AggregatePostProcessor	Agregator metrik yang memberikan nilai minimum, maksimum, rata-rata, varians, simpangan baku, total, jumlah, dan persentil opsional untuk metrik numerik yang dikumpulkan selama pengujian multi-iterasi, memperlakukan mereka sebagai {i>double<i}.
AveragePostProcessor	Implementasi pascapemroses yang menghitung rata-rata daftar metrik.
BluetoothConnectionSuccessRatePostProcessor	Implementasi postprocessor yang menghitung tingkat keberhasilan untuk profil Bluetooth Menggunakan "pencocokan kunci metrik" untuk menentukan metrik yang berisi status koneksi Bluetooth dalam angka Contoh himpunan [0, 1, 2, 3, 0, 1, 2, 3].
MetricFilePostProcessor	Digunakan untuk mengupload file log metrik yang dikumpulkan selama tingkat pengujian dan pengoperasian.
PerfettoGenericPostProcessor	Pemroses postingan yang memproses file proto perfetto metrik biner/teks menjadi pasangan nilai kunci dengan secara rekursif memperluas pesan proto dan kolom dengan nilai string hingga kolom dengan ditemukan nilai numerik.
StatsdGenericPostProcessor	Pemroses postingan yang memproses laporan statistik proto biner menjadi pasangan nilai kunci dengan memperluas sebagai struktur pohon.

Subclass tidak langsung yang umum

StatsdBeforeAfterGaugeMetricPostProcessor, StatsdEventMetricPostProcessor

StatsdBeforeAfterGaugeMetricPostProcessor	Pemroses postingan yang memproses metrik yang dikumpulkan di "sebelum/sesudah" pendekatan, yaitu
StatsdEventMetricPostProcessor	Pemroses postingan yang memproses metrik peristiwa dalam laporan statistik menjadi pasangan nilai kunci, menggunakan pemformat yang ditentukan pada prosesor.

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 `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` langsung callback tidak mungkin dilakukan. Memperbarui pengaitan log-ke-pengujian.
	`processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)` Implementasikan metode ini untuk menggabungkan metrik dan log di semua pengujian.
`abstract`	`processRunMetricsAndLogs( rawMetrics, runLogs)` Terapkan metode ini untuk menghasilkan kumpulan metrik baru dari metrik yang ada dan log.
	`processTestMetricsAndLogs(TestDescription testDescription, testMetrics, testLogs)` Terapkan metode ini untuk memposting metrik dan log proses dari setiap pengujian.
`final void`	`setLogSaver(ILogSaver logSaver)` Setel `ILogSaver` untuk mengizinkan pengimplementasi menyimpan file.
`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, testMetrics)` Alternatif untuk `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` yang memungkinkan kita menentukan waktu berakhir secara langsung.
`final void`	`testEnded(TestDescription test, testMetrics)` 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, runMetrics)` Melaporkan berakhirnya uji coba.
`final void`	`testRunFailed(FailureDescription failure)` Melaporkan pengujian yang gagal diselesaikan karena kegagalan yang dijelaskan oleh `FailureDescription`.
`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 `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.
`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

public  processAllTestMetricsAndLogs (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 abstract  processRunMetricsAndLogs ( 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

public  processTestMetricsAndLogs (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`