ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

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

---

Bir çağırma parçasından (paralel olarak birden çok kaynakta çalışacak bir çağırma 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ıyla veya bazı hata durumlarından dolayı çağrının sonlandırıldığını bildirir.
void	invocationFailed ( FailureDescription failure) Bazı hata koşulları nedeniyle tamamlanmamış bir çağrı 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	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) üzerinde 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.
void	setSupportGranularResults (boolean enableGranularResults)
boolean	supportGranularResults () Muhabir ayrıntılı sonuçları destekliyorsa True, aksi halde false 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ü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ı, FailureDescription tarafından tanımlanan bir hata nedeniyle tamamlanamadı.
void	testRunFailed (String failureMessage) Raporlar test çalıştırması, önemli bir hata nedeniyle tamamlanamadı.
void	testRunStarted (String name, int numTests, int attemptNumber, long startTime) Bir test çalışmasının başladığı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 s ile çarpışmaları önlemek için bu nesne, sonuçları iletirken main üzerinde eşitlenir. Sonuçlar yalnızca çağırma parçası tamamlandığında gönderilir.

Genel yöntemler

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

İadeler

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

Bazı hata koşulları nedeniyle tamamlanmamış bir çağrı bildirir.

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

parametreler
failure	FailureDescription : hatanın nedenini açıklayan FailureDescription

ç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

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) üzerinde 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 .

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

parametreler
enableGranularResults	boolean

destekGranülerSonuçlar

public boolean supportGranularResults ()

Muhabir ayrıntılı sonuçları destekliyorsa True, aksi halde false 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, 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.

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ü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 failureMessage)

Raporlar test çalıştırması, önemli bir hata nedeniyle tamamlanamadı.

parametreler
failureMessage	String : ERROR(/String) çalışma hatasının nedenini açıklıyor.

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şim Numarası 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, ERROR(/System#currentTimeMillis()) aracılığıyla ölçülür