אירוטיל

public interface IRunUtil

com.android.tradefed.util.IRunUtil


ממשק להרצת פעולות מתוזמנות ופקודות מערכת.

סיכום

מחלקות מקוננות

interface IRunUtil.IRunnableResult

ממשק לביצוע פעולה אסינכרונית שמחזירה סטטוס בוליאני. 

שיטות ציבוריות

abstract void allowInterrupt(boolean allow)

מאפשר או לא מאפשר להריץ הפרעות בשרשור הנוכחי.

abstract void interrupt(Thread thread, String message, ErrorIdentifier errorId)

הפרעה לפעולות ההפעלה המתמשכות או הבאות בשרשור הנתון.

abstract void interrupt(Thread thread, String message)

הפרעה לפעולות ההפעלה המתמשכות או הבאות בשרשור הנתון.

abstract boolean isInterruptAllowed()

מציינים את סטטוס ההתערבות של RunUtil.

abstract Process runCmdInBackground(Redirect redirect, command)

רכיב runCmdInBackground(String) חלופי שמקבל את הארגומנטים של הפקודה בפורמט ERROR(/List).

abstract Process runCmdInBackground( command)

רכיב runCmdInBackground(String) חלופי שמקבל את הארגומנטים של הפקודה בפורמט ERROR(/List).

abstract Process runCmdInBackground( command, OutputStream output)

הרצת הפקודה עם ERROR(/OutputStream) תציג את הפלט של הפקודה ביומן.

abstract Process runCmdInBackground(String... command)

שיטה של עוזר לבצע פקודת מערכת באופן אסינכרוני.

abstract Process runCmdInBackground(Redirect redirect, String... command)

שיטה של עוזר לבצע פקודת מערכת באופן אסינכרוני.

abstract boolean runEscalatingTimedRetry(long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)

חסימה והפעלה של פעולה מספר פעמים, עד שהיא מצליחה.

abstract boolean runFixedTimedRetry(long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)

חסימה והפעלה של פעולה מספר פעמים, עד שהיא מצליחה.

abstract boolean runFixedTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)

חסימה והפעלה של פעולה מספר פעמים, עד שהיא מצליחה.

abstract CommandStatus runTimed(long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)

חסימה וביצוע של פעולה, ביטול אם הפעולה נמשכת יותר מפרק זמן מוגדר.

abstract CommandResult runTimedCmd(long timeout, OutputStream stdout, OutputStream stderr, String... command)

שיטה מסייעת לבצע פקודת מערכת, לבטל אם הפעולה נמשכת יותר מזמן מוגדר, ולהפנות את הפלט לקבצים, אם יש כאלה.

abstract CommandResult runTimedCmd(long timeout, String... command)

שיטה לעזרה בהרצת פקודת מערכת, וביטול אם התהליך נמשך יותר זמן מההגדרה בזמן האימון.

abstract CommandResult runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command)

שיטה לעזרה בהרצת פקודת מערכת, וביטול אם התהליך נמשך יותר זמן מההגדרה בזמן האימון.

abstract CommandResult runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)

שיטה לעזרה בהרצת פקודת מערכת, וביטול אם התהליך נמשך יותר זמן מההגדרה בזמן האימון.

abstract CommandResult runTimedCmdSilently(long timeout, String... command)

שיטה לעזרה בהרצת פקודת מערכת, וביטול אם התהליך נמשך יותר זמן מההגדרה בזמן האימון.

abstract CommandResult runTimedCmdSilentlyRetry(long timeout, long retryInterval, int attempts, String... command)

שיטה לעזרה בהרצת פקודת מערכת, וביטול אם התהליך נמשך יותר זמן מההגדרה בזמן האימון.

abstract CommandResult runTimedCmdWithInput(long timeout, String input, File stdoutFile, File stderrFile, String... command)

שיטה מסייעת לבצע פקודת מערכת, לבטל אם הפעולה נמשכת יותר מזמן מוגדר, ולהפנות את הפלט לקבצים, אם יש כאלה.

abstract CommandResult runTimedCmdWithInput(long timeout, String input, String... command)

שיטת עוזר לבצע פקודת מערכת שמחייבת קלט stdin ולבטל אם נמשכת יותר מפרק זמן מסוים.

abstract CommandResult runTimedCmdWithInput(long timeout, String input, command)

שיטת עוזר לבצע פקודת מערכת שמחייבת קלט stdin ולבטל אם נמשכת יותר מפרק זמן מסוים.

abstract CommandResult runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command)

שיטת עוזר להריץ פקודת מערכת שמחייבת הפניה אוטומטית של Stdin מקובץ, וגם לבטל אם התהליך נמשך זמן רב יותר מהזמן שצוין.

abstract CommandResult runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)

שיטה מסייעת לבצע פקודת מערכת, לבטל אם הפעולה נמשכת יותר מזמן מוגדר, ולהפנות את הפלט לקבצים, אם יש כאלה.

abstract CommandResult runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)

שיטה לעזרה בהרצת פקודת מערכת, וביטול אם התהליך נמשך יותר זמן מההגדרה בזמן האימון.

abstract CommandResult runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, String... command)

שיטה לעזרה בביצוע פקודת מערכת באמצעות שמירה במטמון.

abstract boolean runTimedRetry(long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)

חסימה והפעלה של פעולה מספר פעמים, עד שהיא מצליחה.

abstract boolean runTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)

חסימה והפעלה של פעולה מספר פעמים, עד שהיא מצליחה.

abstract CommandStatus runTimedWithOutputMonitor(long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)

חסימה וביצוע של פעולה, ביטול אם הפעולה נמשכת יותר מפרק זמן מוגדר.

abstract void setEnvVariable(String key, String value)

מגדירה משתנה סביבה שישמש כשמריצים פקודות מערכת.

abstract void setEnvVariablePriority(IRunUtil.EnvPriority priority)

צריך להחליט אם כשיוצרים תהליך, ביטול ההגדרה של משתנה הסביבה גבוה יותר חשוב יותר מאשר להגדיר אותם.

abstract void setInterruptibleInFuture(Thread thread, long timeMs)

הגדרה כ'ניתן להפסקה' לאחר זמן המתנה.

abstract void setLinuxInterruptProcess(boolean interrupt)

אפשר להשתמש ב-linux 'kill' הפרעה בתהליך הריצה באמצעות שיטות #runTimed כאשר מגיע לזמן קצוב לתפוגה.

abstract void setRedirectStderrToStdout(boolean redirect)

הגדרת זרם שגיאה רגיל שיפנה לזרם הפלט הסטנדרטי בזמן הפעלת המערכת פקודות.

abstract void setWorkingDir(File dir)

מגדירה את ספריית העבודה לפקודות מערכת.

abstract void sleep(long time)

שיטה שעוזרת לישון במשך זמן נתון, תוך התעלמות מכל החריגים.

abstract void unsetEnvVariable(String key)

מבטל את ההגדרה של משתנה סביבה, כך שפקודות המערכת פועלות בלי משתנה הסביבה.

שיטות ציבוריות

AllowInterrupt

public abstract void allowInterrupt (boolean allow)

מאפשר או לא מאפשר להריץ הפרעות בשרשור הנוכחי. אם הוא מותר, מריצים פעולות של אפשר להפסיק את השרשור הנוכחי משרשורים אחרים באמצעות method interrupt(Thread, String).

פרמטרים
allow boolean: האם לאפשר הרצת הפרעות בשרשור הנוכחי.

להפריע

public abstract void interrupt (Thread thread, 
                String message, 
                ErrorIdentifier errorId)

הפרעה לפעולות ההפעלה המתמשכות או הבאות בשרשור הנתון. פעולות הריצה ב השרשור הנתון יקפיץ RunInterruptedException.

פרמטרים
message String: ההודעה של RunInterruptedException.

errorId ErrorIdentifier: ייצוג הגורם להפרעה, כפי שהוא ידוע.

להפריע

public abstract void interrupt (Thread thread, 
                String message)

הפרעה לפעולות ההפעלה המתמשכות או הבאות בשרשור הנתון. פעולות הריצה ב השרשור הנתון יקפיץ RunInterruptedException.

פרמטרים
message String: ההודעה של RunInterruptedException.

isInterruptAllowed

public abstract boolean isInterruptAllowed ()

מציינים את סטטוס ההתערבות של RunUtil.

החזרות
boolean true אם ניתן להפסיק את ההפעלה, אחרת false.

runCmdInBackground

public abstract Process runCmdInBackground (Redirect redirect, 
                 command)

רכיב runCmdInBackground(String) חלופי שמקבל את הארגומנטים של הפקודה בפורמט ERROR(/List).

פרמטרים
redirect Redirect: ה-ERROR(/Redirect) שצריך להחיל על ProcessBuilder.

command : השדה ERROR(/List) שמכיל את פקודת המערכת שצוינה וגם ארגומנטים (אופציונלי) עד לביצוע

החזרות
Process Process של פקודת ההרצה

קליעות
אם הרצת הפקודה נכשלה

runCmdInBackground

public abstract Process runCmdInBackground ( command)

רכיב runCmdInBackground(String) חלופי שמקבל את הארגומנטים של הפקודה בפורמט ERROR(/List).

פרמטרים
command : השדה ERROR(/List) שמכיל את פקודת המערכת שצוינה וגם ארגומנטים (אופציונלי) עד לביצוע

החזרות
Process Process של פקודת ההרצה

קליעות
אם הרצת הפקודה נכשלה

runCmdInBackground

public abstract Process runCmdInBackground ( command, 
                OutputStream output)

הרצת הפקודה עם ERROR(/OutputStream) תציג את הפלט של הפקודה ביומן. Stdout ו-stderr ממוזגים יחד.

פרמטרים
command : הפקודה להרצה

output OutputStream: ה-OutputStream כדי לשמור את הפלט

החזרות
Process הפקודה Process מריצים את הפקודה

קליעות
חריגת IO

runCmdInBackground

public abstract Process runCmdInBackground (String... command)

שיטה של עוזר לבצע פקודת מערכת באופן אסינכרוני.

ההודעה תוחזר מיד לאחר הפעלת הפקודה.

פרמטרים
command String: פקודת המערכת שצוינה, וארגומנטים שרוצים להפעיל

החזרות
Process Process של פקודת ההרצה

קליעות
אם הרצת הפקודה נכשלה

runCmdInBackground

public abstract Process runCmdInBackground (Redirect redirect, 
                String... command)

שיטה של עוזר לבצע פקודת מערכת באופן אסינכרוני.

ההודעה תוחזר מיד לאחר הפעלת הפקודה.

פרמטרים
redirect Redirect: ה-ERROR(/Redirect) שצריך להחיל על ProcessBuilder.

command String: פקודת המערכת שצוינה, וארגומנטים שרוצים להפעיל

החזרות
Process Process של פקודת ההרצה

קליעות
אם הרצת הפקודה נכשלה

runEscalatingTimedRetry

public abstract boolean runEscalatingTimedRetry (long opTimeout, 
                long initialPollInterval, 
                long maxPollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

חסימה והפעלה של פעולה מספר פעמים, עד שהיא מצליחה.

הגדלה אקספוננציאלית של זמן ההמתנה בין ניסיונות הפעולה. זה מיועד לשימוש בעת ביצוע פעולה כגון דגימה של שרת, כדי לתת לו זמן להתאושש במקרה שהוא מושבתת זמנית.

פרמטרים
opTimeout long: זמן המתנה מקסימלי באלפיות השנייה עבור ניסיון פעולה אחד

initialPollInterval long: הזמן הראשוני להמתנה בין ניסיונות הפעולה

maxPollInterval long: משך הזמן המקסימלי להמתנה בין ניסיונות פעולה

maxTime long: הזמן המקסימלי המשוער הכולל כדי להמשיך לנסות את הפעולה

runnable IRunUtil.IRunnableResult: IRunUtil.IRunnableResult להפעלה

החזרות
boolean true אם הפעולה הושלמה לפני שהתוקף של maxTime פג

runFixedTimedRetry

public abstract boolean runFixedTimedRetry (long opTimeout, 
                long pollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

חסימה והפעלה של פעולה מספר פעמים, עד שהיא מצליחה.

פרמטרים
opTimeout long: זמן המתנה מקסימלי באלפיות השנייה עבור ניסיון פעולה אחד

pollInterval long: הזמן הראשוני להמתנה בין ניסיונות הפעולה

maxTime long: הזמן המקסימלי המשוער הכולל כדי להמשיך לנסות את הפעולה

runnable IRunUtil.IRunnableResult: IRunUtil.IRunnableResult להפעלה

החזרות
boolean true אם הפעולה הושלמה לפני שהתוקף של maxTime פג

runFixedTimedRetryWithOutputMonitor

public abstract boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, 
                long idleOutputTimeout, 
                long pollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

חסימה והפעלה של פעולה מספר פעמים, עד שהיא מצליחה. עוקב גם אחר שידורי פלט של פעילות, לביטול אם לא נצפתה פעילות זרם במשך פרק זמן מסוים. אם ערך הזמן הקצוב לתפוגה של פלט פעיל (boutout) מוגדר לאפס, לא יתבצע מעקב אחר השידור.

פרמטרים
opTimeout long: זמן המתנה מקסימלי באלפיות השנייה עבור ניסיון פעולה אחד

idleOutputTimeout long: זמן מקסימלי להמתנה באלפיות השנייה לפלט של שידורי הפלט

pollInterval long: הזמן הראשוני להמתנה בין ניסיונות הפעולה

maxTime long: הזמן המקסימלי המשוער הכולל כדי להמשיך לנסות את הפעולה

runnable IRunUtil.IRunnableResult: IRunUtil.IRunnableResult להפעלה

החזרות
boolean true אם הפעולה הושלמה לפני שהתוקף של maxTime פג

זמן ריצה

public abstract CommandStatus runTimed (long timeout, 
                IRunUtil.IRunnableResult runnable, 
                boolean logErrors)

חסימה וביצוע של פעולה, ביטול אם הפעולה נמשכת יותר מפרק זמן מוגדר.

פרמטרים
timeout long: זמן המתנה מקסימלי באלפיות שנייה

runnable IRunUtil.IRunnableResult: IRunUtil.IRunnableResult להפעלה

logErrors boolean: יש שגיאות ביומן של חריגות או שאינן חריגות.

החזרות
CommandStatus תוצאת הפעולה CommandStatus.

runTimedCmd

public abstract CommandResult runTimedCmd (long timeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                String... command)

שיטה מסייעת לבצע פקודת מערכת, לבטל אם הפעולה נמשכת יותר מזמן מוגדר, ולהפנות את הפלט לקבצים, אם יש כאלה. אם ERROR(/OutputStream) מסופקים בצורה הזו, הן יישארו פתוחות בסוף הפונקציה.

פרמטרים
timeout long: משך הזמן המקסימלי להמתנה באלפיות השנייה 0 פירושו שאין זמן קצוב לתפוגה.

stdout OutputStream: ERROR(/OutputStream) שאליו יופנה פלט ה-std. הערך יכול להיות null.

stderr OutputStream: ERROR(/OutputStream) שאליו יופנה פלט השגיאה. הערך יכול להיות null.

command String: פקודת המערכת שצוינה, וארגומנטים שרוצים להפעיל

החזרות
CommandResult תוצאה מסוג CommandResult שמכילה תוצאה מהרצת פקודות

runTimedCmd

public abstract CommandResult runTimedCmd (long timeout, 
                String... command)

שיטה לעזרה בהרצת פקודת מערכת, וביטול אם התהליך נמשך יותר זמן מההגדרה בזמן האימון.

פרמטרים
timeout long: זמן המתנה מקסימלי באלפיות השנייה. 0 פירושו שאין זמן קצוב לתפוגה.

command String: פקודת המערכת שצוינה, וארגומנטים שרוצים להפעיל

החזרות
CommandResult תוצאה מסוג CommandResult שמכילה תוצאה מהרצת פקודות

runTimedCmdRetry

public abstract CommandResult runTimedCmdRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

שיטה לעזרה בהרצת פקודת מערכת, וביטול אם התהליך נמשך יותר זמן מההגדרה בזמן האימון.

פרמטרים
timeout long: זמן המתנה מקסימלי באלפיות השנייה עבור כל ניסיון

retryInterval long: הזמן שצריך להמתין בין הניסיונות החוזרים של הפקודה

attempts int: מספר הניסיונות המקסימלי

command String: פקודת המערכת שצוינה, וארגומנטים שרוצים להפעיל

החזרות
CommandResult תוצאה מסוג CommandResult שמכילה תוצאה מהרצת פקודות

runTimedCmdRetryWithOutputMonitor

public abstract CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                long retryInterval, 
                int attempts, 
                String... command)

שיטה לעזרה בהרצת פקודת מערכת, וביטול אם התהליך נמשך יותר זמן מההגדרה בזמן האימון. כולל גם מעקב אחר זרמי הפלט לאיתור פעילות, כאשר אין פעילות זרם נצפו למשך זמן מסוים. אם ערך הזמן הקצוב לתפוגה של פלט בלתי פעיל (backOutputTimeout) מוגדר כאפס, אין מעקב אחר סטרימינג יתרחשו.

פרמטרים
timeout long: זמן המתנה מקסימלי באלפיות השנייה עבור כל ניסיון

idleOutputTimeout long: זמן מקסימלי להמתנה באלפיות השנייה לפלט של שידורי הפלט

retryInterval long: הזמן שצריך להמתין בין הניסיונות החוזרים של הפקודה

attempts int: מספר הניסיונות המקסימלי

command String: פקודת המערכת שצוינה, וארגומנטים שרוצים להפעיל

החזרות
CommandResult תוצאה מסוג CommandResult שמכילה תוצאה מהרצת פקודות

runTimedCmdSilently

public abstract CommandResult runTimedCmdSilently (long timeout, 
                String... command)

שיטה לעזרה בהרצת פקודת מערכת, וביטול אם התהליך נמשך יותר זמן מההגדרה בזמן האימון. דומה ל-runTimedCmd(long, String), אבל לא מתעד שגיאות ב- חריג.

פרמטרים
timeout long: זמן המתנה מקסימלי באלפיות שנייה

command String: פקודת המערכת שצוינה, וארגומנטים שרוצים להפעיל

החזרות
CommandResult תוצאה מסוג CommandResult שמכילה תוצאה מהרצת פקודות

runTimedCmdSilentlyRetry

public abstract CommandResult runTimedCmdSilentlyRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

שיטה לעזרה בהרצת פקודת מערכת, וביטול אם התהליך נמשך יותר זמן מההגדרה בזמן האימון. דומה ל-runTimedCmdRetry(long, long, int, String[]), אבל לא רושם שגיאות חריגות.

פרמטרים
timeout long: זמן המתנה מקסימלי באלפיות שנייה

retryInterval long: הזמן שצריך להמתין בין הניסיונות החוזרים של הפקודה

attempts int: מספר הניסיונות המקסימלי

command String: פקודת המערכת שצוינה, וארגומנטים שרוצים להפעיל

החזרות
CommandResult תוצאה מסוג CommandResult שמכילה תוצאה מהרצת פקודות

runTimedCmdWithInput

public abstract CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                File stdoutFile, 
                File stderrFile, 
                String... command)

שיטה מסייעת לבצע פקודת מערכת, לבטל אם הפעולה נמשכת יותר מזמן מוגדר, ולהפנות את הפלט לקבצים, אם יש כאלה.

פרמטרים
timeout long: משך הזמן המקסימלי להמתנה באלפיות השנייה 0 פירושו שאין זמן קצוב לתפוגה.

input String: קלט ה-stdin להעברה לעיבוד

stdoutFile File: ERROR(/File) שאליו יופנה פלט ה-std. הערך יכול להיות null.

stderrFile File: ERROR(/File) שאליו יופנה פלט השגיאה. הערך יכול להיות null.

command String: פקודת המערכת שצוינה, וארגומנטים שרוצים להפעיל

החזרות
CommandResult תוצאה מסוג CommandResult שמכילה תוצאה מהרצת פקודות

runTimedCmdWithInput

public abstract CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                String... command)

שיטת עוזר לבצע פקודת מערכת שמחייבת קלט stdin ולבטל אם נמשכת יותר מפרק זמן מסוים.

פרמטרים
timeout long: זמן המתנה מקסימלי באלפיות שנייה

input String: קלט ה-stdin להעברה לעיבוד

command String: פקודת המערכת שצוינה, וארגומנטים שרוצים להפעיל

החזרות
CommandResult תוצאה מסוג CommandResult שמכילה תוצאה מהרצת פקודות

runTimedCmdWithInput

public abstract CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                 command)

שיטת עוזר לבצע פקודת מערכת שמחייבת קלט stdin ולבטל אם נמשכת יותר מפרק זמן מסוים.

פרמטרים
timeout long: זמן המתנה מקסימלי באלפיות שנייה

input String: קלט ה-stdin להעברה לעיבוד

command : ERROR(/List) שמכיל את פקודת המערכת ואפשר גם ארגומנטים להפעלה

החזרות
CommandResult תוצאה מסוג CommandResult שמכילה תוצאה מהרצת פקודות

runTimedCmdWithInputRedirect

public abstract CommandResult runTimedCmdWithInputRedirect (long timeout, 
                File inputRedirect, 
                String... command)

שיטת עוזר להריץ פקודת מערכת שמחייבת הפניה אוטומטית של Stdin מקובץ, וגם לבטל אם התהליך נמשך זמן רב יותר מהזמן שצוין.

פרמטרים
timeout long: זמן המתנה מקסימלי באלפיות שנייה

inputRedirect File: ה-ERROR(/File) להפניה אוטומטית כקלט רגיל באמצעות ProcessBuilder.redirectInput(). אם הערך הוא null, לא תתבצע הפניה אוטומטית של stdin.

command String: פקודת המערכת שצוינה, וארגומנטים שרוצים להפעיל

החזרות
CommandResult תוצאה מסוג CommandResult שמכילה תוצאה מהרצת פקודות

runTimedCmdWithOutputMonitor

public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                String... command)

שיטה מסייעת לבצע פקודת מערכת, לבטל אם הפעולה נמשכת יותר מזמן מוגדר, ולהפנות את הפלט לקבצים, אם יש כאלה. אם ERROR(/OutputStream) מסופקים בצורה הזו, הן יישארו פתוחות בסוף הפונקציה.

פרמטרים
timeout long: משך הזמן המקסימלי להמתנה באלפיות השנייה 0 פירושו שאין זמן קצוב לתפוגה.

idleOutputTimeout long: זמן מקסימלי להמתנה באלפיות השנייה לפלט של שידורי הפלט

stdout OutputStream: ERROR(/OutputStream) שאליו יופנה פלט ה-std. הערך יכול להיות null.

stderr OutputStream: ERROR(/OutputStream) שאליו יופנה פלט השגיאה. הערך יכול להיות null.

command String: פקודת המערכת שצוינה, וארגומנטים שרוצים להפעיל

החזרות
CommandResult תוצאה מסוג CommandResult שמכילה תוצאה מהרצת פקודות

runTimedCmdWithOutputMonitor

public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                String... command)

שיטה לעזרה בהרצת פקודת מערכת, וביטול אם התהליך נמשך יותר זמן מההגדרה בזמן האימון. כולל גם מעקב אחר זרמי הפלט לאיתור פעילות, כאשר אין פעילות זרם נצפו למשך זמן מסוים. אם ערך הזמן הקצוב לתפוגה של פלט בלתי פעיל (backOutputTimeout) מוגדר כאפס, אין מעקב אחר סטרימינג יתרחשו.

פרמטרים
timeout long: זמן המתנה מקסימלי באלפיות השנייה. 0 פירושו שאין זמן קצוב לתפוגה.

idleOutputTimeout long: זמן מקסימלי להמתנה באלפיות השנייה לפלט של שידורי הפלט

command String: פקודת המערכת שצוינה, וארגומנטים שרוצים להפעיל

החזרות
CommandResult תוצאה מסוג CommandResult שמכילה תוצאה מהרצת פקודות

runTimedCmdWithOutputMonitor

public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                ICacheClient cacheClient, 
                String... command)

שיטה לעזרה בביצוע פקודת מערכת באמצעות שמירה במטמון.

אם מציינים cacheClient, השמירה במטמון תופעל. אם המטמון זמין, תוחזר התוצאה שנשמרה במטמון. אחרת, runTimedCmdWithOutputMonitor(long, long, OutputStream, OutputStream, String) ישמש לביצוע הפקודה והתוצאה תועלה לשמירה במטמון.

פרמטרים
timeout long: משך הזמן המקסימלי להמתנה באלפיות השנייה 0 פירושו שאין זמן קצוב לתפוגה.

idleOutputTimeout long: משך הזמן המקסימלי להמתנה באלפיות השנייה לפלט של שידורי הפלט.

stdout OutputStream: ERROR(/OutputStream) שאליו יופנה פלט ה-std. הערך יכול להיות null.

stderr OutputStream: ERROR(/OutputStream) שאליו יופנה פלט השגיאה. הערך יכול להיות null.

cacheClient ICacheClient: מכונה של ICacheClient שמשמשת לטיפול בשמירה במטמון.

command String: פקודת המערכת שצוינה, וארגומנטים שרוצים להפעיל.

החזרות
CommandResult תוצאה מסוג CommandResult שמכילה את התוצאה מהרצת פקודות.

runTimedRetry

public abstract boolean runTimedRetry (long opTimeout, 
                long pollInterval, 
                int attempts, 
                IRunUtil.IRunnableResult runnable)

חסימה והפעלה של פעולה מספר פעמים, עד שהיא מצליחה.

פרמטרים
opTimeout long: זמן המתנה מקסימלי באלפיות שנייה עבור ניסיון פעולה אחד

pollInterval long: הזמן שצריך להמתין בין הניסיונות החוזרים של הפקודה

attempts int: מספר הניסיונות המקסימלי

runnable IRunUtil.IRunnableResult: IRunUtil.IRunnableResult להפעלה

החזרות
boolean true אם הפעולה הושלמה בהצלחה לפני שמגיעים לניסיונות.

runTimedRetryWithOutputMonitor

public abstract boolean runTimedRetryWithOutputMonitor (long opTimeout, 
                long idleOutputTimeout, 
                long pollInterval, 
                int attempts, 
                IRunUtil.IRunnableResult runnable)

חסימה והפעלה של פעולה מספר פעמים, עד שהיא מצליחה. עוקב גם אחר שידורי פלט של פעילות, לביטול אם לא נצפתה פעילות זרם במשך פרק זמן מסוים. אם ערך הזמן הקצוב לתפוגה של פלט פעיל (boutout) מוגדר לאפס, לא יתבצע מעקב אחר השידור.

פרמטרים
opTimeout long: זמן המתנה מקסימלי באלפיות שנייה עבור ניסיון פעולה אחד

idleOutputTimeout long: זמן מקסימלי להמתנה באלפיות השנייה לפלט של שידורי הפלט

pollInterval long: הזמן שצריך להמתין בין הניסיונות החוזרים של הפקודה

attempts int: מספר הניסיונות המקסימלי

runnable IRunUtil.IRunnableResult: IRunUtil.IRunnableResult להפעלה

החזרות
boolean true אם הפעולה הושלמה בהצלחה לפני שמגיעים לניסיונות.

runTimedWithOutputMonitor

public abstract CommandStatus runTimedWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                IRunUtil.IRunnableResult runnable, 
                boolean logErrors)

חסימה וביצוע של פעולה, ביטול אם הפעולה נמשכת יותר מפרק זמן מוגדר. וגם עוקב אחר זרמי הפלט עבור פעילות, ומבטל אם לא נצפתה פעילות זרם עבור בזמן שצוין. אם ערך הזמן הקצוב לתפוגה של פלט פעיל (boutout) מוגדר לאפס, לא יתבצע מעקב אחר השידור.

פרמטרים
timeout long: זמן המתנה מקסימלי באלפיות שנייה

idleOutputTimeout long: זמן מקסימלי להמתנה באלפיות השנייה לפלט של שידורי הפלט

runnable IRunUtil.IRunnableResult: IRunUtil.IRunnableResult להפעלה

logErrors boolean: יש שגיאות ביומן של חריגות או שאינן חריגות.

החזרות
CommandStatus תוצאת הפעולה CommandStatus.

setEnvVariable (משתנה)

public abstract void setEnvVariable (String key, 
                String value)

מגדירה משתנה סביבה שישמש כשמריצים פקודות מערכת.

פרמטרים
key String: שם המשתנה

value String: ערך המשתנה

למידע נוסף:

setEnvVariablePriority

public abstract void setEnvVariablePriority (IRunUtil.EnvPriority priority)

צריך להחליט אם כשיוצרים תהליך, ביטול ההגדרה של משתנה הסביבה גבוה יותר חשוב יותר מאשר להגדיר אותם. כברירת מחדל, ביטול ההגדרה הוא בעדיפות גבוהה יותר. כלומר, אם ניסיון להגדיר משתנה עם אותו שם, הוא לא יקרה כי המשתנה לא יוגדר. לא ניתן להשתמש במופע של IRunUtil שמוגדר כברירת המחדל.

פרמטרים
priority IRunUtil.EnvPriority

setInterruptibleInFuture

public abstract void setInterruptibleInFuture (Thread thread, 
                long timeMs)

הגדרה כ'ניתן להפסקה' לאחר זמן המתנה. ERROR(/CommandScheduler#shutdownHard()) כדי לאכוף את החוזה שלנו בסופו של דבר.

פרמטרים
thread Thread: השרשור שאפשר להפריע לו.

timeMs long: זמן המתנה לפני הגדרת הפרעות.

setLinuxInterruptProcess

public abstract void setLinuxInterruptProcess (boolean interrupt)

אפשר להשתמש ב-linux 'kill' הפרעה בתהליך הריצה באמצעות שיטות #runTimed כאשר מגיע לזמן קצוב לתפוגה. לא ניתן להשתמש במופע של IRunUtil שמוגדר כברירת המחדל.

פרמטרים
interrupt boolean

setRedirectStderrToStdout

public abstract void setRedirectStderrToStdout (boolean redirect)

הגדרת זרם שגיאה רגיל שיפנה לזרם הפלט הסטנדרטי בזמן הפעלת המערכת פקודות. הערך הראשוני הוא False.

פרמטרים
redirect boolean: ערך חדש שמציין אם להפנות לכתובת אחרת

setWorkingDir

public abstract void setWorkingDir (File dir)

מגדירה את ספריית העבודה לפקודות מערכת.

פרמטרים
dir File: ספריית העבודה

למידע נוסף:

שינה

public abstract void sleep (long time)

שיטה שעוזרת לישון במשך זמן נתון, תוך התעלמות מכל החריגים.

פרמטרים
time long: אלפיות השנייה עד לשינה. המערכת תתעלם מערכים שקטן מ-0 או שווה ל-0

לא מוגדרEnvVariable

public abstract void unsetEnvVariable (String key)

מבטל את ההגדרה של משתנה סביבה, כך שפקודות המערכת פועלות בלי משתנה הסביבה.

פרמטרים
key String: שם המשתנה

למידע נוסף: