SystemUtils¶

public class org.apache.commons.lang3.SystemUtils[source]¶

Helpers for System.

If a system property cannot be read due to security restrictions, the corresponding field in this class will be set to null; the SecurityException is swallowed silently, so a denied read is indistinguishable from an absent property.

#ThreadSafe#

Since:: 1.0
See also:: SystemProperties

Constructors¶

SystemUtils()

SystemUtils instances shouldn’t be constructed in standard programming.

public SystemUtils()[source]¶

SystemUtils instances shouldn’t be constructed in standard programming. Instead, elements should be accessed directly, for example SystemUtils.FILE_SEPARATOR.

This constructor is public to permit tools that require a JavaBean instance to operate.

Fields and constants¶

`AWT_TOOLKIT`	Deprecated. A constant for the System Property `awt.toolkit`.
`FILE_ENCODING`	A constant for the System Property `file.encoding`.
`FILE_SEPARATOR`	Deprecated. A constant for the System Property `file.separator`.
`IS_JAVA_10`	The constant `true` if this is Java version 10 (also 10.x versions).
`IS_JAVA_11`	The constant `true` if this is Java version 11 (also 11.x versions).
`IS_JAVA_12`	The constant `true` if this is Java version 12 (also 12.x versions).
`IS_JAVA_13`	The constant `true` if this is Java version 13 (also 13.x versions).
`IS_JAVA_14`	The constant `true` if this is Java version 14 (also 14.x versions).
`IS_JAVA_15`	The constant `true` if this is Java version 15 (also 15.x versions).
`IS_JAVA_16`	The constant `true` if this is Java version 16 (also 16.x versions).
`IS_JAVA_17`	The constant `true` if this is Java version 17 (also 17.x versions).
`IS_JAVA_18`	The constant `true` if this is Java version 18 (also 18.x versions).
`IS_JAVA_19`	The constant `true` if this is Java version 19 (also 19.x versions).
`IS_JAVA_1_1`	The constant `true` if this is Java version 1.1 (also 1.1.x versions).
`IS_JAVA_1_2`	The constant `true` if this is Java version 1.2 (also 1.2.x versions).
`IS_JAVA_1_3`	The constant `true` if this is Java version 1.3 (also 1.3.x versions).
`IS_JAVA_1_4`	The constant `true` if this is Java version 1.4 (also 1.4.x versions).
`IS_JAVA_1_5`	The constant `true` if this is Java version 1.5 (also 1.5.x versions).
`IS_JAVA_1_6`	The constant `true` if this is Java version 1.6 (also 1.6.x versions).
`IS_JAVA_1_7`	The constant `true` if this is Java version 1.7 (also 1.7.x versions).
`IS_JAVA_1_8`	The constant `true` if this is Java version 1.8 (also 1.8.x versions).
`IS_JAVA_1_9`	Deprecated. The constant `true` if this is Java version 1.9 (also 1.9.x versions).
`IS_JAVA_20`	The constant `true` if this is Java version 20 (also 20.x versions).
`IS_JAVA_21`	The constant `true` if this is Java version 21 (also 21.x versions).
`IS_JAVA_22`	The constant `true` if this is Java version 22 (also 22.x versions).
`IS_JAVA_23`	The constant `true` if this is Java version 23 (also 23.x versions).
`IS_JAVA_24`	The constant `true` if this is Java version 24 (also 24.x versions).
`IS_JAVA_25`	The constant `true` if this is Java version 25 (also 25.x versions).
`IS_JAVA_26`	The constant `true` if this is Java version 26 (also 26.x versions).
`IS_JAVA_27`	The constant `true` if this is Java version 27 (also 27.x versions).
`IS_JAVA_28`	The constant `true` if this is Java version 28 (also 28.x versions).
`IS_JAVA_9`	The constant `true` if this is Java version 9 (also 9.x versions).
`IS_OS_400`	The constant `true` if this is IBM OS/400.
`IS_OS_AIX`	The constant `true` if this is AIX.
`IS_OS_ANDROID`	The constant `true` if this is Android.
`IS_OS_FREE_BSD`	The constant `true` if this is FreeBSD.
`IS_OS_HP_UX`	The constant `true` if this is HP-UX.
`IS_OS_IRIX`	The constant `true` if this is Irix.
`IS_OS_LINUX`	The constant `true` if this is Linux.
`IS_OS_MAC`	The constant `true` if this is Mac.
`IS_OS_MAC_OSX`	The constant `true` if this is Mac.
`IS_OS_MAC_OSX_BIG_SUR`	The constant `true` if this is macOS X Big Sur.
`IS_OS_MAC_OSX_CATALINA`	The constant `true` if this is macOS X Catalina.
`IS_OS_MAC_OSX_CHEETAH`	The constant `true` if this is macOS X Cheetah.
`IS_OS_MAC_OSX_EL_CAPITAN`	The constant `true` if this is macOS X El Capitan.
`IS_OS_MAC_OSX_HIGH_SIERRA`	The constant `true` if this is macOS X High Sierra.
`IS_OS_MAC_OSX_JAGUAR`	The constant `true` if this is macOS X Jaguar.
`IS_OS_MAC_OSX_LEOPARD`	The constant `true` if this is macOS X Leopard.
`IS_OS_MAC_OSX_LION`	The constant `true` if this is macOS X Lion.
`IS_OS_MAC_OSX_MAVERICKS`	The constant `true` if this is macOS X Mavericks.
`IS_OS_MAC_OSX_MOJAVE`	The constant `true` if this is macOS X Mojave.
`IS_OS_MAC_OSX_MONTEREY`	The constant `true` if this is macOS X Monterey.
`IS_OS_MAC_OSX_MOUNTAIN_LION`	The constant `true` if this is macOS X Mountain Lion.
`IS_OS_MAC_OSX_PANTHER`	The constant `true` if this is macOS X Panther.
`IS_OS_MAC_OSX_PUMA`	The constant `true` if this is macOS X Puma.
`IS_OS_MAC_OSX_SEQUOIA`	The constant `true` if this is macOS X Sequoia.
`IS_OS_MAC_OSX_SIERRA`	The constant `true` if this is macOS X Sierra.
`IS_OS_MAC_OSX_SNOW_LEOPARD`	The constant `true` if this is macOS X Snow Leopard.
`IS_OS_MAC_OSX_SONOMA`	The constant `true` if this is macOS X Sonoma.
`IS_OS_MAC_OSX_TIGER`	The constant `true` if this is macOS X Tiger.
`IS_OS_MAC_OSX_VENTURA`	The constant `true` if this is macOS X Ventura.
`IS_OS_MAC_OSX_YOSEMITE`	The constant `true` if this is macOS X Yosemite.
`IS_OS_NETWARE`	The constant `true` if this is Netware.
`IS_OS_NET_BSD`	The constant `true` if this is NetBSD.
`IS_OS_OPEN_BSD`	The constant `true` if this is OpenBSD.
`IS_OS_OS2`	The constant `true` if this is OS/2.
`IS_OS_SOLARIS`	The constant `true` if this is Solaris.
`IS_OS_SUN_OS`	The constant `true` if this is SunOS.
`IS_OS_UNIX`	The constant `true` if this is a Unix like system, as in any of AIX, HP-UX, Irix, Linux, MacOSX, Solaris or SUN OS.
`IS_OS_WINDOWS`	The constant `true` if this is Windows.
`IS_OS_WINDOWS_10`	The constant `true` if this is Windows 10.
`IS_OS_WINDOWS_11`	The constant `true` if this is Windows 11.
`IS_OS_WINDOWS_2000`	The constant `true` if this is Windows 2000.
`IS_OS_WINDOWS_2003`	The constant `true` if this is Windows 2003.
`IS_OS_WINDOWS_2008`	The constant `true` if this is Windows Server 2008.
`IS_OS_WINDOWS_2012`	The constant `true` if this is Windows Server 2012.
`IS_OS_WINDOWS_7`	The constant `true` if this is Windows 7.
`IS_OS_WINDOWS_8`	The constant `true` if this is Windows 8.
`IS_OS_WINDOWS_95`	The constant `true` if this is Windows 95.
`IS_OS_WINDOWS_98`	The constant `true` if this is Windows 98.
`IS_OS_WINDOWS_ME`	The constant `true` if this is Windows ME.
`IS_OS_WINDOWS_NT`	The constant `true` if this is Windows NT.
`IS_OS_WINDOWS_VISTA`	The constant `true` if this is Windows Vista.
`IS_OS_WINDOWS_XP`	The constant `true` if this is Windows XP.
`IS_OS_ZOS`	The constant `true` if this is z/OS.
`JAVA_AWT_FONTS`	Deprecated. A constant for the System Property `java.awt.fonts`.
`JAVA_AWT_GRAPHICSENV`	Deprecated. A constant for the System Property `java.awt.graphicsenv`.
`JAVA_AWT_HEADLESS`	Deprecated. A constant for the System Property `java.awt.headless`.
`JAVA_AWT_PRINTERJOB`	Deprecated. A constant for the System Property `java.awt.printerjob`.
`JAVA_CLASS_PATH`	A constant for the System Property `java.class.path`.
`JAVA_CLASS_VERSION`	A constant for the System Property `java.class.version`.
`JAVA_COMPILER`	Deprecated. A constant for the System Property `java.compiler`.
`JAVA_ENDORSED_DIRS`	Deprecated. A constant for the System Property `java.endorsed.dirs`.
`JAVA_EXT_DIRS`	Deprecated. A constant for the System Property `java.ext.dirs`.
`JAVA_HOME`	A constant for the System Property `java.home`.
`JAVA_HOME_KEY`	Deprecated. The System property key for the Java home directory.
`JAVA_IO_TMPDIR`	A constant for the System Property `java.io.tmpdir`.
`JAVA_IO_TMPDIR_KEY`	Deprecated. The System property key for the Java IO temporary directory.
`JAVA_LIBRARY_PATH`	A constant for the System Property `java.library.path`.
`JAVA_RUNTIME_NAME`	A constant for the System Property `java.runtime.name`.
`JAVA_RUNTIME_VERSION`	A constant for the System Property `java.runtime.version`.
`JAVA_SPECIFICATION_NAME`	A constant for the System Property `java.specification.name`.
`JAVA_SPECIFICATION_VENDOR`	A constant for the System Property `java.specification.vendor`.
`JAVA_SPECIFICATION_VERSION`	A constant for the System Property `java.specification.version`.
`JAVA_UTIL_PREFS_PREFERENCES_FACTORY`	A constant for the System Property `java.util.prefs.PreferencesFactory`.
`JAVA_VENDOR`	A constant for the System Property `java.vendor`.
`JAVA_VENDOR_URL`	A constant for the System Property `java.vendor.url`.
`JAVA_VERSION`	A constant for the System Property `java.version`.
`JAVA_VM_INFO`	A constant for the System Property `java.vm.info`.
`JAVA_VM_NAME`	A constant for the System Property `java.vm.name`.
`JAVA_VM_SPECIFICATION_NAME`	A constant for the System Property `java.vm.specification.name`.
`JAVA_VM_SPECIFICATION_VENDOR`	A constant for the System Property `java.vm.specification.vendor`.
`JAVA_VM_SPECIFICATION_VERSION`	A constant for the System Property `java.vm.specification.version`.
`JAVA_VM_VENDOR`	A constant for the System Property `java.vm.vendor`.
`JAVA_VM_VERSION`	A constant for the System Property `java.vm.version`.
`LINE_SEPARATOR`	Deprecated. A constant for the System Property `line.separator`.
`OS_ARCH`	A constant for the System Property `os.arch`.
`OS_NAME`	A constant for the System Property `os.name`.
`OS_VERSION`	A constant for the System Property `os.version`.
`PATH_SEPARATOR`	Deprecated. A constant for the System Property `path.separator`.
`USER_COUNTRY`	A constant for the System Property `user.country` or `user.region`.
`USER_DIR`	A constant for the System Property `user.dir`.
`USER_DIR_KEY`	Deprecated. The System property key for the user directory.
`USER_HOME`	A constant for the System Property `user.home`.
`USER_HOME_KEY`	The System property key for the user home directory.
`USER_LANGUAGE`	A constant for the System Property `user.language`.
`USER_NAME`	A constant for the System Property `user.name`.
`USER_NAME_KEY`	Deprecated. The System property key for the user name.
`USER_TIMEZONE`	A constant for the System Property `user.timezone`.

@Deprecated public static final String AWT_TOOLKIT[source]¶

Deprecated: Deprecated without replacement.

A constant for the System Property awt.toolkit.

Holds a class name, on Windows XP this is sun.awt.windows.WToolkit.

On platforms without a GUI, this value is null.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

This value is initialized when the class is loaded. If System#setProperty(String,String) or System#setProperties(java.util.Properties) is called after this class is loaded, the value will be out of sync with that System property.

Since:: 2.1
See also:: SystemProperties#getAwtToolkit()

public static final String FILE_ENCODING[source]¶

A constant for the System Property file.encoding.

File encoding, such as Cp1252.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getFileEncoding()
Since:: Java 1.2

@Deprecated public static final String FILE_SEPARATOR[source]¶

Deprecated: Use File#separator, since it is guaranteed to be a string containing a single character and it does not require a privilege check.

A constant for the System Property file.separator.

The file separator is:

"/" on Unix
"\" on Windows.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getFileSeparator()
Since:: Java 1.1

public static final boolean IS_JAVA_10[source]¶

The constant true if this is Java version 10 (also 10.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.7

public static final boolean IS_JAVA_11[source]¶

The constant true if this is Java version 11 (also 11.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.8

public static final boolean IS_JAVA_12[source]¶

The constant true if this is Java version 12 (also 12.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.9

public static final boolean IS_JAVA_13[source]¶

The constant true if this is Java version 13 (also 13.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.9

public static final boolean IS_JAVA_14[source]¶

The constant true if this is Java version 14 (also 14.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.10

public static final boolean IS_JAVA_15[source]¶

The constant true if this is Java version 15 (also 15.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.10

public static final boolean IS_JAVA_16[source]¶

The constant true if this is Java version 16 (also 16.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.13.0

public static final boolean IS_JAVA_17[source]¶

The constant true if this is Java version 17 (also 17.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.13.0

public static final boolean IS_JAVA_18[source]¶

The constant true if this is Java version 18 (also 18.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.13.0

public static final boolean IS_JAVA_19[source]¶

The constant true if this is Java version 19 (also 19.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.13.0

public static final boolean IS_JAVA_1_1[source]¶

The constant true if this is Java version 1.1 (also 1.1.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

public static final boolean IS_JAVA_1_2[source]¶

The constant true if this is Java version 1.2 (also 1.2.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

public static final boolean IS_JAVA_1_3[source]¶

The constant true if this is Java version 1.3 (also 1.3.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

public static final boolean IS_JAVA_1_4[source]¶

The constant true if this is Java version 1.4 (also 1.4.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

public static final boolean IS_JAVA_1_5[source]¶

The constant true if this is Java version 1.5 (also 1.5.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

public static final boolean IS_JAVA_1_6[source]¶

The constant true if this is Java version 1.6 (also 1.6.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

public static final boolean IS_JAVA_1_7[source]¶

The constant true if this is Java version 1.7 (also 1.7.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.0

public static final boolean IS_JAVA_1_8[source]¶

The constant true if this is Java version 1.8 (also 1.8.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.3.2

@Deprecated public static final boolean IS_JAVA_1_9[source]¶

Deprecated: As of release 3.5, replaced by #IS_JAVA_9.

The constant true if this is Java version 1.9 (also 1.9.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.4

public static final boolean IS_JAVA_20[source]¶

The constant true if this is Java version 20 (also 20.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.13.0

public static final boolean IS_JAVA_21[source]¶

The constant true if this is Java version 21 (also 21.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.13.0

public static final boolean IS_JAVA_22[source]¶

The constant true if this is Java version 22 (also 22.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.15.0

public static final boolean IS_JAVA_23[source]¶

The constant true if this is Java version 23 (also 23.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.18.0

public static final boolean IS_JAVA_24[source]¶

The constant true if this is Java version 24 (also 24.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.18.0

public static final boolean IS_JAVA_25[source]¶

The constant true if this is Java version 25 (also 25.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.20.0

public static final boolean IS_JAVA_26[source]¶

The constant true if this is Java version 26 (also 26.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.20.0

public static final boolean IS_JAVA_27[source]¶

The constant true if this is Java version 27 (also 27.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.21.0

public static final boolean IS_JAVA_28[source]¶

The constant true if this is Java version 28 (also 28.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.21.0

public static final boolean IS_JAVA_9[source]¶

The constant true if this is Java version 9 (also 9.x versions).

The result depends on the value of the #JAVA_SPECIFICATION_VERSION constant.

The field will return false if #JAVA_SPECIFICATION_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.5

public static final boolean IS_OS_400[source]¶

The constant true if this is IBM OS/400.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 3.3

public static final boolean IS_OS_AIX[source]¶

The constant true if this is AIX.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 2.0

public static final boolean IS_OS_ANDROID[source]¶

The constant true if this is Android.

See https://developer.android.com/reference/java/lang/System#getProperties().

This value is initialized when the class is loaded.

Since:: 3.15.0

public static final boolean IS_OS_FREE_BSD[source]¶

The constant true if this is FreeBSD.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 3.1

public static final boolean IS_OS_HP_UX[source]¶

The constant true if this is HP-UX.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 2.0

public static final boolean IS_OS_IRIX[source]¶

The constant true if this is Irix.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 2.0

public static final boolean IS_OS_LINUX[source]¶

The constant true if this is Linux.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 2.0

public static final boolean IS_OS_MAC[source]¶

The constant true if this is Mac.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 2.0

public static final boolean IS_OS_MAC_OSX[source]¶

The constant true if this is Mac.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 2.0

public static final boolean IS_OS_MAC_OSX_BIG_SUR[source]¶

The constant true if this is macOS X Big Sur.

The value depends on the value of the #OS_NAME and #OS_VERSION constants.

The value is false if #OS_NAME or #OS_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.12.0

public static final boolean IS_OS_MAC_OSX_CATALINA[source]¶

The constant true if this is macOS X Catalina.

The field will return false if OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 3.12.0

public static final boolean IS_OS_MAC_OSX_CHEETAH[source]¶

The constant true if this is macOS X Cheetah.

The value depends on the value of the #OS_NAME and #OS_VERSION constants.

The value is false if #OS_NAME or #OS_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.4

public static final boolean IS_OS_MAC_OSX_EL_CAPITAN[source]¶

The constant true if this is macOS X El Capitan.

The value depends on the value of the #OS_NAME and #OS_VERSION constants.

The value is false if #OS_NAME or #OS_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.5

public static final boolean IS_OS_MAC_OSX_HIGH_SIERRA[source]¶

The constant true if this is macOS X High Sierra.

The value depends on the value of the #OS_NAME and #OS_VERSION constants.

The value is false if #OS_NAME or #OS_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.12.0

public static final boolean IS_OS_MAC_OSX_JAGUAR[source]¶

The constant true if this is macOS X Jaguar.

The value depends on the value of the #OS_NAME and #OS_VERSION constants.

The value is false if #OS_NAME or #OS_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.4

public static final boolean IS_OS_MAC_OSX_LEOPARD[source]¶

The constant true if this is macOS X Leopard.

The value depends on the value of the #OS_NAME and #OS_VERSION constants.

The value is false if #OS_NAME or #OS_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.4

public static final boolean IS_OS_MAC_OSX_LION[source]¶

The constant true if this is macOS X Lion.

The value depends on the value of the #OS_NAME and #OS_VERSION constants.

The value is false if #OS_NAME or #OS_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.4

public static final boolean IS_OS_MAC_OSX_MAVERICKS[source]¶

The constant true if this is macOS X Mavericks.

The value depends on the value of the #OS_NAME and #OS_VERSION constants.

The value is false if #OS_NAME or #OS_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.4

public static final boolean IS_OS_MAC_OSX_MOJAVE[source]¶

The constant true if this is macOS X Mojave.

The value depends on the value of the #OS_NAME and #OS_VERSION constants.

The value is false if #OS_NAME or #OS_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.12.0

public static final boolean IS_OS_MAC_OSX_MONTEREY[source]¶

The constant true if this is macOS X Monterey.

The value depends on the value of the #OS_NAME and #OS_VERSION constants.

The value is false if #OS_NAME or #OS_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.13.0

public static final boolean IS_OS_MAC_OSX_MOUNTAIN_LION[source]¶

The constant true if this is macOS X Mountain Lion.

The value depends on the value of the #OS_NAME and #OS_VERSION constants.

The value is false if #OS_NAME or #OS_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.4

public static final boolean IS_OS_MAC_OSX_PANTHER[source]¶

The constant true if this is macOS X Panther.

The value depends on the value of the #OS_NAME and #OS_VERSION constants.

The value is false if #OS_NAME or #OS_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.4

public static final boolean IS_OS_MAC_OSX_PUMA[source]¶

The constant true if this is macOS X Puma.

The value depends on the value of the #OS_NAME and #OS_VERSION constants.

The value is false if #OS_NAME or #OS_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.4

public static final boolean IS_OS_MAC_OSX_SEQUOIA[source]¶

The constant true if this is macOS X Sequoia.

The value depends on the value of the #OS_NAME and #OS_VERSION constants.

The value is false if #OS_NAME or #OS_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.18.0

public static final boolean IS_OS_MAC_OSX_SIERRA[source]¶

The constant true if this is macOS X Sierra.

The value depends on the value of the #OS_NAME and #OS_VERSION constants.

The value is false if #OS_NAME or #OS_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.12.0

public static final boolean IS_OS_MAC_OSX_SNOW_LEOPARD[source]¶

The constant true if this is macOS X Snow Leopard.

The value depends on the value of the #OS_NAME and #OS_VERSION constants.

The value is false if #OS_NAME or #OS_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.4

public static final boolean IS_OS_MAC_OSX_SONOMA[source]¶

The constant true if this is macOS X Sonoma.

The value depends on the value of the #OS_NAME and #OS_VERSION constants.

The value is false if #OS_NAME or #OS_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.15.0

public static final boolean IS_OS_MAC_OSX_TIGER[source]¶

The constant true if this is macOS X Tiger.

The value depends on the value of the #OS_NAME and #OS_VERSION constants.

The value is false if #OS_NAME or #OS_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.4

public static final boolean IS_OS_MAC_OSX_VENTURA[source]¶

The constant true if this is macOS X Ventura.

The value depends on the value of the #OS_NAME and #OS_VERSION constants.

The value is false if #OS_NAME or #OS_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.13.0

public static final boolean IS_OS_MAC_OSX_YOSEMITE[source]¶

The constant true if this is macOS X Yosemite.

The value depends on the value of the #OS_NAME and #OS_VERSION constants.

The value is false if #OS_NAME or #OS_VERSION is null.

This value is initialized when the class is loaded.

Since:: 3.4

public static final boolean IS_OS_NETWARE[source]¶

The constant true if this is Netware.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 3.19.0

public static final boolean IS_OS_NET_BSD[source]¶

The constant true if this is NetBSD.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 3.1

public static final boolean IS_OS_OPEN_BSD[source]¶

The constant true if this is OpenBSD.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 3.1

public static final boolean IS_OS_OS2[source]¶

The constant true if this is OS/2.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 2.0

public static final boolean IS_OS_SOLARIS[source]¶

The constant true if this is Solaris.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 2.0

public static final boolean IS_OS_SUN_OS[source]¶

The constant true if this is SunOS.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 2.0

public static final boolean IS_OS_UNIX[source]¶

The constant true if this is a Unix like system, as in any of AIX, HP-UX, Irix, Linux, MacOSX, Solaris or SUN OS.

The field will return false if OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 2.1

public static final boolean IS_OS_WINDOWS[source]¶

The constant true if this is Windows.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 2.0

public static final boolean IS_OS_WINDOWS_10[source]¶

The constant true if this is Windows 10.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 3.5

public static final boolean IS_OS_WINDOWS_11[source]¶

The constant true if this is Windows 11.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

OpenJDK fixed the return value for os.name on Windows 11 to versions 8, 11, and 17:

Affects Java versions 7u321, 8u311, 11.0.13-oracle, 17.0.1: https://bugs.openjdk.org/browse/JDK-8274737
Fixed in OpenJDK commit https://github.com/openjdk/jdk/commit/97ea9dd2f24f9f1fb9b9345a4202a825ee28e014

This value is initialized when the class is loaded.

Since:: 3.13.0

public static final boolean IS_OS_WINDOWS_2000[source]¶

The constant true if this is Windows 2000.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 2.0

public static final boolean IS_OS_WINDOWS_2003[source]¶

The constant true if this is Windows 2003.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 3.1

public static final boolean IS_OS_WINDOWS_2008[source]¶

The constant true if this is Windows Server 2008.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 3.1

public static final boolean IS_OS_WINDOWS_2012[source]¶

The constant true if this is Windows Server 2012.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 3.4

public static final boolean IS_OS_WINDOWS_7[source]¶

The constant true if this is Windows 7.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 3.0

public static final boolean IS_OS_WINDOWS_8[source]¶

The constant true if this is Windows 8.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 3.2

public static final boolean IS_OS_WINDOWS_95[source]¶

The constant true if this is Windows 95.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 2.0

public static final boolean IS_OS_WINDOWS_98[source]¶

The constant true if this is Windows 98.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 2.0

public static final boolean IS_OS_WINDOWS_ME[source]¶

The constant true if this is Windows ME.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 2.0

public static final boolean IS_OS_WINDOWS_NT[source]¶

The constant true if this is Windows NT.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 2.0

public static final boolean IS_OS_WINDOWS_VISTA[source]¶

The constant true if this is Windows Vista.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 2.4

public static final boolean IS_OS_WINDOWS_XP[source]¶

The constant true if this is Windows XP.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 2.0

public static final boolean IS_OS_ZOS[source]¶

The constant true if this is z/OS.

The result depends on the value of the #OS_NAME constant.

The field will return false if #OS_NAME is null.

This value is initialized when the class is loaded.

Since:: 3.5

@Deprecated public static final String JAVA_AWT_FONTS[source]¶

Deprecated: Deprecated without replacement.

A constant for the System Property java.awt.fonts.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaAwtFonts()
Since:: 2.1

@Deprecated public static final String JAVA_AWT_GRAPHICSENV[source]¶

Deprecated: Deprecated without replacement.

A constant for the System Property java.awt.graphicsenv.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaAwtGraphicsenv()
Since:: 2.1

@Deprecated public static final String JAVA_AWT_HEADLESS[source]¶

Deprecated: Deprecated without replacement.

A constant for the System Property java.awt.headless. The value of this property is the String "true" or "false".

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:

Since:

Java 1.4

@Deprecated public static final String JAVA_AWT_PRINTERJOB[source]¶

Deprecated: Deprecated without replacement.

A constant for the System Property java.awt.printerjob.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaAwtPrinterjob()
Since:: 2.1

public static final String JAVA_CLASS_PATH[source]¶

A constant for the System Property java.class.path. Java class path.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaClassPath()
Since:: Java 1.1

public static final String JAVA_CLASS_VERSION[source]¶

A constant for the System Property java.class.version. Java class format version number.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaClassVersion()
Since:: Java 1.1

@Deprecated public static final String JAVA_COMPILER[source]¶

Deprecated: Deprecated without replacement; see https://bugs.openjdk.org/browse/JDK-8305998

A constant for the System Property java.compiler. Name of JIT compiler to use. First in JDK version 1.2. Not used in Sun JDKs after 1.2.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaCompiler()
Since:: Java 1.2. Not used in Sun versions after 1.2.

@Deprecated public static final String JAVA_ENDORSED_DIRS[source]¶

Deprecated: Deprecated without replacement.

A constant for the System Property java.endorsed.dirs. Path of endorsed directory or directories.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaEndorsedDirs()
Since:: Java 1.4

@Deprecated public static final String JAVA_EXT_DIRS[source]¶

Deprecated: Deprecated without replacement.

A constant for the System Property java.ext.dirs. Path of extension directory or directories.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaExtDirs()
Since:: Java 1.3

public static final String JAVA_HOME[source]¶

A constant for the System Property java.home. Java installation directory.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaHome()
Since:: Java 1.1

@Deprecated public static final String JAVA_HOME_KEY = "java.home"[source]¶: Deprecated: Use SystemProperties#JAVA_HOME.

The System property key for the Java home directory.

public static final String JAVA_IO_TMPDIR[source]¶

A constant for the System Property java.io.tmpdir. Default temp file path.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaIoTmpdir()
Since:: Java 1.2

@Deprecated public static final String JAVA_IO_TMPDIR_KEY = "java.io.tmpdir"[source]¶: Deprecated: Use SystemProperties#JAVA_IO_TMPDIR.

The System property key for the Java IO temporary directory.

public static final String JAVA_LIBRARY_PATH[source]¶

A constant for the System Property java.library.path. List of paths to search when loading libraries.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaLibraryPath()
Since:: Java 1.2

public static final String JAVA_RUNTIME_NAME[source]¶

A constant for the System Property java.runtime.name. Java Runtime Environment name.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaRuntimeName()
Since:: Java 1.3

public static final String JAVA_RUNTIME_VERSION[source]¶

A constant for the System Property java.runtime.version. Java Runtime Environment version.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaRuntimeVersion()
Since:: Java 1.3

public static final String JAVA_SPECIFICATION_NAME[source]¶

A constant for the System Property java.specification.name. Java Runtime Environment specification name.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaSpecificationName()
Since:: Java 1.2

public static final String JAVA_SPECIFICATION_VENDOR[source]¶

A constant for the System Property java.specification.vendor. Java Runtime Environment specification vendor.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaSpecificationVendor()
Since:: Java 1.2

public static final String JAVA_SPECIFICATION_VERSION[source]¶

A constant for the System Property java.specification.version. Java Runtime Environment specification version.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaSpecificationVersion()
Since:: Java 1.3

public static final String JAVA_UTIL_PREFS_PREFERENCES_FACTORY[source]¶

A constant for the System Property java.util.prefs.PreferencesFactory. A class name.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaUtilPrefsPreferencesFactory()
Since:: Java 1.4

public static final String JAVA_VENDOR[source]¶

A constant for the System Property java.vendor. Java vendor-specific string.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaVendor()
Since:: Java 1.1

public static final String JAVA_VENDOR_URL[source]¶

A constant for the System Property java.vendor.url. Java vendor URL.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaVendorUrl()
Since:: Java 1.1

public static final String JAVA_VERSION[source]¶

A constant for the System Property java.version. Java version number.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaVersion()
Since:: Java 1.1

public static final String JAVA_VM_INFO[source]¶

A constant for the System Property java.vm.info. Java Virtual Machine implementation info.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaVmInfo()
Since:: Java 1.2

public static final String JAVA_VM_NAME[source]¶

A constant for the System Property java.vm.name. Java Virtual Machine implementation name.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaVmName()
Since:: Java 1.2

public static final String JAVA_VM_SPECIFICATION_NAME[source]¶

A constant for the System Property java.vm.specification.name. Java Virtual Machine specification name.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaVmSpecificationName()
Since:: Java 1.2

public static final String JAVA_VM_SPECIFICATION_VENDOR[source]¶

A constant for the System Property java.vm.specification.vendor. Java Virtual Machine specification vendor.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaVmSpecificationVendor()
Since:: Java 1.2

public static final String JAVA_VM_SPECIFICATION_VERSION[source]¶

A constant for the System Property java.vm.specification.version. Java Virtual Machine specification version.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaVmSpecificationVersion()
Since:: Java 1.2

public static final String JAVA_VM_VENDOR[source]¶

A constant for the System Property java.vm.vendor. Java Virtual Machine implementation vendor.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaVmVendor()
Since:: Java 1.2

public static final String JAVA_VM_VERSION[source]¶

A constant for the System Property java.vm.version. Java Virtual Machine implementation version.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getJavaVmVersion()
Since:: Java 1.2

@Deprecated public static final String LINE_SEPARATOR[source]¶

Deprecated: Use System#lineSeparator() instead, since it does not require a privilege check.

A constant for the System Property line.separator. Line separator ("\n" on Unix).

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getLineSeparator()
Since:: Java 1.1

public static final String OS_ARCH[source]¶

A constant for the System Property os.arch. Operating system architecture.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getOsArch()
Since:: Java 1.1

public static final String OS_NAME[source]¶

A constant for the System Property os.name. Operating system name.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getOsName()
Since:: Java 1.1

public static final String OS_VERSION[source]¶

A constant for the System Property os.version. Operating system version.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getOsVersion()
Since:: Java 1.1

@Deprecated public static final String PATH_SEPARATOR[source]¶

Deprecated: Use File#pathSeparator, since it is guaranteed to be a string containing a single character and it does not require a privilege check.

A constant for the System Property path.separator. Path separator (":" on Unix).

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getPathSeparator()
Since:: Java 1.1

public static final String USER_COUNTRY[source]¶

A constant for the System Property user.country or user.region. User’s country code, such as "GB". First in Java version 1.2 as user.region. Renamed to user.country in 1.4

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

Since:: Java 1.2

public static final String USER_DIR[source]¶

A constant for the System Property user.dir. User’s current working directory.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getUserDir()
Since:: Java 1.1

@Deprecated public static final String USER_DIR_KEY = "user.dir"[source]¶: Deprecated: Use SystemProperties#USER_DIR.

The System property key for the user directory.

public static final String USER_HOME[source]¶

A constant for the System Property user.home. User’s home directory.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getUserHome()
Since:: Java 1.1

public static final String USER_HOME_KEY = "user.home"[source]¶: The System property key for the user home directory.

public static final String USER_LANGUAGE[source]¶

A constant for the System Property user.language. User’s language code, such as "en".

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getUserLanguage()
Since:: Java 1.2

public static final String USER_NAME[source]¶

A constant for the System Property user.name. User’s account name.

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getUserName()
Since:: Java 1.1

@Deprecated public static final String USER_NAME_KEY = "user.name"[source]¶: Deprecated: Use SystemProperties#USER_NAME.

The System property key for the user name.

public static final String USER_TIMEZONE[source]¶

A constant for the System Property user.timezone. For example: "America/Los_Angeles".

Defaults to null if the runtime does not have security access to read this property or the property does not exist.

See also:: SystemProperties#getUserTimezone()
Since:: 2.1

Methods¶

`getEnvironmentVariable(String, String)`	Gets an environment variable, defaulting to `defaultValue` if the variable cannot be read.
`getHostName()`	Gets the host name from an environment variable (`COMPUTERNAME` on Windows, `HOSTNAME` elsewhere).
`getJavaHome()`	Gets the current Java home directory as a `File`.
`getJavaHomePath()`	Gets the current Java home directory as a `File`.
`getJavaIoTmpDir()`	Gets the current Java IO temporary directory as a `File`.
`getJavaIoTmpDirPath()`	Gets the current Java IO temporary directory as a `Path`.
`getUserDir()`	Gets the current user directory as a `File`.
`getUserDirPath()`	Gets the current user directory as a `Path`.
`getUserHome()`	Gets the current user home directory as a `File`.
`getUserHomePath()`	Gets the current user home directory as a `Path`.
`getUserName()`	Deprecated. Gets the current user name.
`getUserName(String)`	Deprecated. Gets the user name.
`isJavaAwtHeadless()`	Deprecated. Tests whether the `#JAVA_AWT_HEADLESS` value is `true`.
`isJavaVersionAtLeast(JavaVersion)`	Tests whether the Java version is at least the requested version.
`isJavaVersionAtMost(JavaVersion)`	Tests whether the Java version is at most the requested version.

public static String getEnvironmentVariable(String name, String defaultValue)[source]¶

Gets an environment variable, defaulting to defaultValue if the variable cannot be read.

If a SecurityException is caught, the return value is defaultValue; the exception is swallowed silently, so a denied read is indistinguishable from an unset variable.

Parameters:

name – The environment variable name.
defaultValue – The default value.

Returns:

The environment variable value or defaultValue if a security problem occurs.

Since:

3.8

public static String getHostName()[source]¶

Gets the host name from an environment variable (COMPUTERNAME on Windows, HOSTNAME elsewhere).

If you want to know what the network stack says is the host name, you should use InetAddress.getLocalHost().getHostName().

Returns:: The host name. Will be null if the environment variable is not defined.
Since:: 3.6

public static File getJavaHome()[source]¶

Gets the current Java home directory as a File.

Returns:: A directory.
Throws:: java.lang.SecurityException – Thrown if a security manager exists and its checkPropertyAccess method doesn’t allow access to the specified system property.
See also:: SystemProperties#getJavaHome()
Since:: 2.1

public static Path getJavaHomePath()[source]¶

Gets the current Java home directory as a File.

Returns:: A directory.
Throws:: java.lang.SecurityException – Thrown if a security manager exists and its checkPropertyAccess method doesn’t allow access to the specified system property.
See also:: SystemProperties#getJavaHome()
Since:: 3.18.0

public static File getJavaIoTmpDir()[source]¶

Gets the current Java IO temporary directory as a File.

Returns:: A directory.
Throws:: java.lang.SecurityException – Thrown if a security manager exists and its checkPropertyAccess method doesn’t allow access to the specified system property.
See also:: SystemProperties#getJavaIoTmpdir()
Since:: 2.1

public static Path getJavaIoTmpDirPath()[source]¶

Gets the current Java IO temporary directory as a Path.

Returns:: A directory.
Throws:: java.lang.SecurityException – Thrown if a security manager exists and its checkPropertyAccess method doesn’t allow access to the specified system property.
See also:: SystemProperties#getJavaIoTmpdir()
Since:: 3.18.0

public static File getUserDir()[source]¶

Gets the current user directory as a File.

The result is based on the system property "user.dir".

Returns:: A directory.
Throws:: java.lang.SecurityException – Thrown if a security manager exists and its checkPropertyAccess method doesn’t allow access to the specified system property.
See also:: SystemProperties#getUserDir()
Since:: 2.1

public static Path getUserDirPath()[source]¶

Gets the current user directory as a Path.

The result is based on the system property "user.dir".

Returns:: A directory.
Throws:: java.lang.SecurityException – Thrown if a security manager exists and its checkPropertyAccess method doesn’t allow access to the specified system property.
See also:: SystemProperties#getUserDir()
Since:: 3.18.0

public static File getUserHome()[source]¶

Gets the current user home directory as a File.

The result is based on the system property "user.home".

Returns:: A directory.
Throws:: java.lang.SecurityException – Thrown if a security manager exists and its checkPropertyAccess method doesn’t allow access to the specified system property.
See also:: SystemProperties#getUserHome()
Since:: 2.1

public static Path getUserHomePath()[source]¶

Gets the current user home directory as a Path.

The result is based on the system property "user.home".

Returns:: A directory.
Throws:: java.lang.SecurityException – Thrown if a security manager exists and its checkPropertyAccess method doesn’t allow access to the specified system property.
See also:: SystemProperties#getUserHome()
Since:: 3.18.0

@Deprecated public static String getUserName()[source]¶

Deprecated: Use SystemProperties#getUserName().

Gets the current user name.

The result is based on the system property "user.name".

Returns:: A name.
Throws:: java.lang.SecurityException – Thrown if a security manager exists and its checkPropertyAccess method doesn’t allow access to the specified system property.
See also:: SystemProperties#getUserName()
Since:: 3.10

@Deprecated public static String getUserName(String defaultValue)[source]¶

Deprecated: Use SystemProperties#getUserName(String).

Gets the user name.

The result is based on the system property "user.name".

Parameters:: defaultValue – A default value.
Returns:: A name.
Throws:: java.lang.SecurityException – Thrown if a security manager exists and its checkPropertyAccess method doesn’t allow access to the specified system property.
See also:: SystemProperties#getUserName()
Since:: 3.10

@Deprecated public static boolean isJavaAwtHeadless()[source]¶

Deprecated: Deprecated without replacement.

Tests whether the #JAVA_AWT_HEADLESS value is true.

The result is based on the system property "java.awt.headless".

Returns:: true if JAVA_AWT_HEADLESS is "true", false otherwise.
See also:: #JAVA_AWT_HEADLESS
Since:: Java 1.4

public static boolean isJavaVersionAtLeast(JavaVersion requiredVersion)[source]¶

Tests whether the Java version is at least the requested version.

The result is based on the system property saved in #JAVA_SPECIFICATION_VERSION.

Parameters:: requiredVersion – The required version, for example 1.31f.
Returns:: true if the actual version is equal or greater than the required version.

public static boolean isJavaVersionAtMost(JavaVersion requiredVersion)[source]¶

Tests whether the Java version is at most the requested version.

The result is based on the system property saved in #JAVA_SPECIFICATION_VERSION.

Parameters:: requiredVersion – The required version, for example 1.31f.
Returns:: true if the actual version is equal or less than the required version.
Since:: 3.9