com.alee.utils

Class SystemUtils

java.lang.Object

com.alee.utils.SystemUtils

public final class SystemUtils
extends Object

This class provides a set of utilities to retrieve various operating system (shortly OS) information.

Author:

Mikle Garin

Method Summary

Modifier and Type	Method and Description
static void	copyToClipboard(String text) Copies text to system clipboard.
static GraphicsDevice	getDefaultScreenDevice() Returns default screen device.
static Rectangle	getDeviceBounds(Component component, boolean applyScreenInsets) Returns screen bounds within which most part of the specified component is placed.
static Rectangle	getDeviceBounds(GraphicsConfiguration gc, boolean applyScreenInsets) Returns screen device bounds.
static Rectangle	getDeviceBounds(GraphicsDevice device, boolean applyScreenInsets) Returns screen device bounds.
static Rectangle	getDeviceBounds(Point location, boolean applyScreenInsets) Returns screen bounds for the specified location.
static Rectangle	getDeviceBounds(Rectangle bounds, boolean applyScreenInsets) Returns screen bounds within which most part of the specified bounds is placed.
static List<Rectangle>	getDevicesBounds(boolean applyScreenInsets) Returns screen device bounds for all screen devices available.
static GraphicsConfiguration	getGraphicsConfiguration() Returns default screen GraphicsConfiguration.
static GraphicsDevice	getGraphicsDevice(Point location) Returns screen device for the specified location.
static GraphicsDevice	getGraphicsDevice(Rectangle bounds) Returns screen device where most part of specified bounds is placed.
static GraphicsDevice	getGraphicsDevice(Window window) Returns screen device for the specified window.
static List<GraphicsDevice>	getGraphicsDevices() Returns list of available screen devices.
static GraphicsEnvironment	getGraphicsEnvironment() Returns default GraphicsEnvironment.
static String	getJavaName() Returns java vm name.
static String	getJavaVendor() Returns java vm vendor.
static JavaVersion	getJavaVersion() Returns java version application is running on.
static String	getJavaVersionString() Returns java version.
static String	getJreArch() Returns JRE architecture.
static String	getJreArchName() Returns JRE architecture name.
static Rectangle	getMaximizedBounds(Frame frame) Returns maximized bounds for the screen where specified frame is displayed.
static Rectangle	getMaximizedEastBounds(Frame frame) Returns maximized bounds for the east half of the screen where specified frame is displayed.
static Rectangle	getMaximizedWestBounds(Frame frame) Returns maximized bounds for the west half of the screen where specified frame is displayed.
static String	getOsArch() Returns OS architecture.
static Icon	getOsIcon() Returns OS icon.
static Icon	getOsIcon(boolean color) Returns colored or grayscale OS icon.
static Icon	getOsIcon(int size) Returns OS icon of specified size if such exists; returns 16x16 icon otherwise.
static Icon	getOsIcon(int size, boolean color) Returns colored or grayscale OS icon of specified size if such exists; returns 16x16 icon otherwise.
static String	getOsName() Returns OS name.
static int	getOsProcessors() Returns the number of processors available to the Java virtual machine.
static String	getOsSite() Returns OS vendor site address.
static SystemType	getOsType() Returns OS type.
static String	getOsVersion() Returns OS version.
static String	getShortOsName() Returns short OS name.
static String	getStringFromClipboard() Returns string clipboard content.
static Cursor	getTransparentCursor() Returns fully transparent cursor.
static boolean	isCapsLock() Returns whether Caps Lock is on or not.
static boolean	isFrameStateSupported(int state) Returns whether or not specified frame state is supported by the OS.
static boolean	isHeadlessEnvironment() Returns whether or not a display, keyboard, and mouse can be supported in this environment.
static boolean	isJava10orAbove() Returns whether application is running on java 10 version and above or not.
static boolean	isJava6orAbove() Returns whether application is running on java 6 version and above or not.
static boolean	isJava7orAbove() Returns whether application is running on java 7 version and above or not.
static boolean	isJava8orAbove() Returns whether application is running on java 8 version and above or not.
static boolean	isJava9orAbove() Returns whether application is running on java 9 version and above or not.
static boolean	isJavaVersionOrAbove(double version) Returns whether application is running on the specified java version and above or not.
static boolean	isJavaVersionOrAbove(double version, int update) Returns whether application is running on the specified java version and above or not.
static boolean	isJavaVersionOrAbove(double major, int minor, int update) Returns whether application is running on the specified java version and above or not.
static boolean	isMac() Returns whether current OS is mac or not.
static boolean	isNumLock() Returns whether Num Lock is on or not.
static boolean	isScrollLock() Returns whether Scroll Lock is on or not.
static boolean	isSolaris() Returns whether current OS is solaris or not.
static boolean	isUnix() Returns whether current OS is unix or not.
static boolean	isWindows() Returns whether current OS is windows or not.

Methods inherited from class java.lang.Object

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

Method Detail

copyToClipboard

public static void copyToClipboard(@Nullable
                                   String text)

Copies text to system clipboard.

Parameters:

text - text to copy into clipboard

getStringFromClipboard

@Nullable
public static String getStringFromClipboard()

Returns string clipboard content.

Returns:

string clipboard content

getJavaVersionString

@NotNull
public static String getJavaVersionString()

Returns java version.

Returns:

java version

getJavaVersion

@NotNull
public static JavaVersion getJavaVersion()

Returns java version application is running on.

Returns:

java version application is running on

isJavaVersionOrAbove

public static boolean isJavaVersionOrAbove(double version)

Returns whether application is running on the specified java version and above or not.

Parameters:

version - version number

Returns:

true if the application is running on the specified java version and above, false otherwise

isJavaVersionOrAbove

public static boolean isJavaVersionOrAbove(double version,
                                           int update)

Returns whether application is running on the specified java version and above or not.

Parameters:

version - version number

update - update number

Returns:

true if the application is running on the specified java version and above, false otherwise

isJavaVersionOrAbove

public static boolean isJavaVersionOrAbove(double major,
                                           int minor,
                                           int update)

Returns whether application is running on the specified java version and above or not.

Parameters:

major - major version

minor - minor version

update - update number

Returns:

true if the application is running on the specified java version and above, false otherwise

isJava6orAbove

public static boolean isJava6orAbove()

Returns whether application is running on java 6 version and above or not.

Returns:

true if the application is running on java 6 version and above, false otherwise

isJava7orAbove

public static boolean isJava7orAbove()

Returns whether application is running on java 7 version and above or not.

Returns:

true if the application is running on java 7 version and above, false otherwise

isJava8orAbove

public static boolean isJava8orAbove()

Returns whether application is running on java 8 version and above or not.

Returns:

true if the application is running on java 8 version and above, false otherwise

isJava9orAbove

public static boolean isJava9orAbove()

Returns whether application is running on java 9 version and above or not.

Returns:

true if the application is running on java 9 version and above, false otherwise

isJava10orAbove

public static boolean isJava10orAbove()

Returns whether application is running on java 10 version and above or not.

Returns:

true if the application is running on java 10 version and above, false otherwise

getJavaName

@NotNull
public static String getJavaName()

Returns java vm name.

Returns:

java vm name

getJavaVendor

@NotNull
public static String getJavaVendor()

Returns java vm vendor.

Returns:

java vm vendor

getOsIcon

@NotNull
public static Icon getOsIcon()

Returns OS icon.

Returns:

OS icon

getOsIcon

@NotNull
public static Icon getOsIcon(boolean color)

Returns colored or grayscale OS icon.

Parameters:

color - whether return colored icon or not

Returns:

OS icon

getOsIcon

@NotNull
public static Icon getOsIcon(int size)

Returns OS icon of specified size if such exists; returns 16x16 icon otherwise.

Parameters:

size - preferred icon size

Returns:

OS icon

getOsIcon

@NotNull
public static Icon getOsIcon(int size,
                                      boolean color)

Returns colored or grayscale OS icon of specified size if such exists; returns 16x16 icon otherwise.

Parameters:

size - preferred icon size

color - whether return colored icon or not

Returns:

OS icon

getOsType

@NotNull
public static SystemType getOsType()

Returns OS type.

Returns:

OS type

isWindows

public static boolean isWindows()

Returns whether current OS is windows or not.

Returns:

true if current OS is windows, false otherwise

isMac

public static boolean isMac()

Returns whether current OS is mac or not.

Returns:

true if current OS is mac, false otherwise

isUnix

public static boolean isUnix()

Returns whether current OS is unix or not.

Returns:

true if current OS is unix, false otherwise

isSolaris

public static boolean isSolaris()

Returns whether current OS is solaris or not.

Returns:

true if current OS is solaris, false otherwise

getOsArch

@NotNull
public static String getOsArch()

Returns OS architecture.

Returns:

OS architecture

getOsName

@NotNull
public static String getOsName()

Returns OS name.

Returns:

OS name

getShortOsName

@NotNull
public static String getShortOsName()

Returns short OS name.

Returns:

short OS name

getOsSite

@NotNull
public static String getOsSite()

Returns OS vendor site address.

Returns:

OS vendor site address

getOsVersion

@NotNull
public static String getOsVersion()

Returns OS version.

Returns:

OS version

getOsProcessors

public static int getOsProcessors()

Returns the number of processors available to the Java virtual machine.

Returns:

number of processors

getJreArch

@NotNull
public static String getJreArch()

Returns JRE architecture.

Returns:

JRE architecture

getJreArchName

@NotNull
public static String getJreArchName()

Returns JRE architecture name.

Returns:

JRE architecture name

isCapsLock

public static boolean isCapsLock()

Returns whether Caps Lock is on or not.

Returns:

true if Caps Lock is on, false otherwise

isNumLock

public static boolean isNumLock()

Returns whether Num Lock is on or not.

Returns:

true if Num Lock is on, false otherwise

isScrollLock

public static boolean isScrollLock()

Returns whether Scroll Lock is on or not.

Returns:

true if Scroll Lock is on, false otherwise

getGraphicsEnvironment

@NotNull
public static GraphicsEnvironment getGraphicsEnvironment()

Returns default GraphicsEnvironment.

Returns:

default GraphicsEnvironment

isHeadlessEnvironment

public static boolean isHeadlessEnvironment()

Returns whether or not a display, keyboard, and mouse can be supported in this environment.

Returns:

true if display, keyboard, and mouse can be supported in this environment, false otherwise

getDefaultScreenDevice

@NotNull
public static GraphicsDevice getDefaultScreenDevice()

Returns default screen device.

Returns:

default screen device

getGraphicsConfiguration

@NotNull
public static GraphicsConfiguration getGraphicsConfiguration()

Returns default screen GraphicsConfiguration.

Returns:

default screen GraphicsConfiguration

getGraphicsDevices

@NotNull
public static List<GraphicsDevice> getGraphicsDevices()

Returns list of available screen devices.

Returns:

list of available screen devices

getGraphicsDevice

@NotNull
public static GraphicsDevice getGraphicsDevice(@Nullable
                                                        Window window)

Returns screen device for the specified window.

Parameters:

window - window to find screen device for

Returns:

screen device for the specified window

getGraphicsDevice

@NotNull
public static GraphicsDevice getGraphicsDevice(@NotNull
                                                        Point location)

Returns screen device for the specified location.

Parameters:

location - location to find screen device for

Returns:

screen device for the specified location

getGraphicsDevice

@NotNull
public static GraphicsDevice getGraphicsDevice(@NotNull
                                                        Rectangle bounds)

Returns screen device where most part of specified bounds is placed.

Parameters:

bounds - bounds to find screen device for

Returns:

screen device where most part of specified bounds is placed

getDeviceBounds

@NotNull
public static Rectangle getDeviceBounds(@Nullable
                                                 GraphicsDevice device,
                                                 boolean applyScreenInsets)

Returns screen device bounds.

Parameters:

device - screen device to return bounds for

applyScreenInsets - whether or not should extract screen insets from graphics device bounds

Returns:

screen device bounds

getDeviceBounds

@NotNull
public static Rectangle getDeviceBounds(@Nullable
                                                 GraphicsConfiguration gc,
                                                 boolean applyScreenInsets)

Returns screen device bounds.

Parameters:

gc - screen device graphics configuration

applyScreenInsets - whether or not should extract screen insets from screen device bounds

Returns:

screen device bounds

getDevicesBounds

@NotNull
public static List<Rectangle> getDevicesBounds(boolean applyScreenInsets)

Returns screen device bounds for all screen devices available.

Parameters:

applyScreenInsets - whether or not should extract screen insets from screen device bounds

Returns:

screen device bounds

getDeviceBounds

@NotNull
public static Rectangle getDeviceBounds(@NotNull
                                                 Point location,
                                                 boolean applyScreenInsets)

Returns screen bounds for the specified location.

Parameters:

location - location to find screen bounds for

applyScreenInsets - whether or not should extract screen insets from graphics device bounds

Returns:

screen bounds for the specified location

getDeviceBounds

@NotNull
public static Rectangle getDeviceBounds(@NotNull
                                                 Rectangle bounds,
                                                 boolean applyScreenInsets)

Returns screen bounds within which most part of the specified bounds is placed.

Parameters:

bounds - bounds to find screen bounds for

applyScreenInsets - whether or not should extract screen insets from graphics device bounds

Returns:

screen bounds within which most part of the specified bounds is placed

getDeviceBounds

@NotNull
public static Rectangle getDeviceBounds(@NotNull
                                                 Component component,
                                                 boolean applyScreenInsets)

Returns screen bounds within which most part of the specified component is placed.

Parameters:

component - component to find screen bounds for

applyScreenInsets - whether or not should extract screen insets from graphics device bounds

Returns:

screen bounds within which most part of the specified component is placed

getMaximizedBounds

@NotNull
public static Rectangle getMaximizedBounds(@NotNull
                                                    Frame frame)

Returns maximized bounds for the screen where specified frame is displayed. Note that we don't need to provide x/y offset of the screen here. It seems that maximized bounds require only bounds inside of the screen bounds, not between the screens overall.

Parameters:

frame - frame to provide maximized bounds for

Returns:

maximized bounds for the screen where specified frame is displayed

getMaximizedWestBounds

@NotNull
public static Rectangle getMaximizedWestBounds(@NotNull
                                                        Frame frame)

Returns maximized bounds for the west half of the screen where specified frame is displayed. Note that we don't need to provide x/y offset of the screen here. It seems that maximized bounds require only bounds inside of the screen bounds, not between the screens overall.

Parameters:

frame - frame to provide maximized bounds for

Returns:

maximized bounds for the west half of the screen where specified frame is displayed

getMaximizedEastBounds

@NotNull
public static Rectangle getMaximizedEastBounds(@NotNull
                                                        Frame frame)

Returns maximized bounds for the east half of the screen where specified frame is displayed. Note that we don't need to provide x/y offset of the screen here. It seems that maximized bounds require only bounds inside of the screen bounds, not between the screens overall.

Parameters:

frame - frame to provide maximized bounds for

Returns:

maximized bounds for the east half of the screen where specified frame is displayed

isFrameStateSupported

public static boolean isFrameStateSupported(int state)

Returns whether or not specified frame state is supported by the OS.

Parameters:

state - frame state

Returns:

true if the specified frame state is supported by the OS, false otherwise

getTransparentCursor

@NotNull
public static Cursor getTransparentCursor()

Returns fully transparent cursor.

Returns:

fully transparent cursor