BugreportCollector

public class BugreportCollector
extends Object implements ITestInvocationListener

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

---

एक पास-थ्रू ITestInvocationListener जो कॉन्फ़िगर करने योग्य ईवेंट होने पर बग रिपोर्ट एकत्र करता है और फिर प्रत्येक बग रिपोर्ट एकत्र होने के बाद अपने बच्चों पर ITestInvocationListener#testLog कॉल करता है।

व्यवहार: (FIXME: इसे समाप्त करें)

• यदि कोई टेस्टकेस विफल हो जाता है तो प्रत्येक के बाद कैप्चर करें
• प्रत्येक टेस्टकेस के बाद कैप्चर करें
• प्रत्येक विफल टेस्टकेस के बाद कैप्चर करें
• कब्ज़ा करना

सारांश

नेस्टेड कक्षाएं
class	BugreportCollector.Predicate बग्रेपोर्ट कब कैप्चर करना है इसका वर्णन करने वाला एक पूर्ण विधेय।
interface	BugreportCollector.SubPredicate

खेत
public static final BugreportCollector.Predicate	AFTER_FAILED_TESTCASES एक पूर्वनिर्धारित विधेय जो प्रत्येक विफल टेस्टकेस के बाद सक्रिय होता है
public static final BugreportCollector.Predicate	AT_START एक पूर्वनिर्धारित विधेय जो पहले आह्वान के शुरू होते ही सक्रिय हो जाता है

सार्वजनिक निर्माणकर्ता
BugreportCollector ( ITestInvocationListener listener, ITestDevice testDevice)

सार्वजनिक तरीके
void	addPredicate ( BugreportCollector.Predicate p)
void	blockUntilIdle () ब्लॉक करें जब तक कलेक्टर कोई बग रिपोर्ट एकत्र नहीं कर रहा है।
TestSummary	getSummary () इनवोकेशन लिस्टनर को सारांश वापस करने की अनुमति देता है।
void	invocationEnded (long elapsedTime) रिपोर्ट करता है कि आमंत्रण समाप्त हो गया है, चाहे सफलतापूर्वक या कुछ त्रुटि स्थिति के कारण।
void	invocationFailed (Throwable cause) कुछ त्रुटि स्थिति के कारण अपूर्ण मंगलाचरण की रिपोर्ट करता है।
void	invocationStarted ( IInvocationContext context) परीक्षण आमंत्रण की शुरुआत की रिपोर्ट करता है।
void	setAsynchronous (boolean asynchronous) सेट करें कि बगरेपोर्ट संग्रह को बगरेपोर्ट को एक अलग थ्रेड ( asynchronous = true ) में इकट्ठा करना चाहिए, या कॉलर को तब तक ब्लॉक करना चाहिए जब तक कि बगरेपोर्ट कैप्चर नहीं हो जाता ( asynchronous = false )।
void	setDescriptiveName (String name) बग रिपोर्ट रिकॉर्ड करते समय उपयोग करने के लिए वर्णनात्मक नाम सेट करें।
void	setDeviceWaitTime (int waitTime) इससे पहले कि हम किसी बग रिपोर्ट को कैप्चर करने का प्रयास करें, डिवाइस के ऑनलाइन होने की प्रतीक्षा करने के लिए समय (सेकंड में) सेट करें।
void	testAssumptionFailure ( TestDescription test, String trace) कॉल किया जाता है जब एक परमाणु परीक्षण ध्वजांकित करता है कि यह एक ऐसी स्थिति मानता है जो झूठी है
void	testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) एक व्यक्तिगत परीक्षण मामले के निष्पादन अंत की रिपोर्ट करता है।
void	testFailed ( TestDescription test, String trace) व्यक्तिगत परीक्षण मामले की विफलता की रिपोर्ट करता है।
void	testIgnored ( TestDescription test) कॉल तब किया जाता है जब कोई परीक्षण नहीं चलाया जाएगा, आम तौर पर क्योंकि एक परीक्षण विधि org.junit.Ignore के साथ एनोटेट की जाती है।
void	testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) परीक्षण मंगलाचरण से संबंधित लॉग या डीबग डेटा प्रदान करता है।
void	testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) टेस्ट रन के अंत की रिपोर्ट।
void	testRunFailed (String errorMessage) घातक त्रुटि के कारण रिपोर्ट परीक्षण रन पूरा करने में विफल रहा।
void	testRunStarted (String runName, int testCount) टेस्ट रन की शुरुआत की रिपोर्ट करता है।
void	testRunStopped (long elapsedTime) एक उपयोगकर्ता के अनुरोध के कारण रिपोर्ट का परीक्षण पूरा होने से पहले ही रुक गया।
void	testStarted ( TestDescription test) एक व्यक्तिगत परीक्षण मामले की शुरुआत की रिपोर्ट करता है।

खेत

AFTER_FAILED_TESTCASES

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

एक पूर्वनिर्धारित विधेय जो प्रत्येक विफल टेस्टकेस के बाद सक्रिय होता है

प्रारंभ में

public static final BugreportCollector.Predicate AT_START

एक पूर्वनिर्धारित विधेय जो पहले आह्वान के शुरू होते ही सक्रिय हो जाता है

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

BugreportCollector

public BugreportCollector (ITestInvocationListener listener, 
                ITestDevice testDevice)

पैरामीटर
listener	ITestInvocationListener
testDevice	ITestDevice

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

addPredicate

public void addPredicate (BugreportCollector.Predicate p)

पैरामीटर
p	BugreportCollector.Predicate

BlockUntilIdle

public void blockUntilIdle ()

ब्लॉक करें जब तक कलेक्टर कोई बग रिपोर्ट एकत्र नहीं कर रहा है। यदि संग्राहक सक्रिय रूप से बग रिपोर्ट एकत्र नहीं कर रहा है, तो तुरंत वापस लौटें

getSummary

public TestSummary getSummary ()

इनवोकेशन लिस्टनर को सारांश वापस करने की अनुमति देता है।

रिटर्न
TestSummary	रन, या शून्य का सारांश देने वाला एक TestSummary

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

public void invocationEnded (long elapsedTime)

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

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

पैरामीटर
elapsedTime	long : एमएस में मंगलाचरण का बीता हुआ समय

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

public void invocationFailed (Throwable cause)

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

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

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

मंगलाचरण प्रारंभ

public void invocationStarted (IInvocationContext context)

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

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

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

सेटअतुल्यकालिक

public void setAsynchronous (boolean asynchronous)

सेट करें कि बगरेपोर्ट संग्रह को बगरेपोर्ट को एक अलग थ्रेड ( asynchronous = true ) में इकट्ठा करना चाहिए, या कॉलर को तब तक ब्लॉक करना चाहिए जब तक कि बगरेपोर्ट कैप्चर नहीं हो जाता ( asynchronous = false )।

पैरामीटर
asynchronous	boolean

setDescriptiveName

public void setDescriptiveName (String name)

बग रिपोर्ट रिकॉर्ड करते समय उपयोग करने के लिए वर्णनात्मक नाम सेट करें। यदि null , तो BugreportCollector उस घटना के नाम को क्रमबद्ध करने के डिफ़ॉल्ट व्यवहार पर वापस आ जाएगा जिसके कारण बगरेपोर्ट एकत्र किया गया था।

पैरामीटर
name	String

सेटडिवाइसवेटटाइम

public void setDeviceWaitTime (int waitTime)

इससे पहले कि हम किसी बग रिपोर्ट को कैप्चर करने का प्रयास करें, डिवाइस के ऑनलाइन होने की प्रतीक्षा करने के लिए समय (सेकंड में) सेट करें। निगेटिव होने पर कोई जांच नहीं की जाएगी। इस जांच के दौरान किसी भी DeviceNotAvailableException का सामना करना पड़ा और उसे अनदेखा कर दिया जाएगा।

पैरामीटर
waitTime	int

परीक्षण धारणा विफलता

public void testAssumptionFailure (TestDescription test, 
                String trace)

कॉल किया जाता है जब एक परमाणु परीक्षण ध्वजांकित करता है कि यह एक ऐसी स्थिति मानता है जो झूठी है

पैरामीटर
test	TestDescription : परीक्षण की पहचान करता है
trace	String : विफलता का स्टैक ट्रेस

परीक्षण समाप्त

public void testEnded (TestDescription test, 
                 testMetrics)

एक व्यक्तिगत परीक्षण मामले के निष्पादन अंत की रिपोर्ट करता है।

अगर testFailed(TestDescription, FailureDescription) लागू नहीं किया गया था, तो यह परीक्षा पास हो गई। किसी भी कुंजी/मान मेट्रिक्स को भी लौटाता है जो टेस्ट केस के निष्पादन के दौरान उत्सर्जित हो सकता है।

पैरामीटर
test	TestDescription : परीक्षण की पहचान करता है
testMetrics	: उत्सर्जित मेट्रिक्स का एक ERROR(/Map)

परीक्षण विफल

public void testFailed (TestDescription test, 
                String trace)

व्यक्तिगत परीक्षण मामले की विफलता की रिपोर्ट करता है।

टेस्टस्टार्टेड और टेस्टएंडेड के बीच कॉल किया जाएगा।

पैरामीटर
test	TestDescription : परीक्षण की पहचान करता है
trace	String : विफलता का स्टैक ट्रेस

परीक्षणउपेक्षित

public void testIgnored (TestDescription test)

कॉल तब किया जाता है जब कोई परीक्षण नहीं चलाया जाएगा, आम तौर पर क्योंकि एक परीक्षण विधि org.junit.Ignore के साथ एनोटेट की जाती है।

पैरामीटर
test	TestDescription : परीक्षण की पहचान करता है

testLog

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

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

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

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

पैरामीटर
dataName	String : एक ERROR(/String) डेटा का वर्णनात्मक नाम। उदाहरण के लिए "डिवाइस_लॉगकैट"। नोट dataName प्रति मंगलाचरण अद्वितीय नहीं हो सकता है। यानी कार्यान्वयनकर्ताओं को एक ही डेटानाम के साथ कई कॉलों को संभालने में सक्षम होना चाहिए
dataType	LogDataType : डेटा का LogDataType
dataStream	InputStreamSource : डेटा का InputStreamSource । कार्यान्वयनकर्ताओं को डेटा पढ़ना शुरू करने के लिए createInputStream को कॉल करना चाहिए और पूरा होने पर परिणामी InputStream को बंद करना सुनिश्चित करना चाहिए। कॉल करने वालों को यह सुनिश्चित करना चाहिए कि टेस्टलॉग विधि पूरी होने तक डेटा का स्रोत मौजूद और सुलभ रहे।

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

testrunFailed

public void testRunFailed (String errorMessage)

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

पैरामीटर
errorMessage	String : ERROR(/String) रन विफलता के कारण का वर्णन करता है।

testrunStarted

public void testRunStarted (String runName, 
                int testCount)

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

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

testRunStopped

public void testRunStopped (long elapsedTime)

एक उपयोगकर्ता के अनुरोध के कारण रिपोर्ट का परीक्षण पूरा होने से पहले ही रुक गया।

TODO: वर्तमान में अप्रयुक्त, हटाने पर विचार करें

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

परीक्षण शुरू

public void testStarted (TestDescription test)

एक व्यक्तिगत परीक्षण मामले की शुरुआत की रिपोर्ट करता है। पुराना इंटरफ़ेस, जब भी संभव हो testStarted(com.android.tradefed.result.TestDescription) उपयोग करना चाहिए।

पैरामीटर
test	TestDescription : परीक्षण की पहचान करता है