ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

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

एक ITestInvocationListener, जो इनवोकेशन शार्ड (यानी कि साथ में कई संसाधनों पर चलाने के लिए बोले जाने वाले स्विच) से नतीजे इकट्ठा करता है और उन्हें दूसरे लिसनर तक फ़ॉरवर्ड करता है.

खास जानकारी

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

ShardListener(ITestInvocationListener main)

ShardListener बनाएं.

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

getUnderlyingResultReporter()
void invocationEnded(long elapsedTime)

यह रिपोर्ट दिखाती है कि अनुरोध पूरा हो गया है या किसी गड़बड़ी की वजह से पूरा नहीं हो सका.

void invocationFailed(FailureDescription failure)

किसी गड़बड़ी की स्थिति की वजह से, कॉल शुरू करने की प्रोसेस पूरी नहीं होने की रिपोर्ट करता है.

void invocationFailed(Throwable cause)

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

void invocationSkipped(SkipReason reason)

किसी अनुरोध को 'अभी नहीं' के तौर पर रिपोर्ट करता है

void invocationStarted(IInvocationContext context)

टेस्ट को शुरू करने के बारे में रिपोर्ट करता है.

void logAssociation(String dataName, LogFile logFile)

कुछ मामलों में, लॉग को टेस्ट केस से ज़्यादा से ज़्यादा जोड़ा जाना चाहिए. हालांकि, डायरेक्ट testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) callback पर ऐसा करना संभव नहीं है.

void setSupportGranularResults(boolean enableGranularResults)
boolean supportGranularResults()

अगर रिपोर्टर ज़्यादा जानकारी वाले नतीजे दिखाता है, तो True दिखाता है. ऐसा न होने पर, False दिखाता है.

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

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

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

void testModuleEnded()

यह मॉड्यूल चलने के खत्म होने की रिपोर्ट करता है.

void testModuleStarted(IInvocationContext moduleContext)

किसी मॉड्यूल के चलने की शुरुआत की रिपोर्ट करता है.

void testRunEnded(long elapsedTime, runMetrics)

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

void testRunFailed(FailureDescription failure)

FailureDescription की बताई गई गड़बड़ी की वजह से, रिपोर्ट की जांच पूरी नहीं हो सकी.

void testRunFailed(String failureMessage)

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

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

टेस्ट रन शुरू होने की रिपोर्ट करता है.

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

ShardListener

public ShardListener (ITestInvocationListener main)

ShardListener बनाएं.

पैरामीटर
main ITestInvocationListener: ITestInvocationListener नतीजे फ़ॉरवर्ड किए जाने चाहिए. नतीजों को फ़ॉरवर्ड करते समय, यह ऑब्जेक्ट main पर सिंक हो जाएगा, ताकि अन्य ShardListener से कोई गड़बड़ी न हो. साथ ही, नतीजे सिर्फ़ तब भेजे जाएंगे, जब invocaton शर्ड पूरा हो जाएगा.

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

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

रिटर्न

शुरू होने का समय खत्म

public void invocationEnded (long elapsedTime)

यह रिपोर्ट दिखाती है कि अनुरोध पूरा हो गया है या किसी गड़बड़ी की वजह से पूरा नहीं हो सका.

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

पैरामीटर
elapsedTime long: शुरू करने का समय मिलीसेकंड में

शुरू करने में समस्या

public void invocationFailed (FailureDescription failure)

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

इसे ट्रेडफ़ेडरेशन फ़्रेमवर्क से अपने-आप कॉल किया जाएगा.

पैरामीटर
failure FailureDescription: FailureDescription, जिसमें गड़बड़ी की वजह बताई गई है

शुरू करने में समस्या

public void invocationFailed (Throwable cause)

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

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

पैरामीटर
cause Throwable: Throwable गड़बड़ी की वजह

invocationSkipped

public void invocationSkipped (SkipReason reason)

किसी बातचीत को 'स्किप किया गया' के तौर पर रिपोर्ट करता है

पैरामीटर
reason SkipReason

शुरू किया गया

public void invocationStarted (IInvocationContext context)

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

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

पैरामीटर
context IInvocationContext: बोलकर निर्देश देने की सुविधा के बारे में जानकारी

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

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

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

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

पैरामीटर
enableGranularResults boolean

supportGranularresults

public boolean supportGranularResults ()

अगर रिपोर्टर ज़्यादा जानकारी वाले नतीजे दिखाता है, तो True दिखाता है. ऐसा न होने पर, False दिखाता है.

रिटर्न
boolean

testLog

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

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

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

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

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

testLogSaved

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

पैरामीटर
dataName String

dataType LogDataType

dataStream InputStreamSource

logFile LogFile

परीक्षण मॉड्यूल का आखिरी चरण

public void testModuleEnded ()

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

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

किसी मॉड्यूल के चलने की शुरुआत की रिपोर्ट करता है. यह कॉलबैक testModuleEnded() से जुड़ा हुआ है और क्रम में ज़रूरी नहीं है. इसका इस्तेमाल सिर्फ़ उस रन के दौरान किया जाता है जिसमें मॉड्यूल का इस्तेमाल किया जाता है: suite based runners.

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

टेस्ट रन खत्म होने की रिपोर्ट.

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

परीक्षणरन विफल

public void testRunFailed (FailureDescription failure)

FailureDescription की बताई गई गड़बड़ी की वजह से, रिपोर्ट की जांच पूरी नहीं हो सकी.

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

testRunFailed

public void testRunFailed (String failureMessage)

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

पैरामीटर
failureMessage String: String, जिसमें रन न होने की वजह बताई गई है.

testRunStarted

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

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

पैरामीटर
name String: टेस्ट रन का नाम
numTests int: टेस्ट रन में टेस्ट की कुल संख्या
attemptNumber int: ऑर्डर नंबर, जो एक ही RunName की अलग-अलग कोशिशों की पहचान करता है जो कई बार चलते हैं. errorNumber 0-इंडेक्स किया गया है और हर बार नया रन होने पर यह बढ़ता है. उदाहरण के लिए, किसी टेस्ट को तीन बार अच्छी तरह से करने की कोशिश की जाती है, एक ही RunName के तहत कुल चार रन होने चाहिए और trialNumber 0 से 3 तक होना चाहिए.
startTime long: दौड़ शुरू होने का समय, System.currentTimeMillis() से मापा गया