शार्ड श्रोता

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.ऑब्जेक्ट
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) पर ऐसा करने का अवसर testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) कॉलबैक संभव नहीं है।

void setSupportGranularResults (boolean enableGranularResults)
boolean supportGranularResults ()

यदि रिपोर्टर विस्तृत परिणामों का समर्थन करता है तो सत्य लौटाता है, अन्यथा गलत लौटाता है।

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) testRunEnded (long elapsedTime, runMetrics)

परीक्षण चलाने की समाप्ति की रिपोर्ट।

void testRunFailed ( FailureDescription failure)

FailureDescription द्वारा वर्णित विफलता के कारण रिपोर्ट परीक्षण चलाने में विफल रही।

void testRunFailed (String failureMessage)

एक घातक त्रुटि के कारण रिपोर्ट परीक्षण पूरा होने में विफल रहा।

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

परीक्षण चलाने की शुरुआत की रिपोर्ट करता है।

सार्वजनिक निर्माणकर्ता

शार्ड श्रोता

public ShardListener (ITestInvocationListener main)

एक ShardListener बनाएं।

पैरामीटर
main ITestInvocationListener : ITestInvocationListener के परिणाम अग्रेषित किए जाने चाहिए। अन्य ShardListener s के साथ टकराव को रोकने के लिए, परिणाम अग्रेषित करते समय यह ऑब्जेक्ट main पर सिंक्रनाइज़ हो जाएगा। और परिणाम केवल मंगलाचरण शार्ड पूरा होने के बाद ही भेजे जाएंगे।

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

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

रिटर्न

मंगलाचरणसमाप्त

public void invocationEnded (long elapsedTime)

रिपोर्ट करता है कि मंगलाचरण समाप्त हो गया है, चाहे सफलतापूर्वक या किसी त्रुटि स्थिति के कारण।

ट्रेडफेडरेशन फ्रेमवर्क द्वारा स्वचालित रूप से बुलाया जाएगा।

पैरामीटर
elapsedTime long : एमएस में आह्वान का बीता हुआ समय

मंगलाचरणविफल

public void invocationFailed (FailureDescription failure)

कुछ त्रुटि स्थिति के कारण अपूर्ण आह्वान की रिपोर्ट करता है।

ट्रेडफेडरेशन फ्रेमवर्क द्वारा स्वचालित रूप से बुलाया जाएगा।

पैरामीटर
failure FailureDescription : FailureDescription विफलता के कारण का वर्णन करता है

मंगलाचरणविफल

public void invocationFailed (Throwable cause)

कुछ त्रुटि स्थिति के कारण अपूर्ण आह्वान की रिपोर्ट करता है।

ट्रेडफेडरेशन फ्रेमवर्क द्वारा स्वचालित रूप से बुलाया जाएगा।

पैरामीटर
cause Throwable : विफलता का Throwable कारण

मंगलाचरणछोड़ दिया गया

public void invocationSkipped (SkipReason reason)

किसी आह्वान को छोड़े गए के रूप में रिपोर्ट करता है

पैरामीटर
reason SkipReason

मंगलाचरणशुरू हुआ

public void invocationStarted (IInvocationContext context)

परीक्षण मंगलाचरण की शुरुआत की रिपोर्ट करता है।

ट्रेडफेडरेशन फ्रेमवर्क द्वारा स्वचालित रूप से बुलाया जाएगा। एकाधिक डिवाइस रिपोर्टिंग का समर्थन करने के लिए रिपोर्टर्स को इस पद्धति को ओवरराइड करने की आवश्यकता है।

पैरामीटर
context IInvocationContext : मंगलाचरण के बारे में जानकारी

लॉगएसोसिएशन

public void logAssociation (String dataName, 
                LogFile logFile)

कुछ मामलों में, लॉग को परीक्षण मामलों के साथ मजबूती से जुड़ा होना चाहिए, लेकिन सीधे testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.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 ()

यदि रिपोर्टर विस्तृत परिणामों का समर्थन करता है तो सत्य लौटाता है, अन्यथा गलत लौटाता है।

रिटर्न
boolean

परीक्षणलॉग

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

परीक्षण आमंत्रण से संबंधित लॉग या डिबग डेटा प्रदान करता है।

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

ट्रेडफेडरेशन फ्रेमवर्क स्वचालित रूप से इस पद्धति को कॉल करेगा, होस्ट लॉग प्रदान करेगा और यदि लागू हो, तो डिवाइस लॉगकैट प्रदान करेगा।

पैरामीटर
dataName String : डेटा का एक String वर्णनात्मक नाम। उदाहरण के लिए "डिवाइस_लॉगकैट"। नोट डेटानाम प्रति आह्वान अद्वितीय नहीं हो सकता है। यानी कार्यान्वयनकर्ताओं को एक ही डेटानाम के साथ एकाधिक कॉल को संभालने में सक्षम होना चाहिए

dataType LogDataType : डेटा का LogDataType

dataStream InputStreamSource : डेटा का InputStreamSource । कार्यान्वयनकर्ताओं को डेटा पढ़ना शुरू करने के लिए createInputStream को कॉल करना चाहिए, और पूरा होने पर परिणामी इनपुटस्ट्रीम को बंद करना सुनिश्चित करना चाहिए। कॉल करने वालों को यह सुनिश्चित करना चाहिए कि टेस्टलॉग विधि पूरी होने तक डेटा का स्रोत मौजूद और पहुंच योग्य बना रहे।

परीक्षण लॉग सहेजा गया

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

पैरामीटर
dataName String

dataType LogDataType

dataStream InputStreamSource

logFile LogFile

testModuleसमाप्त

public void testModuleEnded ()

मॉड्यूल रन के अंत की रिपोर्ट करता है।

testModuleशुरू हुआ

public void testModuleStarted (IInvocationContext moduleContext)

किसी मॉड्यूल के चलने की शुरुआत की रिपोर्ट करता है। यह कॉलबैक testModuleEnded() से संबद्ध है और अनुक्रम में वैकल्पिक है। इसका उपयोग केवल रन के दौरान किया जाता है जो मॉड्यूल का उपयोग करता है: सुइट आधारित धावक।

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

परीक्षण चलाने की समाप्ति की रिपोर्ट। FIXME: हमारे पास अलग-अलग प्रकार के दो Map<> इंटरफ़ेस नहीं हो सकते हैं, इसलिए हमें यहां HashMap का उपयोग करना होगा।

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

runMetrics : Metric के साथ परीक्षण चलाने के अंत में कुंजी-मूल्य जोड़े की सूचना दी गई।

परीक्षण चलाने में विफल

public void testRunFailed (FailureDescription failure)

FailureDescription द्वारा वर्णित विफलता के कारण रिपोर्ट परीक्षण चलाने में विफल रही।

पैरामीटर
failure FailureDescription : FailureDescription विफलता और उसके संदर्भ का वर्णन करता है।

परीक्षण चलाने में विफल

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 : क्रम संख्या, एक ही रननाम के विभिन्न प्रयासों की पहचान करना जो कई बार चलते हैं। प्रयास संख्या 0-अनुक्रमित है और हर बार एक नया रन होने पर इसमें वृद्धि होनी चाहिए। उदाहरण के लिए एक परीक्षण को 3 बार पुनः प्रयास किया जाता है, इसमें एक ही रननाम के तहत कुल 4 रन होने चाहिए और प्रयास संख्या 0 से 3 तक होनी चाहिए।

startTime long : रन शुरू होने का समय, System.currentTimeMillis() के माध्यम से मापा गया