RunUtil

public class RunUtil
extends Object implements IRunUtil

java.lang.Object
   ↳ com.android.tradefed.util.RunUtil

אוסף של שיטות עזר להפעלת פעולות.

סיכום

ערכים קבועים

String INHERITIO_PREFIX

String RUNNABLE_NOTIFIER_NAME

Constructors ציבוריים

RunUtil()

יוצרים אובייקט RunUtil חדש לשימוש.

RunUtil(boolean inheritEnvVars)

‫methods ציבוריים

void allowInterrupt(boolean allow)

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

ProcessBuilder createProcessBuilder(Redirect redirect, commandList, boolean enableCache)
static IRunUtil getDefault()

מקבלים הפניה לאובייקט RunUtil שמוגדר כברירת מחדל.

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

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

void interrupt(Thread thread, String message)

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

boolean isInterruptAllowed()

מחזירה את סטטוס ההפרעה של RunUtil.

Process runCmdInBackground(Redirect redirect, command)

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

Process runCmdInBackground( command)

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

Process runCmdInBackground( command, OutputStream output)

הפעלת הפקודה עם ERROR(/OutputStream) תרשום את הפלט של הפקודה.

Process runCmdInBackground(String... command)

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

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

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

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

חסימה וביצוע של פעולה כמה פעמים עד שהיא מצליחה.

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

חסימה וביצוע של פעולה כמה פעמים עד שהיא מצליחה.

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

חסימה וביצוע של פעולה כמה פעמים עד שהיא מצליחה.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

CommandResult runTimedCmdWithInput(long timeout, String input, command)

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

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

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

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

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

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

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

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

חסימה וביצוע של פעולה כמה פעמים עד שהיא מצליחה.

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

חסימה וביצוע של פעולה כמה פעמים עד שהיא מצליחה.

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

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

void setEnvVariable(String name, String value)

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

void setEnvVariablePriority(IRunUtil.EnvPriority priority)

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

void setInterruptibleInFuture(Thread thread, long timeMs)

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

void setLinuxInterruptProcess(boolean interrupt)

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

void setRedirectStderrToStdout(boolean redirect)

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

void setWorkingDir(File dir)

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

void sleep(long time)

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

void unsetEnvVariable(String key)

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

ערכים קבועים

INHERITIO_PREFIX

public static final String INHERITIO_PREFIX

ערך קבוע: "inheritio-"

RUNNABLE_NOTIFIER_NAME

public static final String RUNNABLE_NOTIFIER_NAME

ערך קבוע: "RunnableNotifier"

Constructors ציבוריים

RunUtil

public RunUtil ()

יוצרים אובייקט RunUtil חדש לשימוש.

RunUtil

public RunUtil (boolean inheritEnvVars)

פרמטרים
inheritEnvVars boolean

‫methods ציבוריים

allowInterrupt

public void allowInterrupt (boolean allow)

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

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

createProcessBuilder

public ProcessBuilder createProcessBuilder (Redirect redirect, 
                 commandList, 
                boolean enableCache)

פרמטרים
redirect Redirect

commandList

enableCache boolean

החזרות
ProcessBuilder

getDefault

public static IRunUtil getDefault ()

מקבלים הפניה לאובייקט RunUtil שמוגדר כברירת מחדל.

האפשרות הזו שימושית למתקשרים שרוצים להשתמש ב-IRunUtil בלי לבצע התאמה אישית. מומלץ שמתקשרים שצריכים מופע מותאם אישית של IRunUtil (כלומר, צריכים להתקשר אל setEnvVariable(String, String) או אל setWorkingDir(File)) ייצרו עותק משלהם.

החזרות
IRunUtil

להפריע

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

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

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

להפריע

public void interrupt (Thread thread, 
                String message)

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

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

isInterruptAllowed

public boolean isInterruptAllowed ()

מחזירה את סטטוס ההפרעה של RunUtil.

החזרות
boolean הערך true אם אפשר להפריע להרצה, אחרת הערך false.

runCmdInBackground

public Process runCmdInBackground (Redirect redirect, 
                 command)

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

פרמטרים
redirect Redirect: ה-ERROR(/Redirect) שיחול על ProcessBuilder.
command ‫: ERROR(/List) שמכיל את פקודת המערכת שצוינה, ואופציונלית ארגומנטים להרצה
החזרות
Process הפקודה Process שהופעלה

runCmdInBackground

public Process runCmdInBackground ( command)

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

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

runCmdInBackground

public Process runCmdInBackground ( command, 
                OutputStream output)

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

פרמטרים
command ‫: הפקודה להרצה
output ‫OutputStream: OutputStream לשמירת הפלט
החזרות
Process האלגוריתם Process שמריץ את הפקודה

runCmdInBackground

public Process runCmdInBackground (String... command)

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

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

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

runCmdInBackground

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

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

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

פרמטרים
redirect Redirect: ה-ERROR(/Redirect) שיחול על ProcessBuilder.
command ‫String: פקודת המערכת שצוינה, וארגומנטים אופציונליים להרצה
החזרות
Process הפקודה Process שהופעלה

runEscalatingTimedRetry

public 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 אם הפעולה הושלמה לפני שחלף הזמן המקסימלי

runFixedTimedRetry

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

חסימה וביצוע של פעולה כמה פעמים עד שהיא מצליחה.

פרמטרים
opTimeout ‫long: הזמן המקסימלי להמתנה באלפיות השנייה לניסיון בודד של פעולה
pollInterval ‫long: זמן ההמתנה הראשוני בין ניסיונות הפעולה
maxTime ‫long: משך הזמן המקסימלי הכולל המשוער לניסיון חוזר של הפעולה
runnable ‫IRunUtil.IRunnableResult: IRunUtil.IRunnableResult להפעלה
החזרות
boolean ‫true אם הפעולה הושלמה לפני שחלף הזמן המקסימלי

runFixedTimedRetryWithOutputMonitor

public 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 אם הפעולה הושלמה לפני שחלף הזמן המקסימלי

runTimed

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

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

פרמטרים
timeout ‫long: זמן ההמתנה המקסימלי במילישניות
runnable ‫IRunUtil.IRunnableResult: IRunUtil.IRunnableResult להפעלה
logErrors ‫boolean: רישום שגיאות ביומן במקרה של חריג או לא.
החזרות
CommandStatus CommandStatus תוצאת הפעולה.

runTimedCmd

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

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

פרמטרים
timeout ‫long: פסק זמן, הזמן המקסימלי להמתנה באלפיות השנייה. 0 פירושו ללא פסק זמן.
stdout ‫OutputStream: ERROR(/OutputStream) לאן יופנה הפלט הרגיל. יכול להיות null.
stderr ‫OutputStream: ERROR(/OutputStream) לאן יופנה פלט השגיאה. יכול להיות null.
command ‫String: פקודת המערכת שצוינה, וארגומנטים אופציונליים להרצה
החזרות
CommandResult CommandResult שמכיל את התוצאה מהרצת הפקודה

runTimedCmd

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

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

פרמטרים
timeout ‫long: הזמן המקסימלי להמתנה באלפיות השנייה. 0 מציין שאין זמן קצוב לתפוגה.
command ‫String: פקודת המערכת שצוינה, וארגומנטים אופציונליים להרצה
החזרות
CommandResult CommandResult שמכיל את התוצאה מהרצת הפקודה

runTimedCmdRetry

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

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

פרמטרים
timeout ‫long: משך הזמן המקסימלי להמתנה באלפיות השנייה לכל ניסיון
retryInterval ‫long: זמן ההמתנה בין ניסיונות חוזרים של פקודה
attempts ‫int: מספר הניסיונות המקסימלי לביצוע
command ‫String: פקודת המערכת שצוינה, וארגומנטים אופציונליים להרצה
החזרות
CommandResult CommandResult שמכיל את התוצאה מהרצת הפקודה

runTimedCmdRetryWithOutputMonitor

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

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

פרמטרים
timeout ‫long: משך הזמן המקסימלי להמתנה באלפיות השנייה לכל ניסיון
idleOutputTimeout ‫long: הזמן המקסימלי להמתנה באלפיות השנייה לפלט בזרמי הפלט
retryInterval ‫long: זמן ההמתנה בין ניסיונות חוזרים של פקודה
attempts ‫int: מספר הניסיונות המקסימלי לביצוע
command ‫String: פקודת המערכת שצוינה, וארגומנטים אופציונליים להרצה
החזרות
CommandResult ‫CommandResult שמכיל את התוצאה מהרצת הפקודה

runTimedCmdSilently

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

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

פרמטרים
timeout ‫long: זמן ההמתנה המקסימלי במילישניות
command ‫String: פקודת המערכת שצוינה, וארגומנטים אופציונליים להרצה
החזרות
CommandResult ‫CommandResult שמכיל את התוצאה מהרצת הפקודה

runTimedCmdSilentlyRetry

public 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 CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                File stdoutFile, 
                File stderrFile, 
                String... command)

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

פרמטרים
timeout ‫long: פסק זמן, הזמן המקסימלי להמתנה באלפיות השנייה. 0 פירושו ללא פסק זמן.
input String: קלט stdin להעברה לתהליך
stdoutFile ‫File: ERROR(/File) לאן הפלט הרגיל יופנה. יכול להיות null.
stderrFile ‫File: ERROR(/File) לאן יופנה פלט השגיאה. יכול להיות null.
command ‫String: פקודת המערכת שצוינה, וארגומנטים אופציונליים להרצה
החזרות
CommandResult CommandResult שמכיל את התוצאה מהרצת הפקודה

runTimedCmdWithInput

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

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

פרמטרים
timeout ‫long: זמן ההמתנה המקסימלי במילישניות
input String: קלט stdin להעברה לתהליך
command ‫String: פקודת המערכת שצוינה, וארגומנטים אופציונליים להרצה
החזרות
CommandResult CommandResult שמכיל את התוצאה מהרצת הפקודה

runTimedCmdWithInput

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

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

פרמטרים
timeout ‫long: זמן ההמתנה המקסימלי במילישניות
input String: קלט stdin להעברה לתהליך
command ‫: ERROR(/List) שמכיל את פקודת המערכת ואופציונלית את הארגומנטים להרצה
החזרות
CommandResult CommandResult שמכיל את התוצאה מהרצת הפקודה

runTimedCmdWithInputRedirect

public 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 CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                String... command)

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

פרמטרים
timeout ‫long: פסק זמן, הזמן המקסימלי להמתנה באלפיות השנייה. 0 פירושו ללא פסק זמן.
idleOutputTimeout ‫long: הזמן המקסימלי להמתנה באלפיות השנייה לפלט בזרמי הפלט
stdout ‫OutputStream: ERROR(/OutputStream) לאן יופנה הפלט הרגיל. יכול להיות null.
stderr ‫OutputStream: ERROR(/OutputStream) לאן יופנה פלט השגיאה. יכול להיות null.
command ‫String: פקודת המערכת שצוינה, וארגומנטים אופציונליים להרצה
החזרות
CommandResult CommandResult שמכיל את התוצאה מהרצת הפקודה

runTimedCmdWithOutputMonitor

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

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

פרמטרים
timeout ‫long: הזמן המקסימלי להמתנה באלפיות השנייה. 0 מציין שאין זמן קצוב לתפוגה.
idleOutputTimeout ‫long: הזמן המקסימלי להמתנה באלפיות השנייה לפלט בזרמי הפלט
command ‫String: פקודת המערכת שצוינה, וארגומנטים אופציונליים להרצה
החזרות
CommandResult CommandResult שמכיל את התוצאה מהרצת הפקודה

runTimedRetry

public 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 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 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 void setEnvVariable (String name, 
                String value)

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

פרמטרים
name ‫String: שם המשתנה
value ‫String: ערך המשתנה

setEnvVariablePriority

public void setEnvVariablePriority (IRunUtil.EnvPriority priority)

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

פרמטרים
priority IRunUtil.EnvPriority

setInterruptibleInFuture

public void setInterruptibleInFuture (Thread thread, 
                long timeMs)

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

פרמטרים
thread ‫Thread: השרשור שיוכל להיקטע.
timeMs ‫long: משך ההמתנה לפני הגדרת האפשרות להפרעה.

setLinuxInterruptProcess

public void setLinuxInterruptProcess (boolean interrupt)

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

פרמטרים
interrupt boolean

setRedirectStderrToStdout

public void setRedirectStderrToStdout (boolean redirect)

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

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

setWorkingDir

public void setWorkingDir (File dir)

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

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

שינה

public void sleep (long time)

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

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

unsetEnvVariable

public void unsetEnvVariable (String key)

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

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

מידע נוסף: