IShellOutputReceiver

public interface IShellOutputReceiver

com.android.ddmlib.IShellOutputReceiver

अप्रत्यक्ष तौर पर जुड़ी जानी-पहचानी सबक्लास CollectingByteOutputReceiver, CollectingOutputReceiver, GTestListTestParser, GTestResultParser, IInstrumentationResultParser, InstallCreateReceiver, InstallReceiver, InstrumentationProtoResultParser, InstrumentationResultParser, LargeOutputReceiver, ListInstrumentationParser, MultiLineReceiver, MultiReceiver, NativeBenchmarkTestParser, NativeStressTestParser, NullOutputReceiver, PythonUnitTestResultParser, RustBenchmarkResultParser, RustTestResultParser CollectingByteOutputReceiver एक IShellOutputReceiver, जो पूरे शेल आउटपुट को byte[] में इकट्ठा करता है.  CollectingOutputReceiver एक IShellOutputReceiver, जो पूरे शेल आउटपुट को एक String में इकट्ठा करता है.  GTestListTestParser यह "--gtest_list_tests" पैरामीटर के साथ, gtest ड्राई रन मोड के लिए नतीजे का पार्सर है.  GTestResultParser यह शेल से चलने वाले GTest का इस्तेमाल करके, नेटिव टेस्ट के 'रॉ आउटपुट मोड' के नतीजों को पार्स करता है. साथ ही, ITestInvocationListener को नतीजों के बारे में सूचना देता है.  IInstrumentationResultParser यह शेल से चलाए गए इंस्ट्रुमेंटेशन टेस्ट के नतीजों को पार्स करने के लिए इंटरफ़ेस है.  InstallCreateReceiver "pm install-create" कमांड लाइन के लिए आउटपुट रिसीवर.  InstallReceiver "pm install package.apk" कमांड लाइन के लिए आउटपुट रिसीवर.  InstrumentationProtoResultParser यह शेल से इंस्ट्रुमेंटेशन टेस्ट रन के 'protoStd output mode' के नतीजों को पार्स करता है. साथ ही, ITestRunListener को नतीजों के बारे में सूचना देता है.  InstrumentationResultParser यह शेल से इंस्ट्रुमेंटेशन टेस्ट रन के 'रॉ आउटपुट मोड' के नतीजों को पार्स करता है और ITestRunListener को नतीजों के बारे में सूचना देता है.  LargeOutputReceiver यह क्लास, लंबे समय तक चलने वाली कमांड को चलाने और आउटपुट इकट्ठा करने के लिए डिज़ाइन की गई है.  ListInstrumentationParser एक IShellOutputReceiver, जो 'pm list instrumentation' क्वेरी के आउटपुट को पार्स करता है  MultiLineReceiver IShellOutputReceiver का बुनियादी तौर पर लागू किया गया वर्शन. यह सॉकेट से मिले रॉ डेटा को लेता है और उसे String ऑब्जेक्ट में बदलता है.  MultiReceiver IShellOutputReceiver का बुनियादी तौर पर लागू किया गया वर्शन. यह IShellOutputReceiver के कई इंस्टेंस लेता है और मिले हुए डेटा को उन सभी पर ब्रॉडकास्ट करता है.IShellOutputReceiver  NativeBenchmarkTestParser एक IShellOutputReceiver जो बेंचमार्क टेस्ट के डेटा आउटपुट को पार्स करता है. साथ ही, हर ऑपरेशन में लगने वाले औसत समय की मेट्रिक इकट्ठा करता है.  NativeStressTestParser एक IShellOutputReceiver जो स्ट्रेस टेस्ट के डेटा आउटपुट को पार्स करता है. साथ ही, पूरी हुई इटरेशन की संख्या और हर इटरेशन में लगने वाले औसत समय के बारे में मेट्रिक इकट्ठा करता है.  NullOutputReceiver IShellOutputReceiver को लागू करने का तरीका, जिसमें कुछ भी नहीं किया जाता.  PythonUnitTestResultParser यह Python के unittest फ़्रेमवर्क के साथ चलाए गए टेस्ट के आउटपुट को समझता है और इसे ITestInvocationListener की सीरीज़ पर कॉल में बदलता है.  RustBenchmarkResultParser यह, मानदंड बेंचमार्किंग फ़्रेमवर्क के साथ चलाए गए टेस्ट के आउटपुट की व्याख्या करता है और इसे ITestInvocationListener की सीरीज़ पर कॉल में बदलता है.  RustTestResultParser यह Rust के unittest फ़्रेमवर्क के साथ चलाए गए टेस्ट के आउटपुट की व्याख्या करता है और इसे ITestInvocationListener की सीरीज़ पर कॉल में बदलता है.

---

इस इंटरफ़ेस को लागू करने वाली क्लास, ऐसे तरीके उपलब्ध कराती हैं जो किसी डिवाइस/इम्यूलेटर पर रिमोट शेल कमांड से डील करते हैं.

खास जानकारी

सार्वजनिक तरीके
abstract void	addOutput(byte[] data, int offset, int length) जब भी कोई नया डेटा उपलब्ध होता है, तब इस फ़ंक्शन को कॉल किया जाता है.
abstract void	flush() इस फ़ंक्शन को प्रोसेस के खत्म होने पर कॉल किया जाता है. हालांकि, अगर प्रोसेस रद्द कर दी गई है, तो इसे कॉल नहीं किया जाता.
abstract boolean	isCancelled() रिमोट शेल कमांड को बंद करने के लिए, cancel तरीके का इस्तेमाल करें.

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

addOutput

public abstract void addOutput (byte[] data, 
                int offset, 
                int length)

जब भी कोई नया डेटा उपलब्ध होता है, तब इस फ़ंक्शन को कॉल किया जाता है.

पैरामीटर
data	byte: नया डेटा.
offset	int: वह ऑफ़सेट जहां से नया डेटा शुरू होता है.
length	int: नए डेटा की लंबाई.

फ़्लश

public abstract void flush ()

इस फ़ंक्शन को प्रोसेस के खत्म होने पर कॉल किया जाता है. हालांकि, अगर प्रोसेस रद्द कर दी गई है, तो इसे कॉल नहीं किया जाता. इससे, डेटा पाने वाले व्यक्ति को उस डेटा को बंद करने और हटाने की अनुमति मिलती है जिसे अब तक प्रोसेस नहीं किया गया है.

isCancelled

public abstract boolean isCancelled ()

रिमोट शेल कमांड को बंद करने के लिए, cancel तरीके का इस्तेमाल करें.

रिटर्न
boolean	कमांड को रद्द करने के लिए, इस वैल्यू को true पर सेट करें.