CollectingTestListener

public class CollectingTestListener
extends Object implements IDisableable, ILogSaverListener, ITestInvocationListener

java.lang.Object
   ↳ com.android.tradefed.result.CollectingTestListener

모든 테스트 결과를 수집하는 ITestInvocationListener입니다.

이 객체에 사용되는 데이터 구조는 스레드 안전하지만 ITestInvocationListener 콜백은 올바른 순서로 호출해야 합니다.

요약

공개 생성자

CollectingTestListener()

공개 메서드

IBuildInfo getBuildInfo()

이 메서드는 지원 중단되었습니다. getInvocationContext()의 IBuildInfo를 사용합니다.

TestRunResult getCurrentRunResults()

현재 테스트 실행의 결과를 가져옵니다.

int getExpectedTests()

예상 테스트 수를 반환합니다.

IInvocationContext getInvocationContext()

invocationStarted(com.android.tradefed.invoker.IInvocationContext)를 통해 보고된 호출 컨텍스트를 반환합니다.

getMergedTestRunResults()

여러 시도에서 모든 실행의 병합된 결과 컬렉션을 반환합니다.

IInvocationContext getModuleContextForRunResult(String testRunName)

결과와 연결된 모듈의 IInvocationContext를 반환합니다.

MultiMap<String, LogFile> getModuleLogFiles()

모듈과 연결된 로깅된 모든 파일이 포함된 맵의 사본을 반환합니다.

MultiMap<String, LogFile> getNonAssociatedLogFiles()

테스트 실행 또는 모듈과 연결되지 않은 로깅된 모든 파일이 포함된 맵의 사본을 반환합니다.

int getNumAllFailedTestRuns()

실패 상태의 총 테스트 실행 수를 반환합니다.

int getNumAllFailedTests()

실패 상태의 총 테스트 수를 반환합니다 (실패한 테스트만 반환됨, 가정 실패는 여기에 포함되지 않음).

int getNumTestsInState(TestStatus status)

이 실행에서 지정된 상태의 테스트 수를 반환합니다.

int getNumTestsInState(TestResult.TestStatus ddmlibStatus)

이전 상태 유형과의 호환성을 위해

int getNumTotalTests()

모든 실행의 완료된 총 테스트 수를 반환합니다.

IBuildInfo getPrimaryBuildInfo()

invocationStarted(com.android.tradefed.invoker.IInvocationContext)를 통해 보고된 기본 빌드 정보를 반환합니다.

getRunResults()

이 메서드는 지원 중단되었습니다. getMergedTestRunResults() 사용

TestRunResult getTestRunAtAttempt(String testRunName, int attempt)

단일 시도에 대해 TestRunResult를 반환합니다.

int getTestRunAttemptCount(String testRunName)

지정된 테스트 실행 이름의 시도 횟수를 반환합니다.

getTestRunAttempts(String testRunName)

지정된 테스트 실행의 TestRunResult에 대한 모든 시도를 가져옵니다.

getTestRunForAttempts(int attempt)

지정된 시도의 모든 결과를 가져옵니다.

getTestRunNames()

모든 테스트 실행의 모든 이름을 반환합니다.

boolean hasFailedTests()

호출에 실패한 테스트 또는 가정 실패 테스트가 있는지 여부를 반환합니다.

boolean hasTestRunResultsForName(String testRunName)

지정된 테스트 실행 이름에 결과가 있는지 여부를 반환합니다.

void invocationEnded(long elapsedTime)

호출이 성공적으로 종료되었는지 또는 일부 오류 조건으로 인해 종료되었는지 보고합니다.

void invocationFailed(Throwable cause)

일부 오류 조건으로 인해 불완전한 호출을 보고합니다.

void invocationSkipped(SkipReason reason)

호출을 건너뛴 것으로 보고

void invocationStarted(IInvocationContext context)

테스트 호출 시작을 보고합니다.

boolean isDisabled()

전체 객체가 사용 중지된 경우 true를 반환합니다 (설정 및 해제를 모두 건너뜀).

void logAssociation(String dataName, LogFile logFile)

경우에 따라 로그가 테스트 사례와 밀접하게 연결되어야 하지만, 직접적인 testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) 콜백에서는 로그가 테스트 사례와 밀접하게 연결되어야 합니다.

void setBuildInfo(IBuildInfo buildInfo)

이 메서드는 지원 중단되었습니다. 더 이상 테스트에 필요하지 않습니다.

void setDisable(boolean isDisabled)

객체를 사용 중지할지 여부를 설정합니다.

void setMergeStrategy(MergeStrategy strategy)

결과를 병합할 때 사용할 MergeStrategy를 설정합니다.

void testAssumptionFailure(TestDescription test, String trace)

원자 테스트에서 거짓인 조건을 가정한다고 플래그를 지정할 때 호출됩니다.

void testAssumptionFailure(TestDescription test, FailureDescription failure)

원자 테스트에서 거짓인 조건을 가정한다고 플래그를 지정할 때 호출됩니다.

void testEnded(TestDescription test, long endTime, testMetrics)

ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))의 대안으로, 종료 시간을 직접 지정할 수 있습니다.

void testEnded(TestDescription test, testMetrics)

개별 테스트 사례의 실행 종료를 보고합니다.

void testFailed(TestDescription test, FailureDescription failure)

개별 테스트 사례의 실패를 보고합니다.

void testFailed(TestDescription test, String trace)

개별 테스트 사례의 실패를 보고합니다.

void testIgnored(TestDescription test)

테스트가 실행되지 않을 때 호출됩니다(일반적으로 테스트 메서드에 org.junit.Ignore 주석이 추가되어 있기 때문).

void testModuleEnded()

모듈 실행 종료를 보고합니다.

void testModuleStarted(IInvocationContext moduleContext)

모듈 실행 시작을 보고합니다.

void testRunEnded(long elapsedTime, runMetrics)

테스트 실행 종료를 보고합니다.

void testRunFailed(FailureDescription failure)

FailureDescription에 설명된 실패로 인해 보고서 테스트 실행을 완료하지 못했습니다.

void testRunFailed(String errorMessage)

치명적인 오류로 인해 테스트 실행을 완료하지 못했습니다.

void testRunStarted(String name, int numTests, int attemptNumber)

테스트 실행 시작을 보고합니다.

void testRunStarted(String name, int numTests)

테스트 실행 시작을 보고합니다.

void testRunStarted(String name, int numTests, int attemptNumber, long startTime)

테스트 실행 시작을 보고합니다.

void testRunStopped(long elapsedTime)

사용자 요청으로 인해 보고서 테스트 실행이 완료되기 전에 중지되었습니다.

void testSkipped(TestDescription test, SkipReason reason)

테스트가 건너뛰어졌으며 일반적으로 예상되지 않는 이유로 실행되지 않았을 때 호출됩니다.

void testStarted(TestDescription test, long startTime)

테스트가 시작된 시점도 지정하는 testStarted(com.android.tradefed.result.TestDescription)의 대안으로, 정확한 측정을 위해 ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))와 함께 사용합니다.

void testStarted(TestDescription test)

개별 테스트 사례의 시작을 보고합니다.

보호된 메서드

final void clearModuleLogFiles()

모듈 파일을 정리하여 너무 오래 전송되지 않도록 합니다.

final void clearResultsForName(String testRunName)

지정된 실행 이름의 결과를 지울 수 있습니다.

void setIsAggregrateMetrics(boolean aggregate)

'집계 측정항목' 옵션 전환

공개 생성자

CollectingTestListener

public CollectingTestListener ()

공개 메서드

getBuildInfo

public IBuildInfo getBuildInfo ()

이 메서드는 지원 중단되었습니다.
는 getInvocationContext()의 IBuildInfo를 사용합니다.

빌드 정보를 반환합니다.

반환 값
IBuildInfo

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

현재 테스트 실행의 결과를 가져옵니다.

결과가 불완전할 수 있습니다. 결과를 처리하기 전에 TestRunResult.isRunComplete() 값 또는 (@link TestRunResult#isRunFailure()} 값을 적절하게 테스트하는 것이 좋습니다.

반환 값
TestRunResult 마지막 테스트 실행 중에 수집된 데이터를 나타내는 TestRunResult

get예상Tests

public int getExpectedTests ()

예상 테스트 수를 반환합니다. 일부 테스트가 실행되지 않은 경우 getNumTotalTests()와 다를 수 있습니다.

반환 값
int

getInvocationContext

public IInvocationContext getInvocationContext ()

invocationStarted(com.android.tradefed.invoker.IInvocationContext)를 통해 보고된 호출 컨텍스트를 반환합니다.

반환 값
IInvocationContext

getMergedTestRunResults

public  getMergedTestRunResults ()

여러 시도에서 모든 실행의 병합된 결과 컬렉션을 반환합니다.

결과가 여러 개인 경우 각 테스트 실행이 병합되며 최신 테스트 결과가 이전 실행의 테스트 결과를 덮어씁니다. 테스트 실행은 시도 횟수순으로 정렬됩니다.

동일한 시도의 측정항목은 aggregate-metrics에서 설정한 환경설정에 따라 병합됩니다. 최종 측정항목은 마지막 시도의 측정항목입니다.

반환 값

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

결과와 연결된 모듈의 IInvocationContext를 반환합니다.

매개변수
testRunName String: {testRunStarted(String, int)에서 지정한 이름입니다.
반환 값
IInvocationContext 해당 이름에 대한 결과가 없는 경우 지정된 테스트 실행 이름 null의 모듈 IInvocationContext입니다.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

모듈과 연결된 모든 로깅된 파일이 포함된 맵의 사본을 반환합니다.

반환 값
MultiMap<String, LogFile>

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

테스트 실행 또는 모듈과 연결되지 않은 로깅된 모든 파일이 포함된 맵의 사본을 반환합니다.

반환 값
MultiMap<String, LogFile>

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

실패 상태의 총 테스트 실행 수를 반환합니다.

반환 값
int

getNumAllFailedTests

public int getNumAllFailedTests ()

실패 상태인 총 테스트 수를 반환합니다 (실패만 반환되며 가정 실패는 집계에 포함되지 않음).

반환 값
int

getNumTestsInState

public int getNumTestsInState (TestStatus status)

이 실행에서 지정된 상태의 테스트 수를 반환합니다.

매개변수
status TestStatus

반환 값
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

이전 상태 유형과의 호환성을 위해

매개변수
ddmlibStatus TestResult.TestStatus

반환 값
int

getNumTotalTests

public int getNumTotalTests ()

모든 실행의 완료된 총 테스트 수를 반환합니다.

반환 값
int

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

invocationStarted(com.android.tradefed.invoker.IInvocationContext)를 통해 보고된 기본 빌드 정보를 반환합니다. 기본 빌드는 실행 중인 구성의 첫 번째 빌드 제공업체에서 반환한 빌드입니다. 컨텍스트가 없는 경우 (테스트 사례를 빌드할 수 없음) null을 반환합니다.

반환 값
IBuildInfo

getRunResults

public  getRunResults ()

이 메서드는 지원 중단되었습니다.
getMergedTestRunResults() 사용

모든 테스트 실행의 결과를 반환합니다.

반환 값

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

단일 시도에 대해 TestRunResult를 반환합니다.

매개변수
testRunName String: {testRunStarted(String, int)에서 지정한 이름입니다.
attempt int: 시도 ID입니다.
반환 값
TestRunResult 지정된 이름 및 시도 ID의 TestRunResult 또는 존재하지 않는 경우 null입니다.

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

지정된 테스트 실행 이름의 시도 횟수를 반환합니다.

매개변수
testRunName String: {testRunStarted(String, int)에서 지정한 이름입니다.
반환 값
int

getTestRunAttempts

public  getTestRunAttempts (String testRunName)

지정된 테스트 실행의 TestRunResult에 대한 모든 시도를 가져옵니다.

매개변수
testRunName String: {testRunStarted(String, int)에서 지정한 이름입니다.
반환 값
지정된 테스트 실행의 모든 TestRunResult로, 시도 횟수순으로 정렬됩니다.

getTestRunForAttempts

public  getTestRunForAttempts (int attempt)

지정된 시도의 모든 결과를 가져옵니다.

매개변수
attempt int: 결과를 원하는 시도입니다.
반환 값
특정 시도의 모든 TestRunResult입니다.

getTestRunNames

public  getTestRunNames ()

모든 테스트 실행의 이름을 모두 반환합니다.

이러한 테스트 실행은 여러 번 시도하여 여러 번 실행되었을 수 있습니다.

반환 값

hasFailedTests

public boolean hasFailedTests ()

호출에 실패한 테스트나 가정에 실패한 테스트가 있는 경우 반환합니다.

반환 값
boolean

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

지정된 테스트 실행 이름에 결과가 있는지 여부를 반환합니다.

매개변수
testRunName String: {testRunStarted(String, int)에서 지정한 이름입니다.
반환 값
boolean

invocationEnded

public void invocationEnded (long elapsedTime)

호출이 성공적 또는 일부 오류 조건으로 인해 종료되었음을 보고합니다.

TradeFederation 프레임워크에서 자동으로 호출됩니다.

매개변수
elapsedTime long: 호출에 걸린 시간(밀리초)

invocationFailed

public void invocationFailed (Throwable cause)

일부 오류 조건으로 인해 불완전한 호출을 보고합니다.

TradeFederation 프레임워크에서 자동으로 호출됩니다.

매개변수
cause Throwable: 실패의 Throwable 원인입니다.

invocationSkipped

public void invocationSkipped (SkipReason reason)

호출을 건너뛴 것으로 보고

매개변수
reason SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

테스트 호출 시작을 보고합니다.

TradeFederation 프레임워크에서 자동으로 호출됩니다. 여러 기기 보고를 지원하려면 리포터가 이 메서드를 재정의해야 합니다.

매개변수
context IInvocationContext: 호출에 관한 정보

isDisabled

public boolean isDisabled ()

전체 객체가 사용 중지된 경우 true를 반환합니다 (설정 및 해체 모두 건너뜁). 그렇지 않으면 false입니다.

반환 값
boolean

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

경우에 따라 로그를 테스트 사례와 밀접하게 연결해야 하지만 직접 testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) 콜백에서는 이를 실행할 수 없습니다. 따라서 이 콜백을 사용하면 강력한 연결을 명시적으로 제공할 수 있습니다.

매개변수
dataName String: 데이터 이름
logFile LogFile: 이전에 로깅되었으며 테스트 사례와 연결되어야 하는 LogFile입니다.

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

이 메서드는 지원 중단되었습니다.
더 이상 테스트에 필요하지 않습니다.

빌드 정보를 설정합니다. 테스트용으로만 사용해야 합니다.

매개변수
buildInfo IBuildInfo

setDisable

public void setDisable (boolean isDisabled)

객체를 사용 중지할지 여부를 설정합니다. 사용 중지됨은 설정 단계와 해체 단계를 모두 건너뛰어야 함을 의미합니다. 기본 생성자에서 기본적으로 사용 중지되는 객체를 만드는 데 사용할 수 있습니다.

매개변수
isDisabled boolean: 객체를 설정해야 하는 상태입니다.

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

결과를 병합할 때 사용할 MergeStrategy를 설정합니다.

매개변수
strategy MergeStrategy

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

원자 테스트에서 거짓인 조건을 가정한다고 플래그를 지정할 때 호출됩니다.

매개변수
test TestDescription: 테스트를 식별합니다.
trace String: 실패의 스택 트레이스

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

원자 테스트에서 거짓인 조건을 가정한다고 플래그를 지정할 때 호출됩니다.

매개변수
test TestDescription: 테스트를 식별합니다.
failure FailureDescription: 오류 및 컨텍스트를 설명하는 FailureDescription입니다.

testEnded

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

종료 시간을 직접 지정할 수 있는 ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))의 대안입니다. 정확한 측정을 위해 testStarted(com.android.tradefed.result.TestDescription, long)와 결합하세요.

매개변수
test TestDescription: 테스트를 식별합니다.
endTime long: System.currentTimeMillis()를 통해 측정된 테스트 종료 시간입니다.
testMetrics : 내보낸 측정항목의 ERROR(/Map)입니다.

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

개별 테스트 사례의 실행 종료를 보고합니다.

testFailed(TestDescription, FailureDescription)이 호출되지 않았다면 이 테스트는 통과한 것입니다. 또한 테스트 사례 실행 중에 내보냈을 수 있는 모든 키-값 측정항목도 반환합니다.

매개변수
test TestDescription: 테스트를 식별합니다.
testMetrics : 내보낸 측정항목의 ERROR(/Map)

테스트 실패

public void testFailed (TestDescription test, 
                FailureDescription failure)

개별 테스트 사례의 실패를 보고합니다.

testStarted와 testEnded 사이에서 호출됩니다.

매개변수
test TestDescription: 테스트를 식별합니다.
failure FailureDescription: 오류 및 컨텍스트를 설명하는 FailureDescription입니다.

testFailed

public void testFailed (TestDescription test, 
                String trace)

개별 테스트 사례의 실패를 보고합니다.

testStarted와 testEnded 사이에서 호출됩니다.

매개변수
test TestDescription: 테스트를 식별합니다.
trace String: 실패의 스택 트레이스

testIgnored

public void testIgnored (TestDescription test)

테스트가 실행되지 않을 때 호출됩니다(일반적으로 테스트 메서드에 org.junit.Ignore 주석이 추가되어 있기 때문).

매개변수
test TestDescription: 테스트를 식별합니다.

testModuleEnded

public void testModuleEnded ()

모듈 실행 종료를 보고합니다.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

모듈 실행 시작을 보고합니다. 이 콜백은 testModuleEnded()와 연결되며 시퀀스에서 선택사항입니다. 모듈 모음 기반 실행기를 사용하는 실행 중에만 사용됩니다.

매개변수
moduleContext IInvocationContext: 모듈의 IInvocationContext입니다.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

테스트 실행 종료를 보고합니다.

매개변수
elapsedTime long: 기기에서 보고한 경과 시간(밀리초)
runMetrics : 테스트 실행 종료 시 보고된 키-값 쌍

testRunFailed

public void testRunFailed (FailureDescription failure)

FailureDescription에 설명된 실패로 인해 보고서 테스트 실행을 완료하지 못했습니다.

매개변수
failure FailureDescription: 오류 및 컨텍스트를 설명하는 FailureDescription입니다.

testRunFailed

public void testRunFailed (String errorMessage)

치명적인 오류로 인해 테스트 실행을 완료하지 못했습니다.

매개변수
errorMessage String: 실행 실패 이유를 설명하는 String입니다.

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber)

테스트 실행 시작을 보고합니다.

매개변수
name String: 테스트 실행 이름
numTests int: 테스트 실행의 총 테스트 수
attemptNumber int: 주문 번호로, 여러 번 실행되는 동일한 runName의 여러 시도를 식별합니다. attemptNumber는 0으로 시작하며 새 실행이 발생할 때마다 증가해야 합니다. 예를 들어 테스트가 세부적으로 세 번 재시도되면 동일한 runName 아래에 총 4개의 실행이 있어야 하며 attemptNumber는 0~3입니다.

testRunStarted

public void testRunStarted (String name, 
                int numTests)

테스트 실행 시작을 보고합니다.

매개변수
name String: 테스트 실행 이름
numTests int: 테스트 실행의 총 테스트 수

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

테스트 실행 시작을 보고합니다.

매개변수
name String: 테스트 실행 이름
numTests int: 테스트 실행의 총 테스트 수
attemptNumber int: 순서 번호로, 여러 번 실행되는 동일한 runName의 여러 시도를 식별합니다. attemptNumber는 0으로 시작하며 새 실행이 발생할 때마다 증가해야 합니다. 예를 들어 테스트가 세부적으로 3번 재시도되면 동일한 runName 아래에 총 4개의 실행이 있어야 하며 attemptNumber는 0~3입니다.
startTime long: System.currentTimeMillis()를 통해 측정된 실행 시작 시간입니다.

testRunStopped

public void testRunStopped (long elapsedTime)

사용자 요청으로 인해 보고서 테스트 실행이 완료되기 전에 중지되었습니다.

TODO: 현재 사용되지 않으며 삭제해도 될 듯

매개변수
elapsedTime long: 기기에서 보고한 경과 시간(밀리초)

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

테스트가 건너뛰어졌으며 일반적으로 예상되지 않는 이유로 실행되지 않았을 때 호출됩니다. 이러한 테스트는 제대로 실행하기 위해 재시도됩니다.

매개변수
test TestDescription: 테스트를 식별합니다.
reason SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

테스트가 시작된 시점도 지정하는 testStarted(com.android.tradefed.result.TestDescription)의 대안으로, 정확한 측정을 위해 ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))와 함께 사용합니다.

매개변수
test TestDescription: 테스트를 식별합니다.
startTime long: System.currentTimeMillis()를 통해 측정된 테스트 시작 시간입니다.

testStarted

public void testStarted (TestDescription test)

개별 테스트 사례의 시작을 보고합니다. 이전 인터페이스이므로 가능하면 testStarted(com.android.tradefed.result.TestDescription)를 사용해야 합니다.

매개변수
test TestDescription: 테스트를 식별합니다.

보호된 메서드

clearModuleLogFiles

protected final void clearModuleLogFiles ()

모듈 파일을 정리하여 너무 오래 전송되지 않도록 합니다.

clearResultsForName

protected final void clearResultsForName (String testRunName)

지정된 실행 이름의 결과를 지울 수 있습니다. 결과 애그리게이터와 같은 일부 경우에만 사용해야 합니다.

매개변수
testRunName String

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

'집계 측정항목' 옵션 전환

매개변수
aggregate boolean