Class SystemUtils
- java.lang.Object
-
- org.apache.commons.lang.SystemUtils
-
public class SystemUtils extends java.lang.ObjectHelpers for
java.lang.System.If a system property cannot be read due to security restrictions, the corresponding field in this class will be set to
nulland a message will be written toSystem.err.#ThreadSafe#
- Since:
- 1.0
- Version:
- $Id: SystemUtils.java 1056988 2011-01-09 17:58:53Z niallp $
-
-
Field Summary
Fields Modifier and Type Field Description static java.lang.StringAWT_TOOLKITTheawt.toolkitSystem Property.static java.lang.StringFILE_ENCODINGThefile.encodingSystem Property.static java.lang.StringFILE_SEPARATORThefile.separatorSystem Property.static booleanIS_JAVA_1_1Istrueif this is Java version 1.1 (also 1.1.x versions).static booleanIS_JAVA_1_2Istrueif this is Java version 1.2 (also 1.2.x versions).static booleanIS_JAVA_1_3Istrueif this is Java version 1.3 (also 1.3.x versions).static booleanIS_JAVA_1_4Istrueif this is Java version 1.4 (also 1.4.x versions).static booleanIS_JAVA_1_5Istrueif this is Java version 1.5 (also 1.5.x versions).static booleanIS_JAVA_1_6Istrueif this is Java version 1.6 (also 1.6.x versions).static booleanIS_JAVA_1_7Istrueif this is Java version 1.7 (also 1.7.x versions).static booleanIS_OS_AIXIstrueif this is AIX.static booleanIS_OS_HP_UXIstrueif this is HP-UX.static booleanIS_OS_IRIXIstrueif this is Irix.static booleanIS_OS_LINUXIstrueif this is Linux.static booleanIS_OS_MACIstrueif this is Mac.static booleanIS_OS_MAC_OSXIstrueif this is Mac.static booleanIS_OS_OS2Istrueif this is OS/2.static booleanIS_OS_SOLARISIstrueif this is Solaris.static booleanIS_OS_SUN_OSIstrueif this is SunOS.static booleanIS_OS_UNIXIstrueif this is a UNIX like system, as in any of AIX, HP-UX, Irix, Linux, MacOSX, Solaris or SUN OS.static booleanIS_OS_WINDOWSIstrueif this is Windows.static booleanIS_OS_WINDOWS_2000Istrueif this is Windows 2000.static booleanIS_OS_WINDOWS_7Istrueif this is Windows 7.static booleanIS_OS_WINDOWS_95Istrueif this is Windows 95.static booleanIS_OS_WINDOWS_98Istrueif this is Windows 98.static booleanIS_OS_WINDOWS_MEIstrueif this is Windows ME.static booleanIS_OS_WINDOWS_NTIstrueif this is Windows NT.static booleanIS_OS_WINDOWS_VISTAIstrueif this is Windows Vista.static booleanIS_OS_WINDOWS_XPIstrueif this is Windows XP.static java.lang.StringJAVA_AWT_FONTSThejava.awt.fontsSystem Property.static java.lang.StringJAVA_AWT_GRAPHICSENVThejava.awt.graphicsenvSystem Property.static java.lang.StringJAVA_AWT_HEADLESSThejava.awt.headlessSystem Property.static java.lang.StringJAVA_AWT_PRINTERJOBThejava.awt.printerjobSystem Property.static java.lang.StringJAVA_CLASS_PATHThejava.class.pathSystem Property.static java.lang.StringJAVA_CLASS_VERSIONThejava.class.versionSystem Property.static java.lang.StringJAVA_COMPILERThejava.compilerSystem Property.static java.lang.StringJAVA_ENDORSED_DIRSThejava.endorsed.dirsSystem Property.static java.lang.StringJAVA_EXT_DIRSThejava.ext.dirsSystem Property.static java.lang.StringJAVA_HOMEThejava.homeSystem Property.private static java.lang.StringJAVA_HOME_KEYThe System property key for the Java home directory.static java.lang.StringJAVA_IO_TMPDIRThejava.io.tmpdirSystem Property.private static java.lang.StringJAVA_IO_TMPDIR_KEYThe System property key for the Java IO temporary directory.static java.lang.StringJAVA_LIBRARY_PATHThejava.library.pathSystem Property.static java.lang.StringJAVA_RUNTIME_NAMEThejava.runtime.nameSystem Property.static java.lang.StringJAVA_RUNTIME_VERSIONThejava.runtime.versionSystem Property.static java.lang.StringJAVA_SPECIFICATION_NAMEThejava.specification.nameSystem Property.static java.lang.StringJAVA_SPECIFICATION_VENDORThejava.specification.vendorSystem Property.static java.lang.StringJAVA_SPECIFICATION_VERSIONThejava.specification.versionSystem Property.static java.lang.StringJAVA_UTIL_PREFS_PREFERENCES_FACTORYThejava.util.prefs.PreferencesFactorySystem Property.static java.lang.StringJAVA_VENDORThejava.vendorSystem Property.static java.lang.StringJAVA_VENDOR_URLThejava.vendor.urlSystem Property.static java.lang.StringJAVA_VERSIONThejava.versionSystem Property.static floatJAVA_VERSION_FLOATGets the Java version as afloat.static intJAVA_VERSION_INTGets the Java version as anint.private static intJAVA_VERSION_TRIM_SIZEstatic java.lang.StringJAVA_VERSION_TRIMMEDGets the Java version as aStringtrimming leading letters.static java.lang.StringJAVA_VM_INFOThejava.vm.infoSystem Property.static java.lang.StringJAVA_VM_NAMEThejava.vm.nameSystem Property.static java.lang.StringJAVA_VM_SPECIFICATION_NAMEThejava.vm.specification.nameSystem Property.static java.lang.StringJAVA_VM_SPECIFICATION_VENDORThejava.vm.specification.vendorSystem Property.static java.lang.StringJAVA_VM_SPECIFICATION_VERSIONThejava.vm.specification.versionSystem Property.static java.lang.StringJAVA_VM_VENDORThejava.vm.vendorSystem Property.static java.lang.StringJAVA_VM_VERSIONThejava.vm.versionSystem Property.static java.lang.StringLINE_SEPARATORTheline.separatorSystem Property.static java.lang.StringOS_ARCHTheos.archSystem Property.static java.lang.StringOS_NAMETheos.nameSystem Property.private static java.lang.StringOS_NAME_WINDOWS_PREFIXThe prefix String for all Windows OS.static java.lang.StringOS_VERSIONTheos.versionSystem Property.static java.lang.StringPATH_SEPARATORThepath.separatorSystem Property.static java.lang.StringUSER_COUNTRYTheuser.countryoruser.regionSystem Property.static java.lang.StringUSER_DIRTheuser.dirSystem Property.private static java.lang.StringUSER_DIR_KEYThe System property key for the user directory.static java.lang.StringUSER_HOMETheuser.homeSystem Property.private static java.lang.StringUSER_HOME_KEYThe System property key for the user home directory.static java.lang.StringUSER_LANGUAGETheuser.languageSystem Property.static java.lang.StringUSER_NAMETheuser.nameSystem Property.static java.lang.StringUSER_TIMEZONETheuser.timezoneSystem Property.
-
Constructor Summary
Constructors Constructor Description SystemUtils()SystemUtils instances should NOT be constructed in standard programming.
-
Method Summary
All Methods Static Methods Concrete Methods Deprecated Methods Modifier and Type Method Description static java.io.FilegetJavaHome()Gets the Java home directory as aFile.static java.io.FilegetJavaIoTmpDir()Gets the Java IO temporary directory as aFile.static floatgetJavaVersion()Deprecated.UseJAVA_VERSION_FLOATinstead.private static floatgetJavaVersionAsFloat()Gets the Java version number as afloat.private static intgetJavaVersionAsInt()Gets the Java version number as anint.private static booleangetJavaVersionMatches(java.lang.String versionPrefix)Decides if the Java version matches.private static java.lang.StringgetJavaVersionTrimmed()Trims the text of the java version to start with numbers.private static booleangetOSMatches(java.lang.String osNamePrefix, java.lang.String osVersionPrefix)Decides if the operating system matches.private static booleangetOSMatchesName(java.lang.String osNamePrefix)Decides if the operating system matches.private static java.lang.StringgetSystemProperty(java.lang.String property)Gets a System property, defaulting tonullif the property cannot be read.static java.io.FilegetUserDir()Gets the user directory as aFile.static java.io.FilegetUserHome()Gets the user home directory as aFile.static booleanisJavaAwtHeadless()Returns whether theJAVA_AWT_HEADLESSvalue istrue.static booleanisJavaVersionAtLeast(float requiredVersion)Is the Java version at least the requested version.static booleanisJavaVersionAtLeast(int requiredVersion)Is the Java version at least the requested version.(package private) static booleanisJavaVersionMatch(java.lang.String version, java.lang.String versionPrefix)Decides if the Java version matches.(package private) static booleanisOSMatch(java.lang.String osName, java.lang.String osVersion, java.lang.String osNamePrefix, java.lang.String osVersionPrefix)Decides if the operating system matches.(package private) static booleanisOSNameMatch(java.lang.String osName, java.lang.String osNamePrefix)Decides if the operating system matches.(package private) static floattoJavaVersionFloat(java.lang.String version)Converts the given Java version string to afloat.(package private) static inttoJavaVersionInt(java.lang.String version)Converts the given Java version string to anint.(package private) static int[]toJavaVersionIntArray(java.lang.String version)Converts the given Java version string to anint[]of maximum size3.private static int[]toJavaVersionIntArray(java.lang.String version, int limit)Converts the given Java version string to anint[]of maximum sizelimit.private static floattoVersionFloat(int[] javaVersions)Converts given the Java version array to afloat.private static inttoVersionInt(int[] javaVersions)Converts given the Java version array to anint.
-
-
-
Field Detail
-
JAVA_VERSION_TRIM_SIZE
private static final int JAVA_VERSION_TRIM_SIZE
- See Also:
- Constant Field Values
-
OS_NAME_WINDOWS_PREFIX
private static final java.lang.String OS_NAME_WINDOWS_PREFIX
The prefix String for all Windows OS.- See Also:
- Constant Field Values
-
USER_HOME_KEY
private static final java.lang.String USER_HOME_KEY
The System property key for the user home directory.- See Also:
- Constant Field Values
-
USER_DIR_KEY
private static final java.lang.String USER_DIR_KEY
The System property key for the user directory.- See Also:
- Constant Field Values
-
JAVA_IO_TMPDIR_KEY
private static final java.lang.String JAVA_IO_TMPDIR_KEY
The System property key for the Java IO temporary directory.- See Also:
- Constant Field Values
-
JAVA_HOME_KEY
private static final java.lang.String JAVA_HOME_KEY
The System property key for the Java home directory.- See Also:
- Constant Field Values
-
AWT_TOOLKIT
public static final java.lang.String AWT_TOOLKIT
The
awt.toolkitSystem Property.Holds a class name, on Windows XP this is
sun.awt.windows.WToolkit.On platforms without a GUI, this value is
null.Defaults to
nullif 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)orSystem.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
-
FILE_ENCODING
public static final java.lang.String FILE_ENCODING
The
file.encodingSystem Property.File encoding, such as
Cp1252.Defaults to
nullif 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)orSystem.setProperties(java.util.Properties)is called after this class is loaded, the value will be out of sync with that System property.- Since:
- 2.0, Java 1.2
-
FILE_SEPARATOR
public static final java.lang.String FILE_SEPARATOR
The
file.separatorSystem Property. File separator ("/"on UNIX).Defaults to
nullif 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)orSystem.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.1
-
JAVA_AWT_FONTS
public static final java.lang.String JAVA_AWT_FONTS
The
java.awt.fontsSystem Property.Defaults to
nullif 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)orSystem.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
-
JAVA_AWT_GRAPHICSENV
public static final java.lang.String JAVA_AWT_GRAPHICSENV
The
java.awt.graphicsenvSystem Property.Defaults to
nullif 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)orSystem.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
-
JAVA_AWT_HEADLESS
public static final java.lang.String JAVA_AWT_HEADLESS
The
java.awt.headlessSystem Property. The value of this property is the String"true"or"false".Defaults to
nullif 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)orSystem.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, Java 1.4
- See Also:
isJavaAwtHeadless()
-
JAVA_AWT_PRINTERJOB
public static final java.lang.String JAVA_AWT_PRINTERJOB
The
java.awt.printerjobSystem Property.Defaults to
nullif 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)orSystem.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
-
JAVA_CLASS_PATH
public static final java.lang.String JAVA_CLASS_PATH
The
java.class.pathSystem Property. Java class path.Defaults to
nullif 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)orSystem.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.1
-
JAVA_CLASS_VERSION
public static final java.lang.String JAVA_CLASS_VERSION
The
java.class.versionSystem Property. Java class format version number.Defaults to
nullif 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)orSystem.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.1
-
JAVA_COMPILER
public static final java.lang.String JAVA_COMPILER
The
java.compilerSystem Property. Name of JIT compiler to use. First in JDK version 1.2. Not used in Sun JDKs after 1.2.Defaults to
nullif 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)orSystem.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. Not used in Sun versions after 1.2.
-
JAVA_ENDORSED_DIRS
public static final java.lang.String JAVA_ENDORSED_DIRS
The
java.endorsed.dirsSystem Property. Path of endorsed directory or directories.Defaults to
nullif 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)orSystem.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.4
-
JAVA_EXT_DIRS
public static final java.lang.String JAVA_EXT_DIRS
The
java.ext.dirsSystem Property. Path of extension directory or directories.Defaults to
nullif 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)orSystem.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.3
-
JAVA_HOME
public static final java.lang.String JAVA_HOME
The
java.homeSystem Property. Java installation directory.Defaults to
nullif 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)orSystem.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.1
-
JAVA_IO_TMPDIR
public static final java.lang.String JAVA_IO_TMPDIR
The
java.io.tmpdirSystem Property. Default temp file path.Defaults to
nullif 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)orSystem.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
-
JAVA_LIBRARY_PATH
public static final java.lang.String JAVA_LIBRARY_PATH
The
java.library.pathSystem Property. List of paths to search when loading libraries.Defaults to
nullif 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)orSystem.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
-
JAVA_RUNTIME_NAME
public static final java.lang.String JAVA_RUNTIME_NAME
The
java.runtime.nameSystem Property. Java Runtime Environment name.Defaults to
nullif 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)orSystem.setProperties(java.util.Properties)is called after this class is loaded, the value will be out of sync with that System property.- Since:
- 2.0, Java 1.3
-
JAVA_RUNTIME_VERSION
public static final java.lang.String JAVA_RUNTIME_VERSION
The
java.runtime.versionSystem Property. Java Runtime Environment version.Defaults to
nullif 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)orSystem.setProperties(java.util.Properties)is called after this class is loaded, the value will be out of sync with that System property.- Since:
- 2.0, Java 1.3
-
JAVA_SPECIFICATION_NAME
public static final java.lang.String JAVA_SPECIFICATION_NAME
The
java.specification.nameSystem Property. Java Runtime Environment specification name.Defaults to
nullif 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)orSystem.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
-
JAVA_SPECIFICATION_VENDOR
public static final java.lang.String JAVA_SPECIFICATION_VENDOR
The
java.specification.vendorSystem Property. Java Runtime Environment specification vendor.Defaults to
nullif 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)orSystem.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
-
JAVA_SPECIFICATION_VERSION
public static final java.lang.String JAVA_SPECIFICATION_VERSION
The
java.specification.versionSystem Property. Java Runtime Environment specification version.Defaults to
nullif 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)orSystem.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.3
-
JAVA_UTIL_PREFS_PREFERENCES_FACTORY
public static final java.lang.String JAVA_UTIL_PREFS_PREFERENCES_FACTORY
The
java.util.prefs.PreferencesFactorySystem Property. A class name.Defaults to
nullif 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)orSystem.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, Java 1.4
-
JAVA_VENDOR
public static final java.lang.String JAVA_VENDOR
The
java.vendorSystem Property. Java vendor-specific string.Defaults to
nullif 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)orSystem.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.1
-
JAVA_VENDOR_URL
public static final java.lang.String JAVA_VENDOR_URL
The
java.vendor.urlSystem Property. Java vendor URL.Defaults to
nullif 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)orSystem.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.1
-
JAVA_VERSION
public static final java.lang.String JAVA_VERSION
The
java.versionSystem Property. Java version number.Defaults to
nullif 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)orSystem.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.1
-
JAVA_VM_INFO
public static final java.lang.String JAVA_VM_INFO
The
java.vm.infoSystem Property. Java Virtual Machine implementation info.Defaults to
nullif 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)orSystem.setProperties(java.util.Properties)is called after this class is loaded, the value will be out of sync with that System property.- Since:
- 2.0, Java 1.2
-
JAVA_VM_NAME
public static final java.lang.String JAVA_VM_NAME
The
java.vm.nameSystem Property. Java Virtual Machine implementation name.Defaults to
nullif 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)orSystem.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
-
JAVA_VM_SPECIFICATION_NAME
public static final java.lang.String JAVA_VM_SPECIFICATION_NAME
The
java.vm.specification.nameSystem Property. Java Virtual Machine specification name.Defaults to
nullif 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)orSystem.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
-
JAVA_VM_SPECIFICATION_VENDOR
public static final java.lang.String JAVA_VM_SPECIFICATION_VENDOR
The
java.vm.specification.vendorSystem Property. Java Virtual Machine specification vendor.Defaults to
nullif 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)orSystem.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
-
JAVA_VM_SPECIFICATION_VERSION
public static final java.lang.String JAVA_VM_SPECIFICATION_VERSION
The
java.vm.specification.versionSystem Property. Java Virtual Machine specification version.Defaults to
nullif 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)orSystem.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
-
JAVA_VM_VENDOR
public static final java.lang.String JAVA_VM_VENDOR
The
java.vm.vendorSystem Property. Java Virtual Machine implementation vendor.Defaults to
nullif 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)orSystem.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
-
JAVA_VM_VERSION
public static final java.lang.String JAVA_VM_VERSION
The
java.vm.versionSystem Property. Java Virtual Machine implementation version.Defaults to
nullif 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)orSystem.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
-
LINE_SEPARATOR
public static final java.lang.String LINE_SEPARATOR
The
line.separatorSystem Property. Line separator ("\n"on UNIX).Defaults to
nullif 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)orSystem.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.1
-
OS_ARCH
public static final java.lang.String OS_ARCH
The
os.archSystem Property. Operating system architecture.Defaults to
nullif 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)orSystem.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.1
-
OS_NAME
public static final java.lang.String OS_NAME
The
os.nameSystem Property. Operating system name.Defaults to
nullif 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)orSystem.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.1
-
OS_VERSION
public static final java.lang.String OS_VERSION
The
os.versionSystem Property. Operating system version.Defaults to
nullif 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)orSystem.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.1
-
PATH_SEPARATOR
public static final java.lang.String PATH_SEPARATOR
The
path.separatorSystem Property. Path separator (":"on UNIX).Defaults to
nullif 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)orSystem.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.1
-
USER_COUNTRY
public static final java.lang.String USER_COUNTRY
The
user.countryoruser.regionSystem Property. User's country code, such asGB. First in Java version 1.2 asuser.region. Renamed touser.countryin 1.4Defaults to
nullif 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)orSystem.setProperties(java.util.Properties)is called after this class is loaded, the value will be out of sync with that System property.- Since:
- 2.0, Java 1.2
-
USER_DIR
public static final java.lang.String USER_DIR
The
user.dirSystem Property. User's current working directory.Defaults to
nullif 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)orSystem.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.1
-
USER_HOME
public static final java.lang.String USER_HOME
The
user.homeSystem Property. User's home directory.Defaults to
nullif 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)orSystem.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.1
-
USER_LANGUAGE
public static final java.lang.String USER_LANGUAGE
The
user.languageSystem Property. User's language code, such as"en".Defaults to
nullif 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)orSystem.setProperties(java.util.Properties)is called after this class is loaded, the value will be out of sync with that System property.- Since:
- 2.0, Java 1.2
-
USER_NAME
public static final java.lang.String USER_NAME
The
user.nameSystem Property. User's account name.Defaults to
nullif 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)orSystem.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.1
-
USER_TIMEZONE
public static final java.lang.String USER_TIMEZONE
The
user.timezoneSystem Property. For example:"America/Los_Angeles".Defaults to
nullif 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)orSystem.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
-
JAVA_VERSION_TRIMMED
public static final java.lang.String JAVA_VERSION_TRIMMED
Gets the Java version as a
Stringtrimming leading letters.The field will return
nullifJAVA_VERSIONisnull.- Since:
- 2.1
-
JAVA_VERSION_FLOAT
public static final float JAVA_VERSION_FLOAT
Gets the Java version as a
float.Example return values:
1.2ffor Java 1.21.31ffor Java 1.3.1
The field will return zero if
JAVA_VERSIONisnull.- Since:
- 2.0
-
JAVA_VERSION_INT
public static final int JAVA_VERSION_INT
Gets the Java version as an
int.Example return values:
120for Java 1.2131for Java 1.3.1
The field will return zero if
JAVA_VERSIONisnull.- Since:
- 2.0
-
IS_JAVA_1_1
public static final boolean IS_JAVA_1_1
Is
trueif this is Java version 1.1 (also 1.1.x versions).The field will return
falseifJAVA_VERSIONisnull.
-
IS_JAVA_1_2
public static final boolean IS_JAVA_1_2
Is
trueif this is Java version 1.2 (also 1.2.x versions).The field will return
falseifJAVA_VERSIONisnull.
-
IS_JAVA_1_3
public static final boolean IS_JAVA_1_3
Is
trueif this is Java version 1.3 (also 1.3.x versions).The field will return
falseifJAVA_VERSIONisnull.
-
IS_JAVA_1_4
public static final boolean IS_JAVA_1_4
Is
trueif this is Java version 1.4 (also 1.4.x versions).The field will return
falseifJAVA_VERSIONisnull.
-
IS_JAVA_1_5
public static final boolean IS_JAVA_1_5
Is
trueif this is Java version 1.5 (also 1.5.x versions).The field will return
falseifJAVA_VERSIONisnull.
-
IS_JAVA_1_6
public static final boolean IS_JAVA_1_6
Is
trueif this is Java version 1.6 (also 1.6.x versions).The field will return
falseifJAVA_VERSIONisnull.
-
IS_JAVA_1_7
public static final boolean IS_JAVA_1_7
Is
trueif this is Java version 1.7 (also 1.7.x versions).The field will return
falseifJAVA_VERSIONisnull.- Since:
- 2.5
-
IS_OS_AIX
public static final boolean IS_OS_AIX
Is
trueif this is AIX.The field will return
falseifOS_NAMEisnull.- Since:
- 2.0
-
IS_OS_HP_UX
public static final boolean IS_OS_HP_UX
Is
trueif this is HP-UX.The field will return
falseifOS_NAMEisnull.- Since:
- 2.0
-
IS_OS_IRIX
public static final boolean IS_OS_IRIX
Is
trueif this is Irix.The field will return
falseifOS_NAMEisnull.- Since:
- 2.0
-
IS_OS_LINUX
public static final boolean IS_OS_LINUX
Is
trueif this is Linux.The field will return
falseifOS_NAMEisnull.- Since:
- 2.0
-
IS_OS_MAC
public static final boolean IS_OS_MAC
Is
trueif this is Mac.The field will return
falseifOS_NAMEisnull.- Since:
- 2.0
-
IS_OS_MAC_OSX
public static final boolean IS_OS_MAC_OSX
Is
trueif this is Mac.The field will return
falseifOS_NAMEisnull.- Since:
- 2.0
-
IS_OS_OS2
public static final boolean IS_OS_OS2
Is
trueif this is OS/2.The field will return
falseifOS_NAMEisnull.- Since:
- 2.0
-
IS_OS_SOLARIS
public static final boolean IS_OS_SOLARIS
Is
trueif this is Solaris.The field will return
falseifOS_NAMEisnull.- Since:
- 2.0
-
IS_OS_SUN_OS
public static final boolean IS_OS_SUN_OS
Is
trueif this is SunOS.The field will return
falseifOS_NAMEisnull.- Since:
- 2.0
-
IS_OS_UNIX
public static final boolean IS_OS_UNIX
Is
trueif this is a UNIX like system, as in any of AIX, HP-UX, Irix, Linux, MacOSX, Solaris or SUN OS.The field will return
falseifOS_NAMEisnull.- Since:
- 2.1
-
IS_OS_WINDOWS
public static final boolean IS_OS_WINDOWS
Is
trueif this is Windows.The field will return
falseifOS_NAMEisnull.- Since:
- 2.0
-
IS_OS_WINDOWS_2000
public static final boolean IS_OS_WINDOWS_2000
Is
trueif this is Windows 2000.The field will return
falseifOS_NAMEisnull.- Since:
- 2.0
-
IS_OS_WINDOWS_95
public static final boolean IS_OS_WINDOWS_95
Is
trueif this is Windows 95.The field will return
falseifOS_NAMEisnull.- Since:
- 2.0
-
IS_OS_WINDOWS_98
public static final boolean IS_OS_WINDOWS_98
Is
trueif this is Windows 98.The field will return
falseifOS_NAMEisnull.- Since:
- 2.0
-
IS_OS_WINDOWS_ME
public static final boolean IS_OS_WINDOWS_ME
Is
trueif this is Windows ME.The field will return
falseifOS_NAMEisnull.- Since:
- 2.0
-
IS_OS_WINDOWS_NT
public static final boolean IS_OS_WINDOWS_NT
Is
trueif this is Windows NT.The field will return
falseifOS_NAMEisnull.- Since:
- 2.0
-
IS_OS_WINDOWS_XP
public static final boolean IS_OS_WINDOWS_XP
Is
trueif this is Windows XP.The field will return
falseifOS_NAMEisnull.- Since:
- 2.0
-
IS_OS_WINDOWS_VISTA
public static final boolean IS_OS_WINDOWS_VISTA
Is
trueif this is Windows Vista.The field will return
falseifOS_NAMEisnull.- Since:
- 2.4
-
IS_OS_WINDOWS_7
public static final boolean IS_OS_WINDOWS_7
Is
trueif this is Windows 7.The field will return
falseifOS_NAMEisnull.- Since:
- 2.5
-
-
Method Detail
-
getJavaHome
public static java.io.File getJavaHome()
Gets the Java home directory as a
File.- Returns:
- a directory
- Throws:
java.lang.SecurityException- if a security manager exists and itscheckPropertyAccessmethod doesn't allow access to the specified system property.- Since:
- 2.1
- See Also:
System.getProperty(String)
-
getJavaIoTmpDir
public static java.io.File getJavaIoTmpDir()
Gets the Java IO temporary directory as a
File.- Returns:
- a directory
- Throws:
java.lang.SecurityException- if a security manager exists and itscheckPropertyAccessmethod doesn't allow access to the specified system property.- Since:
- 2.1
- See Also:
System.getProperty(String)
-
getJavaVersion
public static float getJavaVersion()
Deprecated.UseJAVA_VERSION_FLOATinstead. Method will be removed in Commons Lang 3.0.Gets the Java version number as a
float.Example return values:
1.2ffor JDK 1.21.31ffor JDK 1.3.1
- Returns:
- the version, for example 1.31f for JDK 1.3.1
-
getJavaVersionAsFloat
private static float getJavaVersionAsFloat()
Gets the Java version number as a
float.Example return values:
1.2ffor Java 1.21.31ffor Java 1.3.11.6ffor Java 1.6.0_20
Patch releases are not reported.
- Returns:
- the version, for example 1.31f for Java 1.3.1
-
getJavaVersionAsInt
private static int getJavaVersionAsInt()
Gets the Java version number as an
int.Example return values:
120for Java 1.2131for Java 1.3.1160for Java 1.6.0_20
Patch releases are not reported.
- Returns:
- the version, for example 131 for Java 1.3.1
-
getJavaVersionMatches
private static boolean getJavaVersionMatches(java.lang.String versionPrefix)
Decides if the Java version matches.
- Parameters:
versionPrefix- the prefix for the java version- Returns:
- true if matches, or false if not or can't determine
-
getJavaVersionTrimmed
private static java.lang.String getJavaVersionTrimmed()
Trims the text of the java version to start with numbers.- Returns:
- the trimmed java version
-
getOSMatches
private static boolean getOSMatches(java.lang.String osNamePrefix, java.lang.String osVersionPrefix)Decides if the operating system matches.- Parameters:
osNamePrefix- the prefix for the os nameosVersionPrefix- the prefix for the version- Returns:
- true if matches, or false if not or can't determine
-
getOSMatchesName
private static boolean getOSMatchesName(java.lang.String osNamePrefix)
Decides if the operating system matches.- Parameters:
osNamePrefix- the prefix for the os name- Returns:
- true if matches, or false if not or can't determine
-
getSystemProperty
private static java.lang.String getSystemProperty(java.lang.String property)
Gets a System property, defaulting to
nullif the property cannot be read.If a
SecurityExceptionis caught, the return value isnulland a message is written toSystem.err.- Parameters:
property- the system property name- Returns:
- the system property value or
nullif a security problem occurs
-
getUserDir
public static java.io.File getUserDir()
Gets the user directory as a
File.- Returns:
- a directory
- Throws:
java.lang.SecurityException- if a security manager exists and itscheckPropertyAccessmethod doesn't allow access to the specified system property.- Since:
- 2.1
- See Also:
System.getProperty(String)
-
getUserHome
public static java.io.File getUserHome()
Gets the user home directory as a
File.- Returns:
- a directory
- Throws:
java.lang.SecurityException- if a security manager exists and itscheckPropertyAccessmethod doesn't allow access to the specified system property.- Since:
- 2.1
- See Also:
System.getProperty(String)
-
isJavaAwtHeadless
public static boolean isJavaAwtHeadless()
Returns whether theJAVA_AWT_HEADLESSvalue istrue.- Returns:
trueifJAVA_AWT_HEADLESSis"true",falseotherwise.- Since:
- 2.1, Java 1.4
- See Also:
JAVA_AWT_HEADLESS
-
isJavaVersionAtLeast
public static boolean isJavaVersionAtLeast(float requiredVersion)
Is the Java version at least the requested version.
Example input:
1.2fto test for Java 1.21.31fto test for Java 1.3.1
- Parameters:
requiredVersion- the required version, for example 1.31f- Returns:
trueif the actual version is equal or greater than the required version
-
isJavaVersionAtLeast
public static boolean isJavaVersionAtLeast(int requiredVersion)
Is the Java version at least the requested version.
Example input:
120to test for Java 1.2 or greater131to test for Java 1.3.1 or greater
- Parameters:
requiredVersion- the required version, for example 131- Returns:
trueif the actual version is equal or greater than the required version- Since:
- 2.0
-
isJavaVersionMatch
static boolean isJavaVersionMatch(java.lang.String version, java.lang.String versionPrefix)Decides if the Java version matches.
This method is package private instead of private to support unit test invocation.
- Parameters:
version- the actual Java versionversionPrefix- the prefix for the expected Java version- Returns:
- true if matches, or false if not or can't determine
-
isOSMatch
static boolean isOSMatch(java.lang.String osName, java.lang.String osVersion, java.lang.String osNamePrefix, java.lang.String osVersionPrefix)Decides if the operating system matches.This method is package private instead of private to support unit test invocation.
- Parameters:
osName- the actual OS nameosVersion- the actual OS versionosNamePrefix- the prefix for the expected OS nameosVersionPrefix- the prefix for the expected OS version- Returns:
- true if matches, or false if not or can't determine
-
isOSNameMatch
static boolean isOSNameMatch(java.lang.String osName, java.lang.String osNamePrefix)Decides if the operating system matches.This method is package private instead of private to support unit test invocation.
- Parameters:
osName- the actual OS nameosNamePrefix- the prefix for the expected OS name- Returns:
- true if matches, or false if not or can't determine
-
toJavaVersionFloat
static float toJavaVersionFloat(java.lang.String version)
Converts the given Java version string to a
float.Example return values:
1.2ffor Java 1.21.31ffor Java 1.3.11.6ffor Java 1.6.0_20
Patch releases are not reported.
This method is package private instead of private to support unit test invocation.
- Parameters:
version- The string version- Returns:
- the version, for example 1.31f for Java 1.3.1
-
toJavaVersionInt
static int toJavaVersionInt(java.lang.String version)
Converts the given Java version string to an
int.Example return values:
120for Java 1.2131for Java 1.3.1160for Java 1.6.0_20
Patch releases are not reported.
This method is package private instead of private to support unit test invocation.
- Parameters:
version- The string version- Returns:
- the version, for example 131 for Java 1.3.1
-
toJavaVersionIntArray
static int[] toJavaVersionIntArray(java.lang.String version)
Converts the given Java version string to an
int[]of maximum size3.Example return values:
[1, 2, 0]for Java 1.2[1, 3, 1]for Java 1.3.1[1, 5, 0]for Java 1.5.0_21
This method is package private instead of private to support unit test invocation.
- Parameters:
version- The string version- Returns:
- the version, for example [1, 5, 0] for Java 1.5.0_21
-
toJavaVersionIntArray
private static int[] toJavaVersionIntArray(java.lang.String version, int limit)Converts the given Java version string to an
int[]of maximum sizelimit.Example return values:
[1, 2, 0]for Java 1.2[1, 3, 1]for Java 1.3.1[1, 5, 0, 21]for Java 1.5.0_21
- Parameters:
version- The string versionlimit- version limit- Returns:
- the version, for example [1, 5, 0, 21] for Java 1.5.0_21
-
toVersionFloat
private static float toVersionFloat(int[] javaVersions)
Converts given the Java version array to a
float.Example return values:
1.2ffor Java 1.21.31ffor Java 1.3.11.6ffor Java 1.6.0_20
Patch releases are not reported.
- Parameters:
javaVersions- The version numbers- Returns:
- the version, for example 1.31f for Java 1.3.1
-
toVersionInt
private static int toVersionInt(int[] javaVersions)
Converts given the Java version array to an
int.Example return values:
120for Java 1.2131for Java 1.3.1160for Java 1.6.0_20
Patch releases are not reported.
- Parameters:
javaVersions- The version numbers- Returns:
- the version, for example 1.31f for Java 1.3.1
-
-