ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

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

ITestInvocationListener, który zbiera wyniki z fragmentu wywołania (czyli wywołania podzielonego na kilka zasobów do działania równoległego) i przekazuje je innemu odbiorcy.

Podsumowanie

Konstruktory publiczne

ShardListener(ITestInvocationListener main)

Utwórz ShardListener.

Metody publiczne

getUnderlyingResultReporter()
void invocationEnded(long elapsedTime)

Informuje, że wywołanie zostało zakończone (z powodu błędu lub pomyślnie).

void invocationFailed(FailureDescription failure)

zgłasza niepełne wywołanie z powodu błędu.

void invocationFailed(Throwable cause)

zgłasza niepełne wywołanie z powodu błędu.

void invocationSkipped(SkipReason reason)

zgłasza wywołanie jako pominięte;

void invocationStarted(IInvocationContext context)

Raportuje rozpoczęcie wywołania testu.

void logAssociation(String dataName, LogFile logFile)

W niektórych przypadkach log musi być silnie powiązany z przypadkami testowymi, ale nie można tego zrobić bezpośrednio w wywołaniu testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile).

void setSupportGranularResults(boolean enableGranularResults)
boolean supportGranularResults()

Zwraca wartość „True” (Prawda), jeśli raportujący obsługuje szczegółowe wyniki, w przeciwnym razie zwraca wartość „False” (Fałsz).

void testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)

Zawiera powiązane dane dziennika lub debugowania z wywołania testu.

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

void testModuleEnded()

Raportuje koniec wykonania modułu.

void testModuleStarted(IInvocationContext moduleContext)

zgłasza rozpoczęcie działania modułu.

void testRunEnded(long elapsedTime, runMetrics)

Raportuje zakończenie testu.

void testRunFailed(FailureDescription failure)

Nie udało się przeprowadzić testu raportów z powodu błędu opisanego w FailureDescription.

void testRunFailed(String failureMessage)

Nie udało się przeprowadzić testu raportów z powodu krytycznego błędu.

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

Raportuje rozpoczęcie testu.

Konstruktory publiczne

ShardListener

public ShardListener (ITestInvocationListener main)

Utwórz ShardListener.

Parametry
main ITestInvocationListener: ITestInvocationListener wyników, które mają zostać przesłane. Aby zapobiec kolizji z innymi obiektami ShardListener, ten obiekt będzie synchronizowany z usługą main podczas przesyłania wyników. Wyniki zostaną wysłane dopiero po zakończeniu wywołania.

Metody publiczne

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

Zwroty

invocationEnded

public void invocationEnded (long elapsedTime)

Informuje, że wywołanie zostało zakończone (z powodu błędu lub pomyślnie).

Będzie wywoływany automatycznie przez platformę TradeFederation.

Parametry
elapsedTime long: upłynął czas wywołania w ms

invocationFailed

public void invocationFailed (FailureDescription failure)

zgłasza niepełne wywołanie z powodu błędu.

Będzie wywoływany automatycznie przez platformę TradeFederation.

Parametry
failure FailureDescription: FailureDescription opisujący przyczynę niepowodzenia

invocationFailed

public void invocationFailed (Throwable cause)

zgłasza niepełne wywołanie z powodu błędu.

Będzie wywoływany automatycznie przez platformę TradeFederation.

Parametry
cause Throwable: przyczyna niepowodzenia Throwable

invocationSkipped

public void invocationSkipped (SkipReason reason)

zgłasza wywołanie jako pominięte;

Parametry
reason SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

Raportuje rozpoczęcie wywołania testu.

Będzie wywoływany automatycznie przez platformę TradeFederation. Aby umożliwić raportowanie z kilku urządzeń, autorzy raportów muszą zastąpić tę metodę.

Parametry
context IInvocationContext: informacje o wywołaniu;

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

W niektórych przypadkach log musi być silnie powiązany z przypadkami testowymi, ale nie można tego zrobić bezpośrednio w wywołaniu testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile). Dzięki temu wywołaniu zwrotnemu można wyraźnie powiązać dane.

Parametry
dataName String: nazwa danych
logFile LogFile: LogFile, który został wcześniej zarejestrowany i powinien być powiązany z przypadkiem testowym.

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

Parametry
enableGranularResults boolean

supportGranularResults

public boolean supportGranularResults ()

Zwraca wartość „True” (Prawda), jeśli raportujący obsługuje szczegółowe wyniki, w przeciwnym razie zwraca wartość „False” (Fałsz).

Zwroty
boolean

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Zawiera powiązane dane dziennika lub debugowania z wywołania testu.

Musi być wywołany przed ERROR(/ITestInvocationListener#invocationFailed(Throwable)) lub ERROR(/ITestInvocationListener#invocationEnded(long))

Framework TradeFederation automatycznie wywoła tę metodę, podając log hosta i w razie potrzeby logcat urządzenia.

Parametry
dataName String: Stringnazwa opisowa danych, np. „device_logcat”. Uwaga: nazwa danych może nie być unikalna dla każdego wywołania. Oznacza to, że implementatorzy muszą mieć możliwość obsługi wielu wywołań z tą samą nazwą danych.
dataType LogDataType: LogDataType danych
dataStream InputStreamSource: InputStreamSource danych. Implementatorzy powinni wywołać createInputStream, aby rozpocząć odczytywanie danych, i upewnić się, że zamkną powstały strumień wejściowy po zakończeniu. Osoby wywołujące tę metodę powinny zadbać o to, aby źródło danych było dostępne do momentu zakończenia metody testLog.

testLogSaved

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

Parametry
dataName String

dataType LogDataType

dataStream InputStreamSource

logFile LogFile

testModuleEnded

public void testModuleEnded ()

Raportuje koniec wykonania modułu.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

zgłasza rozpoczęcie działania modułu. To wywołanie zwrotne jest powiązane z testModuleEnded() i jest opcjonalne w sekwencji. Jest używany tylko podczas wykonywania testu, który korzysta z modułów: modułów opartych na zestawach.

Parametry
moduleContext IInvocationContext: IInvocationContext modułu.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Raportuje zakończenie testu.

Parametry
elapsedTime long: czas upłynął, milisekundy zgłoszone przez urządzenie
runMetrics : pary klucz-wartość zgłoszone na końcu wykonania testu

testRunFailed

public void testRunFailed (FailureDescription failure)

Nie udało się przeprowadzić testu raportów z powodu błędu opisanego w FailureDescription.

Parametry
failure FailureDescription: FailureDescription opisujący błąd i jego kontekst.

testRunFailed

public void testRunFailed (String failureMessage)

Nie udało się przeprowadzić testu raportów z powodu krytycznego błędu.

Parametry
failureMessage String: String opisujący przyczynę niepowodzenia wykonania.

testRunStarted

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

Raportuje rozpoczęcie testu.

Parametry
name String: nazwa testu;
numTests int: łączna liczba testów w sesji testowej
attemptNumber int: numer zamówienia, który identyfikuje różne próby tego samego runName, które są wykonywane wielokrotnie. attemptNumber ma indeks 0 i powinien zwiększać się za każdym razem, gdy następuje nowe uruchomienie. Przykład: test jest szczegółowo powtarzany 3 razy, więc powinien mieć łącznie 4 uruchomienia pod tym samym nazwą runName, a wartość attemptNumber powinna się zmieniać od 0 do 3.
startTime long: czas rozpoczęcia wykonywania zadania, mierzony za pomocą System.currentTimeMillis()