결과 전달자

public class ResultForwarder
extends Object implements ITestInvocationListener

java.lang.객체
↳	com.android.tradefed.result.ResultForwarder

알려진 직접 하위 클래스 FilteredResultForwarder , JarHostTest.HostTestListener , LogSaverResultForwarder , LogcatCrashResultForwarder , PythonBinaryHostTest.PythonForwarder , ResultAndLogForwarder , RetryResultForwarder , ShardMainResultForwarder , TestTimeoutEnforcer FilteredResultForwarder TestDescription 의 허용 목록만 보고되도록 허용하는 ResultForwarder 의 변형입니다. JarHostTest.HostTestListener testRunStarted() 및 testRunEnded()를 제외한 모든 이벤트를 포함된 리스너로 전달하는 래퍼 리스너입니다. LogSaverResultForwarder 전역 파일 보호기로 로그를 저장하기 위한 ResultForwarder 입니다. LogcatCrashResult전달자 특수 리스너: 실패(계측 프로세스 충돌) 시 logcat에서 충돌을 추출하여 테스트와 관련된 실패 메시지에 추가합니다. PythonBinaryHostTest.PythonForwarder 결과 전달자는 실행 이름을 이진 이름으로 대체합니다. ResultAndLogForwarder 결과 및 로그 이벤트 전달자. RetryResultForwarder 항상 주어진 시도 횟수로 푸시하는 ResultForwarder 의 확장입니다. ShardMainResultForwarder 분할된 테스트 호출의 결과를 결합하는 ResultForwarder 입니다. TestTimeoutEnforcer 주어진 테스트 케이스의 실행 시간을 확인하고 주어진 시간 초과 시 실패할 수 있는 리스너.

알려진 간접 하위 클래스 GranularRetriableTestWrapper.StartEndCollector , RetryLogSaverResultForwarder GranularRetriableTestWrapper.StartEndCollector 누락된 실행 시작 및 종료를 포착하는 클래스 도우미입니다. RetryLogSaverResultForwarder 우리가 있는 현재 시도를 전달하는 전달자도 처리합니다.

---

호출 결과를 다른 수신기 목록에 전달하는 ITestInvocationListener 입니다.

요약

공개 생성자
ResultForwarder ( listeners) ResultForwarder ( listeners) ResultForwarder 를 만듭니다.
ResultForwarder ( ITestInvocationListener... listeners) ResultForwarder 에 대한 대체 변수 arg 생성자입니다.

보호된 생성자
ResultForwarder () 지연된 리스너 설정으로 ResultForwarder 를 만듭니다.

공개 방법
TestSummary	getSummary () InvocationListener가 요약을 반환하도록 허용합니다.
void	invocationEnded (long elapsedTime) 성공적으로 또는 일부 오류 조건으로 인해 호출이 종료되었음을 보고합니다.
void	invocationFailed ( FailureDescription failure) 일부 오류 조건으로 인해 불완전한 호출을 보고합니다.
void	invocationFailed (Throwable cause) 일부 오류 조건으로 인해 불완전한 호출을 보고합니다.
void	invocationStarted ( IInvocationContext context) 테스트 호출의 시작을 보고합니다.
void	testAssumptionFailure ( TestDescription test, String trace) false인 조건을 가정한다고 원자성 테스트 플래그가 표시될 때 호출됩니다.
void	testAssumptionFailure ( TestDescription test, FailureDescription failure) false인 조건을 가정한다고 원자성 테스트 플래그가 표시될 때 호출됩니다.
void	testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) 대신 종료 시간을 직접 지정할 수 있습니다.
void	testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) 개별 테스트 사례의 실행 종료를 보고합니다.
void	testFailed ( TestDescription test, FailureDescription failure) 개별 테스트 사례의 실패를 보고합니다.
void	testFailed ( TestDescription test, String trace) 개별 테스트 사례의 실패를 보고합니다.
void	testIgnored ( TestDescription test) 일반적으로 테스트 메서드가 org.junit.Ignore로 주석 처리되기 때문에 테스트가 실행되지 않을 때 호출됩니다.
void	testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) 테스트 호출에서 연결된 로그 또는 디버그 데이터를 제공합니다.
void	testModuleEnded () 모듈 실행의 끝을 보고합니다.
void	testModuleStarted ( IInvocationContext moduleContext) 실행 중인 모듈의 시작을 보고합니다.
void	testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) 테스트 실행 종료를 보고합니다.
void	testRunFailed ( FailureDescription failure) FailureDescription 에서 설명한 실패로 인해 테스트 실행을 완료하지 못한 것을 보고합니다.
void	testRunFailed (String errorMessage) 치명적인 오류로 인해 테스트 실행을 완료하지 못한 보고서입니다.
void	testRunStarted (String runName, int testCount, int attemptNumber) 테스트 실행의 시작을 보고합니다.
void	testRunStarted (String runName, int testCount) 테스트 실행의 시작을 보고합니다.
void	testRunStarted (String runName, int testCount, int attemptNumber, long startTime) 테스트 실행의 시작을 보고합니다.
void	testRunStopped (long elapsedTime) 사용자 요청으로 인해 테스트 실행이 완료되기 전에 중지되었음을 보고합니다.
void	testStarted ( TestDescription test, long startTime) 정확한 측정을 위해 ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) 와 결합하여 테스트가 시작된 시기도 지정하는 testStarted(com.android.tradefed.result.TestDescription) 의 대안 .
void	testStarted ( TestDescription test) 개별 테스트 사례의 시작을 보고합니다.

보호된 메서드
	getListeners () 청취자 목록을 가져옵니다.
void	setListeners ( ITestInvocationListener... listeners) 생성 후 리스너를 설정합니다.
void	setListeners ( listeners) setListeners ( listeners) 생성 후 리스너를 설정합니다.

공개 생성자

결과 전달자

public ResultForwarder ( listeners)

ResultForwarder 를 만듭니다.

매개변수
listeners	: 결과를 전달할 실제 ITestInvocationListener

결과 전달자

public ResultForwarder (ITestInvocationListener... listeners)

ResultForwarder 에 대한 대체 변수 arg 생성자입니다.

매개변수
listeners	ITestInvocationListener : 결과를 전달할 실제 ITestInvocationListener

보호된 생성자

결과 전달자

protected ResultForwarder ()

지연된 리스너 설정으로 ResultForwarder 를 만듭니다. 하위 클래스에서만 사용할 수 있습니다.

공개 방법

getSummary

public TestSummary getSummary ()

InvocationListener가 요약을 반환하도록 허용합니다.

보고
TestSummary	실행을 요약하는 TestSummary 또는 null

호출 종료됨

public void invocationEnded (long elapsedTime)

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

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

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

호출 실패

public void invocationFailed (FailureDescription failure)

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

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

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

호출 실패

public void invocationFailed (Throwable cause)

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

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

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

호출 시작됨

public void invocationStarted (IInvocationContext context)

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

TradeFederation 프레임워크에 의해 자동으로 호출됩니다. 여러 장치 보고를 지원하려면 보고자가 이 방법을 재정의해야 합니다.

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

테스트 가정 실패

public void testAssumptionFailure (TestDescription test, 
                String trace)

false인 조건을 가정한다고 원자성 테스트 플래그가 표시될 때 호출됩니다.

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

테스트 가정 실패

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

false인 조건을 가정한다고 원자성 테스트 플래그가 표시될 때 호출됩니다.

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

테스트 종료됨

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)

테스트 종료됨

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 .

테스트 실패

public void testFailed (TestDescription test, 
                String trace)

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

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

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

테스트무시됨

public void testIgnored (TestDescription test)

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

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

testLog

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

테스트 호출에서 연결된 로그 또는 디버그 데이터를 제공합니다.

ERROR(/ITestInvocationListener#invocationFailed(Throwable)) 또는 ERROR(/ITestInvocationListener#invocationEnded(long)) 전에 호출해야 합니다.

TradeFederation 프레임워크는 이 메서드를 자동으로 호출하여 호스트 로그와 해당하는 경우 장치 logcat을 제공합니다.

매개변수
dataName	String : 데이터를 설명하는 String 이름입니다. 예: "device_logcat". 참고 dataName은 호출마다 고유하지 않을 수 있습니다. 즉, 구현자는 동일한 dataName을 사용하여 여러 호출을 처리할 수 있어야 합니다.
dataType	LogDataType : 데이터의 LogDataType
dataStream	InputStreamSource : 데이터의 InputStreamSource . 구현자는 createInputStream을 호출하여 데이터 읽기를 시작하고 완료되면 결과 InputStream을 닫도록 해야 합니다. 호출자는 testLog 메소드가 완료될 때까지 데이터 소스가 존재하고 액세스 가능한지 확인해야 합니다.

testModuleEnded

public void testModuleEnded ()

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

testModule시작됨

public void testModuleStarted (IInvocationContext moduleContext)

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

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

매개변수
elapsedTime	long : 장치에서 보고된 경과 시간(밀리초)
runMetrics	: Metric 사용한 테스트 실행 종료 시 보고된 키-값 쌍입니다.

테스트 실행 실패

public void testRunFailed (FailureDescription failure)

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

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

테스트 실행 실패

public void testRunFailed (String errorMessage)

치명적인 오류로 인해 테스트 실행을 완료하지 못한 보고서입니다.

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

testRunStarted

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

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

매개변수
runName	String : 테스트 실행 이름
testCount	int : 테스트 실행의 총 테스트 수
attemptNumber	int : 여러 번 실행되는 동일한 runName의 다른 시도를 식별하는 순서 번호입니다. tryNumber는 인덱스가 0이며 새 실행이 발생할 때마다 증가해야 합니다. 예를 들어 테스트가 3번 세부적으로 재시도되고 동일한 runName에서 총 4번의 실행이 있어야 하며 tryNumber는 0에서 3까지입니다.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

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

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

testRunStarted

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

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

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

testRunStopped

public void testRunStopped (long elapsedTime)

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

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

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

테스트 시작됨

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

개별 테스트 사례의 시작을 보고합니다. 이전 인터페이스는 가능할 때마다 testStarted(com.android.tradefed.result.TestDescription) 사용해야 합니다.

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

보호된 메서드

getListeners

protected  getListeners ()

청취자 목록을 가져옵니다. 하위 클래스에서만 사용할 수 있습니다.

보고
	ITestInvocationListener 목록입니다.

setListeners

protected void setListeners (ITestInvocationListener... listeners)

생성 후 리스너를 설정합니다. 하위 클래스에서만 사용할 수 있습니다.

매개변수
listeners	ITestInvocationListener : 결과를 전달할 실제 ITestInvocationListener

setListeners

protected void setListeners ( listeners)

생성 후 리스너를 설정합니다. 하위 클래스에서만 사용할 수 있습니다.

매개변수
listeners	: 결과를 전달할 실제 ITestInvocationListener