דף זה תורגם על ידי Cloud Translation API.

RunUtil

public class RunUtil
extends Object implements IRunUtil

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

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

סיכום

שדות
`public static final String`	`INHERITIO_PREFIX`
`public static final String`	`RUNNABLE_NOTIFIER_NAME`

בנאים ציבוריים
`RunUtil()` יוצרים אובייקט `RunUtil` חדש לשימוש.
`RunUtil(boolean inheritEnvVars)`

שיטות ציבוריות
`void`	`allowInterrupt(boolean allow)` מאפשר או לא מאפשר להריץ הפרעות בשרשור הנוכחי.
`static IRunUtil`	`getDefault()` מקבלים הפניה לאובייקט ברירת המחדל `RunUtil`.
`void`	`interrupt(Thread thread, String message, ErrorIdentifier errorId)` הפרעה לפעולות ההפעלה המתמשכות או הבאות בשרשור הנתון.
`void`	`interrupt(Thread thread, String message)` הפרעה לפעולות ההפעלה המתמשכות או הבאות בשרשור הנתון.
`boolean`	`isInterruptAllowed()` מציינים את סטטוס ההתערבות של RunUtil.
`static void`	`linkFile(File destRoot, String relToRoot, File target)` מתבצע קישור של `target` למקום שנמצא ב`destRoot`.
`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)` שיטה לעזרה בהרצת פקודת מערכת, וביטול אם התהליך נמשך יותר זמן מההגדרה בזמן האימון.
`CommandResult`	`runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, 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)` אפשר להשתמש ב-linux 'kill' הפרעה בתהליך הריצה באמצעות שיטות #runTimed כאשר מגיע לזמן קצוב לתפוגה.
`void`	`setRedirectStderrToStdout(boolean redirect)` הגדרת זרם שגיאה רגיל שיפנה לזרם הפלט הסטנדרטי בזמן הפעלת המערכת פקודות.
`void`	`setWorkingDir(File dir)` מגדירה את ספריית העבודה לפקודות מערכת.
`void`	`sleep(long time)` שיטה שעוזרת לישון במשך זמן נתון, תוך התעלמות מכל החריגים.
`static String`	`toRelative(File start, String target)`
`void`	`unsetEnvVariable(String key)` מבטל את ההגדרה של משתנה סביבה, כך שפקודות המערכת פועלות בלי משתנה הסביבה. משתני סביבה עשויים לעבור בירושה מתהליך ההורה, ולכן אנחנו צריכים למחוק משתנה הסביבה מ-`ProcessBuilder.environment()`

שדות

INHERITIO_PREFIX

public static final String INHERITIO_PREFIX

RUNNABLE_NOTIFIER_NAME

public static final String RUNNABLE_NOTIFIER_NAME

בנאים ציבוריים

RunUtil

public RunUtil ()

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

RunUtil

public RunUtil (boolean inheritEnvVars)

פרמטרים
`inheritEnvVars`	`boolean`

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

AllowInterrupt

public void allowInterrupt (boolean allow)

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

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

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.

קובץ linkFile

public static void linkFile (File destRoot, 
                String relToRoot, 
                File target)

מתבצע קישור של target למקום שנמצא בdestRoot.

אם קובץ היעד או הקישור הסמלי כבר קיימים במסגרת destRoot, הקובץ לא יקושר.

פרמטרים
`destRoot`	`File`: הרמה הבסיסית (root) של היעד.
`relToRoot`	`String`: הנתיב היחסי מ-dir היעד לרמה הבסיסית (root).
`target`	`File`: קובץ היעד לקישור.

קליעות
	אם קובץ היעד לא מקושר.

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) תציג את הפלט של הפקודה ביומן. Stdout ו-stderr ממוזגים יחד.

פרמטרים
`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` אם הפעולה הושלמה לפני שהתוקף של maxTime פג

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` אם הפעולה הושלמה לפני שהתוקף של maxTime פג

runFixedTimedRetryWithOutputMonitor

public 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 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)` שאליו יופנה פלט ה-std. הערך יכול להיות 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)

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

פרמטרים
`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)` שאליו יופנה פלט ה-std. הערך יכול להיות 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)

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

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

runTimedCmdWithOutputMonitor

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

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

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

runTimedCmdWithOutputMonitor

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

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

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

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

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

לקרוב משפחה

public static String toRelative (File start, 
                String target)

פרמטרים
`start`	`File`
`target`	`String`

החזרות
`String`

לא מוגדרEnvVariable

public void unsetEnvVariable (String key)

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

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

למידע נוסף:

ProcessBuilder.environment()