परिणाम अग्रेषणकर्ता

public class ResultForwarder
extends Object implements ITestInvocationListener

java.lang.ऑब्जेक्ट
↳	com.android.tradefed.result.ResultForwarder

ज्ञात प्रत्यक्ष उपवर्ग फ़िल्टर किए गएResultForwarder , JarHostTest.HostTestListener , LogSaverResultForwarder , LogcatCrashResultForwarder , PythonBinaryHostTest.PythonForwarder , ResultAndLogForwarder , RetryResultForwarder , ShardMainResultForwarder , TestTimeoutEnforcer फ़िल्टर किए गए परिणाम फ़ॉरवर्डर ResultForwarder का वैरिएंट जो केवल TestDescription की अनुमति सूची को रिपोर्ट करने की अनुमति देता है। JarHostTest.HostTestListener रैपर श्रोता जो testRunStarted() और testRunEnded() को छोड़कर सभी घटनाओं को एम्बेडेड श्रोता को अग्रेषित करता है। लॉगसेवररिजल्टफॉरवर्डर वैश्विक फ़ाइल सेवर के साथ लॉग सहेजने के लिए एक ResultForwarder । लॉगकैटक्रैशरिजल्टफॉरवर्डर विशेष श्रोता: विफलताओं (इंस्ट्रूमेंटेशन प्रक्रिया क्रैश होने) पर यह लॉगकैट से क्रैश को निकालने का प्रयास करेगा और इसे परीक्षण से जुड़े विफलता संदेश में जोड़ देगा। PythonBinaryHostTest.PythonForwarder रन नाम को बाइनरी नाम से बदलने के लिए परिणाम फारवर्डर। ResultAndLogForwarder परिणामों और लॉग इवेंट के लिए फारवर्डर। पुनःप्रयासपरिणामफॉरवर्डर ResultForwarder का एक एक्सटेंशन जो हमेशा किसी दिए गए प्रयास संख्या पर धकेलता है। ShardMainResultForwarder एक ResultForwarder जो एक शार्ड परीक्षण आमंत्रण के परिणामों को जोड़ता है। टेस्टटाइमआउटएनफोर्सर श्रोता जो किसी दिए गए परीक्षण मामले के निष्पादन समय की जांच करने की अनुमति देते हैं और यदि यह दिए गए समयबाह्य से अधिक हो जाता है तो इसे विफल कर देते हैं।

ज्ञात अप्रत्यक्ष उपवर्ग ग्रैन्युलर रिट्राइबलटेस्टवापर.स्टार्टएंडकलेक्टर , रिट्रीलॉगसेवररिजल्टफॉरवर्डर ग्रैन्युलर रिट्रायबलटेस्टरैपर.स्टार्टएंडकलेक्टर छूटे हुए रन के आरंभ और अंत को पकड़ने के लिए क्लास सहायक। पुनः प्रयास करेंLogSaverResultForwarder फारवर्डर जो हमारे मौजूदा प्रयास को पार करने का काम भी संभालता है।

---

एक ITestInvocationListener जो मंगलाचरण के परिणामों को अन्य श्रोताओं की सूची में अग्रेषित करता है।

सारांश

सार्वजनिक निर्माणकर्ता
ResultForwarder ( listeners) ResultForwarder ( listeners) एक ResultForwarder बनाएं।
ResultForwarder ( ITestInvocationListener... listeners) ResultForwarder के लिए वैकल्पिक वेरिएबल arg कंस्ट्रक्टर।

संरक्षित कंस्ट्रक्टर
ResultForwarder () विलंबित श्रोता सेटिंग के साथ एक ResultForwarder बनाएं।

सार्वजनिक तरीके
TestSummary	getSummary () इनवोकेशन लिस्टनर को सारांश वापस करने की अनुमति देता है।
void	invocationEnded (long elapsedTime) रिपोर्ट करता है कि मंगलाचरण समाप्त हो गया है, चाहे सफलतापूर्वक या किसी त्रुटि स्थिति के कारण।
void	invocationFailed ( FailureDescription failure) कुछ त्रुटि स्थिति के कारण अपूर्ण आह्वान की रिपोर्ट करता है।
void	invocationFailed (Throwable cause) कुछ त्रुटि स्थिति के कारण अपूर्ण आह्वान की रिपोर्ट करता है।
void	invocationSkipped ( SkipReason reason) किसी आह्वान को छोड़े गए के रूप में रिपोर्ट करता है
void	invocationStarted ( IInvocationContext context) परीक्षण मंगलाचरण की शुरुआत की रिपोर्ट करता है।
void	testAssumptionFailure ( TestDescription test, String trace) तब कॉल किया जाता है जब एक परमाणु परीक्षण यह संकेत देता है कि यह एक ऐसी स्थिति मानता है जो झूठी है
void	testAssumptionFailure ( TestDescription test, FailureDescription failure) तब कॉल किया जाता है जब एक परमाणु परीक्षण यह संकेत देता है कि यह एक ऐसी स्थिति मानता है जो झूठी है
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	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) एक व्यक्तिगत परीक्षण मामले की शुरुआत की रिपोर्ट करता है।

संरक्षित तरीके
	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 बनाएं। केवल उपवर्गों द्वारा उपयोग के लिए अभिप्रेत है।

सार्वजनिक तरीके

सारांश प्राप्त करें

public TestSummary getSummary ()

इनवोकेशन लिस्टनर को सारांश वापस करने की अनुमति देता है।

रिटर्न
TestSummary	रन, या शून्य का सारांश देने वाला एक TestSummary

मंगलाचरणसमाप्त

public void invocationEnded (long elapsedTime)

रिपोर्ट करता है कि मंगलाचरण समाप्त हो गया है, चाहे सफलतापूर्वक या किसी त्रुटि स्थिति के कारण।

ट्रेडफेडरेशन फ्रेमवर्क द्वारा स्वचालित रूप से बुलाया जाएगा।

पैरामीटर
elapsedTime	long : एमएस में आह्वान का बीता हुआ समय

मंगलाचरणविफल

public void invocationFailed (FailureDescription failure)

कुछ त्रुटि स्थिति के कारण अपूर्ण आह्वान की रिपोर्ट करता है।

ट्रेडफेडरेशन फ्रेमवर्क द्वारा स्वचालित रूप से बुलाया जाएगा।

पैरामीटर
failure	FailureDescription : FailureDescription विफलता के कारण का वर्णन करता है

मंगलाचरणविफल

public void invocationFailed (Throwable cause)

कुछ त्रुटि स्थिति के कारण अपूर्ण आह्वान की रिपोर्ट करता है।

ट्रेडफेडरेशन फ्रेमवर्क द्वारा स्वचालित रूप से बुलाया जाएगा।

पैरामीटर
cause	Throwable : विफलता का Throwable कारण

मंगलाचरणछोड़ दिया गया

public void invocationSkipped (SkipReason reason)

किसी आह्वान को छोड़े गए के रूप में रिपोर्ट करता है

पैरामीटर
reason	SkipReason

मंगलाचरणशुरू हुआ

public void invocationStarted (IInvocationContext context)

परीक्षण मंगलाचरण की शुरुआत की रिपोर्ट करता है।

ट्रेडफेडरेशन फ्रेमवर्क द्वारा स्वचालित रूप से बुलाया जाएगा। एकाधिक डिवाइस रिपोर्टिंग का समर्थन करने के लिए रिपोर्टर्स को इस पद्धति को ओवरराइड करने की आवश्यकता है।

पैरामीटर
context	IInvocationContext : मंगलाचरण के बारे में जानकारी

परीक्षणधारणाविफलता

public void testAssumptionFailure (TestDescription test, 
                String trace)

तब कॉल किया जाता है जब एक परमाणु परीक्षण यह संकेत देता है कि यह एक ऐसी स्थिति मानता है जो झूठी है

पैरामीटर
test	TestDescription : परीक्षण की पहचान करता है
trace	String : विफलता का स्टैक ट्रेस

परीक्षणधारणाविफलता

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

तब कॉल किया जाता है जब एक परमाणु परीक्षण यह संकेत देता है कि यह एक ऐसी स्थिति मानता है जो झूठी है

पैरामीटर
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)

किसी व्यक्तिगत परीक्षण मामले की विफलता की रिपोर्ट करता है।

टेस्टस्टार्टेड और टेस्टएंडेड के बीच बुलाया जाएगा।

पैरामीटर
test	TestDescription : परीक्षण की पहचान करता है
failure	FailureDescription : FailureDescription विफलता और उसके संदर्भ का वर्णन करता है।

परीक्षण विफल

public void testFailed (TestDescription test, 
                String trace)

किसी व्यक्तिगत परीक्षण मामले की विफलता की रिपोर्ट करता है।

टेस्टस्टार्टेड और टेस्टएंडेड के बीच बुलाया जाएगा।

पैरामीटर
test	TestDescription : परीक्षण की पहचान करता है
trace	String : विफलता का स्टैक ट्रेस

परीक्षणअनदेखा

public void testIgnored (TestDescription test)

तब कॉल किया जाता है जब कोई परीक्षण नहीं चलाया जाएगा, आम तौर पर क्योंकि एक परीक्षण विधि को org.junit.Ignore के साथ एनोटेट किया जाता है।

पैरामीटर
test	TestDescription : परीक्षण की पहचान करता है

परीक्षणलॉग

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

परीक्षण आमंत्रण से संबंधित लॉग या डिबग डेटा प्रदान करता है।

ERROR(/ITestInvocationListener#invocationFailed(Throwable)) या ERROR(/ITestInvocationListener#invocationEnded(long)) से पहले कॉल किया जाना चाहिए

ट्रेडफेडरेशन फ्रेमवर्क स्वचालित रूप से इस पद्धति को कॉल करेगा, होस्ट लॉग प्रदान करेगा और यदि लागू हो, तो डिवाइस लॉगकैट प्रदान करेगा।

पैरामीटर
dataName	String : डेटा का एक String वर्णनात्मक नाम। उदाहरण के लिए "डिवाइस_लॉगकैट"। नोट डेटानाम प्रति आह्वान अद्वितीय नहीं हो सकता है। यानी कार्यान्वयनकर्ताओं को एक ही डेटानाम के साथ एकाधिक कॉल को संभालने में सक्षम होना चाहिए
dataType	LogDataType : डेटा का LogDataType
dataStream	InputStreamSource : डेटा का InputStreamSource । कार्यान्वयनकर्ताओं को डेटा पढ़ना शुरू करने के लिए createInputStream को कॉल करना चाहिए, और पूरा होने पर परिणामी इनपुटस्ट्रीम को बंद करना सुनिश्चित करना चाहिए। कॉल करने वालों को यह सुनिश्चित करना चाहिए कि टेस्टलॉग विधि पूरी होने तक डेटा का स्रोत मौजूद और पहुंच योग्य बना रहे।

testModuleसमाप्त

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 : क्रम संख्या, एक ही रननाम के विभिन्न प्रयासों की पहचान करना जो कई बार चलते हैं। प्रयास संख्या 0-अनुक्रमित है और हर बार एक नया रन होने पर इसमें वृद्धि होनी चाहिए। उदाहरण के लिए एक परीक्षण को 3 बार पुनः प्रयास किया जाता है, इसमें एक ही रननाम के तहत कुल 4 रन होने चाहिए और प्रयास संख्या 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 : क्रम संख्या, एक ही रननाम के विभिन्न प्रयासों की पहचान करना जो कई बार चलते हैं। प्रयास संख्या 0-अनुक्रमित है और हर बार एक नया रन होने पर इसमें वृद्धि होनी चाहिए। उदाहरण के लिए एक परीक्षण को 3 बार पुनः प्रयास किया जाता है, इसमें एक ही रननाम के तहत कुल 4 रन होने चाहिए और प्रयास संख्या 0 से 3 तक होनी चाहिए।
startTime	long : रन शुरू होने का समय, System.currentTimeMillis() के माध्यम से मापा गया

टेस्टरनस्टॉप किया गया

public void testRunStopped (long elapsedTime)

उपयोगकर्ता के अनुरोध के कारण रिपोर्ट परीक्षण पूरा होने से पहले ही रुक गया।

कार्य: वर्तमान में अप्रयुक्त, हटाने पर विचार करें

पैरामीटर
elapsedTime	long : डिवाइस ने बीता हुआ समय, मिलीसेकेंड में बताया

परीक्षणछोड़ दिया गया

public void testSkipped (TestDescription test, 
                SkipReason reason)

तब कॉल किया जाता है जब कोई परीक्षण छोड़ दिया जाता है और उस कारण से निष्पादित नहीं होता है जिसकी आमतौर पर अपेक्षा नहीं की जाती है। उचित निष्पादन प्राप्त करने का प्रयास करने के लिए इन परीक्षणों को पुनः प्रयास करने का प्रयास किया जाएगा।

पैरामीटर
test	TestDescription : परीक्षण की पहचान करता है
reason	SkipReason : SkipReason

परीक्षण प्रारंभ

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() के माध्यम से मापा गया

परीक्षण प्रारंभ

public void testStarted (TestDescription test)

एक व्यक्तिगत परीक्षण मामले की शुरुआत की रिपोर्ट करता है। पुराना इंटरफ़ेस, जब भी संभव हो testStarted(com.android.tradefed.result.TestDescription) उपयोग करना चाहिए।

पैरामीटर
test	TestDescription : परीक्षण की पहचान करता है

संरक्षित तरीके

श्रोता प्राप्त करें

protected  getListeners ()

श्रोताओं की सूची प्राप्त करें. केवल उपवर्गों द्वारा उपयोग के लिए अभिप्रेत है।

रिटर्न
	ITestInvocationListener की सूची।

सेट श्रोता

protected void setListeners (ITestInvocationListener... listeners)

निर्माण के बाद श्रोताओं को सेट करें। केवल उपवर्गों द्वारा उपयोग के लिए अभिप्रेत है।

पैरामीटर
listeners	ITestInvocationListener : परिणामों को अग्रेषित करने के लिए वास्तविक ITestInvocationListener है

सेट श्रोता

protected void setListeners ( listeners)

निर्माण के बाद श्रोताओं को सेट करें। केवल उपवर्गों द्वारा उपयोग के लिए अभिप्रेत है।

पैरामीटर
listeners	: परिणामों को अग्रेषित करने के लिए वास्तविक ITestInvocationListener