ToplamaTestDinleyici
public class CollectingTestListener
extends Object
implements ITestInvocationListener , ILogSaverListener , IDisableable
java.lang.Object | |
↳ | com.android.tradefed.result.CollectingTestListener |
Tüm test sonuçlarını toplayacak bir ITestInvocationListener
.
Bu nesnede kullanılan veri yapıları iş parçacığı açısından güvenli olsa da, ITestInvocationListener
geri çağrıları doğru sırada çağrılmalıdır.
Özet
kamu inşaatçılar | |
---|---|
CollectingTestListener () |
Genel yöntemler | |
---|---|
IBuildInfo | getBuildInfo () Bu yöntem kullanımdan kaldırıldı. |
TestRunResult | getCurrentRunResults () Geçerli test çalıştırması için sonuçları alır. |
int | getExpectedTests () Beklenen test sayısı sayısını döndürür. |
IInvocationContext | getInvocationContext () |
getMergedTestRunResults () Farklı denemelerdeki tüm çalıştırmalar için birleştirilmiş sonuç koleksiyonunu döndürün. | |
IInvocationContext | getModuleContextForRunResult (String testRunName) Sonuçlarla ilişkili modülün |
MultiMap <String, LogFile > | getModuleLogFiles () Modülle ilişkili tüm kayıtlı dosyaları içeren haritanın bir kopyasını döndürür |
MultiMap <String, LogFile > | getNonAssociatedLogFiles () Bir test çalıştırması veya bir modül ile ilişkili olmayan, günlüğe kaydedilen tüm dosyaları içeren haritanın bir kopyasını döndürür. |
int | getNumAllFailedTestRuns () Başarısız durumdaki test çalıştırmalarının toplam sayısını verir |
int | getNumAllFailedTests () Başarısız durumdaki testlerin toplam sayısını verir (yalnızca başarısız, varsayım başarısızlıkları buna sayılmaz). |
int | getNumTestsInState (TestResult.TestStatus status) Bu çalıştırma için verilen durumdaki testlerin sayısını döndürür. |
int | getNumTotalTests () Tüm çalıştırmalar için tamamlanan testlerin toplam sayısını verir. |
IBuildInfo | getPrimaryBuildInfo () |
getRunResults () Bu yöntem kullanımdan kaldırıldı. | |
TestRunResult | getTestRunAtAttempt (String testRunName, int attempt) Tek bir deneme için |
int | getTestRunAttemptCount (String testRunName) Belirli bir test çalıştırması adı için deneme sayısını döndürür. |
getTestRunAttempts (String testRunName) Belirli bir test çalıştırmasının | |
getTestRunForAttempts (int attempt) Belirli bir deneme için tüm sonuçları alır. | |
getTestRunNames () Tüm test çalıştırmaları için tüm adları döndürün. | |
boolean | hasFailedTests () Çağrının herhangi bir başarısız veya varsayım başarısız testi olup olmadığını döndürür. |
boolean | hasTestRunResultsForName (String testRunName) Belirli bir test çalışması adının herhangi bir sonucu olup olmadığını döndürür. |
void | invocationEnded (long elapsedTime) Başarıyla veya bazı hata durumlarından dolayı çağrının sonlandırıldığını bildirir. |
void | invocationFailed (Throwable cause) Bazı hata koşulları nedeniyle tamamlanmamış bir çağrı bildirir. |
void | invocationStarted ( IInvocationContext context) Test çağrısının başlangıcını bildirir. |
boolean | isDisabled () Nesnenin tamamı devre dışı bırakılırsa True döndürür (hem kurulumu hem de ayırmayı atlayın). |
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 |
void | setBuildInfo ( IBuildInfo buildInfo) Bu yöntem kullanımdan kaldırıldı. Artık test için gerekli değil. |
void | setDisable (boolean isDisabled) Nesnenin devre dışı bırakılıp bırakılmayacağını ayarlar. |
void | setMergeStrategy ( MergeStrategy strategy) Sonuçları birleştirirken kullanılacak |
void | testAssumptionFailure ( TestDescription test, String trace) Bir atomik test, yanlış olan bir koşulu varsaydığını işaretlediğinde çağrılır |
void | testAssumptionFailure ( TestDescription test, FailureDescription failure) Bir atomik test, yanlış olan bir koşulu varsaydığını işaretlediğinde çağrılır |
void | testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) Bitiş zamanını doğrudan belirtebileceğimiz |
void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Tek bir test senaryosunun yürütme sonunu bildirir. |
void | testFailed ( TestDescription test, FailureDescription failure) Tek bir test senaryosunun başarısızlığını bildirir. |
void | testFailed ( TestDescription test, String trace) Tek bir test senaryosunun başarısızlığını bildirir. |
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. |
void | testModuleEnded () Bir modülün çalışmasının sonunu bildirir. |
void | testModuleStarted ( IInvocationContext moduleContext) Çalışan bir modülün başlangıcını bildirir. |
void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) Test çalışmasının sonunu bildirir. |
void | testRunFailed ( FailureDescription failure) Reports test çalıştırması, |
void | testRunFailed (String errorMessage) Raporlar test çalıştırması, önemli bir hata nedeniyle tamamlanamadı. |
void | testRunStarted (String name, int numTests, int attemptNumber) Bir test çalışmasının başladığını bildirir. |
void | testRunStarted (String name, int numTests) Bir test çalışmasının başladığını bildirir. |
void | testRunStarted (String name, int numTests, int attemptNumber, long startTime) Bir test çalışmasının başladığını bildirir. |
void | testRunStopped (long elapsedTime) Bir kullanıcı isteği nedeniyle test çalıştırmasının tamamlanmadan önce durdurulduğunu bildirir. |
void | testStarted ( TestDescription test, long startTime) Doğru ölçüm için |
void | testStarted ( TestDescription test) Tek bir test senaryosunun başlangıcını bildirir. |
Korumalı yöntemler | |
---|---|
final void | clearModuleLogFiles () Modül dosyasını temizlemeye izin verir, böylece onları çok uzun süre taşımaktan kaçınırız. |
final void | clearResultsForName (String testRunName) Belirli bir çalışma adı için sonuçları temizlemeye izin verir. |
void | setIsAggregrateMetrics (boolean aggregate) 'Toplu ölçümler' seçeneğini değiştirin |
kamu inşaatçılar
ToplamaTestDinleyici
public CollectingTestListener ()
Genel yöntemler
getBuildInfo
public IBuildInfo getBuildInfo ()
Bu yöntem kullanımdan kaldırıldı.
getInvocationContext()
kaynağından IBuildInfo
güvenin.
Derleme bilgisini döndürür.
İadeler | |
---|---|
IBuildInfo |
getCurrentRunSonuçları
public TestRunResult getCurrentRunResults ()
Geçerli test çalıştırması için sonuçları alır.
Sonuçların tam olmayabileceğini unutmayın. Sonuçları işlemeden önce TestRunResult.isRunComplete()
ve/veya (@link TestRunResult#isRunFailure()} değerinin test edilmesi önerilir.
İadeler | |
---|---|
TestRunResult | son test çalışması sırasında toplanan verileri temsil eden TestRunResult |
BeklenenTestleri al
public int getExpectedTests ()
Beklenen test sayısı sayısını döndürür. Bazı testler çalışmadıysa getNumTotalTests()
ten farklı olabilir.
İadeler | |
---|---|
int |
getInvocationContext
public IInvocationContext getInvocationContext ()
invocationStarted(com.android.tradefed.invoker.IInvocationContext)
aracılığıyla bildirilen çağrı bağlamını döndürün
İadeler | |
---|---|
IInvocationContext |
getMergedTestRunResults
publicgetMergedTestRunResults ()
Farklı denemelerdeki tüm çalıştırmalar için birleştirilmiş sonuç koleksiyonunu döndürün.
Birden çok sonuç varsa, her test çalıştırması birleştirilir ve en son test sonucu, önceki çalıştırmaların test sonuçlarının üzerine yazılır. Test çalıştırmaları, deneme numarasına göre sıralanır.
Aynı deneme için ölçümler, aggregate-metrics
tarafından ayarlanan tercihe göre birleştirilecektir. Nihai metrikler, son denemenin metrikleri olacaktır.
İadeler | |
---|---|
getModuleContextForRunResult
public IInvocationContext getModuleContextForRunResult (String testRunName)
Sonuçlarla ilişkili modülün IInvocationContext
döndürür.
parametreler | |
---|---|
testRunName | String : { testRunStarted(String, int) tarafından verilen ad. |
İadeler | |
---|---|
IInvocationContext | Belirli bir test çalıştırması adı için modülün IInvocationContext , söz konusu ad için sonuç yoksa null . |
getModuleLogFiles
public MultiMap<String, LogFile> getModuleLogFiles ()
Modülle ilişkili tüm kayıtlı dosyaları içeren haritanın bir kopyasını döndürür
İadeler | |
---|---|
MultiMap <String, LogFile > |
getNonAssociatedLogFiles
public MultiMap<String, LogFile> getNonAssociatedLogFiles ()
Bir test çalıştırması veya bir modül ile ilişkili olmayan, günlüğe kaydedilen tüm dosyaları içeren haritanın bir kopyasını döndürür.
İadeler | |
---|---|
MultiMap <String, LogFile > |
getNumAllFailedTestRuns
public int getNumAllFailedTestRuns ()
Başarısız durumdaki test çalıştırmalarının toplam sayısını verir
İadeler | |
---|---|
int |
getNumAllFailedTests
public int getNumAllFailedTests ()
Başarısız durumdaki testlerin toplam sayısını verir (yalnızca başarısız, varsayım başarısızlıkları buna sayılmaz).
İadeler | |
---|---|
int |
getNumTestsInState
public int getNumTestsInState (TestResult.TestStatus status)
Bu çalıştırma için verilen durumdaki testlerin sayısını döndürür.
parametreler | |
---|---|
status | TestResult.TestStatus |
İadeler | |
---|---|
int |
getNumTotalTests
public int getNumTotalTests ()
Tüm çalıştırmalar için tamamlanan testlerin toplam sayısını verir.
İadeler | |
---|---|
int |
getPrimaryBuildInfo
public IBuildInfo getPrimaryBuildInfo ()
invocationStarted(com.android.tradefed.invoker.IInvocationContext)
aracılığıyla bildirilen birincil derleme bilgisini döndürün. Birincil yapı, çalışan yapılandırmanın ilk yapı sağlayıcısı tarafından döndürülen yapıdır. Bağlam yoksa (durumu test etmek için derleme yoksa) null değerini döndürür.
İadeler | |
---|---|
IBuildInfo |
getRunSonuçları
publicgetRunResults ()
Bu yöntem kullanımdan kaldırıldı.
getMergedTestRunResults()
işlevini kullanın
Tüm test çalıştırmalarının sonuçlarını döndürür.
İadeler | |
---|---|
getTestRunAttempt
public TestRunResult getTestRunAtAttempt (String testRunName, int attempt)
Tek bir deneme için TestRunResult
döndürün.
parametreler | |
---|---|
testRunName | String : { testRunStarted(String, int) tarafından verilen ad. |
attempt | int : Deneme kimliği. |
İadeler | |
---|---|
TestRunResult | Verilen ad ve deneme kimliği için TestRunResult veya yoksa null . |
getTestRunAttemptCount
public int getTestRunAttemptCount (String testRunName)
Belirli bir test çalıştırması adı için deneme sayısını döndürür.
parametreler | |
---|---|
testRunName | String : { testRunStarted(String, int) tarafından verilen ad. |
İadeler | |
---|---|
int |
getTestRunAttempts
publicgetTestRunAttempts (String testRunName)
Belirli bir test çalıştırmasının TestRunResult
için tüm denemelerini alır.
parametreler | |
---|---|
testRunName | String : { testRunStarted(String, int) tarafından verilen ad. |
İadeler | |
---|---|
Belirli bir test çalıştırması için tüm TestRunResult , denemelere göre sıralanır. |
getTestRunForAttempts
publicgetTestRunForAttempts (int attempt)
Belirli bir deneme için tüm sonuçları alır.
parametreler | |
---|---|
attempt | int : Sonuç almak istediğimiz girişim. |
İadeler | |
---|---|
Belirli bir deneme için tüm TestRunResult . |
getTestRunNames
publicgetTestRunNames ()
Tüm test çalıştırmaları için tüm adları döndürün.
Bu test çalıştırmaları, farklı denemelerle birden çok kez çalıştırılmış olabilir.
İadeler | |
---|---|
hasBaşarısızTestler
public boolean hasFailedTests ()
Çağrının herhangi bir başarısız veya varsayım başarısız testi olup olmadığını döndürür.
İadeler | |
---|---|
boolean |
hasTestRunResultsForName
public boolean hasTestRunResultsForName (String testRunName)
Belirli bir test çalışması adının herhangi bir sonucu olup olmadığını döndürür.
parametreler | |
---|---|
testRunName | String : { testRunStarted(String, int) tarafından verilen ad. |
İadeler | |
---|---|
boolean |
Çağrı Sona Erdi
public 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 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 : başarısızlığın Throwable nedeni |
çağrı başlatıldı
public void invocationStarted (IInvocationContext context)
Test çağrısının başlangıcını bildirir.
TradeFederation çerçevesi tarafından otomatik olarak çağrılacaktır. Raporlayıcıların, birden fazla cihaz raporlamasını desteklemek için bu yöntemi geçersiz kılmaları gerekir.
parametreler | |
---|---|
context | IInvocationContext : çağrı hakkında bilgi |
devre dışı
public 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 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)
üzerinden 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.
parametreler | |
---|---|
dataName | String : Verinin adı |
logFile | LogFile : Daha önce günlüğe kaydedilen ve test durumuyla ilişkilendirilmesi gereken LogFile . |
setBuildInfo
public void setBuildInfo (IBuildInfo buildInfo)
Bu yöntem kullanımdan kaldırıldı.
Artık test için gerekli değil.
Yapı bilgisini ayarlayın. Sadece test için kullanılmalıdır.
parametreler | |
---|---|
buildInfo | IBuildInfo |
setDisable
public void setDisable (boolean isDisabled)
Nesnenin devre dışı bırakılıp bırakılmayacağını ayarlar. Devre dışı, hem kurulum hem de ayırma adımlarının atlanması gerektiği anlamına gelir. Varsayılan kurucuda bir nesneyi varsayılan olarak devre dışı bırakmak için kullanılabilir.
parametreler | |
---|---|
isDisabled | boolean : nesnenin konması gereken durum. |
setMergeStrategy
public void setMergeStrategy (MergeStrategy strategy)
Sonuçları birleştirirken kullanılacak MergeStrategy
ayarlar.
parametreler | |
---|---|
strategy | MergeStrategy |
test Varsayım Başarısızlığı
public 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 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 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 : System.currentTimeMillis() aracılığıyla ölçülen, testin sona erdiği süre |
testMetrics | ERROR(/Map) |
test Bitti
public 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 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 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 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 |
testModuleEnded
public void testModuleEnded ()
Bir modülün çalışmasının sonunu bildirir.
testModuleStarted
public 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 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 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 void testRunFailed (String errorMessage)
Raporlar test çalıştırması, önemli bir hata nedeniyle tamamlanamadı.
parametreler | |
---|---|
errorMessage | String : Çalıştırma hatasının nedenini açıklayan String . |
testÇalıştırBaşlatıldı
public void testRunStarted (String name, int numTests, int attemptNumber)
Bir test çalışmasının başladığını bildirir.
parametreler | |
---|---|
name | String : test çalıştırması adı |
numTests | 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şimNumarası 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 void testRunStarted (String name, int numTests)
Bir test çalışmasının başladığını bildirir.
parametreler | |
---|---|
name | String : test çalıştırması adı |
numTests | int : test çalışmasında toplam test sayısı |
testÇalıştırBaşlatıldı
public void testRunStarted (String name, int numTests, int attemptNumber, long startTime)
Bir test çalışmasının başladığını bildirir.
parametreler | |
---|---|
name | String : test çalıştırması adı |
numTests | 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şimNumarası 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, System.currentTimeMillis() aracılığıyla ölçülür |
testRunStopped
public 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 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 : testin başladığı zaman, System.currentTimeMillis() aracılığıyla ölçülür |
test başladı
public void testStarted (TestDescription test)
Tek bir test senaryosunun başlangıcını bildirir. Daha eski arayüz, mümkün olduğunda testStarted(com.android.tradefed.result.TestDescription)
kullanmalıdır.
parametreler | |
---|---|
test | TestDescription : testi tanımlar |
Korumalı yöntemler
clearModuleLogFiles
protected final void clearModuleLogFiles ()
Modül dosyasını temizlemeye izin verir, böylece onları çok uzun süre taşımaktan kaçınırız.
clearResultsForName
protected final void clearResultsForName (String testRunName)
Belirli bir çalışma adı için sonuçları temizlemeye izin verir. Yalnızca sonuçların toplayıcısı gibi bazı durumlarda kullanılmalıdır.
parametreler | |
---|---|
testRunName | String |
setIsAggregrateMetrics
protected void setIsAggregrateMetrics (boolean aggregate)
'Toplu ölçümler' seçeneğini değiştirin
parametreler | |
---|---|
aggregate | boolean |