BasePostProcessor
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ç raporlayıcılarından önce çağrıldığından emin olun.
Özet
Herkese açık kurucular | |
---|---|
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)
Bazı hata koşulları nedeniyle tamamlanmamış bir çağrı bildirir. |
void
|
invocationSkipped(SkipReason reason)
Çağrıyı atlandı olarak bildirir |
final
void
|
invocationStarted(IInvocationContext context)
Yönlendirme için çağrı dinleyicileri |
final
boolean
|
isDisabled()
Nesnenin tamamı devre dışıysa True (Doğru) değerini döndürür (hem kurulum hem de kaldırma işlemi atlanır). |
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 testlerdeki metrikleri ve günlükleri toplamak 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 almak 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)
Bir atomik test, yanlış bir koşulu varsaydığını işaretlediğ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 testin yürütülmesinin 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öntemi org.junit.Ignore ile eklendiği için test çalıştırılmadığında çağrılır. |
final
void
|
testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)
Son işlemci 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ıştırılmasının sonunu bildirir. |
final
void
|
testModuleStarted(IInvocationContext moduleContext)
Bir modülün çalışmaya başlamasını bildirir. |
final
void
|
testRunEnded(long elapsedTime,
Test çalıştırmasının sonunu bildirir. |
final
void
|
testRunFailed(FailureDescription failure)
Raporlar test çalıştırması, |
final
void
|
testRunFailed(String errorMessage)
Raporlar test çalışması, önemli bir hata nedeniyle tamamlanamadı. |
final
void
|
testRunStarted(String runName, int testCount, int attemptNumber)
Test çalıştırmasının başlangıcını bildirir. |
final
void
|
testRunStarted(String runName, int testCount)
Test çalıştırma geri aramaları |
final
void
|
testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
Test çalıştırmasının başlangıcını bildirir. |
final
void
|
testRunStopped(long elapsedTime)
Raporlar test çalışması, kullanıcı isteği nedeniyle tamamlanmadan önce durduruldu. |
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. |
final
void
|
testStarted(TestDescription test, long startTime)
Doğru ölçüm için |
final
void
|
testStarted(TestDescription test)
Test durumları için geri çağırma |
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
BasePostProcessor
public BasePostProcessor ()
Herkese açık yöntemler
init
public final ITestInvocationListener init (ITestInvocationListener listener)
Son işlemcinin başlatma adımı. Test geri çağırmalarından önce çağrılması gerekir.
Parametreler | |
---|---|
listener |
ITestInvocationListener |
İlerlemeler | |
---|---|
ITestInvocationListener |
invocationEnded
public final void invocationEnded (long elapsedTime)
Çağrının başarıyla 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 geçtiği süre (ms.) |
invocationFailed
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 : Hatanın nedenini açıklayan FailureDescription |
invocationFailed
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 |
invocationSkipped
public void invocationSkipped (SkipReason reason)
Çağrıyı atlandı olarak bildirir
Parametreler | |
---|---|
reason |
SkipReason |
invocationStarted
public final void invocationStarted (IInvocationContext context)
Yönlendirme için çağrı dinleyicileri
Parametreler | |
---|---|
context |
IInvocationContext : çağrı hakkında bilgi |
isDisabled
public final boolean isDisabled ()
Nesnenin tamamı devre dışıysa True (Doğru) değerini döndürür (hem kurulum hem de kaldırma işlemi atlanır). 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 : Daha önce günlüğe kaydedilen ve test durumuyla ilişkilendirilmesi gereken LogFile . |
processAllTestMetricsAndLogs
publicprocessAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)
Tüm testlerdeki metrikleri ve günlükleri toplamak için bu yöntemi uygulayın. Bu yöntemden elde edilen metrikler, çalıştırma metrikleri olarak raporlanır. 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 günlük dosyası haritasını, anahtar olarak her testin TestDescription değerini kullanarak veri adlarına göre anahtarlanmış şekilde depolayan bir harita. |
İlerlemeler | |
---|---|
|
Tüm test metriklerinden yeni oluşturulan metrik grubu. |
processRunMetricsAndLogs
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 döndürülmelidir (mevcut anahtarlarla çakışmaya izin verilmez).
Parametreler | |
---|---|
rawMetrics |
: Çalıştırma için kullanılabilen ham metrik grubu. |
runLogs |
: Test çalıştırması için günlük dosyası grubu. |
İlerlemeler | |
---|---|
|
Çalıştırma metriklerinden yeni oluşturulan metrik grubu. |
processTestMetricsAndLogs
publicprocessTestMetricsAndLogs (TestDescription testDescription, testMetrics, testLogs)
Her testten elde edilen metrikleri ve günlükleri son işleme almak için bu yöntemi uygulayın. Yalnızca yeni oluşturulan metrikler benzersiz anahtar adıyla döndürülmelidir (mevcut anahtarlarla çakışmaya izin verilmez).
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şlatmak için alt son işlemcilerde bu yöntemi geçersiz kılın.
testAssumptionFailure
public final void testAssumptionFailure (TestDescription test, String trace)
Bir atomik test, yanlış 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 |
testAssumptionFailure
public final void testAssumptionFailure (TestDescription test, FailureDescription failure)
Bir atomik test, yanlış bir koşulu varsaydığını işaretlediğinde çağrılır
Parametreler | |
---|---|
test |
TestDescription : Testi tanımlar |
failure |
FailureDescription : FailureDescription hatayı ve bağlamını açıklayan. |
testEnded
public final void testEnded (TestDescription test, long endTime,testMetrics)
Bitiş zamanını doğrudan belirtebildiğimiz ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
'e alternatif. 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 : System.currentTimeMillis() aracılığıyla ölçülen, testin sona erdiği zaman |
testMetrics |
: Yayınlanan metriklerin ERROR(/Map) |
testEnded
public final void testEnded (TestDescription test,testMetrics)
Tek bir testin yürütülmesinin sonunu bildirir.
testFailed(TestDescription, FailureDescription)
çağrılmadıysa bu test geçmiştir. Ayrıca, test senaryosunun yürütülmesi sırasında yayınlanmış olabilecek tüm anahtar/değer metriklerini döndürür.
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ılır.
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ılır.
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 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)
Son işlemci 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 . 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. |
testLogSaved
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. Yani uygulayıcılar aynı dataName ile birden fazla çağrıyı işleyebilmelidir. |
dataType |
LogDataType : Verilerin LogDataType |
dataStream |
InputStreamSource : Verilerin InputStreamSource . Uygulamacılar, verileri okumaya başlamak için createInputStream'i çağırmalı ve işlem tamamlandığında ortaya çıkan InputStream'i kapatmalıdır. |
logFile |
LogFile : Kayıtlı dosyanın meta verilerini içeren LogFile . |
testModuleEnded
public final void testModuleEnded ()
Bir modülün çalıştırılmasının sonunu bildirir.
testModuleStarted
public final void testModuleStarted (IInvocationContext moduleContext)
Bir modülün çalışmaya başlamasını bildirir. Bu geri çağırma, testModuleEnded()
ile ilişkilidir ve dizede isteğe bağlıdır. Yalnızca modül kullanan bir çalıştırma sırasında kullanılır: paket tabanlı çalıştırıcılar.
Parametreler | |
---|---|
moduleContext |
IInvocationContext : Modülün IInvocationContext değeri. |
testRunEnded
public final void testRunEnded (long elapsedTime,runMetrics)
Test çalıştırmasının sonunu bildirir.
Parametreler | |
---|---|
elapsedTime |
long : Cihaz tarafından bildirilen geçen süre (milisaniye cinsinden) |
runMetrics |
: Test çalışmasının sonunda raporlanan anahtar/değer çiftleri |
testRunFailed
public final void testRunFailed (FailureDescription failure)
Raporlar test çalıştırması, FailureDescription
tarafından açıklanan bir hata nedeniyle tamamlanamadı.
Parametreler | |
---|---|
failure |
FailureDescription : FailureDescription hatayı ve bağlamını açıklayan. |
testRunFailed
public final void testRunFailed (String errorMessage)
Raporlar test çalışması, önemli bir hata nedeniyle tamamlanamadı.
Parametreler | |
---|---|
errorMessage |
String : String , çalıştırma hatasının nedenini açıklıyor. |
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 dizindir ve 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. |
testRunStarted
public final void testRunStarted (String runName, int testCount)
Test çalıştırma geri aramaları
Parametreler | |
---|---|
runName |
String : test çalıştırması adı |
testCount |
int : test çalıştırmasında toplam test sayısı |
testRunStarted
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 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, 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 tarafından bildirilen geçen süre (milisaniye cinsinden) |
testSkipped
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. Bu testler, düzgün bir şekilde yürütülmeleri için tekrar denenir.
Parametreler | |
---|---|
test |
TestDescription : Testi tanımlar |
reason |
SkipReason : SkipReason |
testStarted
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 : System.currentTimeMillis() aracılığıyla ölçülen, testin başladığı zaman |
testStarted
public final void testStarted (TestDescription test)
Test durumları için geri çağırma
Parametreler | |
---|---|
test |
TestDescription : Testi tanımlar |
Korunan yöntemler
cleanUp
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üre ayarlanır.
İlerlemeler | |
---|---|
MetricMeasurement.DataType |
getRunName
protected String getRunName ()
İlerlemeler | |
---|---|
String |