BasePostProcessor

public abstract class BasePostProcessor
extends Object implements IConfigurationReceiver, IPostProcessor

java.lang.Object
   ↳ com.android.tradefed.postprocessor.BasePostProcessor

यह बुनियादी IPostProcessor है, जिसे हर लागू करने वाले को बढ़ाना चाहिए. पक्का करें कि फ़ाइनल नतीजे की जानकारी देने वाले रिपोर्टर से पहले, पोस्ट प्रोसेसिंग के तरीकों को कॉल किया गया हो.

खास जानकारी

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

BasePostProcessor()

पब्लिक मेथड

IConfiguration getConfiguration()
final ITestInvocationListener init(ITestInvocationListener listener)

पोस्ट प्रोसेसर को शुरू करने का चरण.

final void invocationEnded(long elapsedTime)

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

final void invocationFailed(FailureDescription failure)

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

final void invocationFailed(Throwable cause)

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

void invocationSkipped(SkipReason reason)

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

final void invocationStarted(IInvocationContext context)

फ़ॉरवर्ड करने के लिए इनवोकेशन लिसनर

final boolean isDisabled()

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

final void logAssociation(String dataName, LogFile logFile)

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

यह फ़ंक्शन, लॉग-टू-टेस्ट असोसिएशन को अपडेट करता है.

Map<String, MetricMeasurement.Metric.Builder> processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, Map<TestDescription, Map<String, LogFile>> allTestLogs)

इस तरीके को लागू करके, सभी टेस्ट के लिए मेट्रिक और लॉग को एग्रीगेट करें.

abstract Map<String, MetricMeasurement.Metric.Builder> processRunMetricsAndLogs(HashMap<String, MetricMeasurement.Metric> rawMetrics, Map<String, LogFile> runLogs)

मौजूदा मेट्रिक और लॉग से नई मेट्रिक का सेट जनरेट करने के लिए, इस तरीके को लागू करें.

Map<String, MetricMeasurement.Metric.Builder> processTestMetricsAndLogs(TestDescription testDescription, HashMap<String, MetricMeasurement.Metric> testMetrics, Map<String, LogFile> testLogs)

इस तरीके को लागू करके, हर टेस्ट से मेट्रिक और लॉग को पोस्ट प्रोसेस करें.

void setConfiguration(IConfiguration configuration)

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

final void setLogSaver(ILogSaver logSaver)

ILogSaver को सेट करें, ताकि लागू करने वाला व्यक्ति फ़ाइलें सेव कर सके.

void setUp()

टेस्ट शुरू होने से पहले, चाइल्ड पोस्ट प्रोसेसर में इस तरीके को ओवरराइड करें.

final void testAssumptionFailure(TestDescription test, String trace)

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

final void testAssumptionFailure(TestDescription test, FailureDescription failure)

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

final void testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)

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

final void testEnded(TestDescription test, Map<String, String> testMetrics)

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

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

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

final void testEnded(TestDescription test, long endTime, Map<String, String> testMetrics)

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

final void testFailed(TestDescription test, FailureDescription failure)

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

final void testFailed(TestDescription test, String trace)

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

final void testIgnored(TestDescription test)

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

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

PostProcessor के लागू करने से किसी फ़ाइल को लॉग करने के लिए, इस तरीके का इस्तेमाल करें.

final void testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

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

final void testModuleEnded()

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

final void testModuleStarted(IInvocationContext moduleContext)

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

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

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

final void testRunEnded(long elapsedTime, Map<String, String> runMetrics)

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

final void testRunFailed(FailureDescription failure)

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

final void testRunFailed(String errorMessage)

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

final void testRunStarted(String runName, int testCount, int attemptNumber)

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

final void testRunStarted(String runName, int testCount)

कॉलबैक की जांच करना

final void testRunStarted(String runName, int testCount, int attemptNumber, long startTime)

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

final void testRunStopped(long elapsedTime)

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

final void testSkipped(TestDescription test, SkipReason reason)

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

final void testStarted(TestDescription test, long startTime)

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

final void testStarted(TestDescription test)

कॉलबैक के टेस्ट केस

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

void cleanUp()
MetricMeasurement.DataType getMetricType()

अगर ज़रूरी हो, तो मेट्रिक का टाइप बदलने के लिए इस तरीके को ओवरराइड करें.

String getRunName()
final String getStackTrace()
final boolean isTestFailed()

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

BasePostProcessor

public BasePostProcessor ()

पब्लिक मेथड

getConfiguration

public IConfiguration getConfiguration ()

रिटर्न
IConfiguration

init

public final ITestInvocationListener init (ITestInvocationListener listener)

पोस्ट प्रोसेसर को शुरू करने का चरण. यह पक्का किया जाता है कि इसे किसी भी टेस्ट के कॉल बैक से पहले कॉल किया जाए.

पैरामीटर
listener ITestInvocationListener

रिटर्न
ITestInvocationListener

invocationEnded

public final void invocationEnded (long elapsedTime)

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

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

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

invocationFailed

public final void invocationFailed (FailureDescription failure)

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

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

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

invocationFailed

public final void invocationFailed (Throwable cause)

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

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

पैरामीटर
cause Throwable: Throwable की वजह से टेस्ट पूरा नहीं हो सका

invocationSkipped

public void invocationSkipped (SkipReason reason)

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

पैरामीटर
reason SkipReason

invocationStarted

public final void invocationStarted (IInvocationContext context)

फ़ॉरवर्ड करने के लिए इनवोकेशन लिसनर

पैरामीटर
context IInvocationContext: शुरू करने के बारे में जानकारी

isDisabled

public final boolean isDisabled ()

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

रिटर्न
boolean

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

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

यह फ़ंक्शन, लॉग-टू-टेस्ट असोसिएशन को अपडेट करता है. अगर इस तरीके को टेस्ट के दौरान कॉल किया जाता है, तो लॉग टेस्ट से जुड़ा होगा. ऐसा न होने पर, यह रन लॉग होगा.

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

processAllTestMetricsAndLogs

public Map<String, MetricMeasurement.Metric.Builder> processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, 
                Map<TestDescription, Map<String, LogFile>> allTestLogs)

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

पैरामीटर
allTestMetrics ListMultimap: यह एक HashMultimap है. इसमें हर टेस्ट की मेट्रिक को मेट्रिक के नाम के हिसाब से ग्रुप करके सेव किया जाता है.
allTestLogs Map: यह एक मैप होता है. इसमें हर टेस्ट की लॉग फ़ाइलों का मैप सेव होता है. इन फ़ाइलों को उनके डेटा के नाम के हिसाब से कुंजी दी जाती है. साथ ही, हर टेस्ट के TestDescription को कुंजियों के तौर पर इस्तेमाल किया जाता है.
रिटर्न
Map<String, MetricMeasurement.Metric.Builder> यह सभी टेस्ट मेट्रिक से जनरेट की गई नई मेट्रिक का सेट होता है.

processRunMetricsAndLogs

public abstract Map<String, MetricMeasurement.Metric.Builder> processRunMetricsAndLogs (HashMap<String, MetricMeasurement.Metric> rawMetrics, 
                Map<String, LogFile> runLogs)

मौजूदा मेट्रिक और लॉग से नई मेट्रिक का सेट जनरेट करने के लिए, इस तरीके को लागू करें. सिर्फ़ नई जनरेट की गई मेट्रिक दिखनी चाहिए. साथ ही, कुंजी का नाम यूनीक होना चाहिए. मौजूदा कुंजियों के साथ कोई टकराव नहीं होना चाहिए.

पैरामीटर
rawMetrics HashMap: रन के लिए उपलब्ध रॉ मेट्रिक का सेट.
runLogs Map: टेस्ट रन के लिए लॉग फ़ाइलों का सेट.
रिटर्न
Map<String, MetricMeasurement.Metric.Builder> रन मेट्रिक से जनरेट की गई नई मेट्रिक का सेट.

processTestMetricsAndLogs

public Map<String, MetricMeasurement.Metric.Builder> processTestMetricsAndLogs (TestDescription testDescription, 
                HashMap<String, MetricMeasurement.Metric> testMetrics, 
                Map<String, LogFile> testLogs)

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

पैरामीटर
testDescription TestDescription: TestDescription ऑब्जेक्ट, जिसमें टेस्ट के बारे में बताया गया है.
testMetrics HashMap: टेस्ट से मिली मेट्रिक का सेट.
testLogs Map: जांच के दौरान लॉग की गई फ़ाइलों का सेट.
रिटर्न
Map<String, MetricMeasurement.Metric.Builder> टेस्ट मेट्रिक से जनरेट की गई नई मेट्रिक का सेट.

setConfiguration

public void setConfiguration (IConfiguration configuration)

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

पैरामीटर
configuration IConfiguration

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

ILogSaver को सेट करें, ताकि लागू करने वाला व्यक्ति फ़ाइलें सेव कर सके.

पैरामीटर
logSaver ILogSaver: ILogSaver

setUp

public void setUp ()

टेस्ट शुरू होने से पहले, चाइल्ड पोस्ट प्रोसेसर में इस तरीके को ओवरराइड करें.

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

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

testEnded

public final 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 final void testEnded (TestDescription test, 
                Map<String, String> testMetrics)

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

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

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

testEnded

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

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

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

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

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                Map<String, String> testMetrics)

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

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

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

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

testFailed

public final void testFailed (TestDescription test, 
                String trace)

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

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

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

testIgnored

public final void testIgnored (TestDescription test)

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

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

testLog

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

PostProcessor के लागू करने से किसी फ़ाइल को लॉग करने के लिए, इस तरीके का इस्तेमाल करें.

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

testLogSaved

public final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

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

इसका इस्तेमाल ITestInvocationListener.testLog(String,LogDataType,InputStreamSource) के बजाय किया जाना चाहिए.

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

testModuleEnded

public final void testModuleEnded ()

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

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

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

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

testRunEnded

public final 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 के साथ टेस्ट रन के आखिर में रिपोर्ट किए गए की-वैल्यू पेयर.

testRunEnded

public final void testRunEnded (long elapsedTime, 
                Map<String, String> runMetrics)

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

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

testRunFailed

public final void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public final void testRunFailed (String errorMessage)

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

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

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

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

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

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

कॉलबैक की जांच करना

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

testRunStarted

public final 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 final void testRunStopped (long elapsedTime)

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

TODO: currently unused, consider removing

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

testSkipped

public final void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

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

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

testStarted

public final void testStarted (TestDescription test)

कॉलबैक के टेस्ट केस

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

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

cleanUp

protected void cleanUp ()

getMetricType

protected MetricMeasurement.DataType getMetricType ()

अगर ज़रूरी हो, तो मेट्रिक का टाइप बदलने के लिए इस तरीके को ओवरराइड करें. डिफ़ॉल्ट रूप से मेट्रिक, प्रोसेस किए गए टाइप पर सेट होती है.

रिटर्न
MetricMeasurement.DataType

getRunName

protected String getRunName ()

रिटर्न
String

getStackTrace

protected final String getStackTrace ()

रिटर्न
String

isTestFailed

protected final boolean isTestFailed ()

रिटर्न
boolean