CollectingTestListener

public class CollectingTestListener
extends Object implements IDisableable, ILogSaverListener, ITestInvocationListener

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

ITestInvocationListener जो जांच के सभी नतीजे इकट्ठा करेगा.

इस ऑब्जेक्ट में इस्तेमाल किए गए डेटा स्ट्रक्चर थ्रेड-सेफ़ होते हैं. हालांकि, ITestInvocationListener कॉलबैक को सही क्रम में कॉल किया जाना चाहिए.

खास जानकारी

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

CollectingTestListener()

पब्लिक मेथड

IBuildInfo getBuildInfo()

इस तरीके का इस्तेमाल बंद कर दिया गया है. getInvocationContext() से मिले IBuildInfo पर भरोसा करें.

TestRunResult getCurrentRunResults()

इससे मौजूदा टेस्ट रन के नतीजे मिलते हैं.

int getExpectedTests()

इससे, अनुमानित टेस्ट की संख्या मिलती है.

IInvocationContext getInvocationContext()

invocationStarted(IInvocationContext) के ज़रिए रिपोर्ट किए गए इनवोकेशन कॉन्टेक्स्ट को वापस लाता है

List<TestRunResult> getMergedTestRunResults()

अलग-अलग कोशिशों में किए गए सभी रन के लिए, नतीजों का मर्ज किया गया कलेक्शन दिखाओ.

IInvocationContext getModuleContextForRunResult(String testRunName)

नतीजों से जुड़े मॉड्यूल का IInvocationContext दिखाता है.

MultiMap<String, LogFile> getModuleLogFiles()

यह फ़ंक्शन, मॉड्यूल से जुड़ी सभी लॉग की गई फ़ाइलों के साथ मैप की कॉपी दिखाता है

MultiMap<String, LogFile> getNonAssociatedLogFiles()

यह फ़ंक्शन, मैप की एक कॉपी दिखाता है. इसमें वे सभी लॉग की गई फ़ाइलें होती हैं जो किसी टेस्ट रन या मॉड्यूल से जुड़ी नहीं होती हैं.

int getNumAllFailedTestRuns()

यह फ़ंक्शन, टेस्ट रन की कुल संख्या दिखाता है जो फ़ेल हो गए हैं

int getNumAllFailedTests()

यह फ़ंक्शन, फ़ेल हो चुके टेस्ट की कुल संख्या दिखाता है. इसमें सिर्फ़ फ़ेल हुए टेस्ट शामिल होते हैं. अनुमान के आधार पर फ़ेल हुए टेस्ट को इसमें शामिल नहीं किया जाता.

int getNumTestsInState(TestStatus status)

इस रन के लिए, दी गई स्थिति में टेस्ट की संख्या दिखाता है.

int getNumTestsInState(TestResult.TestStatus ddmlibStatus)

पुराने स्टेटस टाइप के साथ काम करने के लिए

int getNumTotalTests()

यह फ़ंक्शन, सभी रन के लिए पूरे किए गए टेस्ट की कुल संख्या दिखाता है.

IBuildInfo getPrimaryBuildInfo()

invocationStarted(IInvocationContext) के ज़रिए रिपोर्ट की गई प्राइमरी बिल्ड की जानकारी दिखाता है.

Collection<TestRunResult> getRunResults()

इस तरीके का इस्तेमाल बंद कर दिया गया है. getMergedTestRunResults() का इस्तेमाल करें

TestRunResult getTestRunAtAttempt(String testRunName, int attempt)

एक बार कोशिश करने के लिए, TestRunResult को वापस लाएं.

int getTestRunAttemptCount(String testRunName)

यह फ़ंक्शन, टेस्ट रन के दिए गए नाम के लिए कोशिशों की संख्या दिखाता है.

List<TestRunResult> getTestRunAttempts(String testRunName)

यह किसी टेस्ट रन के TestRunResult के लिए किए गए सभी प्रयासों को दिखाता है.

List<TestRunResult> getTestRunForAttempts(int attempt)

यह किसी दिए गए अनुरोध के सभी नतीजे दिखाता है.

Collection<String> getTestRunNames()

सभी टेस्ट रन के नाम दिखाओ.

boolean hasFailedTests()

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

boolean hasTestRunResultsForName(String testRunName)

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

void invocationEnded(long elapsedTime)

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

void invocationFailed(Throwable cause)

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

void invocationSkipped(SkipReason reason)

इस फ़ंक्शन का इस्तेमाल, किसी इनवोकेशन को 'अभी नहीं' के तौर पर रिपोर्ट करने के लिए किया जाता है

void invocationStarted(IInvocationContext context)

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

boolean isDisabled()

अगर पूरा ऑब्जेक्ट बंद है, तो True दिखाता है. इससे सेटअप और टियरडाउन, दोनों को स्किप किया जा सकता है.

void logAssociation(String dataName, LogFile logFile)

कुछ मामलों में, लॉग को टेस्ट केस से जोड़ा जाना ज़रूरी होता है. हालांकि, सीधे testLogSaved(String,LogDataType,InputStreamSource,LogFile) कॉलबैक पर ऐसा नहीं किया जा सकता.

void setBuildInfo(IBuildInfo buildInfo)

इस तरीके का इस्तेमाल बंद कर दिया गया है. अब इसकी ज़रूरत नहीं है.

void setDisable(boolean isDisabled)

इससे यह सेट किया जाता है कि ऑब्जेक्ट को बंद करना है या नहीं.

void setMergeStrategy(MergeStrategy strategy)

इस कुकी का इस्तेमाल, नतीजों को मर्ज करते समय इस्तेमाल किए जाने वाले MergeStrategy को सेट करने के लिए किया जाता है.

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 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 name, int numTests, int attemptNumber)

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

void testRunStarted(String name, int numTests)

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

void testRunStarted(String name, int numTests, 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)

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

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

final void clearModuleLogFiles()

इस कुकी की मदद से, मॉड्यूल फ़ाइल को क्लीन किया जा सकता है, ताकि हम उन्हें ज़्यादा समय तक न रखें.

final void clearResultsForName(String testRunName)

इससे किसी रन के नाम के लिए, नतीजों को मिटाया जा सकता है.

final void clearTestRunResults()

इस कुकी की मदद से, टेस्ट रन के सभी नतीजों को मिटाया जा सकता है, ताकि हम उन्हें ज़्यादा समय तक सेव न रखें.

void setIsAggregrateMetrics(boolean aggregate)

'कुल मेट्रिक' विकल्प को टॉगल करें

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

CollectingTestListener

public CollectingTestListener ()

पब्लिक मेथड

getBuildInfo

public IBuildInfo getBuildInfo ()

इस तरीके का इस्तेमाल बंद कर दिया गया है.
getInvocationContext() से मिले IBuildInfo पर भरोसा करते हैं.

यह बिल्ड की जानकारी दिखाता है.

रिटर्न
IBuildInfo

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

इससे मौजूदा टेस्ट रन के नतीजे मिलते हैं.

ध्यान दें कि नतीजे पूरे नहीं हो सकते. हमारा सुझाव है कि नतीजों को प्रोसेस करने से पहले, TestRunResult.isRunComplete() और/या (@link TestRunResult#isRunFailure()} की वैल्यू की जांच कर लें.

रिटर्न
TestRunResult TestRunResult, पिछले टेस्ट रन के दौरान इकट्ठा किए गए डेटा को दिखाता है

getExpectedTests

public int getExpectedTests ()

इससे, अनुमानित टेस्ट की संख्या मिलती है. अगर कुछ टेस्ट नहीं चले, तो यह getNumTotalTests() से अलग हो सकता है.

रिटर्न
int

getInvocationContext

public IInvocationContext getInvocationContext ()

invocationStarted(IInvocationContext) के ज़रिए रिपोर्ट किए गए इनवोकेशन कॉन्टेक्स्ट को वापस लाता है

रिटर्न
IInvocationContext

getMergedTestRunResults

public List<TestRunResult> getMergedTestRunResults ()

अलग-अलग कोशिशों में किए गए सभी रन के लिए, नतीजों का मर्ज किया गया कलेक्शन दिखाओ.

अगर एक से ज़्यादा नतीजे हैं, तो हर टेस्ट रन को मर्ज कर दिया जाता है. साथ ही, टेस्ट के सबसे नए नतीजे, पिछले रन के नतीजों को बदल देते हैं. टेस्ट रन को कोशिश की संख्या के हिसाब से क्रम में लगाया जाता है.

एक ही कोशिश के लिए मेट्रिक, aggregate-metrics की सेट की गई प्राथमिकता के आधार पर मर्ज की जाएंगी. आखिरी कोशिश की मेट्रिक ही फ़ाइनल मेट्रिक होंगी.

रिटर्न
List<TestRunResult>

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

नतीजों से जुड़े मॉड्यूल का IInvocationContext दिखाता है.

पैरामीटर
testRunName String: {testRunStarted(String,int) ने यह नाम दिया है.
रिटर्न
IInvocationContext अगर दिए गए टेस्ट रन के नाम null के लिए कोई नतीजा नहीं है, तो मॉड्यूल का IInvocationContext.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

यह फ़ंक्शन, मॉड्यूल से जुड़ी सभी लॉग की गई फ़ाइलों के साथ मैप की कॉपी दिखाता है

रिटर्न
MultiMap<String, LogFile>

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

यह फ़ंक्शन, मैप की एक कॉपी दिखाता है. इसमें वे सभी लॉग की गई फ़ाइलें होती हैं जो किसी टेस्ट रन या मॉड्यूल से जुड़ी नहीं होती हैं.

रिटर्न
MultiMap<String, LogFile>

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

यह फ़ंक्शन, टेस्ट रन की कुल संख्या दिखाता है जो फ़ेल हो गए हैं

रिटर्न
int

getNumAllFailedTests

public int getNumAllFailedTests ()

यह फ़ंक्शन, फ़ेल हो चुके टेस्ट की कुल संख्या दिखाता है. इसमें सिर्फ़ फ़ेल हुए टेस्ट शामिल होते हैं. अनुमान के आधार पर फ़ेल हुए टेस्ट को इसमें शामिल नहीं किया जाता.

रिटर्न
int

getNumTestsInState

public int getNumTestsInState (TestStatus status)

इस रन के लिए, दी गई स्थिति में टेस्ट की संख्या दिखाता है.

पैरामीटर
status TestStatus

रिटर्न
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

पुराने स्टेटस टाइप के साथ काम करने के लिए

पैरामीटर
ddmlibStatus TestResult.TestStatus

रिटर्न
int

getNumTotalTests

public int getNumTotalTests ()

यह फ़ंक्शन, सभी रन के लिए पूरे किए गए टेस्ट की कुल संख्या दिखाता है.

रिटर्न
int

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

invocationStarted(IInvocationContext) के ज़रिए रिपोर्ट की गई प्राइमरी बिल्ड की जानकारी दिखाता है. प्राइमरी बिल्ड, चालू कॉन्फ़िगरेशन के पहले बिल्ड प्रोवाइडर से मिला बिल्ड होता है. अगर कोई कॉन्टेक्स्ट नहीं है (टेस्ट केस बनाने के लिए कोई बिल्ड नहीं है), तो यह फ़ंक्शन शून्य दिखाता है.

रिटर्न
IBuildInfo

getRunResults

public Collection<TestRunResult> getRunResults ()

इस तरीके का इस्तेमाल बंद कर दिया गया है.
getMergedTestRunResults() का इस्तेमाल करें

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

रिटर्न
Collection<TestRunResult>

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

एक बार कोशिश करने के लिए, TestRunResult को वापस लाएं.

पैरामीटर
testRunName String: {testRunStarted(String,int) ने यह नाम दिया है.
attempt int: कोशिश का आईडी.
रिटर्न
TestRunResult दिए गए नाम और कोशिश के आईडी के लिए TestRunResult या null अगर यह मौजूद नहीं है.

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

यह फ़ंक्शन, टेस्ट रन के दिए गए नाम के लिए कोशिशों की संख्या दिखाता है.

पैरामीटर
testRunName String: {testRunStarted(String,int) ने यह नाम दिया है.
रिटर्न
int

getTestRunAttempts

public List<TestRunResult> getTestRunAttempts (String testRunName)

यह किसी टेस्ट रन के TestRunResult के लिए किए गए सभी प्रयासों को दिखाता है.

पैरामीटर
testRunName String: {testRunStarted(String,int) ने यह नाम दिया है.
रिटर्न
List<TestRunResult> किसी टेस्ट रन के लिए सभी TestRunResult, कोशिशों के हिसाब से क्रम में लगाए गए हैं.

getTestRunForAttempts

public List<TestRunResult> getTestRunForAttempts (int attempt)

यह किसी दिए गए अनुरोध के सभी नतीजे दिखाता है.

पैरामीटर
attempt int: वह कोशिश जिसके लिए हमें नतीजे चाहिए.
रिटर्न
List<TestRunResult> किसी दिए गए अनुरोध के लिए सभी TestRunResult.

getTestRunNames

public Collection<String> getTestRunNames ()

सभी टेस्ट रन के नाम दिखाओ.

ये टेस्ट रन, अलग-अलग कोशिशों के साथ कई बार चलाए गए हों.

रिटर्न
Collection<String>

hasFailedTests

public boolean hasFailedTests ()

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

रिटर्न
boolean

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

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

पैरामीटर
testRunName String: {testRunStarted(String,int) ने यह नाम दिया है.
रिटर्न
boolean

invocationEnded

public void invocationEnded (long elapsedTime)

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

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

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

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

isDisabled

public boolean isDisabled ()

अगर पूरा ऑब्जेक्ट बंद है, तो True दिखाता है. इससे सेटअप और टियरडाउन, दोनों को स्किप किया जा सकता है. अगर ऐसा नहीं है, तो वैल्यू 'गलत' दिखती है.

रिटर्न
boolean

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

कुछ मामलों में, लॉग को टेस्ट केस से जोड़ा जाना ज़रूरी होता है. हालांकि, सीधे testLogSaved(String,LogDataType,InputStreamSource,LogFile) कॉलबैक पर ऐसा नहीं किया जा सकता. इसलिए, यह कॉलबैक साफ़ तौर पर एक मज़बूत असोसिएशन उपलब्ध कराने की अनुमति देता है.

पैरामीटर
dataName String: डेटा का नाम
logFile LogFile: वह LogFile जिसे पहले लॉग किया गया था और जिसे टेस्ट केस से जोड़ा जाना चाहिए.

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

इस तरीके का इस्तेमाल बंद कर दिया गया है.
अब इसकी जांच करना ज़रूरी नहीं है.

बिल्ड की जानकारी सेट करता है. इसका इस्तेमाल सिर्फ़ टेस्टिंग के लिए किया जाना चाहिए.

पैरामीटर
buildInfo IBuildInfo

setDisable

public void setDisable (boolean isDisabled)

इससे यह सेट किया जाता है कि ऑब्जेक्ट को बंद करना है या नहीं. बंद होने का मतलब है कि सेटअप और टियरडाउन, दोनों चरणों को छोड़ दिया जाना चाहिए. इसका इस्तेमाल, डिफ़ॉल्ट कंस्ट्रक्टर में किसी ऑब्जेक्ट को डिफ़ॉल्ट रूप से बंद करने के लिए किया जा सकता है.

पैरामीटर
isDisabled boolean: वह स्थिति जिसमें ऑब्जेक्ट को रखा जाना चाहिए.

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

इस कुकी का इस्तेमाल, नतीजों को मर्ज करते समय इस्तेमाल किए जाने वाले MergeStrategy को सेट करने के लिए किया जाता है.

पैरामीटर
strategy MergeStrategy

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

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 name, 
                int numTests, 
                int attemptNumber)

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

पैरामीटर
name String: टेस्ट रन का नाम
numTests int: टेस्ट रन में कुल टेस्ट की संख्या
attemptNumber int: ऑर्डर नंबर, जो एक ही runName के अलग-अलग प्रयासों की पहचान करता है. यह कई बार चलता है. attemptNumber, 0 से शुरू होता है और हर बार नया रन होने पर इसे बढ़ाना चाहिए. उदाहरण के लिए, अगर किसी टेस्ट को तीन बार फिर से आज़माया जाता है, तो उसे एक ही runName के तहत कुल चार रन करने चाहिए. साथ ही, attemptNumber 0 से 3 तक होना चाहिए.

testRunStarted

public void testRunStarted (String name, 
                int numTests)

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

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

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

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

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

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

clearModuleLogFiles

protected final void clearModuleLogFiles ()

इस कुकी की मदद से, मॉड्यूल फ़ाइल को क्लीन किया जा सकता है, ताकि हम उन्हें ज़्यादा समय तक न रखें.

clearResultsForName

protected final void clearResultsForName (String testRunName)

इससे किसी रन के नाम के लिए, नतीजों को मिटाया जा सकता है. इसका इस्तेमाल सिर्फ़ कुछ मामलों में किया जाना चाहिए. जैसे, नतीजों का एग्रीगेटर.

पैरामीटर
testRunName String

clearTestRunResults

protected final void clearTestRunResults ()

इस कुकी की मदद से, टेस्ट रन के सभी नतीजों को मिटाया जा सकता है, ताकि हम उन्हें ज़्यादा समय तक सेव न रखें.

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

'कुल मेट्रिक' विकल्प को टॉगल करें

पैरामीटर
aggregate boolean