BasePostProcessor

public abstract class BasePostProcessor
extends Object implements IPostProcessor

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

알려진 직접 서브클래스 AggregatePostProcessor, AveragePostProcessor, BluetoothConnectionSuccessRatePostProcessor, MetricFilePostProcessor, PerfettoGenericPostProcessor, PerfettoTracePostProcessor, StatsdGenericPostProcessor AggregatePostProcessor 여러 반복 테스트 실행 중에 수집된 숫자 측정항목에 대해 최소, 최대, 평균, 분산, 표준 편차, 합계, 개수, 선택적으로 백분위수를 제공하는 측정항목 애그리게이터입니다. 측정항목은 double로 처리됩니다.  AveragePostProcessor 측정항목 목록의 평균을 계산하는 후처리기의 구현  BluetoothConnectionSuccessRatePostProcessor 블루투스 프로필의 성공률을 계산하는 후처리기 구현 'metric-key-match'를 사용하여 블루투스 연결 상태가 숫자 배열에 포함된 측정항목을 지정합니다(예: [0, 1, 2, 3, 0, 1, 2, 3]).  MetricFilePostProcessor 테스트 및 실행 수준에서 수집된 측정항목 로그 파일을 업로드하는 데 사용됩니다.  PerfettoGenericPostProcessor 숫자 값이 있는 필드가 발견될 때까지 문자열 값이 있는 프로토 메시지와 필드를 재귀적으로 확장하여 텍스트/바이너리 측정항목 perfetto 프로토 파일을 키-값 쌍으로 처리하는 후처리기입니다.  PerfettoTracePostProcessor 테스트 로그에서 Perfetto 트레이스 파일을 가져오고 트레이스 프로세서를 실행하여 Perfetto 측정항목 프로토를 생성하는 후처리 프로세서입니다.  StatsdGenericPostProcessor 바이너리 proto statsd 보고서를 트리 구조로 확장하여 키-값 쌍으로 처리하는 후처리기입니다.

알려진 간접 하위 클래스 StatsdBeforeAfterGaugeMetricPostProcessor, StatsdEventMetricPostProcessor StatsdBeforeAfterGaugeMetricPostProcessor '전/후' 접근 방식으로 수집된 게이지 측정항목을 처리하는 후처리 프로세서입니다.  StatsdEventMetricPostProcessor 프로세서에 지정된 포맷터를 사용하여 statsd 보고서의 이벤트 측정항목을 키-값 쌍으로 처리하는 후처리 프로세서입니다.

---

모든 구현이 확장해야 하는 기본 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) 콜백에서 이렇게 할 수는 없습니다. 로그-테스트 연결을 업데이트합니다.
	processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs) 이 메서드를 구현하여 모든 테스트에서 측정항목과 로그를 집계합니다.
abstract	processRunMetricsAndLogs( rawMetrics, runLogs) 기존 측정항목과 로그에서 새로운 측정항목 집합을 생성하려면 이 메서드를 구현하세요.
	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) 종료 시간을 직접 지정할 수 있는 ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))의 대안입니다.
final void	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) 테스트 실행의 종료를 보고합니다.
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) 테스트가 시작된 시간을 지정하는 testStarted(com.android.tradefed.result.TestDescription)의 대안으로, 정확한 측정을 위해 ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))와 결합됩니다.
final void	testStarted(TestDescription test) 테스트 사례 콜백

보호된 메서드
void	cleanUp()
MetricMeasurement.DataType	getMetricType() 필요한 경우 측정항목 유형을 변경하려면 이 메서드를 재정의하세요.
String	getRunName()

공개 생성자

BasePostProcessor

public BasePostProcessor ()

공개 메서드

init

public final ITestInvocationListener init (ITestInvocationListener listener)

후처리기의 초기화 단계입니다. 테스트 콜백 전에 호출되도록 보장됩니다.

매개변수
listener	ITestInvocationListener

반환 값
ITestInvocationListener

invocationEnded

public final void invocationEnded (long elapsedTime)

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

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

매개변수
elapsedTime	long: 호출의 경과 시간(밀리초)

invocationFailed

public final void invocationFailed (FailureDescription failure)

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

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

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

invocationFailed

public final void invocationFailed (Throwable cause)

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

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

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

invocationSkipped

public void invocationSkipped (SkipReason reason)

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

매개변수
reason	SkipReason

invocationStarted

public final void invocationStarted (IInvocationContext context)

전달을 위한 호출 리스너

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

isDisabled

public final boolean isDisabled ()

전체 객체가 사용 중지된 경우 (설정과 해체를 모두 건너뜀) True를 반환합니다. 그렇지 않으면 거짓입니다.

반환 값
boolean

logAssociation

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) 콜백에서 이렇게 할 수는 없습니다. 따라서 이 콜백을 사용하면 강력한 연결을 명시적으로 제공할 수 있습니다.

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

매개변수
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

setUp

public void setUp ()

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

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

원자 테스트에서 거짓인 조건을 가정한다고 표시할 때 호출됩니다.

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

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

원자 테스트에서 거짓인 조건을 가정한다고 표시할 때 호출됩니다.

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

testEnded

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)

testEnded

public final void testEnded (TestDescription test, 
                 testMetrics)

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

testFailed(TestDescription, FailureDescription)가 호출되지 않은 경우 이 테스트는 통과됩니다. 테스트 사례 실행 중에 발생했을 수 있는 키/값 측정항목도 반환합니다.

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

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

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

testFailed

public final void testFailed (TestDescription test, 
                String trace)

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

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

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

testIgnored

public final void testIgnored (TestDescription test)

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

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

testLog

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 메서드가 완료될 때까지 데이터 소스가 표시되고 액세스 가능하도록 해야 합니다.

testLogSaved

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입니다.

testModuleEnded

public final void testModuleEnded ()

모듈 실행의 끝을 보고합니다.

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

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

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

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

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

매개변수
elapsedTime	long: 기기에서 보고한 경과 시간(밀리초)
runMetrics	: 테스트 실행이 끝날 때 보고되는 키-값 쌍

testRunFailed

public final void testRunFailed (FailureDescription failure)

FailureDescription에 설명된 실패로 인해 테스트 실행이 완료되지 않았다고 보고합니다.

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

testRunFailed

public final void testRunFailed (String errorMessage)

심각한 오류로 인해 테스트 실행을 완료하지 못했다고 보고합니다.

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

testRunStarted

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

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

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

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

테스트 실행 콜백

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

testRunStarted

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

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

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

testRunStopped

public final void testRunStopped (long elapsedTime)

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

TODO: 현재 사용되지 않음, 삭제 고려

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

testSkipped

public final void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

testStarted

public final 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 final void testStarted (TestDescription test)

테스트 사례 콜백

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

보호된 메서드

cleanUp

protected void cleanUp ()

getMetricType

protected MetricMeasurement.DataType getMetricType ()

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

반환 값
MetricMeasurement.DataType

getRunName

protected String getRunName ()

반환 값
String