ProtoResultReporter

public abstract class ProtoResultReporter
extends Object implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults

Obiekt Java.lang.Object
com.android.tradefed.result.proto.ProtoResultReporter


Reporter wyników tworzy protobuf TestRecord zawierający wszystkie wyniki. Należy rozszerzyć, aby obsługiwał, co zrobić z końcowym proto w processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord) .

Streszczenie

Konstruktorzy publiczni

ProtoResultReporter ()

Metody publiczne

final void invocationEnded (long elapsedTime)

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

void invocationFailed ( FailureDescription failure)

Zgłasza niekompletne wywołanie z powodu błędu.

void invocationFailed (Throwable cause)

Zgłasza niekompletne wywołanie z powodu błędu.

void invocationSkipped ( SkipReason reason)

Zgłasza wywołanie jako pominięte

final void invocationStarted ( IInvocationContext context)

Zgłasza początek wywołania testu.

final void logAssociation (String dataName, LogFile logFile)

W niektórych przypadkach log musi być ściśle powiązany z przypadkami testowymi, ale możliwość zrobienia tego bezpośrednio na testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) wywołanie zwrotne nie jest możliwe.

void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

Użyj rekordu wywołania, aby wysłać jeden po drugim wszystkie końcowe dzienniki wywołania.

void processFinalProto (TestRecordProto.TestRecord finalRecord)

Obsługa końcowego proto ze wszystkimi wynikami.

void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)

Wystąpiła obsługa proto rekordu testu częściowego wywołania po invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Obsługa sfinalizowanego rekordu przypadku testowego proto po wystąpieniu ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) .

void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Obsługa częściowego rekordu przypadku testowego proto po wystąpieniu testStarted(com.android.tradefed.result.TestDescription, long) .

void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Obsługa sfinalizowanego rekordu modułu proto po wystąpieniu testModuleEnded() .

void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

Obsługa częściowego rekordu modułu proto po wystąpieniu testModuleStarted(com.android.tradefed.invoker.IInvocationContext) .

void processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress)

Obsługa sfinalizowanego rekordu przebiegu po wystąpieniu ERROR(/#testRunEnded(long,HashMap)) .

void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Obsługa częściowego rekordu przebiegu testu proto po wystąpieniu testRunStarted(String, int) .

void setGranularResults (boolean granularResults)
void setInlineRecordOfChildren (boolean inline)
boolean supportGranularResults ()

Zwraca True, jeśli reporter obsługuje szczegółowe wyniki, w przeciwnym razie zwraca false.

final void testAssumptionFailure ( TestDescription test, String trace)

Wywoływana, gdy test atomowy sygnalizuje, że zakłada warunek, który jest fałszywy

final void testAssumptionFailure ( TestDescription test, FailureDescription failure)

Wywoływana, gdy test atomowy sygnalizuje, że zakłada warunek, który jest fałszywy

final void testEnded ( TestDescription test, long endTime, testMetrics) 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) testEnded ( TestDescription test, testMetrics)

Zgłasza koniec wykonania pojedynczego przypadku testowego.

final void testFailed ( TestDescription test, FailureDescription failure)

Zgłasza niepowodzenie pojedynczego przypadku testowego.

final void testFailed ( TestDescription test, String trace)

Zgłasza niepowodzenie pojedynczego przypadku testowego.

final void testIgnored ( TestDescription test)

Wywoływane, gdy test nie zostanie uruchomiony, zazwyczaj dlatego, że metoda testowa jest oznaczona adnotacją org.junit.Ignore.

final void testModuleEnded ()

Zgłasza koniec działania modułu.

final void testModuleStarted ( IInvocationContext moduleContext)

Zgłasza początek działania modułu.

final void testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics)

Zgłasza koniec przebiegu testowego.

final void testRunFailed ( FailureDescription failure)

Raportuje, że przebieg testu nie został ukończony z powodu błędu opisanego w FailureDescription .

final void testRunFailed (String errorMessage)

Raportuje, że przebieg testu nie został ukończony z powodu błędu krytycznego.

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

Zgłasza rozpoczęcie przebiegu testowego.

final void testRunStarted (String runName, int testCount)

Zgłasza rozpoczęcie przebiegu testowego.

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

Zgłasza rozpoczęcie przebiegu testowego.

final void testSkipped ( TestDescription test, SkipReason reason)

Wywoływane, gdy test został pominięty i nie został wykonany z powodu, którego zwykle się nie oczekuje.

final void testStarted ( TestDescription test, long startTime)

Alternatywa dla testStarted(com.android.tradefed.result.TestDescription) , gdzie określamy również, kiedy test został rozpoczęty, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) w celu dokładnego pomiaru .

final void testStarted ( TestDescription test)

Zgłasza rozpoczęcie pojedynczego przypadku testowego.

Metody chronione

TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

Tworzy odwołanie podrzędne dla modułu.

Konstruktorzy publiczni

ProtoResultReporter

public ProtoResultReporter ()

Metody publiczne

wywołanieZakończone

public final void invocationEnded (long elapsedTime)

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

Zostanie automatycznie wywołany przez platformę TradeFederation.

Parametry
elapsedTime long : czas wywołania, który upłynął w ms

wywołanie nie powiodło się

public void invocationFailed (FailureDescription failure)

Zgłasza niekompletne wywołanie z powodu błędu.

Zostanie automatycznie wywołany przez platformę TradeFederation.

Parametry
failure FailureDescription : FailureDescription opisujący przyczynę niepowodzenia

wywołanie nie powiodło się

public void invocationFailed (Throwable cause)

Zgłasza niekompletne wywołanie z powodu błędu.

Zostanie automatycznie wywołany przez platformę TradeFederation.

Parametry
cause Throwable : Throwable , czyli przyczyna niepowodzenia

wywołaniePominięte

public void invocationSkipped (SkipReason reason)

Zgłasza wywołanie jako pominięte

Parametry
reason SkipReason

wywołanieRozpoczęte

public final void invocationStarted (IInvocationContext context)

Zgłasza początek wywołania testu.

Zostanie automatycznie wywołany przez platformę TradeFederation. Reporterzy muszą zastąpić tę metodę, aby obsługiwać raporty z wielu urządzeń.

Parametry
context IInvocationContext : informacja o wywołaniu

stowarzyszenie log

public final void logAssociation (String dataName, 
                LogFile logFile)

W niektórych przypadkach log musi być ściśle powiązany z przypadkami testowymi, ale możliwość zrobienia tego bezpośrednio na testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) wywołanie zwrotne nie jest możliwe. Zatem to wywołanie zwrotne pozwala na wyraźne zapewnienie silnego powiązania.

Parametry
dataName String : nazwa danych

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

dzienniki procesuFinalInvocation

public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

Użyj rekordu wywołania, aby wysłać jeden po drugim wszystkie końcowe dzienniki wywołania.

Parametry
invocationLogs TestRecordProto.TestRecord : Sfinalizowany proto reprezentujący wywołanie.

procesFinalProto

public void processFinalProto (TestRecordProto.TestRecord finalRecord)

Obsługa końcowego proto ze wszystkimi wynikami.

Parametry
finalRecord TestRecordProto.TestRecord : Sfinalizowany proto ze wszystkimi wynikami wywołania.

procesStartInwokacja

public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, 
                IInvocationContext invocationContext)

Wystąpiła obsługa proto rekordu testu częściowego wywołania po invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

Parametry
invocationStartRecord TestRecordProto.TestRecord : Częściowy proto wypełniany po wywołaniuStart.

invocationContext IInvocationContext : Wywołanie IInvocationContext .

procesTestCaseEnded

public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Obsługa sfinalizowanego rekordu przypadku testowego proto po wystąpieniu ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) .

Parametry
testCaseRecord TestRecordProto.TestRecord : Sfinalizowane proto reprezentujące przypadek testowy.

Rozpoczęto procesTestCase

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Obsługa częściowego rekordu przypadku testowego proto po wystąpieniu testStarted(com.android.tradefed.result.TestDescription, long) .

Parametry
testCaseStartedRecord TestRecordProto.TestRecord : Częściowe proto reprezentujące przypadek testowy.

ProcessTestModuleEnd

public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Obsługa sfinalizowanego rekordu modułu proto po wystąpieniu testModuleEnded() .

Parametry
moduleRecord TestRecordProto.TestRecord : Sfinalizowany proto reprezentujący moduł.

ProcessTestModuleStarted

public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

Obsługa częściowego rekordu modułu proto po wystąpieniu testModuleStarted(com.android.tradefed.invoker.IInvocationContext) .

Parametry
moduleStartRecord TestRecordProto.TestRecord : Częściowe proto reprezentujące moduł.

procesTestRunEnded

public void processTestRunEnded (TestRecordProto.TestRecord runRecord, 
                boolean moduleInProgress)

Obsługa sfinalizowanego rekordu przebiegu po wystąpieniu ERROR(/#testRunEnded(long,HashMap)) .

Parametry
runRecord TestRecordProto.TestRecord : Sfinalizowany proto reprezentujący przebieg.

moduleInProgress boolean : czy moduł jest w toku.

ProcessTestRunStarted

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Obsługa częściowego rekordu przebiegu testu proto po wystąpieniu testRunStarted(String, int) .

Parametry
runStartedRecord TestRecordProto.TestRecord : Częściowe proto reprezentujące przebieg.

setGranularResults

public void setGranularResults (boolean granularResults)

Parametry
granularResults boolean

setInlineRecordOfChildren

public void setInlineRecordOfChildren (boolean inline)

Parametry
inline boolean

wsparcieGranularResults

public boolean supportGranularResults ()

Zwraca True, jeśli reporter obsługuje szczegółowe wyniki, w przeciwnym razie zwraca false.

Zwroty
boolean

testZałożenieNiepowodzenie

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Wywoływana, gdy test atomowy sygnalizuje, że zakłada warunek, który jest fałszywy

Parametry
test TestDescription : identyfikuje test

trace String : ślad stosu awarii

testZałożenieNiepowodzenie

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Wywoływana, gdy test atomowy sygnalizuje, że zakłada warunek, który jest fałszywy

Parametry
test TestDescription : identyfikuje test

failure FailureDescription : FailureDescription opisujący awarię i jej kontekst.

testZakończony

public final 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. Połącz z testStarted(com.android.tradefed.result.TestDescription, long) , aby uzyskać dokładny pomiar.

Parametry
test TestDescription : identyfikuje test

endTime long : czas zakończenia testu mierzony za pomocą System.currentTimeMillis()

testMetrics : ERROR(/Map) emitowanych metryk

testZakończony

public void testEnded (TestDescription test, 
                 testMetrics)

Zgłasza koniec wykonania pojedynczego przypadku testowego.

Jeśli testFailed(TestDescription, FailureDescription) nie został wywołany, test zakończył się pomyślnie. Zwraca również wszelkie metryki klucz/wartość, które mogły zostać wyemitowane podczas wykonywania przypadku testowego.

Parametry
test TestDescription : identyfikuje test

testMetrics : ERROR(/Map) emitowanych metryk

Test nieudany

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Zgłasza niepowodzenie pojedynczego przypadku testowego.

Będzie wywoływany pomiędzy testStarted i testEnded.

Parametry
test TestDescription : identyfikuje test

failure FailureDescription : FailureDescription opisujący awarię i jej kontekst.

Test nieudany

public final void testFailed (TestDescription test, 
                String trace)

Zgłasza niepowodzenie pojedynczego przypadku testowego.

Będzie wywoływany pomiędzy testStarted i testEnded.

Parametry
test TestDescription : identyfikuje test

trace String : ślad stosu awarii

testIgnorowany

public final void testIgnored (TestDescription test)

Wywoływane, gdy test nie zostanie uruchomiony, zazwyczaj dlatego, że metoda testowa jest oznaczona adnotacją org.junit.Ignore.

Parametry
test TestDescription : identyfikuje test

moduł testowyZakończony

public final void testModuleEnded ()

Zgłasza koniec działania modułu.

Uruchomiono moduł testowy

public final void testModuleStarted (IInvocationContext moduleContext)

Zgłasza początek działania modułu. To wywołanie zwrotne jest powiązane z testModuleEnded() i jest opcjonalne w sekwencji. Jest używany tylko podczas biegu, który wykorzystuje moduły: biegacze bazujący na pakiecie.

Parametry
moduleContext IInvocationContext : IInvocationContext modułu.

testRunZakończony

public final void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Zgłasza koniec przebiegu testowego. FIXME: Nie możemy mieć dwóch interfejsów Map<> różnych typów, więc musimy tutaj użyć HashMap.

Parametry
elapsedTimeMillis long : urządzenie zgłosiło czas, który upłynął, w milisekundach

runMetrics : pary klucz-wartość zgłaszane na koniec przebiegu testowego z Metric .

testRun nie powiódł się

public final void testRunFailed (FailureDescription failure)

Raportuje, że przebieg testu nie został ukończony z powodu błędu opisanego w FailureDescription .

Parametry
failure FailureDescription : FailureDescription opisujący awarię i jej kontekst.

testRun nie powiódł się

public final void testRunFailed (String errorMessage)

Raportuje, że przebieg testu nie został ukończony z powodu błędu krytycznego.

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

Uruchomiono testRun

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

Zgłasza rozpoczęcie przebiegu testowego.

Parametry
runName String : nazwa przebiegu testowego

testCount int : całkowita liczba testów w przebiegu testu

attemptNumber int : numer zamówienia, identyfikujący różne próby tej samej nazwy runName, które są uruchamiane wiele razy. PróbaNumber jest indeksowana przez 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. np. test jest szczegółowo powtarzany 3 razy, powinien mieć w sumie 4 przebiegi pod tą samą nazwą uruchomienia, a numer próby wynosi od 0 do 3.

Uruchomiono testRun

public final void testRunStarted (String runName, 
                int testCount)

Zgłasza rozpoczęcie przebiegu testowego.

Parametry
runName String : nazwa przebiegu testowego

testCount int : całkowita liczba testów w przebiegu testu

Uruchomiono testRun

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

Zgłasza rozpoczęcie przebiegu testowego.

Parametry
runName String : nazwa przebiegu testowego

testCount int : całkowita liczba testów w przebiegu testu

attemptNumber int : numer zamówienia, identyfikujący różne próby tej samej nazwy runName, które są uruchamiane wiele razy. PróbaNumber jest indeksowana przez 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. np. test jest szczegółowo powtarzany 3 razy, powinien mieć w sumie 4 przebiegi pod tą samą nazwą uruchomienia, a numer próby wynosi od 0 do 3.

startTime long : czas rozpoczęcia przebiegu mierzony za pomocą System.currentTimeMillis()

testPominięty

public final void testSkipped (TestDescription test, 
                SkipReason reason)

Wywoływane, gdy test został pominięty i nie został wykonany z powodu, którego zwykle się nie oczekuje. Testy te zostaną ponowione, aby zapewnić ich prawidłowe wykonanie.

Parametry
test TestDescription : identyfikuje test

reason SkipReason : SkipReason

test rozpoczęty

public final void testStarted (TestDescription test, 
                long startTime)

Alternatywa dla testStarted(com.android.tradefed.result.TestDescription) , gdzie określamy również, kiedy test został rozpoczęty, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) w celu dokładnego pomiaru .

Parametry
test TestDescription : identyfikuje test

startTime long : czas rozpoczęcia testu mierzony za pomocą System.currentTimeMillis()

test rozpoczęty

public final void testStarted (TestDescription test)

Zgłasza rozpoczęcie pojedynczego przypadku testowego. Starszy interfejs, jeśli to możliwe, należy używać testStarted(com.android.tradefed.result.TestDescription) .

Parametry
test TestDescription : identyfikuje test

Metody chronione

utwórzModuleChildReference

protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

Tworzy odwołanie podrzędne dla modułu.

Parametry
record TestRecordProto.TestRecord

Zwroty
TestRecordProto.ChildReference