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ı (diğer adıyla, paralel olarak birden fazla kaynakta çalıştırılacak bir çağırma bölmesi) sonuçlarını toplayan ve bunları başka bir dinleyiciye yönlendiren bir ITestInvocationListener.

Özet

Herkese açık oluşturucular

ShardListener(ITestInvocationListener main)

ShardListener oluşturun.

Herkese açık yöntemler

List<ITestInvocationListener> getUnderlyingResultReporter()
void invocationEnded(long elapsedTime)

Çağırmanın başarıyla mı yoksa bir hata durumu nedeniyle mi sonlandırıldığını bildirir.

void invocationFailed(FailureDescription failure)

Bir hata durumu nedeniyle eksik bir çağırma bildirir.

void invocationFailed(Throwable cause)

Bir hata durumu nedeniyle eksik bir çağırma bildirir.

void invocationSkipped(SkipReason reason)

Bir çağırmayı 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üğün test senaryolarıyla güçlü bir şekilde ilişkilendirilmesi gerekir ancak doğrudan testLogSaved(String,LogDataType,InputStreamSource,LogFile) geri çağırmada bunu yapmak mümkün değildir.

void setSupportGranularResults(boolean enableGranularResults)
boolean supportGranularResults()

Rapor oluşturucu ayrıntılı sonuçları destekliyorsa True (Doğru), aksi takdirde False (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 çalıştırmanın sonunu bildirir.

void testModuleStarted(IInvocationContext moduleContext)

Çalışan bir modülün başlangıcını bildirir.

void testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)

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

void testRunFailed(FailureDescription failure)

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

void testRunFailed(String failureMessage)

Raporlar test çalıştırması, ölümcül 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 oluşturucular

ShardListener

public ShardListener (ITestInvocationListener main)

ShardListener oluşturun.

Parametreler
main ITestInvocationListener: Sonuçların yönlendirileceği ITestInvocationListener. Diğer ShardListener'larla çakışmaları önlemek için bu nesne, sonuçları yönlendirirken main üzerinde senkronize edilir. Sonuçlar yalnızca çağırma parçası tamamlandıktan sonra gönderilir.

Herkese açık yöntemler

getUnderlyingResultReporter

public List<ITestInvocationListener> getUnderlyingResultReporter ()

İadeler
List<ITestInvocationListener>

invocationEnded

public void invocationEnded (long elapsedTime)

Çağırmanın başarıyla mı yoksa bir hata durumu nedeniyle mi sonlandırıldığını bildirir.

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

Parametreler
elapsedTime long: çağrının geçen süresi (ms)

invocationFailed

public void invocationFailed (FailureDescription failure)

Bir hata durumu nedeniyle eksik bir çağırma bildirir.

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

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

invocationFailed

public void invocationFailed (Throwable cause)

Bir hata durumu nedeniyle eksik bir çağırma 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)

Bir çağırmayı 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ılır. Raporcuların, birden fazla cihazın raporlamasını desteklemek için bu yöntemi geçersiz kılması gerekir.

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Bazı durumlarda, günlüğün test senaryolarıyla güçlü bir şekilde ilişkilendirilmesi gerekir ancak doğrudan testLogSaved(String,LogDataType,InputStreamSource,LogFile) geri çağırmada bunu yapmak mümkün değildir. Bu nedenle, bu geri çağırma, güçlü bir ilişkilendirme sağlamaya olanak tanır.

Parametreler
dataName String: Verilerin adı
logFile LogFile: Daha önce kaydedilmiş ve test senaryosuyla ilişkilendirilmesi gereken LogFile.

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

Parametreler
enableGranularResults boolean

supportGranularResults

public boolean supportGranularResults ()

Raporlayıcı ayrıntılı sonuçları destekliyorsa True, aksi takdirde False değerini döndürür.

İadeler
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)/ITestInvocationListener#invocationFailed(java.lang.Throwable) ITestInvocationListener.invocationFailed(Throwable)) veya ERROR(/ITestInvocationListener#invocationEnded(long)) tarihinden önce aranmalıdır.

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

Parametreler
dataName String: Verilerin String açıklayıcı adı. Örneğin, "device_logcat". Not dataName, her çağırmada benzersiz olmayabilir. Yani uygulayıcılar, aynı dataName ile birden fazla çağrıyı işleyebilmelidir.
dataType LogDataType: Verilerin LogDataType
dataStream InputStreamSource: verilerin InputStreamSource. Uygulayıcılar, verileri okumaya başlamak için createInputStream'i çağırmalı ve tamamlandığında sonuçtaki 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.

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 çalıştırmanı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ül kullanan bir çalıştırma sırasında kullanılır: pakete dayalı çalıştırıcılar.

Parametreler
moduleContext IInvocationContext: modülün IInvocationContext.

testRunEnded

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

Test çalıştırmasının sonunu bildirir. DÜZELTİLMESİ GEREKEN YER: Farklı türde iki Map<> arayüzümüz olamaz. Bu nedenle burada HashMap kullanmamız gerekiyor.

Parametreler
elapsedTime long: Cihazın bildirdiği geçen süre (milisaniye cinsinden)
runMetrics HashMap: Metric ile yapılan bir test çalıştırmasının sonunda bildirilen anahtar/değer çiftleri.

testRunFailed

public void testRunFailed (FailureDescription failure)

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

Parametreler
failure FailureDescription: FailureDescription arızayı ve bağlamını açıklayın.

testRunFailed

public void testRunFailed (String failureMessage)

Raporlar test çalıştırması, ölümcül bir hata nedeniyle tamamlanamadı.

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

testRunStarted

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

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

Parametreler
name String: Test çalıştırmasının adı
numTests int: test çalıştırmasındaki toplam test sayısı
attemptNumber int: Aynı runName'in birden fazla kez çalıştırılan farklı denemelerini tanımlayan sipariş numarası. attemptNumber, 0 tabanlıdır ve her yeni çalıştırmada artırılmalıdır. Örneğin, bir test 3 kez ayrıntılı olarak yeniden denenirse aynı runName altında toplam 4 çalıştırma olmalı ve attemptNumber 0 ile 3 arasında olmalıdır.
startTime long: Çalıştırmanın başladığı zaman (System.currentTimeMillis() üzerinden ölçülür)