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
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, 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)
제한 시간에 도달하면 #runTimed 메서드를 통해 실행 중인 프로세스에 Linux 'kill' 중단을 사용할 수 있습니다. |
abstract
void
|
setRedirectStderrToStdout(boolean redirect)
시스템 명령어를 실행할 때 표준 출력 스트림으로 리디렉션되도록 표준 오류 스트림을 설정합니다. |
abstract
void
|
setWorkingDir(File dir)
시스템 명령어의 작업 디렉터리를 설정합니다. |
abstract
void
|
sleep(long time)
예외를 무시하고 지정된 시간 동안 절전하는 도우미 메서드입니다. |
abstract
void
|
unsetEnvVariable(String key)
환경 변수를 설정 해제하여 시스템 명령어가 이 환경 변수 없이 실행되도록 합니다. |
abstract
void
|
uploadCache(ICacheClient cacheClient, ExecutableActionResult actionResult)
cacheClient로 실행된 마지막 |
공개 메서드
allowInterrupt
public abstract void allowInterrupt (boolean allow)
현재 스레드에서 실행 인터럽트를 허용하거나 허용하지 않습니다. 허용하는 경우 현재 스레드의 실행 작업은 interrupt(Thread, String)
메서드를 통해 다른 스레드에서 중단될 수 있습니다.
매개변수 | |
---|---|
allow |
boolean : 현재 스레드에서 실행 인터럽트를 허용할지 여부입니다. |
인터럽트
public abstract void interrupt (Thread thread, String message, ErrorIdentifier errorId)
지정된 스레드에서 진행 중인/예정된 실행 작업을 중단합니다. 지정된 스레드에서 실행 작업을 실행하면 RunInterruptedException
이 발생합니다.
매개변수 | |
---|---|
message |
String : RunInterruptedException 의 메시지입니다. |
errorId |
ErrorIdentifier : 알려진 경우 중단의 원인을 나타냅니다. |
인터럽트
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)
ERROR(/List)
형식의 명령어 인수를 허용하는 대체 runCmdInBackground(String)
메서드입니다.
매개변수 | |
---|---|
redirect |
Redirect : ProcessBuilder 에 적용할 ERROR(/Redirect) 입니다. |
command |
: 지정된 시스템 명령어와 선택적으로 exec 인수를 포함하는 ERROR(/List) |
반환 값 | |
---|---|
Process |
실행된 명령어의 Process |
생성 값 | |
---|---|
|
명령어 실행 실패 |
runCmdInBackground
public abstract Process runCmdInBackground (command)
ERROR(/List)
형식의 명령어 인수를 허용하는 대체 runCmdInBackground(String)
메서드입니다.
매개변수 | |
---|---|
command |
: 지정된 시스템 명령어와 선택적으로 exec 인수를 포함하는 ERROR(/List) |
반환 값 | |
---|---|
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 : ProcessBuilder 에 적용할 ERROR(/Redirect) 입니다. |
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 |
maxTime이 만료되기 전에 작업이 완료된 경우 true |
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 |
maxTime이 만료되기 전에 작업이 성공적으로 완료된 경우 true 입니다. |
runFixedTimedRetryWithOutputMonitor
public abstract boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
작업이 성공할 때까지 작업을 차단하고 여러 번 실행합니다. 또한 출력 스트림에서 활동을 모니터링하고 지정된 시간 동안 스트림 활동이 관찰되지 않으면 취소됩니다. idleOutputTimeout이 0으로 설정되면 스트림 모니터링이 실행되지 않습니다.
매개변수 | |
---|---|
opTimeout |
long : 단일 작업 시도에 대해 기다릴 수 있는 최대 시간(밀리초)입니다. |
idleOutputTimeout |
long : 출력 스트림의 출력을 기다리는 최대 시간(밀리초) |
pollInterval |
long : 작업 시도 사이에 대기할 초기 시간입니다. |
maxTime |
long : 작업을 계속 시도하는 데 걸리는 총 대략적인 최대 시간입니다. |
runnable |
IRunUtil.IRunnableResult : 실행할 IRunUtil.IRunnableResult |
반환 값 | |
---|---|
boolean |
maxTime이 만료되기 전에 작업이 성공적으로 완료된 경우 true 입니다. |
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 : std 출력이 리디렉션되는 ERROR(/OutputStream) 입니다. 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이 0으로 설정되면 스트림 모니터링이 발생하지 않습니다.
매개변수 | |
---|---|
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 : std 출력이 리디렉션되는 ERROR(/File) 입니다. 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) |
반환 값 | |
---|---|
CommandResult |
명령어 실행의 결과가 포함된 CommandResult |
runTimedCmdWithInputRedirect
public abstract CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)
파일에서 Stdin을 리디렉션하고 지정된 시간보다 오래 걸리는 경우 취소해야 하는 시스템 명령어를 실행하는 도우미 메서드입니다.
매개변수 | |
---|---|
timeout |
long : 최대 대기 시간(밀리초) |
inputRedirect |
File : ProcessBuilder.redirectInput() 를 사용하여 표준 입력으로 리디렉션할 ERROR(/File) 입니다. 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 : std 출력이 리디렉션되는 ERROR(/OutputStream) 입니다. null일 수 있습니다. |
stderr |
OutputStream : 오류 출력이 리디렉션되는 ERROR(/OutputStream) 입니다. null일 수 있습니다. |
command |
String : 지정된 시스템 명령어 및 선택적으로 exec 인수 |
반환 값 | |
---|---|
CommandResult |
명령어 실행 결과가 포함된 CommandResult |
runTimedCmdWithOutputMonitor
public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)
시스템 명령어를 실행하고 지정된 시간보다 오래 걸리는 경우 중단하는 도우미 메서드입니다. 또한 활동에 대한 출력 스트림을 모니터링하여 지정된 시간 동안 스트림 활동이 관찰되지 않으면 중단합니다. idOutputTimeout을 0으로 설정하면 스트림 모니터링이 발생하지 않습니다.
매개변수 | |
---|---|
timeout |
long : 대기할 최대 시간(밀리초)입니다. 0은 제한 시간이 없음을 의미합니다. |
idleOutputTimeout |
long : 출력 스트림의 출력을 기다리는 최대 시간(밀리초) |
command |
String : 지정된 시스템 명령어 및 선택적으로 exec 인수 |
반환 값 | |
---|---|
CommandResult |
명령어 실행 결과가 포함된 CommandResult |
runTimedCmdWithOutputMonitor
public abstract 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 : std 출력이 리디렉션되는 ERROR(/OutputStream) 입니다. null일 수 있습니다. |
stderr |
OutputStream : ERROR(/OutputStream) . 여기서 오류 출력이 리디렉션됩니다. null일 수 있습니다. |
cacheClient |
ICacheClient : 캐싱을 처리하는 데 사용되는 ICacheClient 의 인스턴스입니다. |
command |
String : 지정된 시스템 명령어이며 exec의 선택적 인수입니다. |
반환 값 | |
---|---|
CommandResult |
명령어 실행 결과가 포함된 CommandResult |
runTimedRetry
public abstract boolean runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
작업이 성공할 때까지 작업을 차단하고 여러 번 실행합니다.
매개변수 | |
---|---|
opTimeout |
long : 작업 시도 1회당 기다릴 최대 시간(밀리초) |
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)
작업이 성공할 때까지 작업을 차단하고 여러 번 실행합니다. 또한 출력 스트림에서 활동을 모니터링하고 지정된 시간 동안 스트림 활동이 관찰되지 않으면 취소됩니다. idOutputTimeout을 0으로 설정하면 스트림 모니터링이 발생하지 않습니다.
매개변수 | |
---|---|
opTimeout |
long : 작업 시도 1회당 기다릴 최대 시간(밀리초) |
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이 0으로 설정되면 스트림 모니터링이 실행되지 않습니다.
매개변수 | |
---|---|
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 |
미래에 인터럽트 가능
public abstract void setInterruptibleInFuture (Thread thread, long timeMs)
일정 시간 대기한 후 중단 가능하도록 설정합니다.
ERROR(/CommandScheduler#shutdownHard())
를 사용하여 결국 종료합니다.
매개변수 | |
---|---|
thread |
Thread : 인터럽트 가능 상태가 되는 스레드입니다. |
timeMs |
long : 인터럽트 가능을 설정하기 전에 기다릴 시간입니다. |
setLinuxInterruptProcess
public abstract void setLinuxInterruptProcess (boolean interrupt)
제한 시간에 도달하면 #runTimed 메서드를 통해 실행되는 프로세스에서 Linux 'kill' 중단을 사용하도록 허용합니다.
기본 IRunUtil
인스턴스에서는 사용할 수 없습니다.
매개변수 | |
---|---|
interrupt |
boolean |
setRedirectStderrToStdout
public abstract void setRedirectStderrToStdout (boolean redirect)
시스템 명령어를 실행할 때 표준 출력 스트림으로 리디렉션되도록 표준 오류 스트림을 설정합니다. 초깃값은 false입니다.
매개변수 | |
---|---|
redirect |
boolean : 리디렉션 여부의 새 값 |
setWorkingDir
public abstract void setWorkingDir (File dir)
시스템 명령어의 작업 디렉터리를 설정합니다.
매개변수 | |
---|---|
dir |
File : 작업 디렉터리 |
sleep
public abstract void sleep (long time)
예외를 무시하고 주어진 시간 동안 절전 모드를 유지하는 도우미 메서드입니다.
매개변수 | |
---|---|
time |
long : 절전 모드까지 걸린 시간(밀리초)입니다. 0보다 작거나 같은 값은 무시됩니다. |
unsetEnvVariable
public abstract void unsetEnvVariable (String key)
환경 변수를 설정 해제하여 시스템 명령어가 이 환경 변수 없이 실행되도록 합니다.
매개변수 | |
---|---|
key |
String : 변수 이름 |
uploadCache
public abstract void uploadCache (ICacheClient cacheClient, ExecutableActionResult actionResult)
cacheClient로 실행된 마지막 ExecutableActionResult
를 업로드합니다.
매개변수 | |
---|---|
cacheClient |
ICacheClient : 결과를 업로드하는 데 사용되는 ICacheClient 입니다. |
actionResult |
ExecutableActionResult : 업로드할 ExecutableActionResult 입니다. |