IInvocationContext

public interface IInvocationContext
implements Serializable

com.android.tradefed.invoker.IInvocationContext

यह कुकी, जांच के लिए Invocation के बारे में जानकारी सेव करती है, ताकि ज़रूरत पड़ने पर जांच इसे ऐक्सेस कर सके. टेस्ट में यहां मौजूद कॉन्टेक्स्ट में बदलाव नहीं किया जाना चाहिए. इसलिए, सिर्फ़ गेटर उपलब्ध होंगे. हालांकि, रिपोर्टिंग के मकसद से कॉन्टेक्स्ट एट्रिब्यूट उपलब्ध होंगे.

खास जानकारी

कॉन्स्टेंट

String INVOCATION_ID

इस कुकी का इस्तेमाल, इससे जुड़े इनवॉकेशन आईडी को सेव करने के लिए किया जाता है.

पब्लिक मेथड

abstract void addAllocatedDevice(Map<String, ITestDevice> deviceWithName)

ITestDevice से जुड़े कॉन्फ़िगरेशन डिवाइस के नाम का मैप ट्रैक करता है.

abstract void addAllocatedDevice(String deviceName, ITestDevice testDevice)

डिवाइस के असाइन होने पर, मेटा डेटा से ट्रैक किए जाने वाले ITestDevice को जोड़ता है.

abstract void addDeviceBuildInfo(String deviceName, IBuildInfo buildinfo)

डिवाइस के कॉन्फ़िगरेशन के नाम के साथ ट्रैक करने के लिए, IBuildInfo जोड़ें.

abstract void addInvocationAttribute(String attributeName, String attributeValue)

इनवोकेशन एट्रिब्यूट जोड़ें.

abstract void addInvocationAttributes(MultiMap<String, String> attributesMap)

UniqueMultiMap का इस्तेमाल करके, एक साथ कई इनवोकेशन एट्रिब्यूट जोड़ें.

default void addInvocationTimingMetric(IInvocationContext.TimingEvent timingEvent, Long durationMillis)

फ़ंक्शन शुरू होने के समय की मेट्रिक जोड़ें.

abstract void addSerialsFromShard(Integer index, List<String> serials)

उस सीरियल को जोड़ें जिसे ट्रैक करना है. इसे किसी ऐसे शार्ड को असाइन किया गया है जो कुछ टेस्ट चला रहा है.

default String getAttribute(String key)

यह एक आसान तरीका है, जिससे इनवॉकेशन कॉन्टेक्स्ट एट्रिब्यूट को एक की-वैल्यू पेयर के तौर पर वापस पाया जा सकता है.

abstract MultiMap<String, String> getAttributes()

यह फ़ंक्शन, मैप की एक कॉपी दिखाता है. इसमें इनवॉकेशन के सभी एट्रिब्यूट शामिल होते हैं.

abstract IBuildInfo getBuildInfo(String deviceName)

डिवाइस कॉन्फ़िगरेशन के दिए गए नाम से जुड़ा IBuildInfo दिखाएं.

abstract IBuildInfo getBuildInfo(ITestDevice testDevice)

ITestDevice से जुड़ा IBuildInfo दिखाएं

abstract String getBuildInfoName(IBuildInfo info)

यह फ़ंक्शन, IBuildInfo से xml कॉन्फ़िगरेशन में डिवाइस सेट का नाम दिखाता है.

abstract List<IBuildInfo> getBuildInfos()

इस इनवोकेशन के लिए ट्रैक किए गए सभी IBuildInfo वापस भेजें.

abstract ConfigurationDescriptor getConfigurationDescriptor()

यह फ़ंक्शन, उस टेस्ट कॉन्फ़िगरेशन से जुड़े डिस्क्रिप्टर को दिखाता है जिसने इनवोकेशन लॉन्च किया है

abstract ITestDevice getDevice(String deviceName)

डिवाइस कॉन्फ़िगरेशन के दिए गए नाम से जुड़ा ITestDevice दिखाएं.

abstract Map<ITestDevice, IBuildInfo> getDeviceBuildMap()

डिवाइस/बिल्ड की जानकारी के बीच के संबंध का मैप दिखाता है

abstract ITestDevice getDeviceBySerial(String serial)

यह फ़ंक्शन, दिए गए सीरियल नंबर से जुड़ा ITestDevice दिखाता है.

abstract List<String> getDeviceConfigNames()

इस इनवोकेशन में ट्रैक किए गए डिवाइस के कॉन्फ़िगरेशन के नामों की सूची दिखाता है

abstract String getDeviceName(ITestDevice device)

यह फ़ंक्शन, ITestDevice से एक्सएमएल कॉन्फ़िगरेशन में मौजूद डिवाइस सेट का नाम दिखाता है.

abstract List<ITestDevice> getDevices()

इस इनवोकेशन के लिए ट्रैक किए गए सभी डिवाइसों की जानकारी दिखाता है.

abstract String getInvocationId()
default Map<IInvocationContext.TimingEvent, Long> getInvocationTimingMetrics()

यह मैप, इनवोकेशन के समय की मेट्रिक दिखाता है.

abstract IInvocationContext getModuleInvocationContext()

यह फ़ंक्शन, सुइट के हिस्से के तौर पर मॉड्यूल को एक्ज़ीक्यूट करते समय, मॉड्यूल के इनवोकेशन कॉन्टेक्स्ट को दिखाता है.

abstract int getNumDevicesAllocated()

इनवॉकेशन के लिए असाइन किए गए डिवाइसों की संख्या दिखाता है.

abstract List<String> getSerials()

इस इनवोकेशन में ट्रैक किए गए डिवाइस के सीरियल की सूची दिखाता है

abstract Map<Integer, List<String>> getShardsSerials()

यह फ़ंक्शन, ट्रैक की गई सभी सीरियलों और शार्डिंग में शामिल उनके शार्ड का मैप दिखाता है.

abstract String getTestTag()

यह इनवोकेशन टेस्ट-टैग दिखाता है.

abstract void markReleasedEarly()

डिवाइसों को जल्द ही रिलीज़ किया जा रहा है के तौर पर मार्क करें.

abstract void setConfigurationDescriptor(ConfigurationDescriptor configurationDescriptor)

यह उस टेस्ट कॉन्फ़िगरेशन से जुड़े डिस्क्रिप्टर को सेट करता है जिसने इनवोकेशन लॉन्च किया है

abstract void setModuleInvocationContext(IInvocationContext invocationContext)

यह कुकी, सुइट के हिस्से के तौर पर मॉड्यूल को एक्ज़ीक्यूट करते समय, मॉड्यूल के इनवोकेशन कॉन्टेक्स्ट को सेट करती है.

abstract void setRecoveryModeForAllDevices(ITestDevice.RecoveryMode mode)

यह कॉन्टेक्स्ट में शामिल सभी डिवाइसों का RecoveryMode सेट करता है

abstract void setTestTag(String testTag)

यह विकल्प, इनवोकेशन टेस्ट-टैग सेट करता है.

abstract InvocationContext.Context toProto()

कॉन्टेक्स्ट इंस्टेंस को protobuf में सीरियल करें.

abstract boolean wasReleasedEarly()

इससे यह पता चलता है कि डिवाइसों को समय से पहले रिलीज़ किया गया था या नहीं. साथ ही, यह भी पता चलता है कि अब उनका इस्तेमाल नहीं किया जाएगा.

कॉन्स्टेंट

INVOCATION_ID

public static final String INVOCATION_ID

इस कुकी का इस्तेमाल, इससे जुड़े इनवॉकेशन आईडी को सेव करने के लिए किया जाता है.

कॉन्स्टेंट वैल्यू: "invocation-id"

पब्लिक मेथड

addAllocatedDevice

public abstract void addAllocatedDevice (Map<String, ITestDevice> deviceWithName)

ITestDevice से जुड़े कॉन्फ़िगरेशन डिवाइस के नाम का मैप ट्रैक करता है. यह ट्रैकिंग को जोड़ने से पहले, पिछली ट्रैकिंग को नहीं हटाता.

पैरामीटर
deviceWithName Map: ट्रैक किए जाने वाले अतिरिक्त डिवाइस का Map

addAllocatedDevice

public abstract void addAllocatedDevice (String deviceName, 
                ITestDevice testDevice)

डिवाइस के असाइन होने पर, मेटा डेटा से ट्रैक किए जाने वाले ITestDevice को जोड़ता है. मैप में, बिल्ड की जानकारी को शून्य पर सेट कर देगा.

पैरामीटर
deviceName String: ITestDevice से जोड़ने के लिए डिवाइस कॉन्फ़िगरेशन का नाम
testDevice ITestDevice: इसे उन डिवाइसों में जोड़ा जाएगा जिन्हें ऐक्सेस करने की अनुमति दी गई है.

addDeviceBuildInfo

public abstract void addDeviceBuildInfo (String deviceName, 
                IBuildInfo buildinfo)

डिवाइस के कॉन्फ़िगरेशन के नाम के साथ ट्रैक करने के लिए, IBuildInfo जोड़ें.

पैरामीटर
deviceName String: डिवाइस के कॉन्फ़िगरेशन का नाम
buildinfo IBuildInfo: डिवाइस के कॉन्फ़िगरेशन के नाम से जुड़ा IBuildInfo.

addInvocationAttribute

public abstract void addInvocationAttribute (String attributeName, 
                String attributeValue)

इनवोकेशन एट्रिब्यूट जोड़ें.

पैरामीटर
attributeName String

attributeValue String

addInvocationAttributes

public abstract void addInvocationAttributes (MultiMap<String, String> attributesMap)

UniqueMultiMap का इस्तेमाल करके, एक साथ कई इनवोकेशन एट्रिब्यूट जोड़ें.

पैरामीटर
attributesMap MultiMap

addInvocationTimingMetric

public void addInvocationTimingMetric (IInvocationContext.TimingEvent timingEvent, 
                Long durationMillis)

फ़ंक्शन शुरू होने के समय की मेट्रिक जोड़ें.

पैरामीटर
timingEvent IInvocationContext.TimingEvent

durationMillis Long

addSerialsFromShard

public abstract void addSerialsFromShard (Integer index, 
                List<String> serials)

उस सीरियल को जोड़ें जिसे ट्रैक करना है. इसे किसी ऐसे शार्ड को असाइन किया गया है जो कुछ टेस्ट चला रहा है.

पैरामीटर
index Integer: सीरियल का इस्तेमाल करने वाले शार्ड का इंडेक्स
serials List: ट्रैक किए जाने वाले सीरियल की सूची.

getAttribute

public String getAttribute (String key)

यह एक आसान तरीका है, जिससे इनवॉकेशन कॉन्टेक्स्ट एट्रिब्यूट को एक की-वैल्यू पेयर के तौर पर वापस पाया जा सकता है. यह कभी भी शून्य वैल्यू नहीं दिखाता.

पैरामीटर
key String

रिटर्न
String अगर कुंजी मौजूद नहीं है, तो खाली स्ट्रिंग. अगर कुंजी मौजूद है, तो वैल्यू.

getAttributes

public abstract MultiMap<String, String> getAttributes ()

यह फ़ंक्शन, मैप की एक कॉपी दिखाता है. इसमें इनवॉकेशन के सभी एट्रिब्यूट शामिल होते हैं.

रिटर्न
MultiMap<String, String>

getBuildInfo

public abstract IBuildInfo getBuildInfo (String deviceName)

डिवाइस कॉन्फ़िगरेशन के दिए गए नाम से जुड़ा IBuildInfo दिखाएं. अगर डिवाइस का नाम मैच नहीं होता है, तो यह फ़ंक्शन null दिखाता है.

पैरामीटर
deviceName String

रिटर्न
IBuildInfo

getBuildInfo

public abstract IBuildInfo getBuildInfo (ITestDevice testDevice)

ITestDevice से जुड़ा IBuildInfo दिखाएं

पैरामीटर
testDevice ITestDevice

रिटर्न
IBuildInfo

getBuildInfoName

public abstract String getBuildInfoName (IBuildInfo info)

यह फ़ंक्शन, IBuildInfo से xml कॉन्फ़िगरेशन में डिवाइस सेट का नाम दिखाता है. अगर IBuildInfo मैच नहीं हो पाता है, तो शून्य दिखाता है

पैरामीटर
info IBuildInfo

रिटर्न
String

getBuildInfos

public abstract List<IBuildInfo> getBuildInfos ()

इस इनवोकेशन के लिए ट्रैक किए गए सभी IBuildInfo वापस भेजें.

रिटर्न
List<IBuildInfo>

getConfigurationDescriptor

public abstract ConfigurationDescriptor getConfigurationDescriptor ()

यह फ़ंक्शन, उस टेस्ट कॉन्फ़िगरेशन से जुड़े डिस्क्रिप्टर को दिखाता है जिसने इनवोकेशन लॉन्च किया है

रिटर्न
ConfigurationDescriptor

getDevice

public abstract ITestDevice getDevice (String deviceName)

डिवाइस कॉन्फ़िगरेशन के दिए गए नाम से जुड़ा ITestDevice दिखाएं.

पैरामीटर
deviceName String

रिटर्न
ITestDevice

getDeviceBuildMap

public abstract Map<ITestDevice, IBuildInfo> getDeviceBuildMap ()

डिवाइस/बिल्ड की जानकारी के बीच के संबंध का मैप दिखाता है

रिटर्न
Map<ITestDevice, IBuildInfo>

getDeviceBySerial

public abstract ITestDevice getDeviceBySerial (String serial)

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

पैरामीटर
serial String

रिटर्न
ITestDevice

getDeviceConfigNames

public abstract List<String> getDeviceConfigNames ()

इस इनवोकेशन में ट्रैक किए गए डिवाइस के कॉन्फ़िगरेशन के नामों की सूची दिखाता है

रिटर्न
List<String>

getDeviceName

public abstract String getDeviceName (ITestDevice device)

यह फ़ंक्शन, ITestDevice से एक्सएमएल कॉन्फ़िगरेशन में मौजूद डिवाइस सेट का नाम दिखाता है. अगर ITestDevice को मैच नहीं किया जा सकता, तो शून्य दिखाता है.

पैरामीटर
device ITestDevice

रिटर्न
String

getDevices

public abstract List<ITestDevice> getDevices ()

इस इनवोकेशन के लिए ट्रैक किए गए सभी डिवाइसों की जानकारी दिखाता है.

रिटर्न
List<ITestDevice>

getInvocationId

public abstract String getInvocationId ()

रिटर्न
String अगर इनवॉकेशन से लिंक नहीं है, तो उससे जुड़ा इनवॉकेशन आईडी या null

getInvocationTimingMetrics

public Map<IInvocationContext.TimingEvent, Long> getInvocationTimingMetrics ()

यह मैप, इनवोकेशन के समय की मेट्रिक दिखाता है.

रिटर्न
Map<IInvocationContext.TimingEvent, Long>

getModuleInvocationContext

public abstract IInvocationContext getModuleInvocationContext ()

यह फ़ंक्शन, सुइट के हिस्से के तौर पर मॉड्यूल को एक्ज़ीक्यूट करते समय, मॉड्यूल के इनवोकेशन कॉन्टेक्स्ट को दिखाता है.

रिटर्न
IInvocationContext

getNumDevicesAllocated

public abstract int getNumDevicesAllocated ()

इनवॉकेशन के लिए असाइन किए गए डिवाइसों की संख्या दिखाता है.

रिटर्न
int

getSerials

public abstract List<String> getSerials ()

इस इनवोकेशन में ट्रैक किए गए डिवाइस के सीरियल की सूची दिखाता है

रिटर्न
List<String>

getShardsSerials

public abstract Map<Integer, List<String>> getShardsSerials ()

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

रिटर्न
Map<Integer, List<String>>

getTestTag

public abstract String getTestTag ()

यह इनवोकेशन टेस्ट-टैग दिखाता है.

रिटर्न
String

markReleasedEarly

public abstract void markReleasedEarly ()

डिवाइसों को जल्द ही रिलीज़ किया जा रहा है के तौर पर मार्क करें.

setConfigurationDescriptor

public abstract void setConfigurationDescriptor (ConfigurationDescriptor configurationDescriptor)

यह उस टेस्ट कॉन्फ़िगरेशन से जुड़े डिस्क्रिप्टर को सेट करता है जिसने इनवोकेशन लॉन्च किया है

पैरामीटर
configurationDescriptor ConfigurationDescriptor

setModuleInvocationContext

public abstract void setModuleInvocationContext (IInvocationContext invocationContext)

यह कुकी, सुइट के हिस्से के तौर पर मॉड्यूल को एक्ज़ीक्यूट करते समय, मॉड्यूल के इनवोकेशन कॉन्टेक्स्ट को सेट करती है.

पैरामीटर
invocationContext IInvocationContext

setRecoveryModeForAllDevices

public abstract void setRecoveryModeForAllDevices (ITestDevice.RecoveryMode mode)

यह कॉन्टेक्स्ट में शामिल सभी डिवाइसों का RecoveryMode सेट करता है

पैरामीटर
mode ITestDevice.RecoveryMode

setTestTag

public abstract void setTestTag (String testTag)

यह विकल्प, इनवोकेशन टेस्ट-टैग सेट करता है.

पैरामीटर
testTag String

toProto

public abstract InvocationContext.Context toProto ()

कॉन्टेक्स्ट इंस्टेंस को protobuf में सीरियल करें.

रिटर्न
InvocationContext.Context

wasReleasedEarly

public abstract boolean wasReleasedEarly ()

इससे यह पता चलता है कि डिवाइसों को समय से पहले रिलीज़ किया गया था या नहीं. साथ ही, यह भी पता चलता है कि अब उनका इस्तेमाल नहीं किया जाएगा.

रिटर्न
boolean