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, Map<String, String> testMetrics) यह कुकी, किसी टेस्ट केस के खत्म होने की जानकारी देती है.
abstract void	testFailed(TestIdentifier test, String trace) यह किसी टेस्ट केस के फ़ेल होने की जानकारी देता है.
abstract void	testIgnored(TestIdentifier test) इस फ़ंक्शन को तब कॉल किया जाता है, जब कोई टेस्ट नहीं चलाया जाता. आम तौर पर, ऐसा इसलिए होता है, क्योंकि टेस्ट के तरीके को org.junit.Ignore के साथ एनोटेट किया जाता है.
abstract void	testRunEnded(long elapsedTime, Map<String, String> 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, 
                Map<String, String> testMetrics)

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

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

पैरामीटर
test	TestIdentifier: इससे टेस्ट की पहचान होती है
testMetrics	Map: android.app.Instrumentation#sendStatus की ओर से टेस्ट केस को लागू करने के दौरान, जनरेट की गई मेट्रिक का 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, 
                Map<String, String> runMetrics)

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

पैरामीटर
elapsedTime	long: डिवाइस ने मिलीसेकंड में बीता हुआ समय रिपोर्ट किया
runMetrics	Map: android.app.Instrumentation#addResults की ओर से टेस्ट केस को लागू करने के दौरान, जनरेट की गई मेट्रिक का 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: इससे टेस्ट की पहचान होती है