BasePostProcessor
public
abstract
class
BasePostProcessor
extends Object
implements
IPostProcessor
java.lang.Object | |
🎃 | com.android.tradefed.postprocessor.BasePostProcessor |
Her uygulamanın genişletilmesi gereken IPostProcessor
temel. Son işleme yöntemlerinin, nihai sonuç raporlayıcılarından önce çağrıldığından emin olun.
Özet
Kamu inşaatçıları | |
---|---|
BasePostProcessor()
|
Herkese açık 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ıyla 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)
Bir hata durumu nedeniyle tamamlanmamış bir çağrıyı bildirir. |
void
|
invocationSkipped(SkipReason reason)
Çağrıyı atlandı olarak bildirir. |
final
void
|
invocationStarted(IInvocationContext context)
Yönlendirme için Çağrı İşleyicileri |
final
boolean
|
isDisabled()
Nesnenin tamamı devre dışı bırakılırsa Doğru değerini döndürür (hem kurulum hem de sökme işlemlerini atlayın). |
final
void
|
logAssociation(String dataName, LogFile logFile)
Bazı durumlarda günlük, test durumları ile güçlü bir şekilde ilişkilendirilmelidir ancak doğrudan Günlüğe kaydetme ile test ilişkilendirmesini günceller. |
|
processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics,
Tüm testlerde metrikleri ve günlükleri birleştirmek için bu yöntemi uygulayın. |
abstract
|
processRunMetricsAndLogs(
Mevcut metriklerden ve günlüklerden yeni metrik grubu oluşturmak için bu yöntemi uygulayın. |
|
processTestMetricsAndLogs(TestDescription testDescription,
Her testten elde edilen metrikleri ve günlükleri son işleme tabi tutmak için bu yöntemi uygulayın. |
final
void
|
setLogSaver(ILogSaver logSaver)
|
void
|
setUp()
Test çalıştırılmadan önce başlatmak için alt son işlemcilerde bu yöntemi geçersiz kılın. |
final
void
|
testAssumptionFailure(TestDescription test, String trace)
Atom testi, yanlış bir koşul olduğunu varsaydığını gösterdiğinde çağrılır |
final
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Bir atomik test, yanlış bir koşulu varsaydığını işaretlediğinde çağrılır |
final
void
|
testEnded(TestDescription test, long endTime,
Bitiş zamanını doğrudan belirtebildiğimiz |
final
void
|
testEnded(TestDescription test,
Tek bir test durumunun yürütme sonunu bildirir. |
final
void
|
testFailed(TestDescription test, FailureDescription failure)
Tek bir test durumunun başarısız olduğunu bildirir. |
final
void
|
testFailed(TestDescription test, String trace)
Tek bir test durumunun başarısız olduğunu bildirir. |
final
void
|
testIgnored(TestDescription test)
Genellikle bir test yönteminde org.junit.Yoksay. |
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ışmakta olan bir modülün başlangıcını bildirir. |
final
void
|
testRunEnded(long elapsedTime,
Test çalıştırmasının sonunu bildirir. |
final
void
|
testRunFailed(FailureDescription failure)
|
final
void
|
testRunFailed(String errorMessage)
Raporlar test çalışması, önemli bir hata nedeniyle 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 çağırmaları |
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)
Rapor testi çalıştırması, bir kullanıcı isteği nedeniyle tamamlanmadan önce durduruldu. |
final
void
|
testSkipped(TestDescription test, SkipReason reason)
Bir test atlandığında ve genellikle beklenmeyen bir nedenden dolayı yürütülmediğinde çağrılır. |
final
void
|
testStarted(TestDescription test, long startTime)
Doğru ölçüm için |
final
void
|
testStarted(TestDescription test)
Test durumları geri çağırmaları |
Korunan yöntemler | |
---|---|
void
|
cleanUp()
|
MetricMeasurement.DataType
|
getMetricType()
Gerekirse metrik türünü değiştirmek için bu yöntemi geçersiz kılın. |
String
|
getRunName()
|
Herkese açık kurucular
Anaİşlemci
public BasePostProcessor ()
Herkese açık yöntemler
başlat
public final ITestInvocationListener init (ITestInvocationListener listener)
Son işlemcinin başlatma adımı. Test geri çağırmalarından önce çağrılacağından emin olun.
Parametreler | |
---|---|
listener |
ITestInvocationListener |
İlerlemeler | |
---|---|
ITestInvocationListener |
çağrı Sona erdi
public final void invocationEnded (long elapsedTime)
Çağrının başarılı bir şekilde veya bir hata nedeniyle sonlandırıldığını bildirir koşul alır.
TradeFederation çerçevesi tarafından otomatik olarak çağrılacaktır.
Parametreler | |
---|---|
elapsedTime |
long : Çağrının geçtiği süre (ms.) |
çağrı başarısız oldu
public final void invocationFailed (FailureDescription failure)
Bir hata durumu nedeniyle tamamlanmamış bir çağrıyı bildirir.
TradeFederation çerçevesi tarafından otomatik olarak çağrılır.
Parametreler | |
---|---|
failure |
FailureDescription : Hatanın nedenini açıklayan FailureDescription |
çağrı başarısız oldu
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 : Hatanın Throwable nedeni |
çağrıAtlandı
public void invocationSkipped (SkipReason reason)
Çağrıyı atlandı olarak bildirir.
Parametreler | |
---|---|
reason |
SkipReason |
çağrı Başlatıldı
public final void invocationStarted (IInvocationContext context)
Yönlendirme için Çağrı İşleyicileri
Parametreler | |
---|---|
context |
IInvocationContext : çağrıyla ilgili bilgiler |
devre dışı
public final boolean isDisabled ()
Nesnenin tamamı devre dışı bırakılırsa Doğru değerini döndürür (hem kurulum hem de sökme işlemlerini atlayın). Aksi takdirde False (yanlış) değerini alır.
İlerlemeler | |
---|---|
boolean |
logAssociation
public final void logAssociation (String dataName, LogFile logFile)
Bazı durumlarda günlük, test durumları ile güçlü bir şekilde ilişkilendirilmelidir ancak doğrudan testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
geri çağırma işleminde bunu yapma olanağı yoktur. Bu nedenle, bu geri çağırma, açıkça güçlü bir ilişkilendirme sağlamanıza olanak tanır.
Günlüğe kaydetme ile test ilişkilendirmesini günceller. Bu yöntem bir test sırasında çağrılırsa günlük teste aittir. Aksi takdirde bir çalıştırma günlüğü olur.
Parametreler | |
---|---|
dataName |
String : Verilerin adı |
logFile |
LogFile : Önceden günlüğe kaydedilen veLogFile
test durumu. |
processAllTestMetricsAndLogs
publicprocessAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)
Tüm testlerdeki metrikleri ve günlükleri toplamak için bu yöntemi uygulayın. Metrikler bu yöntem çalıştırma metrikleri olarak raporlayıcı olur. Yalnızca yeni oluşturulan metrikler benzersiz anahtar adıyla döndürülmelidir (mevcut anahtarlarla çakışmaya izin verilmez).
Parametreler | |
---|---|
allTestMetrics |
ListMultimap : Her testteki metrikleri metrik adlarına göre gruplandırarak saklayan bir HashMultimap. |
allTestLogs |
: Her testin, veri adları ile girilen günlük dosyaları haritasını saklayan bir harita,
her testin TestDescription özelliğini anahtar olarak kullanın. |
İlerlemeler | |
---|---|
|
Tüm test metriklerinden yeni oluşturulan metrik grubu. |
transactionRunMetricsAndLogs
public abstractprocessRunMetricsAndLogs ( rawMetrics, runLogs)
Mevcut metriklerden ve günlüklerden yeni metrik grubu oluşturmak için bu yöntemi uygulayın. Yalnızca yeni oluşturulan metrikler, benzersiz anahtar adıyla ( mevcut anahtarlarla çakışmaya izin verilir).
Parametreler | |
---|---|
rawMetrics |
: Çalıştırma için kullanılabilen ham metrik grubu. |
runLogs |
: Test çalıştırması için günlük dosyaları grubu. |
İlerlemeler | |
---|---|
|
Çalıştırma metriklerinden yeni oluşturulan metrik grubu. |
işlemTestMetrikleriveGünlükler
publicprocessTestMetricsAndLogs (TestDescription testDescription, testMetrics, testLogs)
Her bir testteki işlem metriklerini ve günlüklerini yüklemek için bu yöntemi uygulayın. Yalnızca yeni oluşturulan metrikler, benzersiz anahtar adıyla (mevcut metriklerle çakışma olmadan) anahtarlarına izin verilir).
Parametreler | |
---|---|
testDescription |
TestDescription : Testi açıklayan TestDescription nesnesi. |
testMetrics |
: Testteki metrik grubu. |
testLogs |
: Test sırasında günlüğe kaydedilen dosya grubu. |
İlerlemeler | |
---|---|
|
Test metriklerinden yeni oluşturulan metrik grubu. |
setLogSaver
public final void setLogSaver (ILogSaver logSaver)
ILogSaver
değerini, uygulayıcının dosya kaydetmesine izin verecek şekilde ayarlayın.
Parametreler | |
---|---|
logSaver |
ILogSaver : ILogSaver |
setUp
public void setUp ()
Test çalıştırılmadan önce başlatılması için alt son işlemcilerde bu yöntemi geçersiz kılın.
testAssumptionFailure
public final void testAssumptionFailure (TestDescription test, String trace)
Atom testi, yanlış bir koşul olduğunu varsaydığını gösterdiğinde çağrılır
Parametreler | |
---|---|
test |
TestDescription : Testi tanımlar |
trace |
String : hatanın yığın izlemesi |
testAssumptionFailure
public final void testAssumptionFailure (TestDescription test, FailureDescription failure)
Atom testi, yanlış bir koşul olduğunu varsaydığını gösterdiğinde çağrılır
Parametreler | |
---|---|
test |
TestDescription : Testi tanımlar |
failure |
FailureDescription : Hatayı ve bağlamını açıklayan FailureDescription . |
testEnded
public final void testEnded (TestDescription test, long endTime,testMetrics)
Bitiş zamanını belirtebileceğimiz ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
alternatifi
ekleyebilirsiniz. Doğru ölçüm için testStarted(com.android.tradefed.result.TestDescription, long)
ile birlikte kullanın.
Parametreler | |
---|---|
test |
TestDescription : Testi tanımlar |
endTime |
long : testin sona erdiği zaman. System.currentTimeMillis() ile ölçülür. |
testMetrics |
: yayınlanan metriklerin ERROR(/Map) kadarı |
testSona Erdi
public final void testEnded (TestDescription test,testMetrics)
Tek bir testin yürütülmesinin sonunu bildirir.
testFailed(TestDescription, FailureDescription)
çağrılmazsa bu test başarılı oldu. Ayrıca, herhangi bir anahtar/değer çiftini de döndürür
test durumu yürütülürken yayınlanmış olabilecek metrikler.
Parametreler | |
---|---|
test |
TestDescription : Testi tanımlar |
testMetrics |
: Yayınlanan metriklerin ERROR(/Map) |
testFailed
public final void testFailed (TestDescription test, FailureDescription failure)
Tek bir test durumunun başarısız olduğunu bildirir.
testStarted ve testEnded arasında çağrılacak.
Parametreler | |
---|---|
test |
TestDescription : Testi tanımlar |
failure |
FailureDescription : FailureDescription hatayı ve bağlamını açıklayan. |
testFailed
public final void testFailed (TestDescription test, String trace)
Tek bir test durumunun başarısız olduğunu bildirir.
testStarted ve testEnded arasında çağrılacak.
Parametreler | |
---|---|
test |
TestDescription : Testi tanımlar |
trace |
String : Hatanın yığın izlemesi |
testIgnored
public final void testIgnored (TestDescription test)
Genellikle bir test yöntemi org.junit.Ignore ile eklendiği için bir test çalıştırılmadığında çağrılır.
Parametreler | |
---|---|
test |
TestDescription : Testi tanımlar |
testLog
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 String açıklayıcı adı. ör. "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 öğesi. Uygulamacılar, verileri okumaya başlamak için createInputStream'i çağırmalı ve işlem tamamlandığında ortaya çıkan InputStream'i kapatmalıdır. Arayanlar, testLog yöntemi tamamlanana kadar verilerin kaynağının mevcut ve erişilebilir olduğundan emin olmalıdır. |
testLogKaydedildi
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 String açıklayıcı adı. Ör. "device_logcat". Not
dataName her çağrı için benzersiz olmayabilir. Örneğin, uygulayıcılar;
aynı dataName'e sahip birden fazla çağrı |
dataType |
LogDataType : verilerin LogDataType değeri |
dataStream |
InputStreamSource : Verilerin InputStreamSource . Uygulayıcıların çağırabileceği
createInputStream'i etkinleştirin ve verileri okumaya başlayın ve sonuç olarak
Tamamlandığında giriş akışı. |
logFile |
LogFile : kaydedilen dosyanın meta verilerini içeren LogFile . |
testModuleEnded
public final void testModuleEnded ()
Bir modül çalıştırmasının sonunu bildirir.
testModülü Başlatıldı
public final void testModuleStarted (IInvocationContext moduleContext)
Çalışmakta olan bir modülün başlangıcını bildirir. Bu geri çağırma, testModuleEnded()
ile ilişkilidir ve dizede isteğe bağlıdır. Yalnızca
modüller: paket tabanlı koşucular.
Parametreler | |
---|---|
moduleContext |
IInvocationContext : modülün IInvocationContext bölümü. |
testRunSona Erdi
public final void testRunEnded (long elapsedTime,runMetrics)
Test çalıştırmasının sonunu bildirir.
Parametreler | |
---|---|
elapsedTime |
long : cihaz bildirilen geçen süre (milisaniye cinsinden) |
runMetrics |
: Test çalıştırmasının sonunda bildirilen anahtar/değer çiftleri |
testRunBaşarısız
public final void testRunFailed (FailureDescription failure)
Raporlar test çalıştırması, FailureDescription
tarafından açıklanan bir hata nedeniyle tamamlanamadı.
Parametreler | |
---|---|
failure |
FailureDescription : Hatayı ve bağlamını açıklayan FailureDescription . |
testRunBaşarısız
public final void testRunFailed (String errorMessage)
Önemli bir hata nedeniyle rapor testi çalıştırma işlemi tamamlanamadı.
Parametreler | |
---|---|
errorMessage |
String : Çalıştırma hatasının nedenini açıklayan String . |
testRunStarted
public final void testRunStarted (String runName, int testCount, int attemptNumber)
Test çalıştırmasının başlangıcını bildirir.
Parametreler | |
---|---|
runName |
String : Test çalıştırması adı |
testCount |
int : test çalıştırmasında toplam test sayısı |
attemptNumber |
int : Aynı runName değerinin birden fazla kez çalıştırıldığı farklı denemelerin sırasını belirten sipariş numarası. attemptNumber, 0 tabanlı bir dizin olup her yeni çalıştırma işleminde artar. Örneğin, bir test ayrıntılı olarak 3 kez yeniden denenirse aynı runName altında toplam 4 çalıştırma işlemi olur ve attemptNumber 0 ile 3 arasında bir değer alır. |
testRunBaşlatıldı
public final void testRunStarted (String runName, int testCount)
Test çalıştırması geri çağırmaları
Parametreler | |
---|---|
runName |
String : Test çalıştırması adı |
testCount |
int : Test çalıştırmasındaki toplam test sayısı |
testRunBaşlatıldı
public final void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Test çalıştırmasının başlangıcını bildirir.
Parametreler | |
---|---|
runName |
String : Test çalıştırması adı |
testCount |
int : test çalıştırmasında toplam test sayısı |
attemptNumber |
int : aynı runName'in farklı denemelerini tanımlayan sipariş numarası
birçok çalışma var. attemptNumber, 0 tabanlı bir dizin olup her yeni çalıştırma işleminde artar. Örneğin, ayrıntılı olarak 3 kez yeniden denenen bir testin aynı runName altında toplam 4 çalıştırması olur ve attemptNumber 0 ile 3 arasında bir değer alır. |
startTime |
long : System.currentTimeMillis() aracılığıyla ölçülen, çalışmanın başladığı zaman |
testRunStopped
public final void testRunStopped (long elapsedTime)
Raporlar test çalışması, kullanıcı isteği nedeniyle tamamlanmadan önce durduruldu.
TODO: currently unused, consider removing
Parametreler | |
---|---|
elapsedTime |
long : cihaz bildirilen geçen süre (milisaniye cinsinden) |
testAtlandı
public final void testSkipped (TestDescription test, SkipReason reason)
Bir test atlandığında ve genellikle beklenmeyen bir nedenle yürütülmediğinde çağrılır. Doğru bir yürütme elde etmek için bu testlerin yeniden denenmesi denenir.
Parametreler | |
---|---|
test |
TestDescription : Testi tanımlar |
reason |
SkipReason : SkipReason |
test başlatıldı
public final void testStarted (TestDescription test, long startTime)
Doğru ölçüm için ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
ile birlikte kullanıldığında, testin ne zaman başlatıldığını da belirttiğimiz testStarted(com.android.tradefed.result.TestDescription)
'e alternatiftir.
Parametreler | |
---|---|
test |
TestDescription : Testi tanımlar |
startTime |
long : testin başladığı zaman (System.currentTimeMillis() ile ölçülür) |
testStarted
public final void testStarted (TestDescription test)
Test durumları geri çağırmaları
Parametreler | |
---|---|
test |
TestDescription : Testi tanımlar |
Korunan yöntemler
temizleme
protected void cleanUp ()
getMetricType
protected MetricMeasurement.DataType getMetricType ()
Gerekirse metrik türünü değiştirmek için bu yöntemi geçersiz kılın. Metrik varsayılan olarak işlenmiş türü.
İlerlemeler | |
---|---|
MetricMeasurement.DataType |
getRunName
protected String getRunName ()
İlerlemeler | |
---|---|
String |