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. |
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 |
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 |
void | processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord) Obsługa sfinalizowanego rekordu przypadku testowego proto po wystąpieniu |
void | processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord) Obsługa częściowego rekordu przypadku testowego proto po wystąpieniu |
void | processTestModuleEnd (TestRecordProto.TestRecord moduleRecord) Obsługa sfinalizowanego rekordu modułu proto po wystąpieniu |
void | processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord) Obsługa częściowego rekordu modułu proto po wystąpieniu |
void | processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress) Obsługa sfinalizowanego rekordu przebiegu po wystąpieniu |
void | processTestRunStarted (TestRecordProto.TestRecord runStartedRecord) Obsługa częściowego rekordu przebiegu testu proto po wystąpieniu |
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 |
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 |
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 | testStarted ( TestDescription test, long startTime) Alternatywa dla |
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ł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 | 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() |
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 |