ProtoResultReporter

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

java.lang.Object
com.android.tradefed.result.proto.ProtoResultReporter


Reporter wyników tworzy protobuf TestRecord ze wszystkimi wynikami w środku. Należy rozszerzyć, aby obsłużyć, 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)

Informuje, ż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 jakiegoś błędu.

void invocationFailed (Throwable cause)

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

final void invocationStarted ( IInvocationContext context)

Zgłasza początek wywołania testowego.

final void logAssociation (String dataName, LogFile logFile)

W niektórych przypadkach dziennik musi być silnie powiązany z przypadkami testowymi, ale możliwość zrobienia tego w bezpośrednim testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) 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)

Obsługa częściowego rekordu testu wywołania po wystąpieniu invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Obsługa sfinalizowanego protokołu rekordu przypadku testowego po ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) .

void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Obsługa częściowego protokołu rekordu przypadku testowego po testStarted(com.android.tradefed.result.TestDescription, long) .

void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Obsługa sfinalizowanego protokołu rekordu modułu po testModuleEnded() .

void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

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

void processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress)

Obsługa sfinalizowanego proto rekordu uruchomienia po ERROR(/#testRunEnded(long,HashMap)) .

void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Obsługa częściowego rekordu przebiegu testu po 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 false.

final void testAssumptionFailure ( TestDescription test, String trace)

Wywoływane, gdy atomowy test zaznaczy, że przyjmuje warunek, który jest fałszywy

final void testAssumptionFailure ( TestDescription test, FailureDescription failure)

Wywoływane, gdy atomowy test zaznaczy, że przyjmuje 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)

Raportuje zakończenie wykonywania 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, zwykle dlatego, że metoda testowa ma adnotację org.junit.Ignore.

final void testModuleEnded ()

Zgłasza koniec uruchomienia modułu.

final void testModuleStarted ( IInvocationContext moduleContext)

Raportuje początek działania modułu.

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

Raportuje koniec uruchomienia testowego.

final void testRunFailed ( FailureDescription failure)

Testowanie raportów nie powiodło się z powodu błędu opisanego przez FailureDescription .

final void testRunFailed (String errorMessage)

Testowanie raportów nie powiodło się z powodu błędu krytycznego.

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

Raportuje początek uruchomienia testowego.

final void testRunStarted (String runName, int testCount)

Raportuje początek uruchomienia testowego.

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

Raportuje początek uruchomienia testowego.

final void testStarted ( TestDescription test, long startTime)

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

final void testStarted ( TestDescription test)

Raportuje początek indywidualnego 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

inwokacjaZakończona

public final void invocationEnded (long elapsedTime)

Informuje, ż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 trwania wywołania w ms

wywołanie nie powiodło się

public void invocationFailed (FailureDescription failure)

Zgłasza niekompletne wywołanie z powodu jakiegoś 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 jakiegoś błędu.

Zostanie automatycznie wywołany przez platformę TradeFederation.

Parametry
cause Throwable : Throwable przyczyna niepowodzenia

wywołanieRozpoczęto

public final void invocationStarted (IInvocationContext context)

Zgłasza początek wywołania testowego.

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

Parametry
context IInvocationContext : informacje o wywołaniu

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

W niektórych przypadkach dziennik musi być silnie powiązany z przypadkami testowymi, ale możliwość zrobienia tego w bezpośrednim testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) nie jest możliwe. W ten sposób to wywołanie zwrotne umożliwia jawne zapewnienie silnego skojarzenia.

Parametry
dataName String : nazwa danych

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

procesFinalInvocationLogs

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.

processStartInwokacja

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

Obsługa częściowego rekordu testu wywołania po wystąpieniu invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

Parametry
invocationStartRecord TestRecordProto.TestRecord : częściowe proto wypełnione po wywołaniuStart.

invocationContext IInvocationContext : wywołanie IInvocationContext .

procesTestCaseEnd

public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Obsługa sfinalizowanego protokołu rekordu przypadku testowego po ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) .

Parametry
testCaseRecord TestRecordProto.TestRecord : sfinalizowany proto reprezentujący przypadek testowy.

procesTestCaseStarted

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Obsługa częściowego protokołu rekordu przypadku testowego po testStarted(com.android.tradefed.result.TestDescription, long) .

Parametry
testCaseStartedRecord TestRecordProto.TestRecord : częściowy proto reprezentujący przypadek testowy.

processTestModuleEnd

public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Obsługa sfinalizowanego protokołu rekordu modułu po testModuleEnded() .

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

processTestModuleStarted

public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

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

Parametry
moduleStartRecord TestRecordProto.TestRecord : częściowy proto reprezentujący moduł.

procesTestUruchomionyZakończony

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

Obsługa sfinalizowanego proto rekordu uruchomienia po ERROR(/#testRunEnded(long,HashMap)) .

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

moduleInProgress boolean : czy moduł jest w toku.

procesTestUruchomiony

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

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

Parametry
runStartedRecord TestRecordProto.TestRecord : częściowy proto reprezentujący przebieg.

setGranularResults

public void setGranularResults (boolean granularResults)

Parametry
granularResults boolean

setInlineRecordOfChildren

public void setInlineRecordOfChildren (boolean inline)

Parametry
inline boolean

supportGranularResults

public boolean supportGranularResults ()

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

Zwroty
boolean

testZałożenieNiepowodzenie

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Wywoływane, gdy atomowy test zaznaczy, że przyjmuje 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ływane, gdy atomowy test zaznaczy, że przyjmuje warunek, który jest fałszywy

Parametry
test TestDescription : identyfikuje test

failure FailureDescription : FailureDescription opisująca niepowodzenie i jego 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)

Raportuje zakończenie wykonywania pojedynczego przypadku testowego.

Jeśli testFailed(TestDescription, FailureDescription) nie został wywołany, ten 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.

Zostanie wywołana między testStarted i testEnded.

Parametry
test TestDescription : identyfikuje test

failure FailureDescription : FailureDescription opisująca niepowodzenie i jego kontekst.

Test nieudany

public final void testFailed (TestDescription test, 
                String trace)

Zgłasza niepowodzenie pojedynczego przypadku testowego.

Zostanie wywołana między testStarted i testEnded.

Parametry
test TestDescription : identyfikuje test

trace String : ślad stosu awarii

testIgnorowane

public final void testIgnored (TestDescription test)

Wywoływane, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testowa ma adnotację org.junit.Ignore.

Parametry
test TestDescription : identyfikuje test

testModułZakończony

public final void testModuleEnded ()

Zgłasza koniec uruchomienia modułu.

testModułUruchomiony

public final void testModuleStarted (IInvocationContext moduleContext)

Raportuje 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 używa modułów: biegaczy opartych na pakiecie.

Parametry
moduleContext IInvocationContext : IInvocationContext modułu.

TestUruchomionyZakończony

public final void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Raportuje koniec uruchomienia testowego. FIXME: Nie możemy mieć dwóch interfejsów Map<> o różnych typach, 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łoszone na koniec testu z Metric .

TestRunFailed

public final void testRunFailed (FailureDescription failure)

Testowanie raportów nie powiodło się z powodu błędu opisanego przez FailureDescription .

Parametry
failure FailureDescription : FailureDescription opisująca niepowodzenie i jego kontekst.

TestRunFailed

public final void testRunFailed (String errorMessage)

Testowanie raportów nie powiodło się z powodu błędu krytycznego.

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

testUruchomiony

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

Raportuje początek uruchomienia testowego.

Parametry
runName String : nazwa uruchomienia testowego

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

attemptNumber int : numer porządkowy, identyfikujący różne próby tego samego runName, które są uruchamiane wiele razy. PróbaNumber jest indeksowana 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. Np. Test jest powtarzany 3 razy na poziomie granularnym, powinien mieć łącznie 4 przebiegi pod tą samą nazwą runName, a numer próby wynosi od 0 do 3.

testUruchomiony

public final void testRunStarted (String runName, 
                int testCount)

Raportuje początek uruchomienia testowego.

Parametry
runName String : nazwa uruchomienia testowego

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

testUruchomiony

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

Raportuje początek uruchomienia testowego.

Parametry
runName String : nazwa uruchomienia testowego

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

attemptNumber int : numer porządkowy, identyfikujący różne próby tego samego runName, które są uruchamiane wiele razy. PróbaNumber jest indeksowana 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. Np. Test jest powtarzany 3 razy na poziomie granularnym, powinien mieć łącznie 4 przebiegi pod tą samą nazwą runName, a numer próby wynosi od 0 do 3.

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

testRozpoczęto

public final void testStarted (TestDescription test, 
                long startTime)

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

Parametry
test TestDescription : identyfikuje test

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

testRozpoczęto

public final void testStarted (TestDescription test)

Raportuje początek indywidualnego przypadku testowego. Starszy interfejs powinien używać testStarted(com.android.tradefed.result.TestDescription) , gdy tylko jest to możliwe.

Parametry
test TestDescription : identyfikuje test

Metody chronione

createModuleChildReference

protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

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

Parametry
record TestRecordProto.TestRecord

Zwroty
TestRecordProto.ChildReference