ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Object
com.android.tradefed.result.CollectingTestListener
com.android.tradefed.invoker.ShardListener


Bir çağrı parçasından (birden çok kaynakta paralel olarak çalışacak şekilde çağrı bölünmesi olarak da bilinir) sonuçları toplayan ve bunları başka bir dinleyiciye ileten bir ITestInvocationListener .

Özet

Kamu inşaatçıları

ShardListener ( ITestInvocationListener main)

Bir ShardListener oluşturun.

Genel yöntemler

getUnderlyingResultReporter ()
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 ( FailureDescription failure)

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

void invocationFailed (Throwable cause)

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

void invocationSkipped ( SkipReason reason)

Bir çağrıyı atlanmış olarak bildirir

void invocationStarted ( IInvocationContext context)

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

void logAssociation (String dataName, LogFile logFile)

Bazı durumlarda, günlüğün bir test durumuyla güçlü bir şekilde ilişkilendirilmesi gerekir, 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 arama mümkün değildir.

void setSupportGranularResults (boolean enableGranularResults)
boolean supportGranularResults ()

Muhabir ayrıntılı sonuçları destekliyorsa True değerini, aksi durumda false değerini döndürü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 testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

void testModuleEnded ()

Bir modül çalıştırması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ıştırmasının sonunu bildirir.

void testRunFailed ( FailureDescription failure)

FailureDescription tarafından açıklanan bir hata nedeniyle rapor test çalıştırması tamamlanamadı.

void testRunFailed (String failureMessage)

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

void testRunStarted (String name, int numTests, int attemptNumber, long startTime)

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

Kamu inşaatçıları

ShardListener

public ShardListener (ITestInvocationListener main)

Bir ShardListener oluşturun.

Parametreler
main ITestInvocationListener : ITestInvocationListener sonuçların iletilmesi gerekir. Diğer ShardListener çarpışmaları önlemek için, bu nesne, sonuçlar iletilirken main üzerinde senkronize edilecektir. Ve sonuçlar yalnızca çağrı parçası tamamlandıktan sonra gönderilecektir.

Genel yöntemler

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

İadeler

ç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 (FailureDescription failure)

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

TradeFederation çerçevesi tarafından otomatik olarak çağrılacaktır.

Parametreler
failure FailureDescription : Arızanın nedenini açıklayan FailureDescription

ç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ı atlandı

public void invocationSkipped (SkipReason reason)

Bir çağrıyı atlanmış olarak bildirir

Parametreler
reason SkipReason

ç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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Bazı durumlarda, günlüğün bir test durumuyla güçlü bir şekilde ilişkilendirilmesi gerekir, 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 arama mümkün değildir. Böylece bu geri arama, güçlü bir ilişkilendirmenin açıkça sağlanmasına olanak tanır.

Parametreler
dataName String : Verinin adı

logFile LogFile : Daha önce günlüğe kaydedilen ve test durumuyla ilişkilendirilmesi gereken LogFile .

setDestekAyrıntılıSonuçlar

public void setSupportGranularResults (boolean enableGranularResults)

Parametreler
enableGranularResults boolean

destekAyrıntılıSonuçlar

public boolean supportGranularResults ()

Muhabir ayrıntılı sonuçları destekliyorsa True değerini, aksi durumda false değerini döndürür.

İadeler
boolean

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 : Verilerin 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.

testLogKaydedildi

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Parametreler
dataName String

dataType LogDataType

dataStream InputStreamSource

logFile LogFile

testModuleEnded

public void testModuleEnded ()

Bir modül çalıştırmasının sonunu bildirir.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Çalışan bir modülün başlangıcını bildirir. Bu geri çağırma testModuleEnded() ile ilişkilidir ve dizide isteğe bağlıdır. Yalnızca modülleri kullanan bir çalıştırma 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ış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 (FailureDescription failure)

FailureDescription tarafından açıklanan bir hata nedeniyle rapor test çalıştırması tamamlanamadı.

Parametreler
failure FailureDescription : Arızayı ve içeriğini açıklayan FailureDescription .

testRun Başarısız

public void testRunFailed (String failureMessage)

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

Parametreler
failureMessage String : Çalıştırma hatasının nedenini açıklayan String .

testRunBaşlatıldı

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

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

Parametreler
name String : test çalıştırması adı

numTests int : test çalıştırmasındaki toplam test sayısı

attemptNumber int : aynı runName'in birden çok kez çalıştırılan farklı girişimlerini tanımlayan sipariş numarası. tryNumber 0 indekslidir ve her yeni çalıştırma gerçekleştiğinde artmalıdır. Örneğin, bir test 3 kez ayrıntılı olarak yeniden denenir, aynı runName altında toplam 4 çalıştırmaya sahip olmalıdır ve tryNumber değeri 0'dan 3'e kadar olmalıdır.

startTime long : koşunun başladığı saat, System.currentTimeMillis() aracılığıyla ölçülür