org.spf4j.base

Class Runtime

java.lang.Object

org.spf4j.base.Runtime

public final class Runtime
extends Object

Author:

zoly

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Runtime.Jmx
static interface	Runtime.ProcOutputHandler Deprecated. use Processhandler
static class	Runtime.Version

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	IS_LITTLE_ENDIAN
static String	JAVA_HOME
static Runtime.Version	JAVA_PLATFORM
static String	JAVA_VERSION
static int	NR_PROCESSORS
static String	OS_NAME
static int	PID Unix PID identifying your process in the OC image it is running.
static String	PROCESS_ID a unique ID for this JVM process.
static String	PROCESS_NAME
static String	TMP_FOLDER
static String	USER_DIR
static String	USER_HOME
static String	USER_NAME
static long	WAIT_FOR_SHUTDOWN_NANOS

Method Summary

Modifier and Type	Method and Description
static void	error(String message)
static void	error(String message, Throwable t)
static boolean	gc(long timeoutMillis) Attempts to run the GC in a verifiable way.
static long	getDeadline() Deprecated. see ExecutionContexts.
static CharSequence	getLsofOutput() Deprecated. use Lsof.getLsofOutput instead.
static Class<?>	getMainClass()
static Thread	getMainThread() get the main Thread.
static int	getNrOpenFiles() Deprecated. use OperatingSystem.getOpenFileDescriptorCount() instead
static void	goDownWithError(SysExits exitCode)
static void	goDownWithError(Throwable t, int exitCode)
static void	goDownWithError(Throwable t, SysExits exitCode)
static boolean	haveJnaPlatform()
static boolean	haveJnaPlatformClib()
static boolean	isMacOsx()
static boolean	isTestFramework()
static boolean	isWindows()
static CharSequence	jrun(Class<?> classWithMain, long timeoutMillis, String... arguments)
static CharSequence	jrun(Class<?> classWithMain, String classPath, long timeoutMillis, String... arguments)
static CharSequence	jrun(Class<?> classWithMain, String classPath, long timeoutMillis, String[] jvmArgs, String... arguments)
static void	jrunAndLog(Class<?> classWithMain, long timeoutMillis, String... arguments)
static void	jrunAndLog(Class<?> classWithMain, String classPath, long timeoutMillis, String... arguments)
static void	jrunAndLog(Class<?> classWithMain, String classPath, long timeoutMillis, String[] jvmArgs, String... arguments)
static int	killProcess(Process proc, long terminateTimeoutMillis, long forceTerminateTimeoutMillis) Deprecated. use OperatingSystem.killProcess.
static long	millisToDeadline() Deprecated. see ExecutionContexts.
static void	queueHook(int priority, Runnable runnable)
static void	queueHookAtBeginning(Runnable runnable)
static void	queueHookAtEnd(Runnable runnable)
static boolean	removeQueuedShutdownHook(Runnable runnable)
static CharSequence	run(String[] command, long timeoutMillis) Deprecated. use OperatingSystem.forkExec.
static int	run(String[] command, Runtime.ProcOutputHandler handler, long timeoutMillis) Deprecated. use OperatingSystem.forkExec instead.
static int	run(String[] command, Runtime.ProcOutputHandler handler, long timeoutMillis, long terminationTimeoutMillis) Deprecated. use OperatingSystem.forkExec instead.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

IS_LITTLE_ENDIAN

public static final boolean IS_LITTLE_ENDIAN

WAIT_FOR_SHUTDOWN_NANOS

public static final long WAIT_FOR_SHUTDOWN_NANOS

TMP_FOLDER

public static final String TMP_FOLDER

JAVA_VERSION

public static final String JAVA_VERSION

USER_NAME

public static final String USER_NAME

USER_DIR

public static final String USER_DIR

USER_HOME

public static final String USER_HOME

JAVA_HOME

public static final String JAVA_HOME

PID

public static final int PID

Unix PID identifying your process in the OC image it is running.

OS_NAME

public static final String OS_NAME

PROCESS_NAME

public static final String PROCESS_NAME

PROCESS_ID

public static final String PROCESS_ID

a unique ID for this JVM process. PID@HOSTNAME:HEXNR

NR_PROCESSORS

public static final int NR_PROCESSORS

JAVA_PLATFORM

public static final Runtime.Version JAVA_PLATFORM

Method Detail

error

public static void error(String message)

error

public static void error(String message,
                         Throwable t)

goDownWithError

public static void goDownWithError(SysExits exitCode)

goDownWithError

public static void goDownWithError(@Nullable
                                   Throwable t,
                                   SysExits exitCode)

goDownWithError

public static void goDownWithError(@Nullable
                                   Throwable t,
                                   int exitCode)

isMacOsx

public static boolean isMacOsx()

isWindows

public static boolean isWindows()

isTestFramework

public static boolean isTestFramework()

haveJnaPlatform

public static boolean haveJnaPlatform()

haveJnaPlatformClib

public static boolean haveJnaPlatformClib()

getNrOpenFiles

@CheckReturnValue
 @Deprecated
public static int getNrOpenFiles()

Deprecated. use OperatingSystem.getOpenFileDescriptorCount() instead

get the number of open files by current java process.

Returns:

-1 if cannot get nr of open files

getLsofOutput

@Nullable
 @CheckReturnValue
 @Deprecated
public static CharSequence getLsofOutput()

Deprecated. use Lsof.getLsofOutput instead.

run

@Deprecated
public static CharSequence run(String[] command,
                                           long timeoutMillis)
                                    throws IOException,
                                           InterruptedException,
                                           ExecutionException,
                                           TimeoutException

Deprecated. use OperatingSystem.forkExec.

Throws:

IOException

InterruptedException

ExecutionException

TimeoutException

killProcess

@Deprecated
public static int killProcess(Process proc,
                                          long terminateTimeoutMillis,
                                          long forceTerminateTimeoutMillis)
                                   throws InterruptedException,
                                          TimeoutException

Deprecated. use OperatingSystem.killProcess.

Throws:

InterruptedException

TimeoutException

run

public static int run(String[] command,
                      Runtime.ProcOutputHandler handler,
                      long timeoutMillis)
               throws IOException,
                      InterruptedException,
                      ExecutionException,
                      TimeoutException

Deprecated. use OperatingSystem.forkExec instead.

Throws:

IOException

InterruptedException

ExecutionException

TimeoutException

run

@Deprecated
public static int run(String[] command,
                                  Runtime.ProcOutputHandler handler,
                                  long timeoutMillis,
                                  long terminationTimeoutMillis)
                           throws IOException,
                                  InterruptedException,
                                  ExecutionException,
                                  TimeoutException

Deprecated. use OperatingSystem.forkExec instead.

Throws:

IOException

InterruptedException

ExecutionException

TimeoutException

queueHookAtBeginning

public static void queueHookAtBeginning(Runnable runnable)

queueHookAtEnd

public static void queueHookAtEnd(Runnable runnable)

queueHook

public static void queueHook(int priority,
                             Runnable runnable)

removeQueuedShutdownHook

public static boolean removeQueuedShutdownHook(Runnable runnable)

getDeadline

@Deprecated
public static long getDeadline()

Deprecated. see ExecutionContexts.

Returns:

returns the deadline as millis since epoch.

millisToDeadline

@Deprecated
public static long millisToDeadline()
                                         throws TimeoutException

Deprecated. see ExecutionContexts.

Returns:

milliseconds until deadline.

Throws:

TimeoutException

gc

public static boolean gc(long timeoutMillis)

Attempts to run the GC in a verifiable way.

Parameters:

timeoutMillis - - timeout for GC attempt

Returns:

true if GC executed for sure, false otherwise, gc might have been executed though, but we cannot be sure.

jrun

public static CharSequence jrun(Class<?> classWithMain,
                                long timeoutMillis,
                                String... arguments)
                         throws IOException,
                                InterruptedException,
                                ExecutionException,
                                TimeoutException

Throws:

IOException

InterruptedException

ExecutionException

TimeoutException

jrun

public static CharSequence jrun(Class<?> classWithMain,
                                String classPath,
                                long timeoutMillis,
                                String... arguments)
                         throws InterruptedException,
                                ExecutionException,
                                TimeoutException,
                                IOException

Throws:

InterruptedException

ExecutionException

TimeoutException

IOException

jrun

public static CharSequence jrun(Class<?> classWithMain,
                                String classPath,
                                long timeoutMillis,
                                String[] jvmArgs,
                                String... arguments)
                         throws InterruptedException,
                                ExecutionException,
                                TimeoutException,
                                IOException

Throws:

InterruptedException

ExecutionException

TimeoutException

IOException

jrunAndLog

public static void jrunAndLog(Class<?> classWithMain,
                              long timeoutMillis,
                              String... arguments)
                       throws IOException,
                              InterruptedException,
                              ExecutionException,
                              TimeoutException

Throws:

IOException

InterruptedException

ExecutionException

TimeoutException

jrunAndLog

public static void jrunAndLog(Class<?> classWithMain,
                              String classPath,
                              long timeoutMillis,
                              String... arguments)
                       throws InterruptedException,
                              ExecutionException,
                              TimeoutException,
                              IOException

Throws:

InterruptedException

ExecutionException

TimeoutException

IOException

jrunAndLog

public static void jrunAndLog(Class<?> classWithMain,
                              String classPath,
                              long timeoutMillis,
                              String[] jvmArgs,
                              String... arguments)
                       throws InterruptedException,
                              ExecutionException,
                              TimeoutException,
                              IOException

Throws:

InterruptedException

ExecutionException

TimeoutException

IOException

getMainThread

@Nullable
public static Thread getMainThread()

get the main Thread.

Returns:

null if there is no main thread (can happen when calling this is a shutdown hook)

getMainClass

@Nullable
public static Class<?> getMainClass()

Returns:

null if main class cannot be found.