BazPostİşlemci
public abstract class BasePostProcessor
extends Object
implements IPostProcessor
java.lang.Object | |
↳ | com.android.tradefed.postprocessor.BasePostProcessor |
Her uygulamanın genişletmesi gereken temel IPostProcessor
. Son işlem yöntemlerinin nihai sonuç raporlayıcılarından önce çağrıldığından emin olun.
Özet
Kamu inşaatçıları | |
---|---|
BasePostProcessor () |
Genel yöntemler | |
---|---|
final ITestInvocationListener | init ( ITestInvocationListener listener) Post işlemcinin başlatma adımı. |
final void | invocationEnded (long elapsedTime) Başarılı bir şekilde veya bazı hata durumlarından dolayı çağrının sonlandırıldığını bildirir. |
final void | invocationFailed ( FailureDescription failure) Bazı hata durumlarından dolayı tamamlanmamış bir çağrıyı bildirir. |
final void | invocationFailed (Throwable cause) Bazı hata durumlarından dolayı tamamlanmamış bir çağrıyı bildirir. |
final void | invocationStarted ( IInvocationContext context) İletim için Çağrı Dinleyicileri |
final boolean | isDisabled () Nesnenin tamamı devre dışı bırakılırsa True değerini 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 durumuyla 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 testlerdeki ö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 testin süreç ölçümlerini ve günlüklerini yayınlamak için bu yöntemi uygulayın. | |
final void | setLogSaver ( ILogSaver logSaver) Uygulayıcının dosyaları kaydetmesine izin vermek için |
void | setUp () Test çalıştırılmadan önce başlatmak için alt işlemcilerdeki bu yöntemi geçersiz kılın. |
final void | testAssumptionFailure ( TestDescription test, String trace) Bir atom testi, yanlış olan bir koşulu varsaydığını işaretlediğinde çağrılır |
final void | testAssumptionFailure ( TestDescription test, FailureDescription failure) Bir atom testi, yanlış olan bir koşulu varsaydığını 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 belirtebileceğimiz |
final void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Bireysel bir test senaryosunun yürütme sonunu bildirir. |
final void | testFailed ( TestDescription test, FailureDescription failure) Bireysel test senaryosunun başarısızlığını bildirir. |
final void | testFailed ( TestDescription test, String trace) Bireysel test senaryosunun başarısızlığını bildirir. |
final void | testIgnored ( TestDescription test) Genellikle bir test yönteminin org.junit.Ignore ile açıklanması nedeniyle bir test çalıştırılmayacağı zaman ç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) |
final void | testRunFailed (String errorMessage) Önemli bir hata nedeniyle rapor test çalıştırması tamamlanamadı. |
final void | testRunStarted (String runName, int testCount, int attemptNumber) Bir test çalıştırmasının başlangıcı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şlangıcını bildirir. |
final void | testRunStopped (long elapsedTime) Kullanıcı isteği nedeniyle rapor test çalıştırması tamamlanmadan durduruldu. |
final void | testStarted ( TestDescription test, long startTime) Testin ne zaman başladığını da belirttiğimiz |
final void | testStarted ( TestDescription test) Test senaryoları geri aramaları |
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ı
BazPostİşlemci
public BasePostProcessor ()
Genel yöntemler
içinde
public final ITestInvocationListener init (ITestInvocationListener listener)
Post işlemcinin başlatma adımı. Herhangi bir test geri aramasından önce aranması sağlandı.
Parametreler | |
---|---|
listener | ITestInvocationListener |
İadeler | |
---|---|
ITestInvocationListener |
çağırma sona erdi
public final void invocationEnded (long elapsedTime)
Başarılı bir şekilde veya bazı hata durumlarından dolayı çağrının sonlandırıldığını bildirir.
TradeFederation çerçevesi tarafından otomatik olarak çağrılacaktır.Parametreler | |
---|---|
elapsedTime | long : çağrının ms cinsinden geçen süresi |
çağrı başarısız oldu
public final void invocationFailed (FailureDescription failure)
Bazı hata durumlarından dolayı tamamlanmamış bir çağrıyı bildirir.
TradeFederation çerçevesi tarafından otomatik olarak çağrılacaktır.
Parametreler | |
---|---|
failure | FailureDescription : Arızanın nedenini açıklayan FailureDescription |
çağrı başarısız oldu
public final void invocationFailed (Throwable cause)
Bazı hata durumlarından dolayı tamamlanmamış bir çağrıyı bildirir.
TradeFederation çerçevesi tarafından otomatik olarak çağrılacaktır.Parametreler | |
---|---|
cause | Throwable : Başarısızlığın Throwable nedeni |
çağrı başlatıldı
public final void invocationStarted (IInvocationContext context)
İletim için Çağrı Dinleyicileri
Parametreler | |
---|---|
context | IInvocationContext : çağırma hakkında bilgi |
Devre Dışı
public final boolean isDisabled ()
Nesnenin tamamı devre dışı bırakılırsa True değerini 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 durumuyla 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)
üzerinden 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, güçlü bir ilişkilendirmenin açıkça sağlanmasına olanak tanır.
Günlük-test ilişkisini günceller. Bu yöntem bir test sırasında çağrılırsa günlük teste aittir; aksi takdirde bir çalışma günlüğü olacaktır.
Parametreler | |
---|---|
dataName | String : Verinin adı |
logFile | LogFile : Daha önce günlüğe kaydedilen ve test durumuyla ilişkilendirilmesi gereken LogFile . |
süreçTümTestMetriklerVeGünlükler
publicprocessAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)
Tüm testlerdeki ö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 benzersiz anahtar adıyla döndürülmelidir (mevcut anahtarlarla çarpışmaya izin verilmez).
Parametreler | |
---|---|
allTestMetrics | ListMultimap : Her testteki metrikleri metrik adlarına göre gruplandırarak saklayan bir HashMultimap. |
allTestLogs | TestDescription anahtar olarak kullanan, veri adlarına göre anahtarlanmış günlük dosyalarının haritasını saklayan bir harita. |
İadeler | |
---|---|
Tüm test metriklerinden yeni oluşturulan metrikler kümesi. |
süreçRunMetricsAndLogs
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 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. |
süreçTestMetricsAndLogs
publicprocessTestMetricsAndLogs (TestDescription testDescription, testMetrics, testLogs)
Her testin süreç ölçümlerini ve günlüklerini yayınlamak için bu yöntemi uygulayın. Yalnızca yeni oluşturulan metrikler 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)
Uygulayıcının dosyaları kaydetmesine izin vermek için ILogSaver
ayarlayın.
Parametreler | |
---|---|
logSaver | ILogSaver : ILogSaver |
kurmak
public void setUp ()
Test çalıştırılmadan önce başlatmak için alt işlemcilerdeki bu yöntemi geçersiz kılın.
testVarsayımBaşarısızlık
public final void testAssumptionFailure (TestDescription test, String trace)
Bir atom testi, yanlış olan bir koşulu varsaydığını işaretlediğinde çağrılır
Parametreler | |
---|---|
test | TestDescription : testi tanımlar |
trace | String : hatanın yığın izlemesi |
testVarsayımBaşarısızlık
public final void testAssumptionFailure (TestDescription test, FailureDescription failure)
Bir atom testi, yanlış olan bir koşulu varsaydığını işaretlediğinde çağrılır
Parametreler | |
---|---|
test | TestDescription : testi tanımlar |
failure | FailureDescription : Arızayı ve içeriğini açıklayan FailureDescription . |
testSonlandı
public final void testEnded (TestDescription test, long endTime,testMetrics)
Bitiş zamanını doğrudan belirtebileceğimiz ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
alternatifi. 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) |
testSonlandı
public final void testEnded (TestDescription test,testMetrics)
Bireysel bir test senaryosunun yürütme sonunu bildirir.
testFailed(TestDescription, FailureDescription)
çağrılmadıysa bu test başarılı oldu. Ayrıca test senaryosunun yürütülmesi sırasında yayılmış olabilecek tüm anahtar/değer ölçümlerini de 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)
Bireysel test senaryosunun başarısızlığını bildirir.
testStarted ve testEnded arasında çağrılacaktır.
Parametreler | |
---|---|
test | TestDescription : testi tanımlar |
failure | FailureDescription : Arızayı ve içeriğini açıklayan FailureDescription . |
test başarısız
public final void testFailed (TestDescription test, String trace)
Bireysel test senaryosunun başarısızlığını bildirir.
testStarted ve testEnded arasında çağrılacaktır.
Parametreler | |
---|---|
test | TestDescription : testi tanımlar |
trace | String : hatanın yığın izlemesi |
testYoksayıldı
public final void testIgnored (TestDescription test)
Genellikle bir test yönteminin org.junit.Ignore ile açıklanması nedeniyle bir test çalıştırılmayacağı zaman ç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 : Verinin String tanımlayıcı adı. örneğin "device_logcat". DataName'in çağrı başına benzersiz olmayabileceğini unutmayın. yani uygulayıcılar aynı veriAdı ile birden fazla çağrıyı yönetebilmelidir |
dataType | LogDataType : verilerin LogDataType |
dataStream | InputStreamSource : Verinin InputStreamSource . Uygulayıcılar, verileri okumaya başlamak için createInputStream'i çağırmalı ve tamamlandığında ortaya çıkan OutputStream'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. |
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 : Verinin String tanımlayıcı adı. örneğin "device_logcat". DataName'in çağrı başına benzersiz olmayabileceğini unutmayın. yani uygulayıcılar aynı veriAdı ile birden fazla çağrıyı yönetebilmelidir |
dataType | LogDataType : verilerin LogDataType |
dataStream | InputStreamSource : Verinin InputStreamSource . Uygulayıcılar, verileri okumaya başlamak için createInputStream'i çağırmalı ve tamamlandığında ortaya çıkan OutputStream'in kapatıldığından emin olmalıdır. |
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.
testModuleStarted
public final void testModuleStarted (IInvocationContext moduleContext)
Çalışan bir modülün başlangıcını bildirir. Bu geri çağırma testModuleEnded()
ile ilişkilidir ve dizide isteğe bağlıdır. Yalnızca modülleri kullanan bir çalıştırma sırasında kullanılır: paket tabanlı koşucular.
Parametreler | |
---|---|
moduleContext | IInvocationContext : modülün IInvocationContext . |
testRunEnded
public final void testRunEnded (long elapsedTime,runMetrics)
Test çalıştırmasının sonunu bildirir. FIXME: Farklı türde iki Map<> arayüzümüz olamaz, bu yüzden burada HashMap kullanmak zorundayız.
Parametreler | |
---|---|
elapsedTime | long : cihaz geçen süreyi milisaniye cinsinden bildirdi |
runMetrics | Metric ile yapılan bir test çalışmasının sonunda rapor edilen anahtar/değer çiftleri. |
testRun Başarısız
public final void testRunFailed (FailureDescription failure)
FailureDescription
tarafından açıklanan bir hata nedeniyle rapor test çalıştırması tamamlanamadı.
Parametreler | |
---|---|
failure | FailureDescription : Arızayı ve içeriğini açıklayan FailureDescription . |
testRun Başarısız
public final void testRunFailed (String errorMessage)
Önemli bir hata nedeniyle rapor test çalıştırması tamamlanamadı.
Parametreler | |
---|---|
errorMessage | String : Çalıştırma hatasının nedenini açıklayan String . |
testRunBaşlatıldı
public final void testRunStarted (String runName, int testCount, int attemptNumber)
Bir 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ındaki toplam test sayısı |
attemptNumber | int : aynı runName'in birden çok kez çalıştırılan farklı girişimlerini tanımlayan sipariş numarası. tryNumber 0 indekslidir ve her yeni çalıştırma gerçekleştiğinde artmalıdır. Örneğin, bir test 3 kez ayrıntılı olarak yeniden denenir, aynı runName altında toplam 4 çalıştırmaya sahip olmalıdır ve tryNumber değeri 0'dan 3'e kadar olmalıdır. |
testRunBaşlatı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ı |
testRunBaşlatıldı
public final void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Bir 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ındaki toplam test sayısı |
attemptNumber | int : aynı runName'in birden çok kez çalıştırılan farklı girişimlerini tanımlayan sipariş numarası. tryNumber 0 indekslidir ve her yeni çalıştırma gerçekleştiğinde artmalıdır. Örneğin, bir test 3 kez ayrıntılı olarak yeniden denenir, aynı runName altında toplam 4 çalıştırmaya sahip olmalıdır ve tryNumber değeri 0'dan 3'e kadar olmalıdır. |
startTime | long : Çalıştırmanın başladığı saat, System.currentTimeMillis() aracılığıyla ölçülür |
testRunDurduruldu
public final void testRunStopped (long elapsedTime)
Kullanıcı isteği nedeniyle rapor test çalıştırması tamamlanmadan durduruldu.
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 birleştirilir. .
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)
Test senaryoları geri aramaları
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 |