Hata Raporu Toplayıcı

public class BugreportCollector
extends Object implements ITestInvocationListener

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

---

Yapılandırılabilir olaylar gerçekleştiğinde hata raporlarını toplayan ve ardından her hata raporu toplandıktan sonra alt öğelerinde ITestInvocationListener#testLog çağıran doğrudan geçişli bir ITestInvocationListener .

Davranışlar: (FIXME: bunu bitir)

• Herhangi bir test durumu başarısız olursa her birinden sonra yakalayın
• Her test durumundan sonra yakalayın
• Başarısız olan her test durumundan sonra yakalayın
• Esir almak

Özet

İç içe 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 koşul
public static final BugreportCollector.Predicate	AT_START İlk çağırma başladığında harekete geçen ö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 () InvocationListener'ın bir özet döndürmesine izin verir.
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.
void	setAsynchronous (boolean asynchronous) Hata raporu koleksiyonunun hata raporunu farklı bir ileti dizisinde toplaması ( asynchronous = true ) veya hata raporu yakalanana kadar ( asynchronous = false ) arayanı engellemesi gerekip gerekmediğini 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ı beklemek için süreyi (saniye olarak) ayarlayın.
void	testAssumptionFailure ( TestDescription test, String trace) Bir atomik test, yanlış olan bir koşulu varsaydığını işaretlediğinde çağrılır
void	testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Tek bir test senaryosunun yürütme sonunu 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	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ışmasının sonunu bildirir.
void	testRunFailed (String errorMessage) Raporlar test çalıştırması, önemli bir hata nedeniyle tamamlanamadı.
void	testRunStarted (String runName, int testCount) 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) Tek 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 koşul

BAŞLANGIÇTA

public static final BugreportCollector.Predicate AT_START

İlk çağırma başladığında harekete geçen ö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

ek yüklem

public void addPredicate (BugreportCollector.Predicate p)

parametreler
p	BugreportCollector.Predicate

blokUntilidle

public void blockUntilIdle ()

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

Özeti al

public TestSummary getSummary ()

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

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

Ç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 : hatanın ERROR(/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

setAsenkronize

public void setAsynchronous (boolean asynchronous)

Hata raporu koleksiyonunun hata raporunu farklı bir ileti dizisinde toplaması ( asynchronous = true ) veya hata raporu yakalanana kadar ( asynchronous = false ) arayanı engellemesi gerekip gerekmediğini ayarlayın.

parametreler
asynchronous	boolean

setTanımlayıcıAd

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ı serileştirme şeklindeki varsayılan davranışa geri dönecektir.

parametreler
name	String

CihazBekleme Süresini ayarla

public void setDeviceWaitTime (int waitTime)

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

parametreler
waitTime	int

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 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	: yayılan metriklerde bir ERROR(/Map)

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

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, bu yöntemi otomatik olarak çağırarak ana bilgisayar günlüğünü ve uygunsa cihaz logcat'ini sağlar.

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.

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

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ı

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)

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