ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

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

---

Bir çağrı parçasını (yani birden fazla kaynakta paralel olarak çalışacak şekilde bölünmüş bir çağrı) toplayan ve başka bir dinleyiciye yönlendiren bir ITestInvocationListener.

Özet

Kamu inşaatçıları
ShardListener(ITestInvocationListener main) ShardListener oluşturun.

Herkese açık yöntemler
	getUnderlyingResultReporter()
void	invocationEnded(long elapsedTime) Çağrının başarıyla veya bir hata durumu nedeniyle 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	invocationSkipped(SkipReason reason) Çağrıyı atlandı 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ük, test durumları ile güçlü bir şekilde ilişkilendirilmelidir ancak doğrudan testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) geri çağırma işleminde bunu yapma olanağı yoktur.
void	setSupportGranularResults(boolean enableGranularResults)
boolean	supportGranularResults() Bildiren ayrıntılı sonuçları destekliyorsa Doğru değerini, aksi takdirde yanlış 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ün çalıştırılmasının sonunu bildirir.
void	testModuleStarted(IInvocationContext moduleContext) Bir modülün çalışmaya başlamasını bildirir.
void	testRunEnded(long elapsedTime, runMetrics) Test çalıştırmasının sonunu bildirir.
void	testRunFailed(FailureDescription failure) Raporlar test çalıştırması, FailureDescription tarafından açıklanan bir hata nedeniyle tamamlanamadı.
void	testRunFailed(String failureMessage) Raporlar test çalışması, önemli bir hata nedeniyle tamamlanamadı.
void	testRunStarted(String name, int numTests, int attemptNumber, long startTime) Test çalıştırmasının başlangıcını bildirir.

Herkese açık kurucular

Parçalayıcı

public ShardListener (ITestInvocationListener main)

Bir ShardListener oluşturun.

Parametreler
main	ITestInvocationListener: ITestInvocationListener sonuçları yönlendirilmelidir. Diğer ShardListener'lerle çakışmayı önlemek için bu nesne, sonuçlar yönlendirilirken main üzerinde senkronize edilir. Sonuçlar yalnızca çağrı kırıntıları tamamlandıktan sonra gönderilir.

Herkese açık yöntemler

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

İlerlemeler

çağrı Sona Erdi

public void invocationEnded (long elapsedTime)

Çağrının başarıyla veya bir hata durumu nedeniyle sonlandırıldığını bildirir.

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

Parametreler
elapsedTime	long: Çağrı için geçen süre (ms)

invocationFailed

public void invocationFailed (FailureDescription failure)

Bir hata durumu nedeniyle tamamlanmamış bir çağrıyı bildirir.

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

Parametreler
failure	FailureDescription: Hatanın nedenini açıklayan FailureDescription

invocationFailed

public void invocationFailed (Throwable cause)

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

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

Parametreler
cause	Throwable: Hatanın Throwable nedeni

invocationSkipped

public void invocationSkipped (SkipReason reason)

Çağrıyı atlandı olarak bildirir

Parametreler
reason	SkipReason

invocationStarted

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. Raporlamacıların, birden fazla cihazdan raporlamayı desteklemek için bu yöntemi geçersiz kılması gerekir.

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Bazı durumlarda günlük, test durumları ile güçlü bir şekilde ilişkilendirilmelidir ancak doğrudan testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) geri çağırma işleminde bunu yapma olanağı yoktur. Bu nedenle, bu geri çağırma, açıkça güçlü bir ilişkilendirme sağlamanıza olanak tanır.

Parametreler
dataName	String: Verilerin 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

supportGranularResults

public boolean supportGranularResults ()

Bildiren ayrıntılı sonuçları destekliyorsa doğru, aksi takdirde yanlış değerini döndürür.

İlerlemeler
boolean

testLog

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)) tarihinden önce çağrılmış olmalıdır.

TradeFederation çerçevesi, ana makine günlüğünü ve varsa cihaz logcat'ini sağlayarak bu yöntemi otomatik olarak çağırır.

Parametreler
dataName	String: Verilerin String açıklayı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ı işleyebilmelidir.
dataType	LogDataType: Verilerin LogDataType
dataStream	InputStreamSource: verilerin InputStreamSource öğesi. Uygulayıcılar, verileri okumaya başlamak için createInputStream'i çağırmalı ve işlem tamamlandığında sonuçta elde edilen Giriş Akışı'nı kapatmalıdır. Arayanlar, testLog yöntemi tamamlanana kadar verilerin kaynağının mevcut ve erişilebilir olduğundan emin olmalıdır.

testLogSaved

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ıştırılmasının sonunu bildirir.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Bir modülün çalışmaya başlaması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ı çalıştırıcılar.

Parametreler
moduleContext	IInvocationContext: modülün IInvocationContext bölümü.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

Parametreler
elapsedTime	long: Cihaz tarafından bildirilen geçen süre (milisaniye cinsinden)
runMetrics	: Test çalışmasının sonunda raporlanan anahtar/değer çiftleri

testRunBaşarısız

public void testRunFailed (FailureDescription failure)

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

Parametreler
failure	FailureDescription: FailureDescription hatayı ve bağlamını açıklayan.

testRunBaşarısız

public void testRunFailed (String failureMessage)

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

Parametreler
failureMessage	String: String, çalıştırma hatasının nedenini açıklıyor.

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 değerinin birden fazla kez çalıştırıldığı farklı denemelerin sırasını belirten sipariş numarası. attemptNumber, 0 tabanlı bir dizindir ve her yeni çalıştırma işleminde artar. Örneğin, bir test ayrıntılı olarak 3 kez yeniden denenirse aynı runName altında toplam 4 çalıştırma işlemi olur ve attemptNumber 0 ile 3 arasında bir değer alır.
startTime	long: koşunun başladığı zaman (System.currentTimeMillis() ile ölçülür)