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, command)

ERROR(/List) 형식의 명령어 인수를 허용하는 대체 runCmdInBackground(String) 메서드입니다.

abstract Process runCmdInBackground( command)

ERROR(/List) 형식의 명령어 인수를 허용하는 대체 runCmdInBackground(String) 메서드입니다.

abstract Process runCmdInBackground( command, OutputStream output)

ERROR(/OutputStream)를 사용하여 명령어를 실행하면 명령어의 출력이 로깅됩니다.

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, command)

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)

환경 변수를 설정 해제하여 시스템 명령어가 이 환경 변수 없이 실행되도록 합니다.

공개 메서드

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)

작업이 성공할 때까지 여러 번 차단하고 실행합니다. 또한 출력 스트림에서 활동을 모니터링하고 지정된 시간 동안 스트림 활동이 관찰되지 않으면 취소됩니다. idOutputTimeout을 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: 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)

시스템 명령어를 실행하는 도우미 메서드이며, 지정된 시간보다 오래 걸리는 경우 취소됩니다. 또한 출력 스트림에서 활동을 모니터링하고 지정된 시간 동안 스트림 활동이 관찰되지 않으면 취소됩니다. idOutputTimeout을 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: 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 : 시스템 명령어와 exec의 선택적 인수가 포함된 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: 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: 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)

작업을 차단하고 실행합니다. 지정된 시간보다 오래 걸리면 취소됩니다. 또한 출력 스트림에서 활동을 모니터링하고 지정된 시간 동안 스트림 활동이 관찰되지 않으면 취소됩니다. idOutputTimeout을 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보다 작거나 같은 값은 무시됩니다.

UnvVariable을 설정하지 않음

public abstract void unsetEnvVariable (String key)

환경 변수를 설정 해제하여 시스템 명령어가 이 환경 변수 없이 실행되도록 합니다.

매개변수
key String: 변수 이름