RunUtil

public class RunUtil
extends Object implements IRunUtil

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

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

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.

static File 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, File target)
static String toRelative(File start, String target)
void unsetEnvVariable(String key)

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

void uploadCache(ICacheClient cacheClient, ExecutableActionResult actionResult)

העלאה של ExecutableActionResult האחרון שהופעל באמצעות cacheClient.

שדות

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)

מאפשרת או אוסרת הפסקות ריצה בשרשור הנוכחי. אם מותר, אפשר להפסיק פעולות ריצה של הליבה הנוכחית מליבות אחרות באמצעות השיטה 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 אחרת.

linkFile

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

קישור של target למקום בקטע destRoot.

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

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

runCmdInBackground

public Process runCmdInBackground (Redirect redirect, 
                 command)

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

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

runCmdInBackground

public Process runCmdInBackground ( command)

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

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

runCmdInBackground

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

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

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

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

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

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

runTimedCmd

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

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

פרמטרים
timeout long: משך ההמתנה המקסימלי, באלפיות שנייה. הערך 0 מציין שאין זמן קצוב לתפוגה.
command String: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי)
החזרות
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)

שיטה מסייעת להרצת פקודת מערכת, וביטול הפקודה אם היא נמשכת יותר מהזמן שצוין. הוא גם עוקב אחרי הפעילות בזרמי הפלט, ומפסיק את הפעולה אם לא מתגלה פעילות בזרם במשך זמן מסוים. אם ערך הזמן הקצוב לתפוגה שהוגדר ל-{/7}OutputTimeout הוא אפס, לא יתבצע מעקב אחר השידור.

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

runTimedCmdWithInput

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

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

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

runTimedCmdWithInput

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

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

פרמטרים
timeout long: משך ההמתנה המקסימלי, במילישניות
input String: הקלט של stdin שרוצים להעביר לתהליך
command : ERROR(/List) שמכיל את פקודת המערכת ואת הארגומנטים ל-exec (אופציונלי)
החזרות
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: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי)
החזרות
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) – המקום שאליו יועבר הפלט של std. הערך יכול להיות null.
stderr OutputStream: ERROR(/OutputStream) – המקום שאליו יועבר הפלט של השגיאה. הערך יכול להיות null.
command String: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי)
החזרות
CommandResult CommandResult שמכיל תוצאה מהרצת הפקודה

runTimedCmdWithOutputMonitor

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

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

פרמטרים
timeout long: משך ההמתנה המקסימלי, באלפיות שנייה. הערך 0 מציין שאין זמן קצוב לתפוגה.
idleOutputTimeout long: משך ההמתנה המקסימלי באלפיות השנייה להצגת פלט בזרמי הפלט
command String: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי)
החזרות
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: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי).
החזרות
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 או שווים לו יימחקו

toRelative

public static String toRelative (File start, 
                File target)

פרמטרים
start File

target File

החזרות
String

toRelative

public static String toRelative (File start, 
                String target)

פרמטרים
start File

target String

החזרות
String

unsetEnvVariable

public void unsetEnvVariable (String key)

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

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

מאמרים קשורים:

העלאת מטמון

public void uploadCache (ICacheClient cacheClient, 
                ExecutableActionResult actionResult)

העלאה של ExecutableActionResult האחרון שהופעל באמצעות cacheClient.

פרמטרים
cacheClient ICacheClient: ICacheClient ששימש להעלאת התוצאה.
actionResult ExecutableActionResult: ה-ExecutableActionResult להעלאה.