베이스포스트 프로세서

public abstract class BasePostProcessor
extends Object implements IPostProcessor

java.lang.Object
com.android.tradefed.postprocessor.BasePostProcessor


모든 구현이 확장되어야 하는 기본 IPostProcessor 입니다. 최종 결과 보고 전에 사후 처리 메서드가 호출되는지 확인하세요.

요약

공개 생성자

BasePostProcessor ()

공개 메소드

final ITestInvocationListener init ( ITestInvocationListener listener)

포스트 프로세서의 초기화 단계입니다.

final void invocationEnded (long elapsedTime)

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

final void invocationFailed ( FailureDescription failure)

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

final void invocationFailed (Throwable cause)

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

void invocationSkipped ( SkipReason reason)

호출을 건너뛴 것으로 보고합니다.

final void invocationStarted ( IInvocationContext context)

전달을 위한 호출 리스너

final boolean isDisabled ()

전체 객체가 비활성화된 경우 True를 반환합니다(설정과 해제를 모두 건너뛰기).

final void logAssociation (String dataName, LogFile logFile)

어떤 경우에는 로그가 테스트 케이스와 강력하게 연관되어야 하지만 직접 testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) 에서 그렇게 할 수 있는 기회가 있습니다. testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) 콜백이 불가능합니다.

로그-테스트 연결을 업데이트합니다.

processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs) processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)

모든 테스트에서 측정항목과 로그를 집계하려면 이 방법을 구현하세요.

abstract processRunMetricsAndLogs ( rawMetrics, runLogs) processRunMetricsAndLogs ( rawMetrics, runLogs) processRunMetricsAndLogs ( rawMetrics, runLogs)

기존 측정항목과 로그에서 새로운 측정항목 집합을 생성하려면 이 방법을 구현하세요.

processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs) processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs) processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs)

각 테스트의 측정항목 및 로그를 게시하려면 이 방법을 구현하세요.

final void setLogSaver ( ILogSaver logSaver)

구현자가 파일을 저장할 수 있도록 ILogSaver 설정합니다.

void setUp ()

테스트가 실행되기 전에 초기화하려면 하위 사후 프로세서에서 이 메서드를 재정의하세요.

final void testAssumptionFailure ( TestDescription test, String trace)

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

final void testAssumptionFailure ( TestDescription test, FailureDescription failure)

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

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

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

final void testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics)

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

final void testFailed ( TestDescription test, FailureDescription failure)

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

final void testFailed ( TestDescription test, String trace)

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

final void testIgnored ( TestDescription test)

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

final void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)

PostProcessor 구현에서 파일을 기록하려면 이 메서드를 사용합니다.

final void testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

테스트 로그가 저장될 때 호출됩니다.

final void testModuleEnded ()

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

final void testModuleStarted ( IInvocationContext moduleContext)

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

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

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

final void testRunFailed ( FailureDescription failure)

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

final void testRunFailed (String errorMessage)

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

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

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

final void testRunStarted (String runName, int testCount)

테스트 실행 콜백

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

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

final void testRunStopped (long elapsedTime)

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

final void testSkipped ( TestDescription test, SkipReason reason)

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

final void testStarted ( TestDescription test, long startTime)

정확한 측정을 위해 ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) 와 결합하여 테스트 시작 시기도 지정하는 testStarted(com.android.tradefed.result.TestDescription) 의 대안입니다. .

final void testStarted ( TestDescription test)

테스트 케이스 콜백

보호된 방법

MetricMeasurement.DataType getMetricType ()

필요한 경우 측정항목 유형을 변경하려면 이 메서드를 재정의하세요.

String getRunName ()

공개 생성자

베이스포스트 프로세서

public BasePostProcessor ()

공개 메소드

초기화

public final ITestInvocationListener init (ITestInvocationListener listener)

포스트 프로세서의 초기화 단계입니다. 테스트 콜백 전에 호출되도록 보장됩니다.

매개변수
listener ITestInvocationListener

보고
ITestInvocationListener

호출종료됨

public final void invocationEnded (long elapsedTime)

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

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

매개변수
elapsedTime long : 호출 경과 시간(ms)

호출 실패

public final void invocationFailed (FailureDescription failure)

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

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

매개변수
failure FailureDescription : 실패 원인을 설명하는 FailureDescription

호출 실패

public final void invocationFailed (Throwable cause)

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

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

매개변수
cause Throwable : Throwable 실패 원인

호출을 건너뛰었습니다.

public void invocationSkipped (SkipReason reason)

호출을 건너뛴 것으로 보고합니다.

매개변수
reason SkipReason

호출시작됨

public final void invocationStarted (IInvocationContext context)

전달을 위한 호출 리스너

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

비활성화됨

public final boolean isDisabled ()

전체 객체가 비활성화된 경우 True를 반환합니다(설정 및 해제 모두 건너뛰기). 그렇지 않으면 거짓입니다.

보고
boolean

로그 연관

public final void logAssociation (String dataName, 
                LogFile logFile)

어떤 경우에는 로그가 테스트 케이스와 강력하게 연관되어야 하지만 직접 testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) 에서 그렇게 할 수 있는 기회가 있습니다. testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) 콜백이 불가능합니다. 따라서 이 콜백을 사용하면 명시적으로 강력한 연관을 제공할 수 있습니다.

로그-테스트 연결을 업데이트합니다. 테스트 중에 이 메소드가 호출되면 로그는 테스트에 속합니다. 그렇지 않으면 실행 로그가 됩니다.

매개변수
dataName String : 데이터의 이름

logFile LogFile : 이전에 기록되었으며 테스트 사례와 연결되어야 하는 LogFile 입니다.

processAllTestMetricsAndLogs

public  processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, 
                 allTestLogs)

모든 테스트에서 측정항목과 로그를 집계하려면 이 방법을 구현하세요. 이 방법에서 나오는 측정항목은 실행 측정항목으로 보고됩니다. 새로 생성된 측정항목만 고유한 키 이름으로 반환되어야 합니다(기존 키와의 충돌은 허용되지 않음).

매개변수
allTestMetrics ListMultimap : 메트릭 이름별로 그룹화된 각 테스트의 메트릭을 저장하는 HashMultimap입니다.

allTestLogs : 각 테스트의 TestDescription 키로 사용하여 데이터 이름으로 키가 지정된 각 테스트의 로그 파일 맵을 저장하는 맵입니다.

보고
모든 테스트 측정항목에서 새로 생성된 측정항목 집합입니다.

processRunMetricsAndLogs

public abstract  processRunMetricsAndLogs ( rawMetrics, 
                 runLogs)

기존 측정항목과 로그에서 새로운 측정항목 집합을 생성하려면 이 방법을 구현하세요. 새로 생성된 측정항목만 고유한 키 이름으로 반환되어야 합니다(기존 키와의 충돌은 허용되지 않음).

매개변수
rawMetrics : 실행에 사용할 수 있는 원시 측정항목 집합입니다.

runLogs : 테스트 실행을 위한 로그 파일 세트입니다.

보고
실행 측정항목에서 새로 생성된 측정항목 집합입니다.

processTestMetricsAndLogs

public  processTestMetricsAndLogs (TestDescription testDescription, 
                 testMetrics, 
                 testLogs)

각 테스트의 측정항목 및 로그를 게시하려면 이 방법을 구현하세요. 새로 생성된 측정항목만 고유한 키 이름으로 반환되어야 합니다(기존 키와의 충돌은 허용되지 않음).

매개변수
testDescription TestDescription : 테스트를 설명하는 TestDescription 개체입니다.

testMetrics : 테스트의 측정항목 집합입니다.

testLogs : 테스트 중에 기록된 파일 세트입니다.

보고
테스트 측정항목에서 새로 생성된 측정항목 집합입니다.

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

구현자가 파일을 저장할 수 있도록 ILogSaver 설정합니다.

매개변수
logSaver ILogSaver : ILogSaver

설정

public void setUp ()

테스트가 실행되기 전에 초기화하려면 하위 사후 프로세서에서 이 메서드를 재정의하세요.

테스트가정실패

public final void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

trace String : 실패 스택 추적

테스트가정실패

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

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

failure FailureDescription : 실패와 해당 컨텍스트를 설명하는 FailureDescription .

테스트 종료됨

public final 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)

테스트 종료됨

public final void testEnded (TestDescription test, 
                 testMetrics)

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

testFailed(TestDescription, FailureDescription) 호출되지 않은 경우 이 테스트는 통과된 것입니다. 또한 테스트 사례 실행 중에 방출되었을 수 있는 모든 키/값 측정항목을 반환합니다.

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

testMetrics : 내보낸 측정항목의 ERROR(/Map)

테스트 실패

public final void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

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

failure FailureDescription : 실패와 해당 컨텍스트를 설명하는 FailureDescription .

테스트 실패

public final void testFailed (TestDescription test, 
                String trace)

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

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

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

trace String : 실패 스택 추적

테스트는 무시됨

public final void testIgnored (TestDescription test)

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

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

테스트로그

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

PostProcessor 구현에서 파일을 기록하려면 이 메서드를 사용합니다.

매개변수
dataName String : 데이터를 설명하는 String 이름입니다. 예: "device_logcat". 참고 dataName은 호출마다 고유하지 않을 수 있습니다. 즉, 구현자는 동일한 dataName을 사용하여 여러 호출을 처리할 수 있어야 합니다.

dataType LogDataType : 데이터의 LogDataType

dataStream InputStreamSource : 데이터의 InputStreamSource . 구현자는 createInputStream을 호출하여 데이터 읽기를 시작하고 완료되면 결과 InputStream을 닫아야 합니다. 호출자는 testLog 메서드가 완료될 때까지 데이터 소스가 계속 존재하고 액세스 가능한지 확인해야 합니다.

테스트로그저장됨

public final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

테스트 로그가 저장될 때 호출됩니다.

ITestInvocationListener#testLog(String, LogDataType, InputStreamSource) 대신 사용해야 합니다.

매개변수
dataName String : 데이터를 설명하는 String 이름입니다. 예: "device_logcat". 참고 dataName은 호출마다 고유하지 않을 수 있습니다. 즉, 구현자는 동일한 dataName을 사용하여 여러 호출을 처리할 수 있어야 합니다.

dataType LogDataType : 데이터의 LogDataType

dataStream InputStreamSource : 데이터의 InputStreamSource . 구현자는 createInputStream을 호출하여 데이터 읽기를 시작하고 완료되면 결과 InputStream을 닫아야 합니다.

logFile LogFile : 저장된 파일의 메타데이터가 포함된 LogFile 입니다.

테스트모듈종료됨

public final void testModuleEnded ()

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

테스트모듈시작됨

public final void testModuleStarted (IInvocationContext moduleContext)

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

매개변수
moduleContext IInvocationContext : 모듈의 IInvocationContext .

테스트실행이 종료됨

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

테스트 실행 종료를 보고합니다. FIXME: 서로 다른 유형의 두 개의 Map<> 인터페이스를 가질 수 없으므로 여기서는 HashMap을 사용해야 합니다.

매개변수
elapsedTime long : 장치가 보고한 경과 시간(밀리초)

runMetrics : Metric 사용한 테스트 실행이 끝나면 보고된 키-값 쌍입니다.

테스트실행실패

public final void testRunFailed (FailureDescription failure)

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

매개변수
failure FailureDescription : 실패와 해당 컨텍스트를 설명하는 FailureDescription .

테스트실행실패

public final void testRunFailed (String errorMessage)

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

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

테스트실행시작됨

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

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

매개변수
runName String : 테스트 실행 이름

testCount int : 테스트 실행의 총 테스트 수

attemptNumber int : 여러 번 실행되는 동일한 runName의 다양한 시도를 식별하는 주문 번호입니다. tryNumber는 0부터 인덱스가 지정되며 새 실행이 발생할 때마다 증가해야 합니다. 예를 들어 테스트는 세 번 세분화되어 재시도됩니다. 동일한 runName에서 총 4번의 실행이 있어야 하며, tryNumber는 0에서 3 사이입니다.

테스트실행시작됨

public final void testRunStarted (String runName, 
                int testCount)

테스트 실행 콜백

매개변수
runName String : 테스트 실행 이름

testCount int : 테스트 실행의 총 테스트 수

테스트실행시작됨

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

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

매개변수
runName String : 테스트 실행 이름

testCount int : 테스트 실행의 총 테스트 수

attemptNumber int : 여러 번 실행되는 동일한 runName의 다양한 시도를 식별하는 주문 번호입니다. tryNumber는 0부터 인덱스가 지정되며 새 실행이 발생할 때마다 증가해야 합니다. 예를 들어 테스트는 세 번 세분화되어 재시도됩니다. 동일한 runName에서 총 4번의 실행이 있어야 하며, tryNumber는 0에서 3 사이입니다.

startTime long : System.currentTimeMillis() 통해 측정된 실행이 시작된 시간

테스트실행중지됨

public final void testRunStopped (long elapsedTime)

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

TODO: 현재 사용되지 않습니다. 제거를 고려하세요.

매개변수
elapsedTime long : 장치가 보고한 경과 시간(밀리초)

테스트를 건너뛰었습니다.

public final void testSkipped (TestDescription test, 
                SkipReason reason)

테스트를 건너뛰고 일반적으로 예상되지 않는 이유로 실행되지 않을 때 호출됩니다. 이러한 테스트는 적절한 실행을 위해 재시도됩니다.

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

reason SkipReason : SkipReason

테스트시작됨

public final void testStarted (TestDescription test, 
                long startTime)

정확한 측정을 위해 ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) 와 결합하여 테스트가 시작된 시기도 지정하는 testStarted(com.android.tradefed.result.TestDescription) 의 대안입니다. .

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

startTime long : System.currentTimeMillis() 통해 측정된 테스트가 시작된 시간입니다.

테스트시작됨

public final void testStarted (TestDescription test)

테스트 케이스 콜백

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

보호된 방법

getMetricType

protected MetricMeasurement.DataType getMetricType ()

필요한 경우 측정항목 유형을 변경하려면 이 메서드를 재정의하세요. 기본적으로 측정항목은 처리된 유형으로 설정됩니다.

보고
MetricMeasurement.DataType

getRunName

protected String getRunName ()

보고
String