BasePostİşlemci
public abstract class BasePostProcessor
extends Object
implements IPostProcessor
java.lang.Nesne | |
↳ | com.android.tradefed.postprocessor.BasePostProcessor |
Her uygulamanın genişletmesi gereken temel IPostProcessor
. İşlem sonrası yöntemlerin nihai sonuç raportörlerinden önce çağrıldığından emin olun.
Özet
Kamu inşaatçıları | |
---|---|
BasePostProcessor () |
Genel yöntemler | |
---|---|
final ITestInvocationListener | init ( ITestInvocationListener listener) Son işlemcinin başlatma adımı. |
final void | invocationEnded (long elapsedTime) Çağrının başarılı bir şekilde veya bir hata durumu nedeniyle sonlandırıldığını bildirir. |
final void | invocationFailed ( FailureDescription failure) Bazı hata koşulları nedeniyle tamamlanmamış bir çağrı bildirir. |
final void | invocationFailed (Throwable cause) Bazı hata koşulları nedeniyle tamamlanmamış bir çağrı bildirir. |
final void | invocationStarted ( IInvocationContext context) Yönlendirme için Çağrı Dinleyicileri |
final boolean | isDisabled () Tüm nesne devre dışı bırakılmışsa True döndürür (hem kurulumu hem de sökmeyi atlayın). |
final void | logAssociation (String dataName, LogFile logFile) Bazı durumlarda, günlüğün bir test senaryosu ile güçlü bir şekilde ilişkilendirilmesi gerekir, ancak bunu doğrudan Günlük-test ilişkisini günceller. |
processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs) processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs) Tüm testlerde ölçümleri ve günlükleri toplamak için bu yöntemi uygulayın. | |
abstract | processRunMetricsAndLogs ( rawMetrics, runLogs) processRunMetricsAndLogs ( rawMetrics, runLogs) processRunMetricsAndLogs ( rawMetrics, runLogs) Mevcut metriklerden ve günlüklerden bir dizi yeni metrik oluşturmak için bu yöntemi uygulayın. |
processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs) processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs) processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs) Her testten süreç ölçümlerini ve günlüklerini göndermek için bu yöntemi uygulayın. | |
final void | setLogSaver ( ILogSaver logSaver) |
void | setUp () Test çalıştırmadan önce başlatmak için alt işlemcilerde bu yöntemi geçersiz kılın. |
final void | testAssumptionFailure ( TestDescription test, String trace) Bir atomik test, yanlış olan bir koşulu üstlendiğini işaretlediğinde çağrılır. |
final void | testAssumptionFailure ( TestDescription test, FailureDescription failure) Bir atomik test, yanlış olan bir koşulu üstlendiğini işaretlediğinde çağrılır. |
final void | testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) Bitiş zamanını doğrudan belirleyebileceğimiz |
final void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Tek bir test senaryosunun yürütme sonunu bildirir. |
final void | testFailed ( TestDescription test, FailureDescription failure) Tek bir test senaryosunun başarısızlığını bildirir. |
final void | testFailed ( TestDescription test, String trace) Tek bir test senaryosunun başarısızlığını bildirir. |
final void | testIgnored ( TestDescription test) Genellikle bir test yöntemine org.junit.Ignore ile açıklama eklendiğinden, bir test çalıştırılmayacaksa çağrılır. |
final void | testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) PostProcessor uygulamasından bir dosyayı günlüğe kaydetmek için bu yöntemi kullanın. |
final void | testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) Test günlüğü kaydedildiğinde çağrılır. |
final void | testModuleEnded () Bir modül çalıştırmasının sonunu bildirir. |
final void | testModuleStarted ( IInvocationContext moduleContext) Çalışan bir modülün başlangıcını bildirir. |
final void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) Test çalıştırmasının sonunu bildirir. |
final void | testRunFailed ( FailureDescription failure) Hata Açıklaması tarafından |
final void | testRunFailed (String errorMessage) Önemli bir hata nedeniyle rapor testi çalıştırması tamamlanamadı. |
final void | testRunStarted (String runName, int testCount, int attemptNumber) Bir test çalıştırmasının başladığını bildirir. |
final void | testRunStarted (String runName, int testCount) Test çalıştırması geri aramaları |
final void | testRunStarted (String runName, int testCount, int attemptNumber, long startTime) Bir test çalıştırmasının başladığını bildirir. |
final void | testRunStopped (long elapsedTime) Bir kullanıcı isteği nedeniyle test çalıştırmasının tamamlanmadan önce durdurulduğunu bildirir. |
final void | testStarted ( TestDescription test, long startTime) Testin ne zaman başladığını da belirttiğimiz |
final void | testStarted ( TestDescription test) Geri aramaları test edin |
Korumalı yöntemler | |
---|---|
MetricMeasurement.DataType | getMetricType () Gerekirse metrik türünü değiştirmek için bu yöntemi geçersiz kılın. |
String | getRunName () |
Kamu inşaatçıları
BasePostİşlemci
public BasePostProcessor ()
Genel yöntemler
içinde
public final ITestInvocationListener init (ITestInvocationListener listener)
Son işlemcinin başlatma adımı. Herhangi bir test geri aramasından önce aranması sağlanır.
parametreler | |
---|---|
listener | ITestInvocationListener |
İadeler | |
---|---|
ITestInvocationListener |
çağrı Bitirildi
public final void invocationEnded (long elapsedTime)
Çağrının başarılı bir şekilde veya bir hata durumu nedeniyle sonlandırıldığını bildirir.
TradeFederation çerçevesi tarafından otomatik olarak çağrılır.parametreler | |
---|---|
elapsedTime | long : çağrının ms cinsinden geçen süresi |
çağırmaBaşarısız
public final void invocationFailed (FailureDescription failure)
Bazı hata koşulları nedeniyle tamamlanmamış bir çağrı bildirir.
TradeFederation çerçevesi tarafından otomatik olarak çağrılır.
parametreler | |
---|---|
failure | FailureDescription : Arızanın nedenini açıklayan FailureDescription |
çağırmaBaşarısız
public final void invocationFailed (Throwable cause)
Bazı hata koşulları nedeniyle tamamlanmamış bir çağrı bildirir.
TradeFederation çerçevesi tarafından otomatik olarak çağrılır.parametreler | |
---|---|
cause | Throwable : Throwable nedeni |
çağrıBaşlatıldı
public final void invocationStarted (IInvocationContext context)
Yönlendirme için Çağrı Dinleyicileri
parametreler | |
---|---|
context | IInvocationContext : çağırma hakkında bilgi |
Devre Dışı
public final boolean isDisabled ()
Tüm nesne devre dışı bırakılmışsa True döndürür (hem kurulumu hem de sökmeyi atlayın). Aksi takdirde yanlış.
İadeler | |
---|---|
boolean |
logAssociation
public final void logAssociation (String dataName, LogFile logFile)
Bazı durumlarda, günlüğün bir test senaryosu ile güçlü bir şekilde ilişkilendirilmesi gerekir, ancak bunu doğrudan testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
üzerinde yapma fırsatı testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
geri arama mümkün değildir. Böylece, bu geri arama, açık bir şekilde güçlü bir ilişki sağlamaya izin verir.
Günlük-test ilişkisini günceller. Bir test sırasında bu yöntem çağrılırsa, log teste aittir; aksi takdirde bir çalıştırma günlüğü olacaktır.
parametreler | |
---|---|
dataName | String : Verinin adı |
logFile | LogFile : Daha önce günlüğe kaydedilen ve test senaryosu ile ilişkilendirilmesi gereken LogFile . |
processAllTestMetricsAndLogs
publicprocessAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)
Tüm testlerde ölçümleri ve günlükleri toplamak için bu yöntemi uygulayın. Bu yöntemden çıkan metrikler, çalıştırma metrikleri olarak raporlayıcı olacaktır. Yalnızca yeni oluşturulan metrikler ve benzersiz anahtar adıyla döndürülmelidir (mevcut anahtarlarla çarpışmaya izin verilmez).
parametreler | |
---|---|
allTestMetrics | ListMultimap : Her testten alınan metrikleri metrik adlarına göre gruplandıran bir HashMultimap. |
allTestLogs | TestDescription kullanılarak, veri adlarıyla anahtarlanmış günlük dosyalarının haritasını saklayan bir harita. |
İadeler | |
---|---|
Tüm test metriklerinden yeni oluşturulan metrikler kümesi. |
processRunMetricsAndLogs
public abstractprocessRunMetricsAndLogs ( rawMetrics, runLogs)
Mevcut metriklerden ve günlüklerden bir dizi yeni metrik oluşturmak için bu yöntemi uygulayın. Yalnızca yeni oluşturulan metrikler ve benzersiz anahtar adıyla döndürülmelidir (mevcut anahtarlarla çarpışmaya izin verilmez).
parametreler | |
---|---|
rawMetrics | |
runLogs |
İadeler | |
---|---|
Çalıştırma metriklerinden yeni oluşturulan metrikler kümesi. |
processTestMetricsAndLogs
publicprocessTestMetricsAndLogs (TestDescription testDescription, testMetrics, testLogs)
Her testten süreç ölçümlerini ve günlüklerini göndermek için bu yöntemi uygulayın. Yalnızca yeni oluşturulan metrikler ve benzersiz anahtar adıyla döndürülmelidir (mevcut anahtarlarla çarpışmaya izin verilmez).
parametreler | |
---|---|
testDescription | TestDescription : Testi açıklayan TestDescription nesnesi. |
testMetrics | |
testLogs |
İadeler | |
---|---|
Test metriklerinden yeni oluşturulan metrikler kümesi. |
setLogSaver
public final void setLogSaver (ILogSaver logSaver)
ILogSaver
, uygulayıcının dosyaları kaydetmesine izin verecek şekilde ayarlayın.
parametreler | |
---|---|
logSaver | ILogSaver : ILogSaver |
kurmak
public void setUp ()
Test çalıştırmadan önce başlatmak için alt işlemcilerde bu yöntemi geçersiz kılın.
testVarsayımFailure
public final void testAssumptionFailure (TestDescription test, String trace)
Bir atomik test, yanlış olan bir koşulu üstlendiğini işaretlediğinde çağrılır.
parametreler | |
---|---|
test | TestDescription : testi tanımlar |
trace | String : başarısızlık yığın izi |
testVarsayımFailure
public final void testAssumptionFailure (TestDescription test, FailureDescription failure)
Bir atomik test, yanlış olan bir koşulu üstlendiğini işaretlediğinde çağrılır.
parametreler | |
---|---|
test | TestDescription : testi tanımlar |
failure | FailureDescription : Arızayı ve bağlamını açıklayan FailureDescription . |
testBitti
public final void testEnded (TestDescription test, long endTime,testMetrics)
Bitiş zamanını doğrudan belirleyebileceğimiz ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
alternatif. Doğru ölçüm için testStarted(com.android.tradefed.result.TestDescription, long)
ile birleştirin.
parametreler | |
---|---|
test | TestDescription : testi tanımlar |
endTime | long : System.currentTimeMillis() aracılığıyla ölçülen testin sona erdiği süre |
testMetrics | ERROR(/Map) |
testBitti
public final void testEnded (TestDescription test,testMetrics)
Tek bir test senaryosunun yürütme sonunu bildirir.
testFailed(TestDescription, FailureDescription)
çağrılmamışsa, bu test başarılı olmuştur. Ayrıca, test senaryosunun yürütülmesi sırasında yayılmış olabilecek tüm anahtar/değer ölçümlerini döndürür.
parametreler | |
---|---|
test | TestDescription : testi tanımlar |
testMetrics | ERROR(/Map) |
test başarısız
public final void testFailed (TestDescription test, FailureDescription failure)
Tek bir test senaryosunun başarısızlığını bildirir.
testStarted ve testEnded arasında çağrılır.
parametreler | |
---|---|
test | TestDescription : testi tanımlar |
failure | FailureDescription : Arızayı ve bağlamını açıklayan FailureDescription . |
test başarısız
public final void testFailed (TestDescription test, String trace)
Tek bir test senaryosunun başarısızlığını bildirir.
testStarted ve testEnded arasında çağrılır.
parametreler | |
---|---|
test | TestDescription : testi tanımlar |
trace | String : başarısızlık yığın izi |
testYoksayıldı
public final void testIgnored (TestDescription test)
Genellikle bir test yöntemine org.junit.Ignore ile açıklama eklendiğinden, bir test çalıştırılmayacaksa çağrılır.
parametreler | |
---|---|
test | TestDescription : testi tanımlar |
test günlüğü
public final void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
PostProcessor uygulamasından bir dosyayı günlüğe kaydetmek için bu yöntemi kullanın.
parametreler | |
---|---|
dataName | String : Verilerin bir String açıklayıcı adı. örneğin "device_logcat". Not dataName, çağrı başına benzersiz olmayabilir. yani uygulayıcılar aynı dataName ile birden fazla çağrıyı işleyebilmelidir |
dataType | LogDataType : verilerin LogDataType |
dataStream | InputStreamSource : verilerin InputStreamSource . Uygulayıcılar, verileri okumaya başlamak için createInputStream'i çağırmalı ve tamamlandığında InputStream'in kapatıldığından emin olmalıdır. Arayanlar, testLog yöntemi tamamlanana kadar veri kaynağının mevcut ve erişilebilir kalmasını sağlamalıdır. |
testGünlüğüKaydedildi
public final void testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
Test günlüğü kaydedildiğinde çağrılır.
ITestInvocationListener#testLog(String, LogDataType, InputStreamSource)
yerine kullanılmalıdır.
parametreler | |
---|---|
dataName | String : Verilerin bir String açıklayıcı adı. örneğin "device_logcat". Not dataName, çağrı başına benzersiz olmayabilir. yani uygulayıcılar aynı dataName ile birden fazla çağrıyı işleyebilmelidir |
dataType | LogDataType : verilerin LogDataType |
dataStream | InputStreamSource : verilerin InputStreamSource . Uygulayıcılar, verileri okumaya başlamak için createInputStream'i çağırmalı ve tamamlandığında InputStream'in kapatıldığından emin olmalıdır. |
logFile | LogFile : Kaydedilen dosyanın meta verilerini içeren LogFile . |
testModuleBitti
public final void testModuleEnded ()
Bir modül çalıştırmasının sonunu bildirir.
testModuleBaşladı
public final void testModuleStarted (IInvocationContext moduleContext)
Çalışan bir modülün başlangıcını bildirir. Bu geri arama, testModuleEnded()
ile ilişkilendirilir ve sırayla isteğe bağlıdır. Yalnızca modülleri kullanan bir koşu sırasında kullanılır: süit tabanlı koşucular.
parametreler | |
---|---|
moduleContext | IInvocationContext : modülün IInvocationContext . |
testRunBitti
public final void testRunEnded (long elapsedTime,runMetrics)
Test çalıştırmasının sonunu bildirir. DÜZELTME: Farklı tipte iki Map<> arayüzümüz olamaz, bu yüzden burada HashMap kullanmamız gerekiyor.
parametreler | |
---|---|
elapsedTime | long : cihaz geçen süreyi milisaniye cinsinden bildirdi |
runMetrics | Metric ile yapılan bir test çalıştırmasının sonunda rapor edilen anahtar/değer çiftleri. |
testRunFailed
public final void testRunFailed (FailureDescription failure)
Hata Açıklaması tarafından FailureDescription
bir hata nedeniyle test çalıştırması tamamlanamadı.
parametreler | |
---|---|
failure | FailureDescription : Arızayı ve bağlamını açıklayan FailureDescription . |
testRunFailed
public final void testRunFailed (String errorMessage)
Önemli bir hata nedeniyle rapor testi çalıştırması tamamlanamadı.
parametreler | |
---|---|
errorMessage | String : Çalıştırma hatasının nedenini açıklayan String . |
testÇalıştırıldı
public final void testRunStarted (String runName, int testCount, int attemptNumber)
Bir test çalıştırmasının başladığını bildirir.
parametreler | |
---|---|
runName | String : test çalıştırması adı |
testCount | int : test çalıştırmasındaki toplam test sayısı |
attemptNumber | int : aynı runName'in birden çok kez çalıştırılan farklı denemelerini tanımlayan sipariş numarası. tryNumber 0 dizinlidir ve her yeni çalıştırma gerçekleştiğinde artmalıdır. örneğin, bir test ayrıntılı olarak 3 kez yeniden denenir, aynı runName altında toplam 4 çalıştırmaya sahip olmalıdır ve trialNumber 0 ile 3 arasında olmalıdır. |
testÇalıştırıldı
public final void testRunStarted (String runName, int testCount)
Test çalıştırması geri aramaları
parametreler | |
---|---|
runName | String : test çalıştırması adı |
testCount | int : test çalıştırmasındaki toplam test sayısı |
testÇalıştırıldı
public final void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Bir test çalıştırmasının başladığını bildirir.
parametreler | |
---|---|
runName | String : test çalıştırması adı |
testCount | int : test çalıştırmasındaki toplam test sayısı |
attemptNumber | int : aynı runName'in birden çok kez çalıştırılan farklı denemelerini tanımlayan sipariş numarası. tryNumber 0 dizinlidir ve her yeni çalıştırma gerçekleştiğinde artmalıdır. örneğin, bir test ayrıntılı olarak 3 kez yeniden denenir, aynı runName altında toplam 4 çalıştırmaya sahip olmalıdır ve trialNumber 0 ile 3 arasında olmalıdır. |
startTime | long : System.currentTimeMillis() aracılığıyla ölçülen çalıştırmanın başladığı süre |
testRunStopped
public final void testRunStopped (long elapsedTime)
Bir kullanıcı isteği nedeniyle test çalıştırmasının tamamlanmadan önce durdurulduğunu bildirir.
YAPILACAKLAR: şu anda kullanılmıyor, kaldırmayı düşünün
parametreler | |
---|---|
elapsedTime | long : cihaz geçen süreyi milisaniye cinsinden bildirdi |
testBaşladı
public final void testStarted (TestDescription test, long startTime)
Testin ne zaman başladığını da belirttiğimiz testStarted(com.android.tradefed.result.TestDescription)
alternatifi, doğru ölçüm için ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
ile birlikte .
parametreler | |
---|---|
test | TestDescription : testi tanımlar |
startTime | long : System.currentTimeMillis() aracılığıyla ölçülen testin başladığı zaman |
testBaşladı
public final void testStarted (TestDescription test)
Geri aramaları test edin
parametreler | |
---|---|
test | TestDescription : testi tanımlar |
Korumalı yöntemler
getMetricType
protected MetricMeasurement.DataType getMetricType ()
Gerekirse metrik türünü değiştirmek için bu yöntemi geçersiz kılın. Varsayılan olarak metrik, işlenen türe ayarlanmıştır.
İadeler | |
---|---|
MetricMeasurement.DataType |
getRunName
protected String getRunName ()
İadeler | |
---|---|
String |