diff options
Diffstat (limited to 'src/main/java/org/apache/commons/lang3/SystemUtils.java')
| -rw-r--r-- | src/main/java/org/apache/commons/lang3/SystemUtils.java | 492 |
1 files changed, 362 insertions, 130 deletions
diff --git a/src/main/java/org/apache/commons/lang3/SystemUtils.java b/src/main/java/org/apache/commons/lang3/SystemUtils.java index 95c6279de..85a2bb443 100644 --- a/src/main/java/org/apache/commons/lang3/SystemUtils.java +++ b/src/main/java/org/apache/commons/lang3/SystemUtils.java @@ -30,6 +30,7 @@ import java.io.File; * </p> * * @since 1.0 + * @see SystemProperties */ public class SystemUtils { @@ -43,54 +44,6 @@ public class SystemUtils { // These MUST be declared first. Other constants depend on this. /** - * The System property key for the user home directory. - */ - private static final String USER_HOME_KEY = "user.home"; - - /** - * The System property key for the user name. - */ - private static final String USER_NAME_KEY = "user.name"; - - /** - * The System property key for the user directory. - */ - private static final String USER_DIR_KEY = "user.dir"; - - /** - * The System property key for the Java IO temporary directory. - */ - private static final String JAVA_IO_TMPDIR_KEY = "java.io.tmpdir"; - - /** - * The System property key for the Java home directory. - */ - private static final String JAVA_HOME_KEY = "java.home"; - - /** - * The {@code awt.toolkit} System Property. - * - * <p> - * Holds a class name, on Windows XP this is {@code sun.awt.windows.WToolkit}. - * </p> - * <p> - * <b>On platforms without a GUI, this value is {@code null}.</b> - * </p> - * <p> - * Defaults to {@code null} if the runtime does not have security access to read this property or the property does - * not exist. - * </p> - * <p> - * This value is initialized when the class is loaded. If {@link System#setProperty(String,String)} or - * {@link System#setProperties(java.util.Properties)} is called after this class is loaded, the value will be out of - * sync with that System property. - * </p> - * - * @since 2.1 - */ - public static final String AWT_TOOLKIT = getSystemProperty("awt.toolkit"); - - /** * The {@code file.encoding} System Property. * * <p> @@ -106,10 +59,11 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getFileEncoding() * @since 2.0 * @since Java 1.2 */ - public static final String FILE_ENCODING = getSystemProperty("file.encoding"); + public static final String FILE_ENCODING = SystemProperties.getFileEncoding(); /** * The {@code file.separator} System Property. @@ -130,12 +84,13 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getFileSeparator() * @deprecated Use {@link File#separator}, since it is guaranteed to be a * string containing a single character and it does not require a privilege check. * @since Java 1.1 */ @Deprecated - public static final String FILE_SEPARATOR = getSystemProperty("file.separator"); + public static final String FILE_SEPARATOR = SystemProperties.getFileSeparator(); /** * The {@code java.awt.fonts} System Property. @@ -150,9 +105,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaAwtFonts() * @since 2.1 */ - public static final String JAVA_AWT_FONTS = getSystemProperty("java.awt.fonts"); + public static final String JAVA_AWT_FONTS = SystemProperties.getJavaAwtFonts(); /** * The {@code java.awt.graphicsenv} System Property. @@ -167,9 +123,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaAwtGraphicsenv() * @since 2.1 */ - public static final String JAVA_AWT_GRAPHICSENV = getSystemProperty("java.awt.graphicsenv"); + public static final String JAVA_AWT_GRAPHICSENV = SystemProperties.getJavaAwtGraphicsenv(); /** * The {@code java.awt.headless} System Property. The value of this property is the String {@code "true"} or @@ -186,10 +143,11 @@ public class SystemUtils { * </p> * * @see #isJavaAwtHeadless() + * @see SystemProperties#getJavaAwtHeadless() * @since 2.1 * @since Java 1.4 */ - public static final String JAVA_AWT_HEADLESS = getSystemProperty("java.awt.headless"); + public static final String JAVA_AWT_HEADLESS = SystemProperties.getJavaAwtHeadless(); /** * The {@code java.awt.printerjob} System Property. @@ -204,9 +162,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaAwtPrinterjob() * @since 2.1 */ - public static final String JAVA_AWT_PRINTERJOB = getSystemProperty("java.awt.printerjob"); + public static final String JAVA_AWT_PRINTERJOB = SystemProperties.getJavaAwtPrinterjob(); /** * The {@code java.class.path} System Property. Java class path. @@ -221,9 +180,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaClassPath() * @since Java 1.1 */ - public static final String JAVA_CLASS_PATH = getSystemProperty("java.class.path"); + public static final String JAVA_CLASS_PATH = SystemProperties.getJavaClassPath(); /** * The {@code java.class.version} System Property. Java class format version number. @@ -238,9 +198,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaClassVersion() * @since Java 1.1 */ - public static final String JAVA_CLASS_VERSION = getSystemProperty("java.class.version"); + public static final String JAVA_CLASS_VERSION = SystemProperties.getJavaClassVersion(); /** * The {@code java.compiler} System Property. Name of JIT compiler to use. First in JDK version 1.2. Not used in Sun @@ -256,9 +217,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaCompiler() * @since Java 1.2. Not used in Sun versions after 1.2. */ - public static final String JAVA_COMPILER = getSystemProperty("java.compiler"); + public static final String JAVA_COMPILER = SystemProperties.getJavaCompiler(); /** * The {@code java.endorsed.dirs} System Property. Path of endorsed directory or directories. @@ -273,9 +235,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaEndorsedDirs() * @since Java 1.4 */ - public static final String JAVA_ENDORSED_DIRS = getSystemProperty("java.endorsed.dirs"); + public static final String JAVA_ENDORSED_DIRS = SystemProperties.getJavaEndorsedDirs(); /** * The {@code java.ext.dirs} System Property. Path of extension directory or directories. @@ -290,9 +253,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaExtDirs() * @since Java 1.3 */ - public static final String JAVA_EXT_DIRS = getSystemProperty("java.ext.dirs"); + public static final String JAVA_EXT_DIRS = SystemProperties.getJavaExtDirs(); /** * The {@code java.home} System Property. Java installation directory. @@ -307,9 +271,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaHome() * @since Java 1.1 */ - public static final String JAVA_HOME = getSystemProperty(JAVA_HOME_KEY); + public static final String JAVA_HOME = SystemProperties.getJavaHome(); /** * The {@code java.io.tmpdir} System Property. Default temp file path. @@ -324,9 +289,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaIoTmpdir() * @since Java 1.2 */ - public static final String JAVA_IO_TMPDIR = getSystemProperty(JAVA_IO_TMPDIR_KEY); + public static final String JAVA_IO_TMPDIR = SystemProperties.getJavaIoTmpdir(); /** * The {@code java.library.path} System Property. List of paths to search when loading libraries. @@ -341,9 +307,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaLibraryPath() * @since Java 1.2 */ - public static final String JAVA_LIBRARY_PATH = getSystemProperty("java.library.path"); + public static final String JAVA_LIBRARY_PATH = SystemProperties.getJavaLibraryPath(); /** * The {@code java.runtime.name} System Property. Java Runtime Environment name. @@ -358,10 +325,11 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaRuntimeName() * @since 2.0 * @since Java 1.3 */ - public static final String JAVA_RUNTIME_NAME = getSystemProperty("java.runtime.name"); + public static final String JAVA_RUNTIME_NAME = SystemProperties.getJavaRuntimeName(); /** * The {@code java.runtime.version} System Property. Java Runtime Environment version. @@ -376,10 +344,11 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaRuntimeVersion() * @since 2.0 * @since Java 1.3 */ - public static final String JAVA_RUNTIME_VERSION = getSystemProperty("java.runtime.version"); + public static final String JAVA_RUNTIME_VERSION = SystemProperties.getJavaRuntimeVersion(); /** * The {@code java.specification.name} System Property. Java Runtime Environment specification name. @@ -394,9 +363,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaSpecificationName() * @since Java 1.2 */ - public static final String JAVA_SPECIFICATION_NAME = getSystemProperty("java.specification.name"); + public static final String JAVA_SPECIFICATION_NAME = SystemProperties.getJavaSpecificationName(); /** * The {@code java.specification.vendor} System Property. Java Runtime Environment specification vendor. @@ -411,9 +381,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaSpecificationVendor() * @since Java 1.2 */ - public static final String JAVA_SPECIFICATION_VENDOR = getSystemProperty("java.specification.vendor"); + public static final String JAVA_SPECIFICATION_VENDOR = SystemProperties.getJavaSpecificationVendor(); /** * The {@code java.specification.version} System Property. Java Runtime Environment specification version. @@ -428,9 +399,11 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaSpecificationVersion() * @since Java 1.3 */ - public static final String JAVA_SPECIFICATION_VERSION = getSystemProperty("java.specification.version"); + public static final String JAVA_SPECIFICATION_VERSION = SystemProperties.getJavaSpecificationVersion(); + private static final JavaVersion JAVA_SPECIFICATION_VERSION_AS_ENUM = JavaVersion.get(JAVA_SPECIFICATION_VERSION); /** @@ -446,11 +419,11 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaUtilPrefsPreferencesFactory() * @since 2.1 * @since Java 1.4 */ - public static final String JAVA_UTIL_PREFS_PREFERENCES_FACTORY = - getSystemProperty("java.util.prefs.PreferencesFactory"); + public static final String JAVA_UTIL_PREFS_PREFERENCES_FACTORY = SystemProperties.getJavaUtilPrefsPreferencesFactory(); /** * The {@code java.vendor} System Property. Java vendor-specific string. @@ -465,9 +438,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaVersion() * @since Java 1.1 */ - public static final String JAVA_VENDOR = getSystemProperty("java.vendor"); + public static final String JAVA_VENDOR = SystemProperties.getJavaVersion(); /** * The {@code java.vendor.url} System Property. Java vendor URL. @@ -482,9 +456,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaVendorUrl() * @since Java 1.1 */ - public static final String JAVA_VENDOR_URL = getSystemProperty("java.vendor.url"); + public static final String JAVA_VENDOR_URL = SystemProperties.getJavaVendorUrl(); /** * The {@code java.version} System Property. Java version number. @@ -499,9 +474,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaVersion() * @since Java 1.1 */ - public static final String JAVA_VERSION = getSystemProperty("java.version"); + public static final String JAVA_VERSION = SystemProperties.getJavaVersion(); /** * The {@code java.vm.info} System Property. Java Virtual Machine implementation info. @@ -516,10 +492,11 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaVmInfo() * @since 2.0 * @since Java 1.2 */ - public static final String JAVA_VM_INFO = getSystemProperty("java.vm.info"); + public static final String JAVA_VM_INFO = SystemProperties.getJavaVmInfo(); /** * The {@code java.vm.name} System Property. Java Virtual Machine implementation name. @@ -534,9 +511,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaVmName() * @since Java 1.2 */ - public static final String JAVA_VM_NAME = getSystemProperty("java.vm.name"); + public static final String JAVA_VM_NAME = SystemProperties.getJavaVmName(); /** * The {@code java.vm.specification.name} System Property. Java Virtual Machine specification name. @@ -551,9 +529,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaVmSpecificationName() * @since Java 1.2 */ - public static final String JAVA_VM_SPECIFICATION_NAME = getSystemProperty("java.vm.specification.name"); + public static final String JAVA_VM_SPECIFICATION_NAME = SystemProperties.getJavaVmSpecificationName(); /** * The {@code java.vm.specification.vendor} System Property. Java Virtual Machine specification vendor. @@ -568,9 +547,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaVmSpecificationVendor() * @since Java 1.2 */ - public static final String JAVA_VM_SPECIFICATION_VENDOR = getSystemProperty("java.vm.specification.vendor"); + public static final String JAVA_VM_SPECIFICATION_VENDOR = SystemProperties.getJavaVmSpecificationVendor(); /** * The {@code java.vm.specification.version} System Property. Java Virtual Machine specification version. @@ -585,9 +565,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaVmSpecificationVersion() * @since Java 1.2 */ - public static final String JAVA_VM_SPECIFICATION_VERSION = getSystemProperty("java.vm.specification.version"); + public static final String JAVA_VM_SPECIFICATION_VERSION = SystemProperties.getJavaVmSpecificationVersion(); /** * The {@code java.vm.vendor} System Property. Java Virtual Machine implementation vendor. @@ -602,9 +583,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaVmVendor() * @since Java 1.2 */ - public static final String JAVA_VM_VENDOR = getSystemProperty("java.vm.vendor"); + public static final String JAVA_VM_VENDOR = SystemProperties.getJavaVmVendor(); /** * The {@code java.vm.version} System Property. Java Virtual Machine implementation version. @@ -619,9 +601,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getJavaVmVersion() * @since Java 1.2 */ - public static final String JAVA_VM_VERSION = getSystemProperty("java.vm.version"); + public static final String JAVA_VM_VERSION = SystemProperties.getJavaVmVersion(); /** * The {@code line.separator} System Property. Line separator ({@code "\n"} on UNIX). @@ -636,11 +619,12 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getLineSeparator() * @deprecated Use {@link System#lineSeparator()} instead, since it does not require a privilege check. * @since Java 1.1 */ @Deprecated - public static final String LINE_SEPARATOR = getSystemProperty("line.separator"); + public static final String LINE_SEPARATOR = SystemProperties.getLineSeparator(); /** * The {@code os.arch} System Property. Operating system architecture. @@ -655,9 +639,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getOsArch() * @since Java 1.1 */ - public static final String OS_ARCH = getSystemProperty("os.arch"); + public static final String OS_ARCH = SystemProperties.getOsArch(); /** * The {@code os.name} System Property. Operating system name. @@ -672,9 +657,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getOsName() * @since Java 1.1 */ - public static final String OS_NAME = getSystemProperty("os.name"); + public static final String OS_NAME = SystemProperties.getOsName(); /** * The {@code os.version} System Property. Operating system version. @@ -689,9 +675,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getOsVersion() * @since Java 1.1 */ - public static final String OS_VERSION = getSystemProperty("os.version"); + public static final String OS_VERSION = SystemProperties.getOsVersion(); /** * The {@code path.separator} System Property. Path separator ({@code ":"} on UNIX). @@ -706,12 +693,13 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getPathSeparator() * @deprecated Use {@link File#pathSeparator}, since it is guaranteed to be a * string containing a single character and it does not require a privilege check. * @since Java 1.1 */ @Deprecated - public static final String PATH_SEPARATOR = getSystemProperty("path.separator"); + public static final String PATH_SEPARATOR = SystemProperties.getPathSeparator(); /** * The {@code user.country} or {@code user.region} System Property. User's country code, such as {@code "GB"}. First @@ -730,8 +718,8 @@ public class SystemUtils { * @since 2.0 * @since Java 1.2 */ - public static final String USER_COUNTRY = getSystemProperty("user.country") == null ? - getSystemProperty("user.region") : getSystemProperty("user.country"); + public static final String USER_COUNTRY = SystemProperties.getProperty(SystemProperties.USER_COUNTRY, + () -> SystemProperties.getProperty(SystemProperties.USER_REGION)); /** * The {@code user.dir} System Property. User's current working directory. @@ -746,9 +734,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getUserDir() * @since Java 1.1 */ - public static final String USER_DIR = getSystemProperty(USER_DIR_KEY); + public static final String USER_DIR = SystemProperties.getUserDir(); /** * The {@code user.home} System Property. User's home directory. @@ -763,9 +752,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getUserHome() * @since Java 1.1 */ - public static final String USER_HOME = getSystemProperty(USER_HOME_KEY); + public static final String USER_HOME = SystemProperties.getUserHome(); /** * The {@code user.language} System Property. User's language code, such as {@code "en"}. @@ -780,10 +770,11 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getUserLanguage() * @since 2.0 * @since Java 1.2 */ - public static final String USER_LANGUAGE = getSystemProperty("user.language"); + public static final String USER_LANGUAGE = SystemProperties.getUserLanguage(); /** * The {@code user.name} System Property. User's account name. @@ -798,9 +789,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getUserName() * @since Java 1.1 */ - public static final String USER_NAME = getSystemProperty(USER_NAME_KEY); + public static final String USER_NAME = SystemProperties.getUserName(); /** * The {@code user.timezone} System Property. For example: {@code "America/Los_Angeles"}. @@ -815,9 +807,10 @@ public class SystemUtils { * sync with that System property. * </p> * + * @see SystemProperties#getUserTimezone() * @since 2.1 */ - public static final String USER_TIMEZONE = getSystemProperty("user.timezone"); + public static final String USER_TIMEZONE = SystemProperties.getUserTimezone(); // Java version checks // ----------------------------------------------------------------------- @@ -830,6 +823,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@link #JAVA_VERSION} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> */ public static final boolean IS_JAVA_1_1 = getJavaVersionMatches("1.1"); @@ -839,6 +835,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@link #JAVA_VERSION} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> */ public static final boolean IS_JAVA_1_2 = getJavaVersionMatches("1.2"); @@ -848,6 +847,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@link #JAVA_VERSION} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> */ public static final boolean IS_JAVA_1_3 = getJavaVersionMatches("1.3"); @@ -857,6 +859,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@link #JAVA_VERSION} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> */ public static final boolean IS_JAVA_1_4 = getJavaVersionMatches("1.4"); @@ -866,6 +871,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@link #JAVA_VERSION} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> */ public static final boolean IS_JAVA_1_5 = getJavaVersionMatches("1.5"); @@ -875,6 +883,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@link #JAVA_VERSION} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> */ public static final boolean IS_JAVA_1_6 = getJavaVersionMatches("1.6"); @@ -884,6 +895,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@link #JAVA_VERSION} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.0 */ @@ -895,6 +909,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@link #JAVA_VERSION} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.3.2 */ @@ -906,6 +923,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@link #JAVA_VERSION} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.4 * @@ -920,6 +940,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@link #JAVA_VERSION} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.5 */ @@ -931,6 +954,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@link #JAVA_VERSION} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.7 */ @@ -942,6 +968,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@link #JAVA_VERSION} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.8 */ @@ -953,6 +982,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@link #JAVA_VERSION} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.9 */ @@ -964,6 +996,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@link #JAVA_VERSION} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.9 */ @@ -975,6 +1010,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@link #JAVA_VERSION} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.10 */ @@ -986,6 +1024,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@link #JAVA_VERSION} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.10 */ @@ -996,6 +1037,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@link #JAVA_VERSION} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.13.0 */ @@ -1006,6 +1050,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@link #JAVA_VERSION} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.13.0 */ @@ -1016,6 +1063,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@link #JAVA_VERSION} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.13.0 */ @@ -1034,6 +1084,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 2.0 */ @@ -1045,6 +1098,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 2.0 */ @@ -1056,6 +1112,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.3 */ @@ -1067,6 +1126,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 2.0 */ @@ -1078,6 +1140,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 2.0 */ @@ -1089,6 +1154,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 2.0 */ @@ -1100,6 +1168,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 2.0 */ @@ -1111,6 +1182,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.4 */ @@ -1122,6 +1196,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.4 */ @@ -1133,6 +1210,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.4 */ @@ -1144,6 +1224,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.4 */ @@ -1155,6 +1238,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.4 */ @@ -1166,6 +1252,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.4 */ @@ -1177,6 +1266,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.4 */ @@ -1188,6 +1280,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.4 */ @@ -1199,6 +1294,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.4 */ @@ -1210,6 +1308,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.4 */ @@ -1221,6 +1322,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.4 */ @@ -1232,6 +1336,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.5 */ @@ -1243,6 +1350,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.12.0 */ @@ -1254,6 +1364,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.12.0 */ @@ -1265,6 +1378,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.12.0 */ @@ -1276,6 +1392,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.12.0 */ @@ -1287,6 +1406,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.12.0 */ @@ -1298,6 +1420,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.1 */ @@ -1309,6 +1434,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.1 */ @@ -1320,6 +1448,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.1 */ @@ -1331,6 +1462,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 2.0 */ @@ -1342,6 +1476,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 2.0 */ @@ -1353,6 +1490,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 2.0 */ @@ -1364,6 +1504,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 2.1 */ @@ -1376,6 +1519,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 2.0 */ @@ -1387,6 +1533,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 2.0 */ @@ -1398,6 +1547,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.1 */ @@ -1409,6 +1561,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.1 */ @@ -1420,6 +1575,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.4 */ @@ -1431,6 +1589,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 2.0 */ @@ -1442,6 +1603,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 2.0 */ @@ -1453,6 +1617,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 2.0 */ @@ -1464,6 +1631,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 2.0 */ @@ -1475,6 +1645,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 2.0 */ @@ -1486,6 +1659,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 2.4 */ @@ -1497,6 +1673,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.0 */ @@ -1508,6 +1687,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.2 */ @@ -1519,6 +1701,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.5 */ @@ -1537,6 +1722,9 @@ public class SystemUtils { * <li>Affects Java versions 7u321, 8u311, 11.0.13-oracle, 17.0.1: https://bugs.openjdk.org/browse/JDK-8274737</li> * <li>Fixed in OpenJDK commit https://github.com/openjdk/jdk/commit/97ea9dd2f24f9f1fb9b9345a4202a825ee28e014</li> * </ul> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.13.0 */ @@ -1548,6 +1736,9 @@ public class SystemUtils { * <p> * The field will return {@code false} if {@code OS_NAME} is {@code null}. * </p> + * <p> + * This value is initialized when the class is loaded. + * </p> * * @since 3.5 */ @@ -1559,6 +1750,67 @@ public class SystemUtils { public static final boolean IS_OS_ZOS = getOsMatchesName("z/OS"); /** + * The System property key for the user home directory. + */ + public static final String USER_HOME_KEY = "user.home"; + + /** + * The System property key for the user name. + * + * @deprecated Use {@link SystemProperties#USER_NAME}. + */ + @Deprecated + public static final String USER_NAME_KEY = "user.name"; + + /** + * The System property key for the user directory. + * + * @deprecated Use {@link SystemProperties#USER_DIR}. + */ + @Deprecated + public static final String USER_DIR_KEY = "user.dir"; + + /** + * The System property key for the Java IO temporary directory. + * + * @deprecated Use {@link SystemProperties#JAVA_IO_TMPDIR}. + */ + @Deprecated + public static final String JAVA_IO_TMPDIR_KEY = "java.io.tmpdir"; + + /** + * The System property key for the Java home directory. + * + * @deprecated Use {@link SystemProperties#JAVA_HOME}. + */ + @Deprecated + public static final String JAVA_HOME_KEY = "java.home"; + + /** + * The {@code awt.toolkit} System Property. + * + * <p> + * Holds a class name, on Windows XP this is {@code sun.awt.windows.WToolkit}. + * </p> + * <p> + * <b>On platforms without a GUI, this value is {@code null}.</b> + * </p> + * <p> + * Defaults to {@code null} if the runtime does not have security access to read this property or the property does + * not exist. + * </p> + * <p> + * This value is initialized when the class is loaded. If {@link System#setProperty(String,String)} or + * {@link System#setProperties(java.util.Properties)} is called after this class is loaded, the value will be out of + * sync with that System property. + * </p> + * + * @since 2.1 + * @see SystemProperties#getAwtToolkit() + */ + public static final String AWT_TOOLKIT = SystemProperties.getAwtToolkit(); + + /** * Gets an environment variable, defaulting to {@code defaultValue} if the variable cannot be read. * * <p> @@ -1600,29 +1852,29 @@ public class SystemUtils { } /** - * Gets the Java home directory as a {@link File}. + * Gets the current Java home directory as a {@link File}. * * @return a directory * @throws SecurityException if a security manager exists and its {@code checkPropertyAccess} method doesn't allow * access to the specified system property. - * @see System#getProperty(String) + * @see SystemProperties#getJavaHome() * @since 2.1 */ public static File getJavaHome() { - return new File(System.getProperty(JAVA_HOME_KEY)); + return new File(SystemProperties.getJavaHome()); } /** - * Gets the Java IO temporary directory as a {@link File}. + * Gets the current Java IO temporary directory as a {@link File}. * * @return a directory * @throws SecurityException if a security manager exists and its {@code checkPropertyAccess} method doesn't allow * access to the specified system property. - * @see System#getProperty(String) + * @see SystemProperties#getJavaIoTmpdir() * @since 2.1 */ public static File getJavaIoTmpDir() { - return new File(System.getProperty(JAVA_IO_TMPDIR_KEY)); + return new File(SystemProperties.getJavaIoTmpdir()); } /** @@ -1657,64 +1909,44 @@ public class SystemUtils { } /** - * Gets a System property, defaulting to {@code null} if the property cannot be read. - * - * <p> - * If a {@link SecurityException} is caught, the return value is {@code null} and a message is written to - * {@code System.err}. - * </p> - * - * @param property the system property name - * @return the system property value or {@code null} if a security problem occurs - */ - private static String getSystemProperty(final String property) { - try { - return System.getProperty(property); - } catch (final SecurityException ex) { - // we are not allowed to look at this property - // System.err.println("Caught a SecurityException reading the system property '" + property - // + "'; the SystemUtils property value will default to null."); - return null; - } - } - - /** - * Gets the user directory as a {@link File}. + * Gets the current user directory as a {@link File}. * * @return a directory * @throws SecurityException if a security manager exists and its {@code checkPropertyAccess} method doesn't allow * access to the specified system property. - * @see System#getProperty(String) + * @see SystemProperties#getUserDir() * @since 2.1 */ public static File getUserDir() { - return new File(System.getProperty(USER_DIR_KEY)); + return new File(SystemProperties.getUserDir()); } /** - * Gets the user home directory as a {@link File}. + * Gets the current user home directory as a {@link File}. * * @return a directory * @throws SecurityException if a security manager exists and its {@code checkPropertyAccess} method doesn't allow * access to the specified system property. - * @see System#getProperty(String) + * @see SystemProperties#getUserHome() * @since 2.1 */ public static File getUserHome() { - return new File(System.getProperty(USER_HOME_KEY)); + return new File(SystemProperties.getUserHome()); } /** - * Gets the user name. + * Gets the current user name. * * @return a name * @throws SecurityException if a security manager exists and its {@code checkPropertyAccess} method doesn't allow * access to the specified system property. - * @see System#getProperty(String) + * @see SystemProperties#getUserName() * @since 3.10 + * @deprecated Use {@link SystemProperties#getUserName()}. */ + @Deprecated public static String getUserName() { - return System.getProperty(USER_NAME_KEY); + return SystemProperties.getUserName(); } /** @@ -1724,11 +1956,11 @@ public class SystemUtils { * @return a name * @throws SecurityException if a security manager exists and its {@code checkPropertyAccess} method doesn't allow * access to the specified system property. - * @see System#getProperty(String) + * @see SystemProperties#getUserName() * @since 3.10 */ public static String getUserName(final String defaultValue) { - return System.getProperty(USER_NAME_KEY, defaultValue); + return System.getProperty(SystemProperties.USER_NAME, defaultValue); } /** |