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,
שיטה חלופית של |
abstract
Process
|
runCmdInBackground(
שיטה חלופית של |
abstract
Process
|
runCmdInBackground(
הפעלת פקודה עם הדגל |
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,
שיטה מסייעת להרצת פקודת מערכת שדורשת קלט מ-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 : שם המשתנה |
מידע נוסף: