ICommandScheduler

public interface ICommandScheduler

com.android.tradefed.command.ICommandScheduler

TradeFederation कमांड चलाने के लिए शेड्यूलर.

खास जानकारी

नेस्ट की गई क्लास

interface ICommandScheduler.IScheduledInvocationListener

इनवोकेशन पूरा होने पर, इनवोकेशन इवेंट के लिए लिसनर. 

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

abstract Pair<Boolean, Integer> addCommand(String[] args)

शेड्यूलर में कोई कमांड जोड़ता है.

abstract void addCommandFile(String cmdFile, extraArgs)

इस विकल्प का इस्तेमाल करके, दी गई फ़ाइल में मौजूद सभी कमांड को शेड्यूलर में जोड़ा जाता है

abstract void await()

शेड्यूलर के शुरू होने का इंतज़ार करता है. इसमें, पुराने TF से हैंडओवर पूरा होने का इंतज़ार करना भी शामिल है. हालांकि, यह सिर्फ़ तब लागू होता है, जब ऐसा करना ज़रूरी हो.

abstract void displayCommandQueue(PrintWriter printWriter)

कमांड को लागू करने की प्रोसेस की स्थिति के बारे में डीबग करने की पूरी जानकारी आउटपुट करता है.

abstract void displayCommandsInfo(PrintWriter printWriter, String regex)

मौजूदा निर्देशों की सूची दिखाओ.

abstract void displayInvocationsInfo(PrintWriter printWriter)

मौजूदा इनवोकेशन की सूची दिखाता है.

abstract void dumpCommandsXml(PrintWriter printWriter, String regex)

सभी मौजूदा कमांड के लिए, Option की सभी वैल्यू के साथ कमांड के लिए, बड़ी की गई एक्सएमएल फ़ाइल डंप करें.

abstract long execCommand(IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args)

यह डिवाइस को सीधे तौर पर असाइन करता है और कमांड को लागू करता है. इसके लिए, डिवाइस को कमांड क्यू में नहीं जोड़ा जाता. इसके लिए, पहले से मौजूद IInvocationContext का इस्तेमाल किया जाता है.

abstract long execCommand(ICommandScheduler.IScheduledInvocationListener listener, String[] args)

यह डिवाइस को सीधे तौर पर असाइन करता है और कमांड को कमांड क्यू में जोड़े बिना ही उसे लागू करता है.

abstract long execCommand(ICommandScheduler.IScheduledInvocationListener listener, ITestDevice device, String[] args)

पहले से असाइन किए गए डिवाइस पर सीधे तौर पर निर्देश लागू करें.

abstract long execCommand(ICommandScheduler.IScheduledInvocationListener listener, devices, String[] args)

पहले से असाइन किए गए डिवाइसों पर सीधे तौर पर निर्देश लागू करें.

abstract CommandFileWatcher getCommandFileWatcher()

इस शेड्यूलर के लिए, सही CommandFileWatcher पाएं

abstract int getExecutingCommandCount()

यह फ़ंक्शन, 'कार्रवाई की जा रही है' स्थिति में मौजूद कमांड की संख्या दिखाता है.

abstract String getInvocationInfo(int invocationId)

इनवोकेशन आईडी तय करके, इनवोकेशन की जानकारी दिखाएं.

abstract CommandRunner.ExitCode getLastInvocationExitCode()

यह फ़ंक्शन, आखिरी बार शुरू किए गए फ़ंक्शन का गड़बड़ी कोड दिखाता है.

abstract Throwable getLastInvocationThrowable()

पिछले इनवोकेशन से मिले Throwable को दिखाता है.

abstract int getReadyCommandCount()

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

abstract boolean isDeviceInInvocationThread(ITestDevice device)

अगर डिवाइस का इस्तेमाल, चालू इनवोकेशन थ्रेड कर रही है, तो यह फ़ंक्शन 'सही' दिखाता है.

abstract void join()

शेड्यूलर के पूरा होने का इंतज़ार करता है.

abstract void join(long millis)

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

abstract void removeAllCommands()

शेड्यूलर से सभी निर्देश हटाना

abstract void setClearcutClient(ClearcutClient client)

हार्नेस डेटा की रिपोर्टिंग के लिए क्लाइंट सेट करना

default void setMaxPollTime(long polling)
default void setPrintSchedulingWarning(boolean print)
abstract boolean shouldShutdownOnCmdfileError()

अगर किसी निर्देश में गड़बड़ियां होने की वजह से हमें शेड्यूलर को बंद करना है, तो यह फ़ंक्शन सही वैल्यू दिखाता है

default void shutdown()

कमांड शेड्यूलर को बंद करने की कोशिश करता है.

abstract void shutdown(boolean notifyStop)

कमांड शेड्यूलर को बंद करने की कोशिश करता है.

abstract void shutdownHard(boolean killAdb)

कमांड शेड्यूलर को बंद करने की कोशिश की जा रही है.

abstract void shutdownHard()

कमांड शेड्यूलर को बंद करने की कोशिश की जा रही है.

abstract void shutdownOnEmpty()

यह shutdown() जैसा ही है, लेकिन यह सभी निर्देशों के पूरा होने का इंतज़ार करेगा. इसके बाद ही, यह बंद होगा.

abstract void start()

ICommandScheduler शुरू करें.

abstract boolean stopInvocation(int invocationId, String cause)

आईडी की जानकारी देकर, चालू इनवोकेशन को बंद करें.

default boolean stopInvocation(int invocationId)

आईडी की जानकारी देकर, चालू इनवोकेशन को बंद करें.

abstract boolean stopInvocation(ITestInvocation invocation)

चल रहे इनवोकेशन को रोकना.

default void stopScheduling()

इससे नई जांचों को शेड्यूल करने और उन्हें स्वीकार करने की प्रोसेस रुक जाती है. हालांकि, Tradefed काम करता रहता है.

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

addCommand

public abstract Pair<Boolean, Integer> addCommand (String[] args)

यह कुकी, शेड्यूलर में कोई कमांड जोड़ती है.

कमांड, चलाने के लिए कॉन्फ़िगरेशन का एक इंस्टेंस होती है. साथ ही, इससे जुड़े आर्ग्युमेंट भी होते हैं.

अगर "--help" आर्ग्युमेंट तय किया गया है, तो कॉन्फ़िगरेशन के लिए सहायता वाला टेक्स्ट stdout पर आउटपुट किया जाएगा. ऐसा न होने पर, कॉन्फ़िगरेशन को चलाने के लिए, उसे कतार में जोड़ दिया जाएगा.

पैरामीटर
args String: कॉन्फ़िगरेशन के तर्क.
रिटर्न
Pair<Boolean, Integer> वैल्यू का एक पेयर. पहली वैल्यू एक बूलियन true होती है. इससे पता चलता है कि कमांड को सफलतापूर्वक जोड़ा गया है या नहीं. अगर कमांड को जोड़ दिया गया है, तो दूसरी वैल्यू, कमांड ट्रैकर आईडी(शून्य से कम नहीं) होती है. अगर कमांड को सभी डिवाइसों के लिए जोड़ा गया है, तो 0 दिखाता है. ऐसा न होने पर, -1 दिखाता है.
थ्रो
ConfigurationException अगर निर्देश को पार्स नहीं किया जा सका

addCommandFile

public abstract void addCommandFile (String cmdFile, 
                 extraArgs)

इस विकल्प का इस्तेमाल करके, दी गई फ़ाइल में मौजूद सभी कमांड को शेड्यूलर में जोड़ा जाता है

पैरामीटर
cmdFile String: कमांड फ़ाइल का फ़ाइल सिस्टम पाथ
extraArgs : फ़ाइल से पार्स किए गए हर निर्देश में जोड़ने के लिए, String तर्कों का ERROR(/List). इसे खाली छोड़ा जा सकता है, लेकिन यह शून्य नहीं होना चाहिए.
थ्रो
ConfigurationException अगर कमांड फ़ाइल को पार्स नहीं किया जा सका

यह भी देखें:

इंतज़ार करें

public abstract void await ()

शेड्यूलर के शुरू होने का इंतज़ार करता है. इसमें, पुराने TF से हैंडओवर पूरा होने का इंतज़ार करना भी शामिल है. हालांकि, यह सिर्फ़ तब लागू होता है, जब ऐसा करना ज़रूरी हो.

displayCommandQueue

public abstract void displayCommandQueue (PrintWriter printWriter)

कमांड को लागू करने की प्रोसेस की स्थिति के बारे में डीबग करने की पूरी जानकारी दिखाता है.

displayCommandsInfo

public abstract void displayCommandsInfo (PrintWriter printWriter, 
                String regex)

मौजूदा निर्देशों की सूची दिखाओ.

पैरामीटर
printWriter PrintWriter: ERROR(/PrintWriter) को आउटपुट करना है.
regex String: यह रेगुलर एक्सप्रेशन है. प्रिंट करने के लिए, कमांड को इससे मैच होना चाहिए. अगर यह वैल्यू शून्य है, तो सभी निर्देश प्रिंट किए जाएंगे.

displayInvocationsInfo

public abstract void displayInvocationsInfo (PrintWriter printWriter)

मौजूदा इनवोकेशन की सूची दिखाता है.

पैरामीटर
printWriter PrintWriter: ERROR(/PrintWriter) को आउटपुट करना है.

dumpCommandsXml

public abstract void dumpCommandsXml (PrintWriter printWriter, 
                String regex)

सभी मौजूदा कमांड के लिए, Option की सभी वैल्यू के साथ कमांड के लिए, बड़ी की गई एक्सएमएल फ़ाइल डंप करें.

पैरामीटर
printWriter PrintWriter: ERROR(/PrintWriter), जिसमें स्टेटस को आउटपुट करना है.
regex String: यह रेगुलर एक्सप्रेशन है. इसके हिसाब से कमांड मैच होने पर ही, एक्सएमएल फ़ाइल को डंप किया जाएगा. अगर यह वैल्यू शून्य है, तो सभी कमांड डंप कर दी जाएंगी.

execCommand

public abstract long execCommand (IInvocationContext context, 
                ICommandScheduler.IScheduledInvocationListener listener, 
                String[] args)

यह डिवाइस को सीधे तौर पर असाइन करता है और कमांड को लागू करता है. इसके लिए, डिवाइस को कमांड क्यू में नहीं जोड़ा जाता. इसके लिए, पहले से मौजूद IInvocationContext का इस्तेमाल किया जाता है.

पैरामीटर
context IInvocationContext: एक मौजूदा IInvocationContext.
listener ICommandScheduler.IScheduledInvocationListener: ICommandScheduler.IScheduledInvocationListener को सूचना दी जाएगी
args String: कमांड के आर्ग्युमेंट
रिटर्न
long

थ्रो
ConfigurationException अगर निर्देश अमान्य था
NoDeviceException अगर इस्तेमाल करने के लिए कोई डिवाइस नहीं है

execCommand

public abstract long execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                String[] args)

यह डिवाइस को सीधे तौर पर असाइन करता है और कमांड को कमांड क्यू में जोड़े बिना ही उसे लागू करता है.

पैरामीटर
listener ICommandScheduler.IScheduledInvocationListener: ICommandScheduler.IScheduledInvocationListener को सूचना दी जाएगी
args String: कमांड के आर्ग्युमेंट
रिटर्न
long शेड्यूल की गई कमांड का इनवोकेशन आईडी.
थ्रो
ConfigurationException अगर निर्देश अमान्य था
NoDeviceException अगर इस्तेमाल करने के लिए कोई डिवाइस नहीं है

execCommand

public abstract long execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                ITestDevice device, 
                String[] args)

पहले से असाइन किए गए डिवाइस पर सीधे तौर पर निर्देश लागू करें.

पैरामीटर
listener ICommandScheduler.IScheduledInvocationListener: ICommandScheduler.IScheduledInvocationListener को सूचना दी जाएगी
device ITestDevice: इस्तेमाल करने के लिए ITestDevice
args String: कमांड के आर्ग्युमेंट
रिटर्न
long शेड्यूल की गई कमांड का इनवोकेशन आईडी.
थ्रो
ConfigurationException अगर निर्देश अमान्य था

execCommand

public abstract long execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                 devices, 
                String[] args)

पहले से असाइन किए गए डिवाइसों पर सीधे तौर पर निर्देश लागू करें.

पैरामीटर
listener ICommandScheduler.IScheduledInvocationListener: ICommandScheduler.IScheduledInvocationListener को सूचना दी जाएगी
devices : इस्तेमाल करने के लिए ERROR(/List)
args String: कमांड के आर्ग्युमेंट
रिटर्न
long शेड्यूल की गई कमांड का इनवोकेशन आईडी.
थ्रो
ConfigurationException अगर निर्देश अमान्य था

getCommandFileWatcher

public abstract CommandFileWatcher getCommandFileWatcher ()

इस शेड्यूलर के लिए, सही CommandFileWatcher पाएं

रिटर्न
CommandFileWatcher

getExecutingCommandCount

public abstract int getExecutingCommandCount ()

यह फ़ंक्शन, 'कार्रवाई की जा रही है' स्थिति में मौजूद कमांड की संख्या दिखाता है.

रिटर्न
int

getInvocationInfo

public abstract String getInvocationInfo (int invocationId)

इनवोकेशन आईडी तय करके, इनवोकेशन की जानकारी दिखाएं.

पैरामीटर
invocationId int: इनवॉकेशन का ट्रैकिंग आईडी.
रिटर्न
String इनवॉकेशन के बारे में जानकारी देने वाला String.

getLastInvocationExitCode

public abstract CommandRunner.ExitCode getLastInvocationExitCode ()

यह फ़ंक्शन, आखिरी बार शुरू किए गए फ़ंक्शन का गड़बड़ी कोड दिखाता है. अगर अब तक कोई इनवोकेशन नहीं हुआ है, तो 0 (कोई गड़बड़ी नहीं) दिखाता है.

रिटर्न
CommandRunner.ExitCode

getLastInvocationThrowable

public abstract Throwable getLastInvocationThrowable ()

पिछले इनवोकेशन से मिले Throwable को वापस भेजता है. अगर कोई थ्रोबल उपलब्ध नहीं है, तो शून्य दिखाता है.

रिटर्न
Throwable

getReadyCommandCount

public abstract int getReadyCommandCount ()

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

रिटर्न
int

isDeviceInInvocationThread

public abstract boolean isDeviceInInvocationThread (ITestDevice device)

अगर डिवाइस का इस्तेमाल, चालू इनवोकेशन थ्रेड कर रही है, तो यह फ़ंक्शन 'सही' दिखाता है.

पैरामीटर
device ITestDevice

रिटर्न
boolean

शामिल हों

public abstract void join ()

शेड्यूलर के पूरा होने का इंतज़ार करता है.

यह भी देखें:

शामिल हों

public abstract void join (long millis)

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

पैरामीटर
millis long

यह भी देखें:

removeAllCommands

public abstract void removeAllCommands ()

शेड्यूलर से सभी निर्देश हटाना

setClearcutClient

public abstract void setClearcutClient (ClearcutClient client)

हार्नेस डेटा की रिपोर्टिंग के लिए क्लाइंट सेट करना

पैरामीटर
client ClearcutClient

setMaxPollTime

public void setMaxPollTime (long polling)

पैरामीटर
polling long

setPrintSchedulingWarning

public void setPrintSchedulingWarning (boolean print)

पैरामीटर
print boolean

shouldShutdownOnCmdfileError

public abstract boolean shouldShutdownOnCmdfileError ()

अगर किसी निर्देश में गड़बड़ियां होने की वजह से हमें शेड्यूलर को बंद करना है, तो यह फ़ंक्शन सही वैल्यू दिखाता है

रिटर्न
boolean

शटडाउन

public void shutdown ()

कमांड शेड्यूलर को बंद करने की कोशिश करता है.

यह उन कमांड को मिटाता है जिनकी जाँच होनी है. साथ ही, यह अनुरोध करता है कि चालू किए गए सभी अनुरोधों को बंद कर दिया जाए.

शटडाउन को कॉल करने के बाद, शेड्यूलर का मुख्य लूप, पूरी तरह से बंद होने से पहले, प्रोसेस में मौजूद सभी इनवोकेशन के पूरा होने का इंतज़ार करेगा.

शटडाउन

public abstract void shutdown (boolean notifyStop)

कमांड शेड्यूलर को बंद करने की कोशिश करता है.

पैरामीटर
notifyStop boolean: अगर सही है, तो TF बंद होने की सूचना देता है.

shutdownHard

public abstract void shutdownHard (boolean killAdb)

कमांड शेड्यूलर को बंद करने की कोशिश की जा रही है.

यह shutdown() जैसा ही है. हालाँकि, यह adb कनेक्शन को भी बंद कर देगा, ताकि 'inspire' इनवोकेशन को तेज़ी से पूरा किया जा सके.

पैरामीटर
killAdb boolean

shutdownHard

public abstract void shutdownHard ()

कमांड शेड्यूलर को बंद करने की कोशिश की जा रही है. shutdownHard(true) की तरह ही काम करता है.

shutdownOnEmpty

public abstract void shutdownOnEmpty ()

यह shutdown() जैसा ही है, लेकिन यह सभी निर्देशों के पूरा होने का इंतज़ार करेगा. इसके बाद ही, यह बंद होगा.

ध्यान दें कि अगर कोई निर्देश लूप मोड में है, तो शेड्यूलर कभी बंद नहीं होगा.

शुरू करें

public abstract void start ()

ICommandScheduler शुरू करें.

इस फ़ंक्शन को अन्य तरीकों को कॉल करने से पहले कॉल किया जाना चाहिए.

shutdown() को कॉल किए जाने तक चलेगा. Thread.start() देखें.

stopInvocation

public abstract boolean stopInvocation (int invocationId, 
                String cause)

आईडी की जानकारी देकर, चालू इनवोकेशन को बंद करें.

पैरामीटर
invocationId int: इनवॉकेशन का ट्रैकिंग आईडी.
cause String: सुविधा को बंद करने की वजह.
रिटर्न
boolean अगर इनवॉकेशन बंद कर दिया गया था, तो वैल्यू true होगी. अगर ऐसा नहीं है, तो वैल्यू false होगी
थ्रो
UnsupportedOperationException अगर लागू करने की प्रोसेस में यह सुविधा काम नहीं करती है

stopInvocation

public boolean stopInvocation (int invocationId)

आईडी की जानकारी देकर, चालू इनवोकेशन को बंद करें.

पैरामीटर
invocationId int

रिटर्न
boolean अगर इनवॉकेशन बंद कर दिया गया था, तो वैल्यू true होगी. अगर ऐसा नहीं है, तो वैल्यू false होगी
थ्रो
UnsupportedOperationException अगर लागू करने की प्रोसेस में यह सुविधा काम नहीं करती है

stopInvocation

public abstract boolean stopInvocation (ITestInvocation invocation)

चल रहे इनवोकेशन को रोकना.

पैरामीटर
invocation ITestInvocation

रिटर्न
boolean अगर इनवॉकेशन बंद कर दिया गया था, तो वैल्यू true होगी. अगर ऐसा नहीं है, तो वैल्यू false होगी
थ्रो
UnsupportedOperationException अगर लागू करने की प्रोसेस में यह सुविधा काम नहीं करती है

stopScheduling

public void stopScheduling ()

इससे नई जांचों को शेड्यूल करने और उन्हें स्वीकार करने की प्रोसेस रुक जाती है. हालांकि, Tradefed काम करता रहता है. इसका मकसद, दो चरणों में बंद करने की सुविधा को चालू करना है. इसमें सबसे पहले, हम सभी चालू टेस्ट को बंद करते हैं. इसके बाद, Tradefed प्रोसेस को बंद करते हैं.