NameMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

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

नतीजों की रिपोर्ट के तौर पर, टेस्ट के तरीके, क्लास, और पैकेज के नामों का अनुवाद करने के लिए प्रॉक्सी लिसनर.

खास जानकारी

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

NameMangleListener(ITestInvocationListener listener)

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

TestSummary getSummary()

इससे InvocationListener को खास जानकारी दिखाने की अनुमति मिलती है.

void invocationEnded(long elapsedTime)

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

void invocationFailed(Throwable cause)

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

void invocationStarted(IInvocationContext context)

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

void testAssumptionFailure(TestDescription test, String trace)

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

void 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)

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

void testRunFailed(String errorMessage)

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

void testRunStarted(String runName, int testCount)

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

void testRunStopped(long elapsedTime)

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

void testStarted(TestDescription test)

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

सुरक्षित तरीके

TestDescription mangleTestId(TestDescription test)

यह तरीका उन सभी TestDescription पर लागू होता है जिन्हें testStarted(com.android.tradefed.result.TestDescription), testFailed(com.android.tradefed.result.TestDescription, String), और ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)) कॉलबैक में पास किया जाता है.

String mangleTestRunName(String name)

यह तरीका, testRunStarted(String, int) कॉलबैक फ़ंक्शन में पास किए गए सभी टेस्ट रन के नामों पर लागू होता है.

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

NameMangleListener

public NameMangleListener (ITestInvocationListener listener)

पैरामीटर
listener ITestInvocationListener

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

सारांश पाएं

public TestSummary getSummary ()

इससे InvocationListener को खास जानकारी दिखाने की अनुमति मिलती है.

रिटर्न
TestSummary दौड़ या शून्य की खास जानकारी वाला TestSummary

invocationEnded

public void invocationEnded (long elapsedTime)

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

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

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

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

public void invocationFailed (Throwable cause)

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

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

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

invocationStarted

public void invocationStarted (IInvocationContext context)

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

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

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

यह रिपोर्ट, टेस्ट केस के लागू होने की प्रोसेस खत्म होने के बारे में बताती है.

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

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

जांच नहीं की जा सकी

public void testFailed (TestDescription test, 
                String trace)

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

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

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

testIgnored

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

testRunFailed

public void testRunFailed (String errorMessage)

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

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

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

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

परीक्षण रन बंद

public void testRunStopped (long elapsedTime)

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

TODO: फ़िलहाल इस्तेमाल नहीं किया जा रहा है, इसे हटाने पर विचार करें

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

परीक्षण प्रारंभ

public void testStarted (TestDescription test)

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

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

सुरक्षित तरीके

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

यह तरीका, testStarted(com.android.tradefed.result.TestDescription), testFailed(com.android.tradefed.result.TestDescription, String), और ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)) कॉलबैक को भेजे गए सभी TestDescription पर चलता है. इस तरीके से, संभावित रूप से अलग TestDescription दिखना चाहिए, जिसे डाउनस्ट्रीम ITestInvocationListener को पास किया जाएगा, जो निर्माण के दौरान तय किया गया था.

लागू करने के दौरान, ध्यान रखें कि ओरिजनल TestDescription में कोई बदलाव न हो.

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

पैरामीटर
test TestDescription

रिटर्न
TestDescription

mangleTestRunName

protected String mangleTestRunName (String name)

यह तरीका, testRunStarted(String, int) कॉलबैक फ़ंक्शन में पास किए गए सभी टेस्ट रन के नामों पर लागू होता है. इस तरीके से, टेस्ट रन का ऐसा नाम दिखना चाहिए जो शायद अलग हो. इसे डाउनस्ट्रीम ITestInvocationListener में पास किया जाएगा, जिसे कॉन्स्ट्रक्शन के दौरान बताया गया था.

लागू करने के दौरान, ओरिजनल रन के नाम में बदलाव न करें.

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

पैरामीटर
name String

रिटर्न
String