/* * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright ownership. * The ASF licenses this file to You under the Apache License, Version 2.0 * (the "License"); you may not use this file except in compliance with * the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package org.apache.commons.lang; import java.io.File; /** ** Helpers 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
* *null
* and a message will be written toSystem.err
. ** #ThreadSafe# *
* * @author Apache Software Foundation * @author Based on code from Avalon Excalibur * @author Based on code from Lucene * @author Steve Downey * @author Gary Gregory * @author Michael Becke * @author Tetsuya Kaneuchi * @author Rafal Krupinski * @author Jason Gritman * @since 1.0 * @version $Id: SystemUtils.java 1056988 2011-01-09 17:58:53Z niallp $ */ public class SystemUtils { private static final int JAVA_VERSION_TRIM_SIZE = 3; /** * The prefix String for all Windows OS. */ private static final String OS_NAME_WINDOWS_PREFIX = "Windows"; // System property constants // ----------------------------------------------------------------------- // 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 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
*awt.toolkit
System 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
* *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 {@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. *
* * @since 2.1 */ public static final String AWT_TOOLKIT = getSystemProperty("awt.toolkit"); /** ** The
*file.encoding
System Property. ** 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 {@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. *
* * @since 2.0 * @since Java 1.2 */ public static final String FILE_ENCODING = getSystemProperty("file.encoding"); /** ** The
* *file.separator
System Property. File 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 {@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. *
* * @since Java 1.1 */ public static final String FILE_SEPARATOR = getSystemProperty("file.separator"); /** ** The
* *java.awt.fonts
System Property. ** 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 {@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. *
* * @since 2.1 */ public static final String JAVA_AWT_FONTS = getSystemProperty("java.awt.fonts"); /** ** The
* *java.awt.graphicsenv
System Property. ** 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 {@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. *
* * @since 2.1 */ public static final String JAVA_AWT_GRAPHICSENV = getSystemProperty("java.awt.graphicsenv"); /** ** The
* *java.awt.headless
System Property. * 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 {@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. *
* * @see #isJavaAwtHeadless() * @since 2.1 * @since Java 1.4 */ public static final String JAVA_AWT_HEADLESS = getSystemProperty("java.awt.headless"); /** ** The
* *java.awt.printerjob
System Property. ** 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 {@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. *
* * @since 2.1 */ public static final String JAVA_AWT_PRINTERJOB = getSystemProperty("java.awt.printerjob"); /** ** The
* *java.class.path
System Property. 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 {@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. *
* * @since Java 1.1 */ public static final String JAVA_CLASS_PATH = getSystemProperty("java.class.path"); /** ** The
* *java.class.version
System Property. 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 {@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. *
* * @since Java 1.1 */ public static final String JAVA_CLASS_VERSION = getSystemProperty("java.class.version"); /** ** The
* *java.compiler
System Property. 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 {@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. *
* * @since Java 1.2. Not used in Sun versions after 1.2. */ public static final String JAVA_COMPILER = getSystemProperty("java.compiler"); /** ** The
* *java.endorsed.dirs
System Property. 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 {@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. *
* * @since Java 1.4 */ public static final String JAVA_ENDORSED_DIRS = getSystemProperty("java.endorsed.dirs"); /** ** The
* *java.ext.dirs
System Property. 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 {@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. *
* * @since Java 1.3 */ public static final String JAVA_EXT_DIRS = getSystemProperty("java.ext.dirs"); /** ** The
* *java.home
System Property. 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 {@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. *
* * @since Java 1.1 */ public static final String JAVA_HOME = getSystemProperty(JAVA_HOME_KEY); /** ** The
* *java.io.tmpdir
System Property. 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 {@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. *
* * @since Java 1.2 */ public static final String JAVA_IO_TMPDIR = getSystemProperty(JAVA_IO_TMPDIR_KEY); /** ** The
* *java.library.path
System Property. 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 {@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. *
* * @since Java 1.2 */ public static final String JAVA_LIBRARY_PATH = getSystemProperty("java.library.path"); /** ** The
* *java.runtime.name
System Property. 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 {@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. *
* * @since 2.0 * @since Java 1.3 */ public static final String JAVA_RUNTIME_NAME = getSystemProperty("java.runtime.name"); /** ** The
* *java.runtime.version
System Property. 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 {@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. *
* * @since 2.0 * @since Java 1.3 */ public static final String JAVA_RUNTIME_VERSION = getSystemProperty("java.runtime.version"); /** ** The
* *java.specification.name
System Property. 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 {@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. *
* * @since Java 1.2 */ public static final String JAVA_SPECIFICATION_NAME = getSystemProperty("java.specification.name"); /** ** The
* *java.specification.vendor
System Property. 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 {@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. *
* * @since Java 1.2 */ public static final String JAVA_SPECIFICATION_VENDOR = getSystemProperty("java.specification.vendor"); /** ** The
* *java.specification.version
System Property. 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 {@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. *
* * @since Java 1.3 */ public static final String JAVA_SPECIFICATION_VERSION = getSystemProperty("java.specification.version"); /** ** The
* *java.util.prefs.PreferencesFactory
System Property. 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 {@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. *
* * @since 2.1 * @since Java 1.4 */ public static final String JAVA_UTIL_PREFS_PREFERENCES_FACTORY = getSystemProperty("java.util.prefs.PreferencesFactory"); /** ** The
* *java.vendor
System Property. 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 {@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. *
* * @since Java 1.1 */ public static final String JAVA_VENDOR = getSystemProperty("java.vendor"); /** ** The
* *java.vendor.url
System Property. 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 {@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. *
* * @since Java 1.1 */ public static final String JAVA_VENDOR_URL = getSystemProperty("java.vendor.url"); /** ** The
* *java.version
System Property. 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 {@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. *
* * @since Java 1.1 */ public static final String JAVA_VERSION = getSystemProperty("java.version"); /** ** The
* *java.vm.info
System Property. 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 {@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. *
* * @since 2.0 * @since Java 1.2 */ public static final String JAVA_VM_INFO = getSystemProperty("java.vm.info"); /** ** The
* *java.vm.name
System Property. 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 {@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. *
* * @since Java 1.2 */ public static final String JAVA_VM_NAME = getSystemProperty("java.vm.name"); /** ** The
* *java.vm.specification.name
System Property. 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 {@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. *
* * @since Java 1.2 */ public static final String JAVA_VM_SPECIFICATION_NAME = getSystemProperty("java.vm.specification.name"); /** ** The
* *java.vm.specification.vendor
System Property. 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 {@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. *
* * @since Java 1.2 */ public static final String JAVA_VM_SPECIFICATION_VENDOR = getSystemProperty("java.vm.specification.vendor"); /** ** The
* *java.vm.specification.version
System Property. 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 {@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. *
* * @since Java 1.2 */ public static final String JAVA_VM_SPECIFICATION_VERSION = getSystemProperty("java.vm.specification.version"); /** ** The
* *java.vm.vendor
System Property. 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 {@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. *
* * @since Java 1.2 */ public static final String JAVA_VM_VENDOR = getSystemProperty("java.vm.vendor"); /** ** The
* *java.vm.version
System Property. 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 {@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. *
* * @since Java 1.2 */ public static final String JAVA_VM_VERSION = getSystemProperty("java.vm.version"); /** ** The
* *line.separator
System Property. 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 {@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. *
* * @since Java 1.1 */ public static final String LINE_SEPARATOR = getSystemProperty("line.separator"); /** ** The
* *os.arch
System Property. 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 {@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. *
* * @since Java 1.1 */ public static final String OS_ARCH = getSystemProperty("os.arch"); /** ** The
* *os.name
System Property. 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 {@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. *
* * @since Java 1.1 */ public static final String OS_NAME = getSystemProperty("os.name"); /** ** The
* *os.version
System Property. 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 {@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. *
* * @since Java 1.1 */ public static final String OS_VERSION = getSystemProperty("os.version"); /** ** The
* *path.separator
System Property. 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 {@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. *
* * @since Java 1.1 */ public static final String PATH_SEPARATOR = getSystemProperty("path.separator"); /** ** The
* *user.country
oruser.region
System Property. * User's country code, such asGB
. First in * Java version 1.2 asuser.region
. Renamed touser.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 {@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. *
* * @since 2.0 * @since Java 1.2 */ public static final String USER_COUNTRY = getSystemProperty("user.country") == null ? getSystemProperty("user.region") : getSystemProperty("user.country"); /** ** The
* *user.dir
System Property. 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 {@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. *
* * @since Java 1.1 */ public static final String USER_DIR = getSystemProperty(USER_DIR_KEY); /** ** The
* *user.home
System Property. 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 {@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. *
* * @since Java 1.1 */ public static final String USER_HOME = getSystemProperty(USER_HOME_KEY); /** ** The
* *user.language
System Property. 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 {@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. *
* * @since 2.0 * @since Java 1.2 */ public static final String USER_LANGUAGE = getSystemProperty("user.language"); /** ** The
* *user.name
System Property. 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 {@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. *
* * @since Java 1.1 */ public static final String USER_NAME = getSystemProperty("user.name"); /** ** The
* *user.timezone
System Property. 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 {@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. *
* * @since 2.1 */ public static final String USER_TIMEZONE = getSystemProperty("user.timezone"); // Java version // ----------------------------------------------------------------------- // This MUST be declared after those above as it depends on the // values being set up /** ** Gets the Java version as a
* *String
trimming leading letters. ** The field will return
* * @since 2.1 */ public static final String JAVA_VERSION_TRIMMED = getJavaVersionTrimmed(); // Java version values // ----------------------------------------------------------------------- // These MUST be declared after the trim above as they depend on the // value being set up /** *null
if {@link #JAVA_VERSION} isnull
. ** Gets the Java version as a
* *float
. ** Example return values: *
*
-
*
1.2f
for Java 1.2 *1.31f
for Java 1.3.1 *
* The field will return zero if {@link #JAVA_VERSION} is null
.
*
* Gets the Java version as an int
.
*
* Example return values: *
*-
*
120
for Java 1.2 *131
for Java 1.3.1 *
* The field will return zero if {@link #JAVA_VERSION} is null
.
*
* Is true
if this is Java version 1.1 (also 1.1.x versions).
*
* The field will return false
if {@link #JAVA_VERSION} is null
.
*
* Is true
if this is Java version 1.2 (also 1.2.x versions).
*
* The field will return false
if {@link #JAVA_VERSION} is null
.
*
* Is true
if this is Java version 1.3 (also 1.3.x versions).
*
* The field will return false
if {@link #JAVA_VERSION} is null
.
*
* Is true
if this is Java version 1.4 (also 1.4.x versions).
*
* The field will return false
if {@link #JAVA_VERSION} is null
.
*
* Is true
if this is Java version 1.5 (also 1.5.x versions).
*
* The field will return false
if {@link #JAVA_VERSION} is null
.
*
* Is true
if this is Java version 1.6 (also 1.6.x versions).
*
* The field will return false
if {@link #JAVA_VERSION} is null
.
*
* Is true
if this is Java version 1.7 (also 1.7.x versions).
*
* The field will return false
if {@link #JAVA_VERSION} is null
.
*
* Is true
if this is AIX.
*
* The field will return false
if OS_NAME
is null
.
*
* Is true
if this is HP-UX.
*
* The field will return false
if OS_NAME
is null
.
*
* Is true
if this is Irix.
*
* The field will return false
if OS_NAME
is null
.
*
* Is true
if this is Linux.
*
* The field will return false
if OS_NAME
is null
.
*
* Is true
if this is Mac.
*
* The field will return false
if OS_NAME
is null
.
*
* Is true
if this is Mac.
*
* The field will return false
if OS_NAME
is null
.
*
* Is true
if this is OS/2.
*
* The field will return false
if OS_NAME
is null
.
*
* Is true
if this is Solaris.
*
* The field will return false
if OS_NAME
is null
.
*
* Is true
if this is SunOS.
*
* The field will return false
if OS_NAME
is null
.
*
* Is 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
.
*
* Is true
if this is Windows.
*
* The field will return false
if OS_NAME
is null
.
*
* Is true
if this is Windows 2000.
*
* The field will return false
if OS_NAME
is null
.
*
* Is true
if this is Windows 95.
*
* The field will return false
if OS_NAME
is null
.
*
* Is true
if this is Windows 98.
*
* The field will return false
if OS_NAME
is null
.
*
* Is true
if this is Windows ME.
*
* The field will return false
if OS_NAME
is null
.
*
* Is true
if this is Windows NT.
*
* The field will return false
if OS_NAME
is null
.
*
* Is true
if this is Windows XP.
*
* The field will return false
if OS_NAME
is null
.
*
* Is true
if this is Windows Vista.
*
* The field will return false
if OS_NAME
is null
.
*
* Is true
if this is Windows 7.
*
* The field will return false
if OS_NAME
is null
.
*
* Gets the Java home directory as a File
.
*
checkPropertyAccess
method doesn't allow access to the specified system property.
* @see System#getProperty(String)
* @since 2.1
*/
public static File getJavaHome() {
return new File(System.getProperty(JAVA_HOME_KEY));
}
/**
*
* Gets the Java IO temporary directory as a File
.
*
checkPropertyAccess
method doesn't allow access to the specified system
* property.
* @see System#getProperty(String)
* @since 2.1
*/
public static File getJavaIoTmpDir() {
return new File(System.getProperty(JAVA_IO_TMPDIR_KEY));
}
/**
* Gets the Java version number as a float
.
Example return values:
*-
*
1.2f
for JDK 1.2 *1.31f
for JDK 1.3.1 *
* Gets the Java version number as a float
.
*
* Example return values: *
*-
*
1.2f
for Java 1.2
* 1.31f
for Java 1.3.1
* 1.6f
for Java 1.6.0_20
*
* Patch releases are not reported. *
* * @return the version, for example 1.31f for Java 1.3.1 */ private static float getJavaVersionAsFloat() { return toVersionFloat(toJavaVersionIntArray(SystemUtils.JAVA_VERSION, JAVA_VERSION_TRIM_SIZE)); } /** *
* Gets the Java version number as an int
.
*
* Example return values: *
*-
*
120
for Java 1.2
* 131
for Java 1.3.1
* 160
for Java 1.6.0_20
*
* Patch releases are not reported. *
* * @return the version, for example 131 for Java 1.3.1 */ private static int getJavaVersionAsInt() { return toVersionInt(toJavaVersionIntArray(SystemUtils.JAVA_VERSION, JAVA_VERSION_TRIM_SIZE)); } /** ** Decides if the Java version matches. *
* * @param versionPrefix * the prefix for the java version * @return true if matches, or false if not or can't determine */ private static boolean getJavaVersionMatches(String versionPrefix) { return isJavaVersionMatch(JAVA_VERSION_TRIMMED, versionPrefix); } /** * Trims the text of the java version to start with numbers. * * @return the trimmed java version */ private static String getJavaVersionTrimmed() { if (JAVA_VERSION != null) { for (int i = 0; i < JAVA_VERSION.length(); i++) { char ch = JAVA_VERSION.charAt(i); if (ch >= '0' && ch <= '9') { return JAVA_VERSION.substring(i); } } } return null; } /** * Decides if the operating system matches. * * @param osNamePrefix * the prefix for the os name * @param osVersionPrefix * the prefix for the version * @return true if matches, or false if not or can't determine */ private static boolean getOSMatches(String osNamePrefix, String osVersionPrefix) { return isOSMatch(OS_NAME, OS_VERSION, osNamePrefix, osVersionPrefix); } /** * Decides if the operating system matches. * * @param osNamePrefix * the prefix for the os name * @return true if matches, or false if not or can't determine */ private static boolean getOSMatchesName(String osNamePrefix) { return isOSNameMatch(OS_NAME, osNamePrefix); } // ----------------------------------------------------------------------- /** *
* Gets a System property, defaulting to null
if the property cannot be read.
*
* If a SecurityException
is caught, the return value is null
and a message is written to
* System.err
.
*
null
if a security problem occurs
*/
private static String getSystemProperty(String property) {
try {
return System.getProperty(property);
} catch (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 File
.
*
checkPropertyAccess
method doesn't allow access to the specified system property.
* @see System#getProperty(String)
* @since 2.1
*/
public static File getUserDir() {
return new File(System.getProperty(USER_DIR_KEY));
}
/**
*
* Gets the user home directory as a File
.
*
checkPropertyAccess
method doesn't allow access to the specified system property.
* @see System#getProperty(String)
* @since 2.1
*/
public static File getUserHome() {
return new File(System.getProperty(USER_HOME_KEY));
}
/**
* Returns whether the {@link #JAVA_AWT_HEADLESS} value is true
.
*
* @return true
if JAVA_AWT_HEADLESS
is "true"
, false
otherwise.
*
* @see #JAVA_AWT_HEADLESS
* @since 2.1
* @since Java 1.4
*/
public static boolean isJavaAwtHeadless() {
return JAVA_AWT_HEADLESS != null ? JAVA_AWT_HEADLESS.equals(Boolean.TRUE.toString()) : false;
}
/**
* * Is the Java version at least the requested version. *
* ** Example input: *
*-
*
1.2f
to test for Java 1.2
* 1.31f
to test for Java 1.3.1
*
true
if the actual version is equal or greater than the required version
*/
public static boolean isJavaVersionAtLeast(float requiredVersion) {
return JAVA_VERSION_FLOAT >= requiredVersion;
}
/**
* * Is the Java version at least the requested version. *
* ** Example input: *
*-
*
120
to test for Java 1.2 or greater
* 131
to test for Java 1.3.1 or greater
*
true
if the actual version is equal or greater than the required version
* @since 2.0
*/
public static boolean isJavaVersionAtLeast(int requiredVersion) {
return JAVA_VERSION_INT >= requiredVersion;
}
/**
* * Decides if the Java version matches. *
** This method is package private instead of private to support unit test invocation. *
* * @param version * the actual Java version * @param versionPrefix * the prefix for the expected Java version * @return true if matches, or false if not or can't determine */ static boolean isJavaVersionMatch(String version, String versionPrefix) { if (version == null) { return false; } return version.startsWith(versionPrefix); } /** * Decides if the operating system matches. ** This method is package private instead of private to support unit test invocation. *
* * @param osName * the actual OS name * @param osVersion * the actual OS version * @param osNamePrefix * the prefix for the expected OS name * @param osVersionPrefix * the prefix for the expected OS version * @return true if matches, or false if not or can't determine */ static boolean isOSMatch(String osName, String osVersion, String osNamePrefix, String osVersionPrefix) { if (osName == null || osVersion == null) { return false; } return osName.startsWith(osNamePrefix) && osVersion.startsWith(osVersionPrefix); } /** * Decides if the operating system matches. ** This method is package private instead of private to support unit test invocation. *
* * @param osName * the actual OS name * @param osNamePrefix * the prefix for the expected OS name * @return true if matches, or false if not or can't determine */ static boolean isOSNameMatch(String osName, String osNamePrefix) { if (osName == null) { return false; } return osName.startsWith(osNamePrefix); } /** *
* Converts the given Java version string to a float
.
*
* Example return values: *
*-
*
1.2f
for Java 1.2
* 1.31f
for Java 1.3.1
* 1.6f
for Java 1.6.0_20
*
* Patch releases are not reported. *
** This method is package private instead of private to support unit test invocation. *
* * @param version The string version * @return the version, for example 1.31f for Java 1.3.1 */ static float toJavaVersionFloat(String version) { return toVersionFloat(toJavaVersionIntArray(version, JAVA_VERSION_TRIM_SIZE)); } /** *
* Converts the given Java version string to an int
.
*
* Example return values: *
*-
*
120
for Java 1.2
* 131
for Java 1.3.1
* 160
for Java 1.6.0_20
*
* Patch releases are not reported. *
** This method is package private instead of private to support unit test invocation. *
* * @param version The string version * @return the version, for example 131 for Java 1.3.1 */ static int toJavaVersionInt(String version) { return toVersionInt(toJavaVersionIntArray(version, JAVA_VERSION_TRIM_SIZE)); } /** *
* Converts the given Java version string to an int[]
of maximum size 3
.
*
* 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. *
* * @param version The string version * @return the version, for example [1, 5, 0] for Java 1.5.0_21 */ static int[] toJavaVersionIntArray(String version) { return toJavaVersionIntArray(version, Integer.MAX_VALUE); } /** *
* Converts the given Java version string to an int[]
of maximum size limit
.
*
* 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
*
* Converts given the Java version array to a float
.
*
* Example return values: *
*-
*
1.2f
for Java 1.2
* 1.31f
for Java 1.3.1
* 1.6f
for Java 1.6.0_20
*
* Patch releases are not reported. *
* * @param javaVersions The version numbers * @return the version, for example 1.31f for Java 1.3.1 */ private static float toVersionFloat(int[] javaVersions) { if (javaVersions == null || javaVersions.length == 0) { return 0f; } if (javaVersions.length == 1) { return javaVersions[0]; } StringBuffer builder = new StringBuffer(); builder.append(javaVersions[0]); builder.append('.'); for (int i = 1; i < javaVersions.length; i++) { builder.append(javaVersions[i]); } try { return Float.parseFloat(builder.toString()); } catch (Exception ex) { return 0f; } } /** *
* Converts given the Java version array to an int
.
*
* Example return values: *
*-
*
120
for Java 1.2
* 131
for Java 1.3.1
* 160
for Java 1.6.0_20
*
* Patch releases are not reported. *
* * @param javaVersions The version numbers * @return the version, for example 1.31f for Java 1.3.1 */ private static int toVersionInt(int[] javaVersions) { if (javaVersions == null) { return 0; } int intVersion = 0; int len = javaVersions.length; if (len >= 1) { intVersion = javaVersions[0] * 100; } if (len >= 2) { intVersion += javaVersions[1] * 10; } if (len >= 3) { intVersion += javaVersions[2]; } return intVersion; } // ----------------------------------------------------------------------- /** *
* SystemUtils instances should NOT be constructed in standard programming. Instead, the class should be used as
* SystemUtils.FILE_SEPARATOR
.
*
* This constructor is public to permit tools that require a JavaBean instance to operate. *
*/ public SystemUtils() { super(); } }