Temel İş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şleme yöntemlerinin 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) Başarıyla veya bazı hata durumlarından dolayı çağrının 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ğırma Dinleyicileri |
final boolean | isDisabled () Nesnenin tamamı devre dışı bırakılırsa True döndürür (hem kurulumu hem de ayırmayı atlayın). |
final void | logAssociation (String dataName, LogFile logFile) Bazı durumlarda, günlük bir test senaryolarıyla güçlü bir şekilde ilişkilendirilmelidir, 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 metrikleri 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 işlem ölçümlerini ve günlükleri göndermek 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 son 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 varsaydığını işaretlediğinde çağrılır |
final void | testAssumptionFailure ( TestDescription test, FailureDescription failure) Bir atomik test, 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) 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öntemi org.junit.Ignore ile açıklamalı olduğundan, bir test çalıştırılmadığında ç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ün çalışması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ışmasının sonunu bildirir. |
final void | testRunFailed ( FailureDescription failure) Reports test çalıştırması, |
final void | testRunFailed (String errorMessage) Raporlar test çalıştırması, önemli bir hata nedeniyle tamamlanamadı. |
final void | testRunStarted (String runName, int testCount, int attemptNumber) Bir test çalışması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ışması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) Doğru ölçüm için |
final void | testStarted ( TestDescription test) Test durumları 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
Temel İş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 çağrıldığından emin olun.
parametreler | |
---|---|
listener | ITestInvocationListener |
İadeler | |
---|---|
ITestInvocationListener |
Çağrı Sona Erdi
public final void invocationEnded (long elapsedTime)
Başarıyla 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 koşulları nedeniyle tamamlanmamış bir çağrı bildirir.
TradeFederation çerçevesi tarafından otomatik olarak çağrılacaktı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ılacaktır.parametreler | |
---|---|
cause | Throwable : hatanın ERROR(/Throwable) nedeni |
çağrı başlatıldı
public final void invocationStarted (IInvocationContext context)
Yönlendirme için Çağırma Dinleyicileri
parametreler | |
---|---|
context | IInvocationContext : çağrı hakkında bilgi |
devre dışı
public final boolean isDisabled ()
Nesnenin tamamı devre dışı bırakılırsa True döndürür (hem kurulumu hem de ayırmayı atlayın). Aksi takdirde yanlış.
İadeler | |
---|---|
boolean |
logAssociation
public final void logAssociation (String dataName, LogFile logFile)
Bazı durumlarda, günlük bir test senaryolarıyla güçlü bir şekilde ilişkilendirilmelidir, 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 çağırma mümkün değildir. Böylece, bu geri arama açıkça güçlü bir ilişkilendirme sağlamaya izin verir.
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 . |
processAllTestMetricsAndLogs
publicprocessAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)
Tüm testlerde metrikleri ve günlükleri toplamak için bu yöntemi uygulayın. Bu metottan çıkan metrikler run metrikleri olarak raporlayıcı olacaktır. Yalnızca yeni oluşturulan metrikler ve benzersiz anahtar adıyla döndürülmelidir (mevcut anahtarlarla çakışmaya izin verilmez).
parametreler | |
---|---|
allTestMetrics | ListMultimap : Her testten alınan 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ı depolayan 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 çakış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 işlem ölçümlerini ve günlükleri 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 çakış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 son işlemcilerde bu yöntemi geçersiz kılın.
test Varsayım Başarısızlığı
public final void testAssumptionFailure (TestDescription test, String trace)
Bir atomik test, 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 |
test Varsayım Başarısızlığı
public final void testAssumptionFailure (TestDescription test, FailureDescription failure)
Bir atomik test, yanlış olan bir koşulu varsaydığını işaretlediğinde çağrılır
parametreler | |
---|---|
test | TestDescription : testi tanımlar |
failure | FailureDescription : Hatayı ve içeriğini açıklayan FailureDescription . |
test Bitti
public final void testEnded (TestDescription test, long endTime,testMetrics)
Bitiş zamanını doğrudan belirtebileceğimiz ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
yerine 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 : ERROR(/System#currentTimeMillis()) aracılığıyla ölçülen, testin sona erdiği süre |
testMetrics | ERROR(/Map) |
test Bitti
public final void testEnded (TestDescription test,testMetrics)
Tek 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 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)
Tek bir test senaryosunun başarısızlığını bildirir.
testStarted ve testEnded arasında çağrılacak.
parametreler | |
---|---|
test | TestDescription : testi tanımlar |
failure | FailureDescription : Hatayı ve içeriğini 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ı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 açıklamalı olduğundan, bir test çalıştırılmadığında ç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 ERROR(/String) tanımlayıcı adı. örneğin "device_logcat". Not dataName her çağrı için benzersiz olmayabilir. yani uygulayıcılar, aynı dataName 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 InputStream'i kapattığı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 : verilerin ERROR(/String) tanımlayıcı adı. örneğin "device_logcat". Not dataName her çağrı için benzersiz olmayabilir. yani uygulayıcılar, aynı dataName 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 InputStream'i kapattığından emin olmalıdır. |
logFile | LogFile : kaydedilen dosyanın meta verilerini içeren LogFile . |
testModuleEnded
public final void testModuleEnded ()
Bir modülün çalışmasının sonunu bildirir.
testModuleStarted
public final void testModuleStarted (IInvocationContext moduleContext)
Çalışan bir modülün başlangıcını bildirir. Bu geri arama, testModuleEnded()
ile ilişkilidir ve dizide isteğe bağlıdır. Yalnızca modülleri kullanan bir çalışma 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ışmasının sonunu bildirir. FIXME: Farklı türde iki Map<> arayüzümüz olamaz, bu yüzden burada HashMap kullanmalıyız.
parametreler | |
---|---|
elapsedTime | long : cihazın milisaniye cinsinden geçen süreyi bildirdiği |
runMetrics | Metric ile yapılan bir test çalışmasının sonunda bildirilen anahtar/değer çiftleri. |
testRunFailed
public final void testRunFailed (FailureDescription failure)
Reports test çalıştırması, FailureDescription
tarafından tanımlanan bir hata nedeniyle tamamlanamadı.
parametreler | |
---|---|
failure | FailureDescription : Hatayı ve içeriğini açıklayan FailureDescription . |
testRunFailed
public final void testRunFailed (String errorMessage)
Raporlar test çalıştırması, önemli bir hata nedeniyle tamamlanamadı.
parametreler | |
---|---|
errorMessage | String : ERROR(/String) çalışma hatasının nedenini açıklıyor. |
testÇalıştırBaşlatıldı
public final void testRunStarted (String runName, int testCount, int attemptNumber)
Bir test çalışmasının başladığını bildirir.
parametreler | |
---|---|
runName | String : test çalıştırması adı |
testCount | int : test çalışmasında toplam test sayısı |
attemptNumber | int : birden çok kez çalışan aynı runName'in farklı denemelerini tanımlayan sipariş numarası. Girişim Numarası 0 dizinlidir ve her yeni çalıştırma gerçekleştiğinde artması gerekir. örneğin, bir test 3 kez parçalı olarak yeniden denenir, aynı çalıştırmaAdı altında toplam 4 çalıştırması olmalıdır ve denemeNumarası 0 ile 3 arasındadır. |
testÇalıştırBaş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ışmasında toplam test sayısı |
testÇalıştırBaşlatıldı
public final void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Bir test çalışmasının başladığını bildirir.
parametreler | |
---|---|
runName | String : test çalıştırması adı |
testCount | int : test çalışmasında toplam test sayısı |
attemptNumber | int : birden çok kez çalışan aynı runName'in farklı denemelerini tanımlayan sipariş numarası. Girişim Numarası 0 dizinlidir ve her yeni çalıştırma gerçekleştiğinde artması gerekir. örneğin, bir test 3 kez parçalı olarak yeniden denenir, aynı çalıştırmaAdı altında toplam 4 çalıştırması olmalıdır ve denemeNumarası 0 ile 3 arasındadır. |
startTime | long : çalıştırmanın başladığı zaman, ERROR(/System#currentTimeMillis()) aracılığıyla ölçülür |
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ın milisaniye cinsinden geçen süreyi bildirdiği |
test baş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)
yöntemine alternatif .
parametreler | |
---|---|
test | TestDescription : testi tanımlar |
startTime | long : ERROR(/System#currentTimeMillis()) aracılığıyla ölçülen testin başladığı zaman |
test başladı
public final void testStarted (TestDescription test)
Test durumları 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şlenmiş türe ayarlanmıştır.
İadeler | |
---|---|
MetricMeasurement.DataType |
GetRunName
protected String getRunName ()
İadeler | |
---|---|
String |