SystemUtils

public class org.apache.commons.lang3.SystemUtils

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()

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

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

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.

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.

See also:

SystemProperties#getFileEncoding()

Since:

Java 1.2

@Deprecated public static final String FILE_SEPARATOR

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.

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.

See also:

SystemProperties#getFileSeparator()

Since:

Java 1.1

public static final boolean IS_JAVA_10

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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.

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.

See also:

SystemProperties#getJavaAwtFonts()

Since:

2.1

@Deprecated public static final String JAVA_AWT_GRAPHICSENV

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.

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.

See also:

SystemProperties#getJavaAwtGraphicsenv()

Since:

2.1

@Deprecated public static final String JAVA_AWT_HEADLESS

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.

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.

See also:

• #isJavaAwtHeadless()

• SystemProperties#getJavaAwtHeadless()

Since:

Java 1.4

@Deprecated public static final String JAVA_AWT_PRINTERJOB

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.

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.

See also:

SystemProperties#getJavaAwtPrinterjob()

Since:

2.1

public static final String JAVA_CLASS_PATH

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.

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.

See also:

SystemProperties#getJavaClassPath()

Since:

Java 1.1

public static final String JAVA_CLASS_VERSION

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.

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.

See also:

SystemProperties#getJavaClassVersion()

Since:

Java 1.1

@Deprecated public static final String JAVA_COMPILER

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.

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.

See also:

SystemProperties#getJavaCompiler()

Since:

Java 1.2. Not used in Sun versions after 1.2.

@Deprecated public static final String JAVA_ENDORSED_DIRS

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.

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.

See also:

SystemProperties#getJavaEndorsedDirs()

Since:

Java 1.4

@Deprecated public static final String JAVA_EXT_DIRS

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.

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.

See also:

SystemProperties#getJavaExtDirs()

Since:

Java 1.3

public static final String JAVA_HOME

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.

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.

See also:

SystemProperties#getJavaHome()

Since:

Java 1.1

@Deprecated public static final String JAVA_HOME_KEY = "java.home"

Deprecated: Use SystemProperties#JAVA_HOME.

The System property key for the Java home directory.

public static final String JAVA_IO_TMPDIR

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.

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.

See also:

SystemProperties#getJavaIoTmpdir()

Since:

Java 1.2

@Deprecated public static final String JAVA_IO_TMPDIR_KEY = "java.io.tmpdir"

Deprecated: Use SystemProperties#JAVA_IO_TMPDIR.

The System property key for the Java IO temporary directory.

public static final String JAVA_LIBRARY_PATH

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.

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.

See also:

SystemProperties#getJavaLibraryPath()

Since:

Java 1.2

public static final String JAVA_RUNTIME_NAME

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.

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.

See also:

SystemProperties#getJavaRuntimeName()

Since:

Java 1.3

public static final String JAVA_RUNTIME_VERSION

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.

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.

See also:

SystemProperties#getJavaRuntimeVersion()

Since:

Java 1.3

public static final String JAVA_SPECIFICATION_NAME

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.

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.

See also:

SystemProperties#getJavaSpecificationName()

Since:

Java 1.2

public static final String JAVA_SPECIFICATION_VENDOR

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.

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.

See also:

SystemProperties#getJavaSpecificationVendor()

Since:

Java 1.2

public static final String JAVA_SPECIFICATION_VERSION

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.

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.

See also:

SystemProperties#getJavaSpecificationVersion()

Since:

Java 1.3

public static final String JAVA_UTIL_PREFS_PREFERENCES_FACTORY

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.

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.

See also:

SystemProperties#getJavaUtilPrefsPreferencesFactory()

Since:

Java 1.4

public static final String JAVA_VENDOR

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.

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.

See also:

SystemProperties#getJavaVendor()

Since:

Java 1.1

public static final String JAVA_VENDOR_URL

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.

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.

See also:

SystemProperties#getJavaVendorUrl()

Since:

Java 1.1

public static final String JAVA_VERSION

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.

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.

See also:

SystemProperties#getJavaVersion()

Since:

Java 1.1

public static final String JAVA_VM_INFO

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.

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.

See also:

SystemProperties#getJavaVmInfo()

Since:

Java 1.2

public static final String JAVA_VM_NAME

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.

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.

See also:

SystemProperties#getJavaVmName()

Since:

Java 1.2

public static final String JAVA_VM_SPECIFICATION_NAME

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.

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.

See also:

SystemProperties#getJavaVmSpecificationName()

Since:

Java 1.2

public static final String JAVA_VM_SPECIFICATION_VENDOR

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.

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.

See also:

SystemProperties#getJavaVmSpecificationVendor()

Since:

Java 1.2

public static final String JAVA_VM_SPECIFICATION_VERSION

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.

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.

See also:

SystemProperties#getJavaVmSpecificationVersion()

Since:

Java 1.2

public static final String JAVA_VM_VENDOR

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.

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.

See also:

SystemProperties#getJavaVmVendor()

Since:

Java 1.2

public static final String JAVA_VM_VERSION

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.

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.

See also:

SystemProperties#getJavaVmVersion()

Since:

Java 1.2

@Deprecated public static final String LINE_SEPARATOR

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.

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.

See also:

SystemProperties#getLineSeparator()

Since:

Java 1.1

public static final String OS_ARCH

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.

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.

See also:

SystemProperties#getOsArch()

Since:

Java 1.1

public static final String OS_NAME

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.

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.

See also:

SystemProperties#getOsName()

Since:

Java 1.1

public static final String OS_VERSION

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.

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.

See also:

SystemProperties#getOsVersion()

Since:

Java 1.1

@Deprecated public static final String PATH_SEPARATOR

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.

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.

See also:

SystemProperties#getPathSeparator()

Since:

Java 1.1

public static final String USER_COUNTRY

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.

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:

Java 1.2

public static final String USER_DIR

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.

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.

See also:

SystemProperties#getUserDir()

Since:

Java 1.1

@Deprecated public static final String USER_DIR_KEY = "user.dir"

Deprecated: Use SystemProperties#USER_DIR.

The System property key for the user directory.

public static final String USER_HOME

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.

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.

See also:

SystemProperties#getUserHome()

Since:

Java 1.1

public static final String USER_HOME_KEY = "user.home"

The System property key for the user home directory.

public static final String USER_LANGUAGE

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.

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.

See also:

SystemProperties#getUserLanguage()

Since:

Java 1.2

public static final String USER_NAME

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.

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.

See also:

SystemProperties#getUserName()

Since:

Java 1.1

@Deprecated public static final String USER_NAME_KEY = "user.name"

Deprecated: Use SystemProperties#USER_NAME.

The System property key for the user name.

public static final String USER_TIMEZONE

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.

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.

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)

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()

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()

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()

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()

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()

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()

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()

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()

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()

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()

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)

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()

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)

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)

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