Hata Raporu Toplayıcı

public class BugreportCollector
extends Object implements ITestInvocationListener

java.lang.Object
com.android.tradefed.result.BugreportCollector


Yapılandırılabilir olaylar meydana geldiğinde hata raporlarını toplayan ve her hata raporu toplandıktan sonra alt öğelerinde ITestInvocationListener#testLog çağıran doğrudan bir ITestInvocationListener .

Davranışlar: (FIXME: bunu bitir)

  • Herhangi bir test senaryosu başarısız olursa her birinden sonra yakalama yapın
  • Her test senaryosundan sonra yakalama
  • Başarısız olan her test senaryosundan sonra yakalama
  • Esir almak

Özet

İç içe geçmiş sınıflar

class BugreportCollector.Predicate

Bir hata raporunun ne zaman yakalanacağını açıklayan tam bir yüklem.

interface BugreportCollector.SubPredicate

Alanlar

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

Başarısız olan her test senaryosundan sonra tetiklenen, önceden tanımlanmış bir yüklem

public static final BugreportCollector.Predicate AT_START

İlk çağrı başladığında tetiklenen, önceden tanımlanmış bir yüklem

Kamu inşaatçıları

BugreportCollector ( ITestInvocationListener listener, ITestDevice testDevice)

Genel yöntemler

void addPredicate ( BugreportCollector.Predicate p)
void blockUntilIdle ()

Toplayıcı herhangi bir hata raporu toplamayana kadar engelleyin.

TestSummary getSummary ()

InvokasyonListener'ın bir özet döndürmesine izin verir.

void invocationEnded (long elapsedTime)

Başarılı bir şekilde veya bazı hata durumlarından dolayı çağrının sonlandırıldığını bildirir.

void invocationFailed (Throwable cause)

Bazı hata durumlarından dolayı tamamlanmamış bir çağrıyı bildirir.

void invocationStarted ( IInvocationContext context)

Test çağrısının başlangıcını bildirir.

void setAsynchronous (boolean asynchronous)

Hata raporu koleksiyonunun, hata raporunu farklı bir iş parçacığında mı toplaması gerektiğini ( asynchronous = true ) veya hata raporu yakalanana kadar arayanı mı engelleyeceğini ( asynchronous = false ) ayarlayın.

void setDescriptiveName (String name)

Hata raporlarını kaydederken kullanılacak açıklayıcı adı ayarlayın.

void setDeviceWaitTime (int waitTime)

Bir hata raporu yakalamaya çalışmadan önce cihazın Çevrimiçi olmasını bekleyeceği süreyi (saniye cinsinden) ayarlayın.

void testAssumptionFailure ( TestDescription test, String trace)

Bir atom testi, yanlış olan bir koşulu varsaydığını işaretlediğinde çağrılır

void testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics)

Bireysel bir test senaryosunun yürütme sonunu bildirir.

void testFailed ( TestDescription test, String trace)

Bireysel test senaryosunun başarısızlığını bildirir.

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.

void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)

Test çağrısından ilişkili günlük veya hata ayıklama verilerini sağlar.

void testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics)

Test çalıştırmasının sonunu bildirir.

void testRunFailed (String errorMessage)

Önemli bir hata nedeniyle rapor test çalıştırması tamamlanamadı.

void testRunStarted (String runName, int testCount)

Bir test çalıştırmasının başlangıcını bildirir.

void testRunStopped (long elapsedTime)

Kullanıcı isteği nedeniyle rapor test çalıştırması tamamlanmadan durduruldu.

void testStarted ( TestDescription test)

Bireysel bir test senaryosunun başlangıcını bildirir.

Alanlar

AFTER_FAILED_TESTCASES

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

Başarısız olan her test senaryosundan sonra tetiklenen, önceden tanımlanmış bir yüklem

BAŞLANGIÇTA

public static final BugreportCollector.Predicate AT_START

İlk çağrı başladığında tetiklenen, önceden tanımlanmış bir yüklem

Kamu inşaatçıları

Hata Raporu Toplayıcı

public BugreportCollector (ITestInvocationListener listener, 
                ITestDevice testDevice)

Parametreler
listener ITestInvocationListener

testDevice ITestDevice

Genel yöntemler

ekle Tahmin

public void addPredicate (BugreportCollector.Predicate p)

Parametreler
p BugreportCollector.Predicate

BlockUntilIdle

public void blockUntilIdle ()

Toplayıcı herhangi bir hata raporu toplamayana kadar engelleyin. Toplayıcı aktif olarak hata raporu toplamıyorsa hemen geri dönün

getÖzet

public TestSummary getSummary ()

InvokasyonListener'ın bir özet döndürmesine izin verir.

İadeler
TestSummary Çalıştırmayı özetleyen bir TestSummary veya null

çağırma sona erdi

public 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 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 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. Muhabirlerin birden fazla cihaz raporlamasını desteklemek için bu yöntemi geçersiz kılmaları gerekir.

Parametreler
context IInvocationContext : çağırma hakkında bilgi

setAsenkron

public void setAsynchronous (boolean asynchronous)

Hata raporu koleksiyonunun, hata raporunu farklı bir iş parçacığında mı toplaması gerektiğini ( asynchronous = true ) veya hata raporu yakalanana kadar arayanı mı engelleyeceğini ( asynchronous = false ) ayarlayın.

Parametreler
asynchronous boolean

setDescriptiveName

public void setDescriptiveName (String name)

Hata raporlarını kaydederken kullanılacak açıklayıcı adı ayarlayın. null ise BugreportCollector , hata raporunun toplanmasına neden olan olayın adının serileştirilmesi şeklindeki varsayılan davranışa geri dönecektir.

Parametreler
name String

setCihazBeklemeSüresi

public void setDeviceWaitTime (int waitTime)

Bir hata raporu yakalamaya çalışmadan önce cihazın Çevrimiçi olmasını bekleyeceği süreyi (saniye cinsinden) ayarlayın. Negatif ise herhangi bir kontrol yapılmayacaktır. Bu kontrol sırasında karşılaşılan herhangi bir DeviceNotAvailableException günlüğe kaydedilecek ve yok sayılacaktır.

Parametreler
waitTime int

testVarsayımBaşarısızlık

public 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

testSonlandı

public 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 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 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 void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Test çağrısından ilişkili günlük veya hata ayıklama verilerini sağlar.

ERROR(/ITestInvocationListener#invocationFailed(Throwable)) veya ERROR(/ITestInvocationListener#invocationEnded(long)) öncesinde çağrılmalıdır

TradeFederation çerçevesi, ana bilgisayar günlüğünü ve varsa cihazın günlük kaydını sağlayarak bu yöntemi otomatik olarak çağıracaktı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. Arayanlar, testLog yöntemi tamamlanana kadar veri kaynağının mevcut ve erişilebilir kalmasını sağlamalıdır.

testRunEnded

public 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 raporlanan anahtar/değer çiftleri.

testRun Başarısız

public 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 void testRunStarted (String runName, 
                int testCount)

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ı

testRunDurduruldu

public 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 void testStarted (TestDescription test)

Bireysel bir test senaryosunun başlangıcını bildirir. Eski arayüz, mümkün olduğunda testStarted(com.android.tradefed.result.TestDescription) kullanmalıdır.

Parametreler
test TestDescription : testi tanımlar