ResultDBReporter

public class ResultDBReporter
extends Object implements IConfigurationReceiver, ILogSaverListener, ISupportGranularResults, ITestSummaryListener

java.lang.Object
   ↳ com.android.tradefed.result.resultdb.ResultDBReporter

Podsumowanie

Stałe

int MAX_PRIMARY_ERROR_MESSAGE_BYTES

int MAX_SUMMARY_HTML_BYTES

Konstruktory publiczne

ResultDBReporter()

Metody publiczne

TestSummary getSummary()

Umożliwia wywoływaniu zwracanie podsumowania.

void invocationEnded(long elapsedTime)

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

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)

Informuje o rozpoczęciu 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 setConfiguration(IConfiguration configuration)

Wstrzykuje IConfiguration w użyciu.

void setLogSaver(ILogSaver logSaver)

Ustaw wartość ILogSaver, aby umożliwić implementatorowi zapisywanie plików.

boolean supportGranularResults()

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

void testAssumptionFailure(TestDescription test, String trace)

Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.

void testAssumptionFailure(TestDescription test, FailureDescription failure)

Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.

void testEnded(TestDescription test, long endTime, testMetrics)

Alternatywa dla ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), gdzie możemy bezpośrednio określić czas zakończenia.

void testEnded(TestDescription test, testMetrics)

Raportuje zakończenie wykonywania pojedynczego przypadku testu.

void testFailed(TestDescription test, FailureDescription failure)

Raportuje niepowodzenie pojedynczego przypadku testowego.

void testFailed(TestDescription test, String trace)

Raportuje niepowodzenie pojedynczego przypadku testowego.

void testIgnored(TestDescription test)

Wywoływany, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testu jest oznaczona adnotacją org.junit.Ignore.

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

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

void testModuleEnded()

Raportuje koniec wykonania modułu.

void testModuleStarted(IInvocationContext moduleContext)

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

void testRunEnded(long elapsedTimeMillis, runMetrics)

Raport o zakończeniu testu.

void testRunFailed(FailureDescription failure)

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

void testRunFailed(String errorMessage)

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

void testRunStarted(String runName, int testCount, int attemptNumber)

Raport o rozpoczęciu testu.

void testRunStarted(String runName, int testCount)

Raport o rozpoczęciu testu.

void testRunStarted(String runName, int testCount, int attemptNumber, long startTime)

Raport o rozpoczęciu testu.

void testRunStopped(long elapsedTime)

Raporty o testach, które zostały przerwane przed zakończeniem na prośbę użytkownika.

void testSkipped(TestDescription test, SkipReason reason)

Wywoływany, gdy test jest pomijany i nie jest wykonywany z nieoczekiwanego powodu.

void testStarted(TestDescription test, long startTime)

Alternatywa dla testStarted(com.android.tradefed.result.TestDescription), w której określamy też, kiedy test się rozpoczął, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)), aby uzyskać dokładne wyniki.

void testStarted(TestDescription test)

Raportuje rozpoczęcie pojedynczego testu.

Stałe

MAX_PRIMARY_ERROR_MESSAGE_BYTES

public static final int MAX_PRIMARY_ERROR_MESSAGE_BYTES

Wartość stała: 1024 (0x00000400)

MAX_SUMMARY_HTML_BYTES

public static final int MAX_SUMMARY_HTML_BYTES

Wartość stała: 4096 (0x00001000)

Konstruktory publiczne

ResultDBReporter

public ResultDBReporter ()

Metody publiczne

getSummary

public TestSummary getSummary ()

Umożliwia wywoływaniu zwracanie podsumowania.

Zwroty
TestSummary TestSummary podsumowujący wykonanie, lub wartość null.

invocationEnded

public void invocationEnded (long elapsedTime)

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

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)

Informuje o rozpoczęciu 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 testu.

setConfiguration

public void setConfiguration (IConfiguration configuration)

Wstrzykuje IConfiguration w użyciu.

Parametry
configuration IConfiguration

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Ustaw wartość ILogSaver, aby umożliwić implementatorowi zapisywanie plików.

Parametry
logSaver ILogSaver: ILogSaver

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.

Parametry
test TestDescription: identyfikuje test
trace String: zrzut stosu błędu

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.

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

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Alternatywa dla ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), gdzie możemy bezpośrednio określić czas zakończenia. Aby uzyskać dokładne pomiary, połącz je z elementem testStarted(com.android.tradefed.result.TestDescription, long).

Parametry
test TestDescription: identyfikuje test
endTime long: czas zakończenia testu mierzony za pomocą funkcji System.currentTimeMillis()
testMetrics : ERROR(/Map) danych wyemitowanych

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Raportuje zakończenie wykonywania pojedynczego przypadku testu.

Jeśli funkcja testFailed(TestDescription, FailureDescription) nie została wywołana, test się powiódł. Zwraca też wszystkie dane klucz-wartość, które mogły zostać wyemitowane podczas wykonywania testu.

Parametry
test TestDescription: identyfikuje test
testMetrics : ERROR(/Map) danych wyemitowanych

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Raportuje niepowodzenie pojedynczego przypadku testowego.

Jest wywoływany między testStarted i testEnded.

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

testFailed

public void testFailed (TestDescription test, 
                String trace)

Raportuje niepowodzenie pojedynczego przypadku testowego.

Jest wywoływany między testStarted i testEnded.

Parametry
test TestDescription: identyfikuje test
trace String: zrzut stosu błędu

testIgnored

public void testIgnored (TestDescription test)

Wywoływany, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testu jest oznaczona adnotacją org.junit.Ignore.

Parametry
test TestDescription: identyfikuje test

testLog

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

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

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

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 elapsedTimeMillis, 
                 runMetrics)

Raport o zakończeniu testu.

Parametry
elapsedTimeMillis long: czas upłynął, w milisekundach
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 errorMessage)

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

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

Raport o rozpoczęciu testu.

Parametry
runName String: nazwa testu
testCount 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 jest indeksowany od 0 i powinien zwiększać się za każdym razem, gdy następuje nowe wykonanie. Przykład: test jest szczegółowo powtarzany 3 razy, więc powinien mieć łącznie 4 wykonania pod tym samym runName, a attemptNumber powinien przyjmować wartości od 0 do 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Raport o rozpoczęciu testu.

Parametry
runName String: nazwa testu
testCount int: łączna liczba testów w sesji testowej

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Raport o rozpoczęciu testu.

Parametry
runName String: nazwa testu
testCount 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 runName, a attemptNumber powinien mieć wartość od 0 do 3.
startTime long: czas rozpoczęcia wykonywania zadania, mierzony za pomocą System.currentTimeMillis()

testRunStopped

public void testRunStopped (long elapsedTime)

Raporty o testach, które zostały przerwane przed zakończeniem na prośbę użytkownika.

TODO: currently unused, consider removing

Parametry
elapsedTime long: czas upłynął, w milisekundach

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Wywoływany, gdy test jest pomijany i nie jest wykonywany z nieoczekiwanego powodu. Te testy zostaną powtórzone, aby sprawdzić, czy tym razem wszystko się uda.

Parametry
test TestDescription: identyfikuje test
reason SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternatywa dla testStarted(com.android.tradefed.result.TestDescription), w której określamy też, kiedy test się rozpoczął, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)), aby uzyskać dokładne wyniki.

Parametry
test TestDescription: identyfikuje test
startTime long: czas rozpoczęcia testu mierzony za pomocą funkcji System.currentTimeMillis()

testStarted

public void testStarted (TestDescription test)

Raportuje rozpoczęcie pojedynczego testu. Starszy interfejs, którego należy używać w miarę możliwości w przypadku testStarted(com.android.tradefed.result.TestDescription).

Parametry
test TestDescription: identyfikuje test