IRunUtil

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 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)

מתן אפשרות להשתמש בהפרעה של 'kill' ב-Linux בתהליך שפועל באמצעות שיטות #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)

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

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

interrupt

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

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

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

errorId ErrorIdentifier: מייצג את הסיבה להפרעה, אם היא ידועה.

interrupt

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) שמכיל את פקודת המערכת שצוינה ואת הארגומנטים ל-exec, אם יש כאלה

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

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

runCmdInBackground

public abstract Process runCmdInBackground ( command)

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

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

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

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

runCmdInBackground

public abstract Process runCmdInBackground ( command, 
                OutputStream output)

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

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

output OutputStream: OutputStream לשמירת הפלט

החזרות
Process ה-Process שמריץ את הפקודה

זריקות
IOException

runCmdInBackground

public abstract Process runCmdInBackground (String... command)

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

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

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

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

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

runCmdInBackground

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

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

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

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

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

החזרות
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)

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

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

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

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

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

runnable IRunUtil.IRunnableResult: IRunUtil.IRunnableResult לביצוע

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

runTimed

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: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי)

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

runTimedCmd

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

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

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

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

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

runTimedCmdRetry

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

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

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

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

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

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

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

runTimedCmdRetryWithOutputMonitor

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

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

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

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

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

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

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

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

runTimedCmdSilently

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

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

פרמטרים
timeout long: משך ההמתנה המקסימלי, במילישניות

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

החזרות
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: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי)

החזרות
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: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי)

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

runTimedCmdWithInput

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

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

פרמטרים
timeout long: משך ההמתנה המקסימלי, במילישניות

input String: הקלט של stdin שרוצים להעביר לתהליך

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

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

runTimedCmdWithInput

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

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

פרמטרים
timeout long: משך ההמתנה המקסימלי, במילישניות

input String: הקלט של stdin שרוצים להעביר לתהליך

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

החזרות
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: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי)

החזרות
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: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי)

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

runTimedCmdWithOutputMonitor

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

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

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

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

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

החזרות
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)

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

פרמטרים
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)

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

פרמטרים
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)

מאפשר להשתמש בהפרעה של 'kill' ב-Linux בתהליך שפועל באמצעות שיטות #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 או שווים לו יימחקו

unsetEnvVariable

public abstract void unsetEnvVariable (String key)

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

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

מידע נוסף: