ShardMainResultForwarder

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object
   ↳ com.android.tradefed.result.ResultForwarder
     ↳ com.android.tradefed.invoker.ShardMainResultForwarder

ResultForwarder, जो शार्ड किए गए टेस्ट इनवोकेशन के नतीजों को जोड़ता है. यह सिर्फ़ तब श्रोताओं को इनवोकेशन पूरा होने की सूचना देता है, जब सभी शार्ड किए गए इनवोकेशन पूरे हो जाते हैं.

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

खास जानकारी

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

ShardMainResultForwarder(List<ITestInvocationListener> listeners, int expectedShards)

ShardMainResultForwarder बनाएं.

पब्लिक मेथड

List<ITestInvocationListener> getListeners()

लिसनर की सूची पाएं.

void invocationEnded(long elapsedTime)

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

void invocationEnded(long elapsedTime, IInvocationContext context)

ज़्यादा जानकारी वाला कॉलबैक, ताकि यह पता चल सके कि कौनसे शार्ड का काम पूरा हो गया है.

void invocationFailed(FailureDescription failure)

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

void invocationFailed(Throwable cause)

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

void invocationSkipped(SkipReason reason)

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

void invocationStarted(IInvocationContext context)

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

void logAssociation(String dataName, LogFile logFile)

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

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

लॉग को सेव करने के बजाय, सिर्फ़ testLog को फ़ॉरवर्ड करें.

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

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

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

ShardMainResultForwarder

public ShardMainResultForwarder (List<ITestInvocationListener> listeners, 
                int expectedShards)

ShardMainResultForwarder बनाएं.

पैरामीटर
listeners List: सभी शार्ड पूरे होने पर, नतीजों को फ़ॉरवर्ड करने के लिए ITestInvocationListener की सूची
expectedShards int: शार्ड की संख्या

पब्लिक मेथड

getListeners

public List<ITestInvocationListener> getListeners ()

लिसनर की सूची पाएं.

रिटर्न
List<ITestInvocationListener> ITestInvocationListener की सूची.

invocationEnded

public void invocationEnded (long elapsedTime)

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

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

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

invocationEnded

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

ज़्यादा जानकारी वाला कॉलबैक, ताकि यह पता चल सके कि कौनसे शार्ड का काम पूरा हो गया है.

पैरामीटर
elapsedTime long

context IInvocationContext

invocationFailed

public void invocationFailed (FailureDescription failure)

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

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

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

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

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

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

testLogForward

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

लॉग को सेव करने के बजाय, सिर्फ़ testLog को फ़ॉरवर्ड करें.

पैरामीटर
dataName String

dataType LogDataType

dataStream InputStreamSource

testLogSaved

public 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.