IPostProcessor

public interface IPostProcessor
implements IDisableable, ILogSaverListener, ITestInvocationListener

com.android.tradefed.postprocessor.IPostProcessor

ऐसे सबक्लास जिनके बारे में पहले से पता है AggregatePostProcessor, AveragePostProcessor, BasePostProcessor, BluetoothConnectionSuccessRatePostProcessor, MetricFilePostProcessor, PerfettoGenericPostProcessor, StatsdBeforeAfterGaugeMetricPostProcessor, StatsdEventMetricPostProcessor, StatsdGenericPostProcessor AggregatePostProcessor यह एक मेट्रिक एग्रीगेटर है, जो कई बार किए गए टेस्ट के दौरान इकट्ठा की गई संख्या वाली मेट्रिक के लिए, कम से कम, ज़्यादा से ज़्यादा, औसत, वैरिएंस, स्टैंडर्ड डिविएशन, कुल, गिनती, और वैकल्पिक रूप से प्रतिशत देता है. साथ ही, इन मेट्रिक को डबल के तौर पर इस्तेमाल करता है.  AveragePostProcessor पोस्ट प्रोसेसर लागू करना, जो मेट्रिक की सूची का औसत निकालता है.  BasePostProcessor बुनियादी IPostProcessor, जिसे हर लागू करने की प्रक्रिया में शामिल किया जाना चाहिए.  BluetoothConnectionSuccessRatePostProcessor पोस्टप्रोसेसर लागू करना, जो ब्लूटूथ प्रोफ़ाइल के लिए सफलता दर का हिसाब लगाता है "मेट्रिक-की-मैच" का इस्तेमाल करके, ऐसी मेट्रिक तय करें जिनमें संख्याओं के ऐरे में ब्लूटूथ कनेक्शन की स्थितियां शामिल हों. उदाहरण के लिए, [0, 1, 2, 3, 0, 1, 2, 3].  MetricFilePostProcessor इसका इस्तेमाल, टेस्ट और रन लेवल के दौरान इकट्ठा की गई मेट्रिक लॉग फ़ाइल को अपलोड करने के लिए किया जाता है.  PerfettoGenericPostProcessor एक पोस्ट प्रोसेसर, जो टेक्स्ट/बाइनरी मेट्रिक की परफ़ेक्टो प्रोटो फ़ाइल को की-वैल्यू पेयर में प्रोसेस करता है. इसके लिए, वह स्ट्रिंग वैल्यू वाले प्रोटो मैसेज और फ़ील्ड को बार-बार बड़ा करता है, जब तक कि संख्या वाली वैल्यू वाला फ़ील्ड न मिल जाए.  StatsdBeforeAfterGaugeMetricPostProcessor एक पोस्ट प्रोसेसर, जो "पहले/बाद" वाले तरीके से इकट्ठा की गई मेट्रिक को प्रोसेस करता है. जैसे,  StatsdEventMetricPostProcessor एक पोस्ट प्रोसेसर, जो प्रोसेसर पर बताए गए फ़ॉर्मैटर का इस्तेमाल करके, statsd रिपोर्ट में इवेंट मेट्रिक को की-वैल्यू पेयर में प्रोसेस करता है.  StatsdGenericPostProcessor एक पोस्ट प्रोसेसर, जो रिपोर्ट को ट्री स्ट्रक्चर के तौर पर बड़ा करके, बाइनरी प्रोटो statsd रिपोर्ट को की-वैल्यू पेयर में प्रोसेस करता है.

---

पोस्ट प्रोसेसर, एक ट्रेड फ़ेडरेशन ऑब्जेक्ट है. इसका मकसद, टेस्ट के बाद और नतीजों की रिपोर्टिंग से पहले, मेट्रिक और लॉग को प्रोसेस करने की अनुमति देना है. इससे कुछ डेटा को पोस्ट-प्रोसेस किया जा सकता है और सभी result_reporter ऑब्जेक्ट को यह डेटा मिल सकता है. ऐसा करने के बजाय, सिर्फ़ एक result_reporter में पोस्ट-प्रोसेसिंग करने पर, नया डेटा पास करने में समस्या आ सकती है.

खास जानकारी

सार्वजनिक तरीके
abstract ITestInvocationListener	init(ITestInvocationListener listener) पोस्ट प्रोसेसर को शुरू करने का चरण.
abstract	processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs) सभी टेस्ट में मेट्रिक और लॉग को इकट्ठा करने के लिए, यह तरीका अपनाएं.
abstract	processRunMetricsAndLogs( rawMetrics, runLogs) मौजूदा मेट्रिक और लॉग से नई मेट्रिक का सेट जनरेट करने के लिए, यह तरीका अपनाएं.
abstract	processTestMetricsAndLogs(TestDescription testDescription, testMetrics, testLogs) हर टेस्ट की मेट्रिक और लॉग को पोस्ट प्रोसेस करने के लिए, यह तरीका अपनाएं.

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

init

public abstract ITestInvocationListener init (ITestInvocationListener listener)

पोस्ट प्रोसेसर को शुरू करने का चरण. यह पक्का करें कि इसे किसी भी टेस्ट कॉलबैक से पहले कॉल किया गया हो.

पैरामीटर
listener	ITestInvocationListener

रिटर्न
ITestInvocationListener

processAllTestMetricsAndLogs

public abstract  processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, 
                 allTestLogs)

सभी टेस्ट में मेट्रिक और लॉग को इकट्ठा करने के लिए, यह तरीका अपनाएं. इस तरीके से मिलने वाली मेट्रिक, रन मेट्रिक के तौर पर रिपोर्ट की जाएंगी. सिर्फ़ नई जनरेट की गई मेट्रिक को दिखाया जाना चाहिए. साथ ही, इनका नाम यूनीक होना चाहिए. मौजूदा कुंजियों से मेल खाने वाले नामों की अनुमति नहीं है.

पैरामीटर
allTestMetrics	ListMultimap: मेट्रिक के नाम के हिसाब से ग्रुप किए गए हर टेस्ट की मेट्रिक को सेव करने वाला हैशमल्टीमैप.
allTestLogs	: यह एक ऐसा मैप है जिसमें हर टेस्ट की लॉग फ़ाइलों का मैप सेव होता है. इस मैप में, लॉग फ़ाइलों को उनके डेटा के नाम के हिसाब से व्यवस्थित किया जाता है. साथ ही, हर टेस्ट के TestDescription को कुंजी के तौर पर इस्तेमाल किया जाता है.

रिटर्न
	सभी टेस्ट मेट्रिक से जनरेट की गई नई मेट्रिक का सेट.

processRunMetricsAndLogs

public abstract  processRunMetricsAndLogs ( rawMetrics, 
                 runLogs)

मौजूदा मेट्रिक और लॉग से नई मेट्रिक का सेट जनरेट करने के लिए, यह तरीका अपनाएं. सिर्फ़ नई जनरेट की गई मेट्रिक दिखानी चाहिए. साथ ही, उनका नाम यूनीक होना चाहिए. मौजूदा कुंजियों के नाम से मेल खाने वाली कुंजियों की अनुमति नहीं है.

पैरामीटर
rawMetrics	: रन के लिए उपलब्ध रॉ मेट्रिक का सेट.
runLogs	: टेस्ट रन के लिए लॉग फ़ाइलों का सेट.

रिटर्न
	रन मेट्रिक से जनरेट हुई नई मेट्रिक का सेट.

processTestMetricsAndLogs

public abstract  processTestMetricsAndLogs (TestDescription testDescription, 
                 testMetrics, 
                 testLogs)

हर टेस्ट की मेट्रिक और लॉग को पोस्ट प्रोसेस करने के लिए, यह तरीका अपनाएं. सिर्फ़ नई जनरेट की गई मेट्रिक दिखानी चाहिए. साथ ही, उनका नाम यूनीक होना चाहिए. मौजूदा कुंजियों के नाम से मेल खाने वाली कुंजियों की अनुमति नहीं है.

पैरामीटर
testDescription	TestDescription: टेस्ट की जानकारी देने वाला TestDescription ऑब्जेक्ट.
testMetrics	: टेस्ट की मेट्रिक का सेट.
testLogs	: जांच के दौरान लॉग की गई फ़ाइलों का सेट.

रिटर्न
	टेस्ट मेट्रिक से जनरेट की गई नई मेट्रिक का सेट.