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.

void invocationSkipped ( SkipReason reason)

Bir çağrıyı atlanmış olarak 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 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.

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 ILogSaver ayarlayın.

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 ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) alternatifi.

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)

FailureDescription tarafından açıklanan bir hata nedeniyle rapor test çalıştırması tamamlanamadı.

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 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)

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

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ı atlandı

public void invocationSkipped (SkipReason reason)

Bir çağrıyı atlanmış olarak bildirir

Parametreler
reason SkipReason

ç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

public  processAllTestMetricsAndLogs (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 : Her testin 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 abstract  processRunMetricsAndLogs ( 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 : Çalıştırma için kullanılabilen ham metrikler kümesi.

runLogs : Test çalıştırması için günlük dosyaları kümesi.

İadeler
Çalıştırma metriklerinden yeni oluşturulan metrikler kümesi.

süreçTestMetricsAndLogs

public  processTestMetricsAndLogs (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 : Testteki ölçüm kümesi.

testLogs : Test sırasında günlüğe kaydedilen dosya kümesi.

İ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 : yayılan metriklerin 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 : yayılan metriklerin 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 : Verilerin 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 : koşunun 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

testAtlandı

public 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. Bu testler, uygun bir yürütme elde etmek için yeniden denenmeye çalışılacaktır.

Parametreler
test TestDescription : testi tanımlar

reason SkipReason : SkipReason

testBaşladı

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 testin ne zaman başladığını da belirttiğimiz testStarted(com.android.tradefed.result.TestDescription) alternatifi .

Parametreler
test TestDescription : testi tanımlar

startTime long : System.currentTimeMillis() aracılığıyla ölçülen, testin başladığı süre

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