ITestRunListener

public interface ITestRunListener

com.android.ddmlib.testrunner.ITestRunListener

अप्रत्यक्ष तौर पर जुड़ी जानी-पहचानी सबक्लास StubTestRunListener, TestRunResult, TestRunToTestInvocationForwarder, XmlTestRunListener StubTestRunListener ITestRunListener का स्टब लागू करना  TestRunResult यह कुकी, एक टेस्ट रन के नतीजे सेव करती है.  TestRunToTestInvocationForwarder ddmlib ITestRunListener से ITestLifeCycleReceiver तक फ़ॉरवर्ड करने वाला.  XmlTestRunListener यह JUnit के नतीजों को एक्सएमएल फ़ाइलों में लिखता है. इसका फ़ॉर्मैट, Ant के XMLJUnitResultFormatter के फ़ॉर्मैट जैसा होता है.

---

यह क्लास, इंस्ट्रुमेंटेशन टेस्ट के दौरान इवेंट की सूचनाएं पाने के लिए इस्तेमाल की जाती है.

org.junit.runner.notification.RunListener के बाद पैटर्न बनाया गया

कॉल का क्रम इस तरह होगा:

• testRunStarted
• testStarted
• [testFailed]
• [testAssumptionFailure]
• [testIgnored]
• testEnded
• ....
• [testRunFailed]
• testRunEnded

खास जानकारी

सार्वजनिक तरीके
abstract void	testAssumptionFailure(TestIdentifier test, String trace) इस फ़ंक्शन को तब कॉल किया जाता है, जब कोई ऐटॉमिक टेस्ट यह फ़्लैग करता है कि वह ऐसी शर्त मान रहा है जो गलत है
abstract void	testEnded(TestIdentifier test, testMetrics) यह किसी टेस्ट केस के खत्म होने की जानकारी देता है.
abstract void	testFailed(TestIdentifier test, String trace) यह किसी टेस्ट केस के फ़ेल होने की जानकारी देता है.
abstract void	testIgnored(TestIdentifier test) इस फ़ंक्शन को तब कॉल किया जाता है, जब टेस्ट नहीं चलाया जाता. आम तौर पर, ऐसा इसलिए होता है, क्योंकि टेस्ट के तरीके को org.junit.Ignore के साथ एनोटेट किया जाता है.
abstract void	testRunEnded(long elapsedTime, runMetrics) यह कुकी, टेस्ट रन के खत्म होने की जानकारी देती है.
abstract void	testRunFailed(String errorMessage) गंभीर गड़बड़ी की वजह से, रिपोर्ट के टेस्ट रन को पूरा नहीं किया जा सका.
abstract void	testRunStarted(String runName, int testCount) यह कुकी, टेस्ट रन की शुरुआत की रिपोर्ट करती है.
abstract void	testRunStopped(long elapsedTime) इस तरीके का इस्तेमाल बंद कर दिया गया है. इस कॉलबैक को कभी भी लागू नहीं किया जाता. मिटा दिया जाएगा.
abstract void	testStarted(TestIdentifier test) यह फ़ंक्शन, किसी टेस्ट केस के शुरू होने की जानकारी देता है.

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

testAssumptionFailure

public abstract void testAssumptionFailure (TestIdentifier test, 
                String trace)

इस फ़ंक्शन को तब कॉल किया जाता है, जब कोई ऐटॉमिक टेस्ट यह फ़्लैग करता है कि वह ऐसी शर्त मान रहा है जो गलत है

पैरामीटर
test	TestIdentifier: इससे टेस्ट की पहचान होती है
trace	String: गड़बड़ी का स्टैक ट्रेस

testEnded

public abstract void testEnded (TestIdentifier test, 
                 testMetrics)

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

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

पैरामीटर
test	TestIdentifier: इससे टेस्ट की पहचान होती है
testMetrics	: android.app.Instrumentation#sendStatus की ओर से टेस्ट केस को लागू करने के दौरान, जनरेट की गई मेट्रिक का ERROR(/Map). अगर एक ही कुंजी को कई बार नहीं भेजा जाता है, तो डेटा को उसी क्रम में दिखाया जाता है जिस क्रम में उसे डाला गया था. ध्यान दें कि IInstrumentationResultParser.StatusKeys में तय की गई स्टैंडर्ड कुंजियों को इस मैप से फ़िल्टर कर दिया जाता है. Ddmlib, IInstrumentationResultParser.StatusKeys में तय की गई अतिरिक्त टेस्ट मेट्रिक जोड़ सकता है.

testFailed

public abstract void testFailed (TestIdentifier test, 
                String trace)

यह किसी टेस्ट केस के फ़ेल होने की जानकारी देता है.

इसे testStarted और testEnded के बीच कॉल किया जाएगा.

पैरामीटर
test	TestIdentifier: इससे टेस्ट की पहचान होती है
trace	String: गड़बड़ी का स्टैक ट्रेस

testIgnored

public abstract void testIgnored (TestIdentifier test)

इस फ़ंक्शन को तब कॉल किया जाता है, जब टेस्ट नहीं चलाया जाता. आम तौर पर, ऐसा इसलिए होता है, क्योंकि टेस्ट के तरीके को org.junit.Ignore के साथ एनोटेट किया जाता है.

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

testRunEnded

public abstract void testRunEnded (long elapsedTime, 
                 runMetrics)

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

पैरामीटर
elapsedTime	long: डिवाइस ने मिलीसेकंड में बीता हुआ समय रिपोर्ट किया
runMetrics	: android.app.Instrumentation#addResults की ओर से टेस्ट केस को लागू करने के दौरान, जनरेट की गई मेट्रिक का ERROR(/Map). अगर एक ही कुंजी को कई बार नहीं भेजा जाता है, तो डेटा को उसी क्रम में दिखाया जाता है जिस क्रम में उसे डाला गया था. ध्यान दें कि IInstrumentationResultParser.StatusKeys में तय की गई स्टैंडर्ड कुंजियों को इस मैप से फ़िल्टर कर दिया जाता है. Ddmlib, IInstrumentationResultParser.StatusKeys में तय की गई अतिरिक्त टेस्ट मेट्रिक जोड़ सकता है.

testRunFailed

public abstract void testRunFailed (String errorMessage)

गंभीर गड़बड़ी की वजह से, रिपोर्ट के टेस्ट रन को पूरा नहीं किया जा सका.

पैरामीटर
errorMessage	String: String में, रन फ़ेल होने की वजह बताई गई है.

testRunStarted

public abstract void testRunStarted (String runName, 
                int testCount)

यह कुकी, टेस्ट रन की शुरुआत की रिपोर्ट करती है.

पैरामीटर
runName	String: टेस्ट रन का नाम
testCount	int: टेस्ट रन में कुल टेस्ट की संख्या

testRunStopped

public abstract void testRunStopped (long elapsedTime)

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

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

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

testStarted

public abstract void testStarted (TestIdentifier test)

यह फ़ंक्शन, किसी टेस्ट केस के शुरू होने की जानकारी देता है.

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