ResultForwarder

public class ResultForwarder
extends Object implements ITestInvocationListener

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

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

इस क्लास से सीधे इनहेरिट न करने वाली ज्ञात सबक्लास GranularRetriableTestWrapper.StartEndCollector, ModuleResultsAndMetricsForwarder, RemoteTestTimeOutEnforcer, RetryLogSaverResultForwarder GranularRetriableTestWrapper.StartEndCollector यह क्लास, रन शुरू और खत्म होने की जानकारी न मिलने की समस्या का पता लगाने में मदद करती है.  ModuleResultsAndMetricsForwarder यह ResultAndLogForwarder का एक्सटेंशन है. यह टेस्ट के नतीजों में, मॉड्यूल से जुड़ी अतिरिक्त मेट्रिक जोड़ता है.  RemoteTestTimeOutEnforcer ऐसे लिसनर जो किसी टेस्ट कॉन्फ़िगरेशन के एक्ज़ीक्यूशन में लगने वाले समय की जांच करते हैं. अगर यह समय तय किए गए टाइम आउट से ज़्यादा होता है, तो वे टेस्ट को फ़ेल कर देते हैं.  RetryLogSaverResultForwarder यह फ़ॉरवर्डर, मौजूदा कोशिश को भी पास करने का काम करता है.

---

एक ITestInvocationListener, जो इनवॉकेशन के नतीजों को सुनने वालों की सूची में शामिल अन्य लोगों को फ़ॉरवर्ड करता है.

खास जानकारी

सार्वजनिक कंस्ट्रक्टर
ResultForwarder(ITestInvocationListener... listeners) ResultForwarder के लिए, वैरिएबल आर्ग कंस्ट्रक्टर का दूसरा विकल्प.
ResultForwarder(List<ITestInvocationListener> listeners) ResultForwarder बनाएं.

प्रोटेक्टेड कंस्ट्रक्टर
ResultForwarder() लिसनर को बाद में शुरू करने की सेटिंग के साथ ResultForwarder बनाएं.

पब्लिक मेथड
List<ITestInvocationListener>	getListeners() लिसनर की सूची पाएं.
TestSummary	getSummary() इस अनुमति से, InvocationListener को खास जानकारी दिखाने की सुविधा मिलती है.
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, HashMap<String, MetricMeasurement.Metric> testMetrics) testEnded(TestDescription,Map) के बजाय, सीधे तौर पर इवेंट खत्म होने का समय बताने का विकल्प.
void	testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> 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, HashMap<String, MetricMeasurement.Metric> 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(TestDescription) के बजाय, यहां हम यह भी बताते हैं कि टेस्ट कब शुरू हुआ था. साथ ही, सटीक मेज़रमेंट के लिए testEnded(TestDescription,long,Map) का इस्तेमाल किया जाता है.
void	testStarted(TestDescription test) यह फ़ंक्शन, किसी टेस्ट केस के शुरू होने की जानकारी देता है.

प्रोटेक्टेड मेथड
void	setListeners(ITestInvocationListener... listeners) कंस्ट्रक्शन के बाद लिसनर सेट करें.
void	setListeners(List<ITestInvocationListener> listeners) कंस्ट्रक्शन के बाद लिसनर सेट करें.

सार्वजनिक कंस्ट्रक्टर

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

ResultForwarder के लिए, वैरिएबल आर्ग कंस्ट्रक्टर का दूसरा विकल्प.

पैरामीटर
listeners	ITestInvocationListener: वे असली ITestInvocationListeners जिन पर नतीजे फ़ॉरवर्ड करने हैं

ResultForwarder

public ResultForwarder (List<ITestInvocationListener> listeners)

ResultForwarder बनाएं.

पैरामीटर
listeners	List: वे असली ITestInvocationListeners जिन पर नतीजे फ़ॉरवर्ड करने हैं

प्रोटेक्टेड कंस्ट्रक्टर

ResultForwarder

protected ResultForwarder ()

लिसनर को बाद में शुरू करने की सेटिंग के साथ ResultForwarder बनाएं. इसका इस्तेमाल सिर्फ़ सबक्लास के लिए किया जाता है.

पब्लिक मेथड

getListeners

public List<ITestInvocationListener> getListeners ()

लिसनर की सूची पाएं.

रिटर्न
List<ITestInvocationListener>	ITestInvocationListener की सूची.

getSummary

public TestSummary getSummary ()

इस अनुमति से, InvocationListener को खास जानकारी दिखाने की सुविधा मिलती है.

रिटर्न
TestSummary	दौड़ के बारे में जानकारी देने वाला TestSummary या शून्य

invocationEnded

public void invocationEnded (long elapsedTime)

यह रिपोर्ट करती है कि इनवॉकेशन खत्म हो गया है. भले ही, यह काम सही तरीके से हुआ हो या किसी गड़बड़ी की वजह से.

इसे TradeFederation फ़्रेमवर्क अपने-आप कॉल करेगा.

पैरामीटर
elapsedTime	long: फ़ंक्शन को कॉल करने में लगा समय, मिलीसेकंड में

invocationFailed

public void invocationFailed (FailureDescription failure)

किसी गड़बड़ी की वजह से, यह कुकी इनवोकेशन पूरा न होने की सूचना देती है.

इसे TradeFederation फ़्रेमवर्क अपने-आप कॉल करेगा.

पैरामीटर
failure	FailureDescription: FailureDescription, जिसमें अनुरोध पूरा न होने की वजह बताई गई है

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: शुरू करने के बारे में जानकारी

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, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

testEnded(TestDescription,Map) के बजाय, सीधे तौर पर इवेंट खत्म होने का समय बताने का विकल्प. सटीक मेज़रमेंट के लिए, इसे testStarted(TestDescription,long) के साथ जोड़ें.

पैरामीटर
test	TestDescription: इससे टेस्ट की पहचान होती है
endTime	long: टेस्ट के खत्म होने का समय, जिसे System.currentTimeMillis() के ज़रिए मेज़र किया जाता है
testMetrics	HashMap: भेजी गई मेट्रिक का Map

testEnded

public void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

यह कुकी, किसी टेस्ट केस के खत्म होने की जानकारी देती है.

अगर testFailed(TestDescription, FailureDescription) को लागू नहीं किया गया है, तो यह टेस्ट पास हो गया है. यह टेस्ट केस के एक्ज़ीक्यूशन के दौरान, जनरेट हुई किसी भी कुंजी/वैल्यू मेट्रिक को भी दिखाता है.

पैरामीटर
test	TestDescription: इससे टेस्ट की पहचान होती है
testMetrics	HashMap: भेजी गई मेट्रिक का Map

testFailed

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: इससे टेस्ट की पहचान होती है

testLog

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

यह टेस्ट शुरू करने से जुड़ा लॉग या डीबग डेटा उपलब्ध कराता है.

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

TradeFederation फ़्रेमवर्क इस तरीके को अपने-आप कॉल करेगा. इसमें होस्ट लॉग और अगर लागू हो, तो डिवाइस लॉगकैट शामिल होगा.

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

testModuleEnded

public void testModuleEnded ()

यह कुकी, मॉड्यूल के रन के खत्म होने की जानकारी देती है.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

यह कुकी, मॉड्यूल के चलने की शुरुआत की जानकारी देती है. यह कॉलबैक, testModuleEnded() से जुड़ा है. साथ ही, यह क्रम में ज़रूरी नहीं है. इसका इस्तेमाल सिर्फ़ ऐसे रन के दौरान किया जाता है जो मॉड्यूल का इस्तेमाल करते हैं: सुइट आधारित रनर.

पैरामीटर
moduleContext	IInvocationContext: मॉड्यूल का IInvocationContext.

testRunEnded

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

यह कुकी, टेस्ट रन के खत्म होने की जानकारी देती है. FIXME: We cannot have two Map<> interfaces with different type, so we have to use HashMap here.

पैरामीटर
elapsedTime	long: डिवाइस ने मिलीसेकंड में बीता हुआ समय रिपोर्ट किया
runMetrics	HashMap: Metric के साथ टेस्ट रन के आखिर में रिपोर्ट किए गए की-वैल्यू पेयर.

testRunFailed

public void testRunFailed (FailureDescription failure)

FailureDescription की वजह से, रिपोर्ट टेस्ट रन पूरा नहीं हो सका.

पैरामीटर
failure	FailureDescription: FailureDescription में गड़बड़ी और उसके संदर्भ के बारे में बताया गया हो.

testRunFailed

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 के अलग-अलग प्रयासों की पहचान करता है. यह कई बार चलता है. attemptNumber, 0 से शुरू होता है और हर बार नया रन होने पर इसे बढ़ाना चाहिए. उदाहरण के लिए, अगर किसी टेस्ट को तीन बार फिर से आज़माया जाता है, तो उसे एक ही runName के तहत कुल चार रन करने चाहिए. साथ ही, attemptNumber 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 के अलग-अलग प्रयासों की पहचान करता है. यह कई बार चलता है. attemptNumber, 0 से शुरू होता है और हर बार नया रन होने पर इसे बढ़ाना चाहिए. उदाहरण के लिए, अगर किसी टेस्ट को तीन बार फिर से चलाया जाता है, तो उसे एक ही runName के तहत कुल चार बार चलाया जाना चाहिए. साथ ही, attemptNumber 0 से 3 तक होना चाहिए.
startTime	long: दौड़ शुरू होने का समय, जिसे System.currentTimeMillis() के ज़रिए मेज़र किया जाता है

testRunStopped

public void testRunStopped (long elapsedTime)

उपयोगकर्ता के अनुरोध की वजह से, रिपोर्ट के टेस्ट रन को पूरा होने से पहले ही रोक दिया गया.

TODO: currently unused, consider removing

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

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

इस फ़ंक्शन को तब कॉल किया जाता है, जब किसी टेस्ट को स्किप किया जाता है और उसे किसी ऐसी वजह से लागू नहीं किया जाता जिसकी आम तौर पर उम्मीद नहीं होती. इन टेस्ट को फिर से चलाने की कोशिश की जाएगी, ताकि इन्हें सही तरीके से लागू किया जा सके.

पैरामीटर
test	TestDescription: इससे टेस्ट की पहचान होती है
reason	SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

testStarted(TestDescription) के बजाय, यहां हम यह भी बताते हैं कि टेस्ट कब शुरू हुआ था. साथ ही, सटीक मेज़रमेंट के लिए testEnded(TestDescription,long,Map) का इस्तेमाल किया जाता है.

पैरामीटर
test	TestDescription: इससे टेस्ट की पहचान होती है
startTime	long: यह टेस्ट शुरू होने का समय है. इसे System.currentTimeMillis() के ज़रिए मेज़र किया जाता है

testStarted

public void testStarted (TestDescription test)

यह फ़ंक्शन, किसी टेस्ट केस के शुरू होने की जानकारी देता है. पुराना इंटरफ़ेस. जब भी हो सके, testStarted(TestDescription) का इस्तेमाल करना चाहिए.

पैरामीटर
test	TestDescription: इससे टेस्ट की पहचान होती है

प्रोटेक्टेड मेथड

setListeners

protected void setListeners (ITestInvocationListener... listeners)

कंस्ट्रक्शन के बाद लिसनर सेट करें. इसका इस्तेमाल सिर्फ़ सबक्लास के लिए किया जाता है.

पैरामीटर
listeners	ITestInvocationListener: वे असली ITestInvocationListeners जिन पर नतीजे फ़ॉरवर्ड करने हैं

setListeners

protected void setListeners (List<ITestInvocationListener> listeners)

कंस्ट्रक्शन के बाद लिसनर सेट करें. इसका इस्तेमाल सिर्फ़ सबक्लास के लिए किया जाता है.

पैरामीटर
listeners	List: वे असली ITestInvocationListeners जिन पर नतीजे फ़ॉरवर्ड करने हैं