de.ipcon.tools

Class OSTools

java.lang.Object

de.ipcon.tools.OSTools

public final class OSTools
extends java.lang.Object

A utility class providing OS-related tools and methods for memory management, desktop integration, and system utilities. This class includes enhanced memory assurance and detection methods for cross-platform compatibility.

Constructor Summary

Constructors

Constructor and Description
OSTools()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	getJVMPid() Retrieves the Process ID (PID) of the current Java Virtual Machine (JVM) instance.
static java.lang.String	getOSName()
static boolean	invokeDesktopAction(java.lang.String action, java.lang.Object arg) Invokes an action on the system's Desktop (if supported) using reflection.
static boolean	isLinux() Checks if the operating system is Linux.
static boolean	isMac() Checks if the operating system is Mac OS.
static boolean	isOtherOS() Checks if the operating system is neither Windows, Linux, nor Mac OS.
static boolean	isWindows() Checks if the operating system is Windows.
static void	sleep(int amount) Deprecated. please use sleepSeconds(int) instead, as it is confusing that the parameter is interpreted as seconds whereas in Thread#sleep it's millis
static void	sleep(int amount, boolean restoreInterruptedState) Deprecated. please use sleepSeconds(int, boolean) instead, as it is confusing that the parameter is interpreted as seconds whereas in Thread#sleep it's millis
static void	sleep(long amount, java.util.concurrent.TimeUnit unit) Pauses the current thread for a specified duration in a given time unit and restores the interrupted state if the thread is interrupted.
static void	sleep(long amount, java.util.concurrent.TimeUnit unit, boolean restoreInterruptedState) Pauses the current thread for a specified duration in a given time unit.
static void	sleepmillis(long milliseconds) Deprecated. please use sleepMilliseconds(long) instead, which is consistent with the camel cased other sleep methods
static void	sleepmillis(long milliseconds, boolean restoreInterruptedState) Deprecated. please use sleepMilliseconds(long, boolean) instead, which is consistent with the camel cased other sleep methods
static void	sleepMilliseconds(long milliseconds) Pauses the current thread for a specified number of milliseconds and restores the interrupted state if the thread is interrupted.
static void	sleepMilliseconds(long milliseconds, boolean restoreInterruptedState) Pauses the current thread for a specified number of milliseconds.
static void	sleepRandom(int minMillisecs, int maxMillisecs) Deprecated. please use sleepRandomMillis(int, int) instead, which reflects what unit the passed parameters should have
static void	sleepRandom(int minMillisecs, int maxMillisecs, boolean restoreInterruptedState) Deprecated. please use sleepRandomMillis(int, int, boolean) instead, which reflects what unit the passed parameters should have
static void	sleepRandomMillis(int minMillisecs, int maxMillisecs) Pauses the current thread for a random duration between specified minimum and maximum values and restores the interrupted state if the thread is interrupted.
static void	sleepRandomMillis(int minMillisecs, int maxMillisecs, boolean restoreInterruptedState) Pauses the current thread for a random duration between specified minimum and maximum values.
static void	sleepRandomUpToMillis(int maxMillisecs) Pauses the current thread for a random duration, up to the specified maximum milliseconds and restores the interrupted state if the thread is interrupted.
static void	sleepRandomUpToMillis(int maxMillisecs, boolean restoreInterruptedState) Pauses the current thread for a random duration, up to the specified maximum milliseconds.
static void	sleepSeconds(int seconds) Pauses the current thread for a specified number of seconds and restores the interrupted state if the thread is interrupted.
static void	sleepSeconds(int seconds, boolean restoreInterruptedState) Pauses the current thread for a specified number of seconds.

Methods inherited from class java.lang.Object

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

Constructor Detail

OSTools

public OSTools()

Method Detail

getJVMPid

public static java.lang.String getJVMPid()

Retrieves the Process ID (PID) of the current Java Virtual Machine (JVM) instance.

Returns:

The PID of the JVM as a string.

getOSName

public static java.lang.String getOSName()

isWindows

public static boolean isWindows()

Checks if the operating system is Windows.

Returns:

true if the OS is Windows, false otherwise.

isLinux

public static boolean isLinux()

Checks if the operating system is Linux.

Returns:

true if the OS is Linux, false otherwise.

isMac

public static boolean isMac()

Checks if the operating system is Mac OS.

Returns:

true if the OS is Mac OS, false otherwise.

isOtherOS

public static boolean isOtherOS()

Checks if the operating system is neither Windows, Linux, nor Mac OS.

Returns:

true if the OS is another type, false otherwise.

invokeDesktopAction

public static boolean invokeDesktopAction(java.lang.String action,
                                          java.lang.Object arg)

Invokes an action on the system's Desktop (if supported) using reflection.

Parameters:

action - The name of the desktop action to invoke (e.g., "browse").

arg - The argument required by the action (e.g., a URI for "browse").

Returns:

true if the action is successfully invoked, false otherwise.

sleepSeconds

public static void sleepSeconds(int seconds)

Pauses the current thread for a specified number of seconds and restores the interrupted state if the thread is interrupted.

Parameters:

seconds - The number of seconds to pause.

sleepSeconds

public static void sleepSeconds(int seconds,
                                boolean restoreInterruptedState)

Pauses the current thread for a specified number of seconds.

Parameters:

seconds - The number of seconds to pause.

restoreInterruptedState - Whether to restore the interrupted state if the thread is interrupted.

sleepMilliseconds

public static void sleepMilliseconds(long milliseconds)

Pauses the current thread for a specified number of milliseconds and restores the interrupted state if the thread is interrupted.

Parameters:

milliseconds - The number of milliseconds to pause.

sleepMilliseconds

public static void sleepMilliseconds(long milliseconds,
                                     boolean restoreInterruptedState)

Pauses the current thread for a specified number of milliseconds.

Parameters:

milliseconds - The number of milliseconds to pause.

restoreInterruptedState - Whether to restore the interrupted state if the thread is interrupted.

sleep

public static void sleep(long amount,
                         java.util.concurrent.TimeUnit unit)

Pauses the current thread for a specified duration in a given time unit and restores the interrupted state if the thread is interrupted.

Parameters:

amount - The amount of time to pause.

unit - The time unit for the duration (e.g., SECONDS, MILLISECONDS).

sleep

public static void sleep(long amount,
                         java.util.concurrent.TimeUnit unit,
                         boolean restoreInterruptedState)

Pauses the current thread for a specified duration in a given time unit.

Parameters:

amount - The amount of time to pause.

unit - The time unit for the duration (e.g., SECONDS, MILLISECONDS).

restoreInterruptedState - Whether to restore the interrupted state if the thread is interrupted.

sleepRandomMillis

public static void sleepRandomMillis(int minMillisecs,
                                     int maxMillisecs)

Pauses the current thread for a random duration between specified minimum and maximum values and restores the interrupted state if the thread is interrupted.

Parameters:

minMillisecs - The minimum duration in milliseconds.

maxMillisecs - The maximum duration in milliseconds.

Throws:

java.lang.IllegalArgumentException - if the minimum value is negative or greater than the maximum value.

sleepRandomMillis

public static void sleepRandomMillis(int minMillisecs,
                                     int maxMillisecs,
                                     boolean restoreInterruptedState)

Pauses the current thread for a random duration between specified minimum and maximum values.

Parameters:

minMillisecs - The minimum duration in milliseconds.

maxMillisecs - The maximum duration in milliseconds.

restoreInterruptedState - Whether to restore the interrupted state if the thread is interrupted.

Throws:

java.lang.IllegalArgumentException - if the minimum value is negative or greater than the maximum value.

sleepRandomUpToMillis

public static void sleepRandomUpToMillis(int maxMillisecs)

Pauses the current thread for a random duration, up to the specified maximum milliseconds and restores the interrupted state if the thread is interrupted.

Parameters:

maxMillisecs - The maximum duration in milliseconds.

Throws:

java.lang.IllegalArgumentException - if the minimum value is negative or greater than the maximum value.

sleepRandomUpToMillis

public static void sleepRandomUpToMillis(int maxMillisecs,
                                         boolean restoreInterruptedState)

Pauses the current thread for a random duration, up to the specified maximum milliseconds.

Parameters:

maxMillisecs - The maximum duration in milliseconds.

restoreInterruptedState - Whether to restore the interrupted state if the thread is interrupted.

Throws:

java.lang.IllegalArgumentException - if the minimum value is negative or greater than the maximum value.

sleep

@Deprecated
public static void sleep(int amount)

Deprecated. please use sleepSeconds(int) instead, as it is confusing that the parameter is interpreted as seconds whereas in Thread#sleep it's millis

Pauses the current thread for the specified number of seconds and restores the interrupted state if the thread is interrupted.

Parameters:

amount - The amount of time to pause in seconds.

sleep

@Deprecated
public static void sleep(int amount,
                                     boolean restoreInterruptedState)

Deprecated. please use sleepSeconds(int, boolean) instead, as it is confusing that the parameter is interpreted as seconds whereas in Thread#sleep it's millis

Pauses the current thread for the specified number of seconds and restores the interrupted state if the thread is interrupted.

Parameters:

amount - The amount of time to pause in seconds.

restoreInterruptedState - Whether to restore the interrupted state if the thread is interrupted.

sleepRandom

@Deprecated
public static void sleepRandom(int minMillisecs,
                                           int maxMillisecs)

Deprecated. please use sleepRandomMillis(int, int) instead, which reflects what unit the passed parameters should have

Pauses the current thread for a random duration between specified minimum and maximum values and restores the interrupted state if the thread is interrupted.

Parameters:

minMillisecs - The minimum duration in milliseconds.

maxMillisecs - The maximum duration in milliseconds.

Throws:

java.lang.IllegalArgumentException - if the minimum value is negative or greater than the maximum value.

sleepRandom

@Deprecated
public static void sleepRandom(int minMillisecs,
                                           int maxMillisecs,
                                           boolean restoreInterruptedState)

Deprecated. please use sleepRandomMillis(int, int, boolean) instead, which reflects what unit the passed parameters should have

Pauses the current thread for a random duration between specified minimum and maximum values.

Parameters:

minMillisecs - The minimum duration in milliseconds.

maxMillisecs - The maximum duration in milliseconds.

restoreInterruptedState - Whether to restore the interrupted state if the thread is interrupted.

Throws:

java.lang.IllegalArgumentException - if the minimum value is negative or greater than the maximum value.

sleepmillis

@Deprecated
public static void sleepmillis(long milliseconds)

Deprecated. please use sleepMilliseconds(long) instead, which is consistent with the camel cased other sleep methods

Pauses the current thread for a specified number of milliseconds and restores the interrupted state if the thread is interrupted.

Parameters:

milliseconds - The number of milliseconds to pause.

sleepmillis

@Deprecated
public static void sleepmillis(long milliseconds,
                                           boolean restoreInterruptedState)

Deprecated. please use sleepMilliseconds(long, boolean) instead, which is consistent with the camel cased other sleep methods

Pauses the current thread for a specified number of milliseconds.

Parameters:

milliseconds - The number of milliseconds to pause.

restoreInterruptedState - Whether to restore the interrupted state if the thread is interrupted.