ProtoResultReporter

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

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

Znane bezpośrednie podklasy FileProtoResultReporter , StreamProtoResultReporter FileProtoResultReporter Proto reporter, który zrzuca TestRecord do pliku. Reporter StreamProtoResultReporter Implementacja 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 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	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ł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()

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