Package org.apache.groovy.util

# Class SystemUtil

java.lang.Object
org.apache.groovy.util.SystemUtil

    public class SystemUtil
    extends Object

- ## Constructor Summary

  Constructors
  Constructor | Description
  --- | ---
  `SystemUtil()` |

- ## Method Summary

  Modifier and Type | Method | Description
  --- | --- | ---
  `static boolean` | `getBooleanSafe​(String name)` | Retrieves a Boolean System property, or returns false if: the property isn't found the property name is null or empty if a security manager exists and its checkPropertyAccess method doesn't allow access to the specified system property.
  `static Integer` | `getIntegerSafe​(String name, Integer def)` | Retrieves an Integer System property
  `static Long` | `getLongSafe​(String name, Long def)` | Retrieves an Long System property
  `static String` | `getSystemPropertySafe​(String name)` | Retrieves a System property, or null if: the property isn't found the property name is null or empty if a security manager exists and its checkPropertyAccess method doesn't allow access to the specified system property.
  `static String` | `getSystemPropertySafe​(String name, String defaultValue)` | Retrieves a System property, or returns some default value if: the property isn't found the property name is null or empty if a security manager exists and its checkPropertyAccess method doesn't allow access to the specified system property.
  `static String` | `setSystemPropertyFrom​(String nameValue)` | Sets a system property from a `name=value` String.
  `static String` | `setSystemPropertyFromSafe​(String nameValue)` | Sets a system property from a `name=value` String.

  ### Methods inherited from class java.lang.Object

  `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- ## Constructor Details

  - ### SystemUtil

    public SystemUtil()

- ## Method Details

  - ### setSystemPropertyFrom

    public static String setSystemPropertyFrom​(String nameValue)
    Sets a system property from a `name=value` String. If no '=' is found, the property is assumed to be a Boolean flag with value `true`.
    Parameters:
      `nameValue` - the non-null name=value String
    Returns:
      the found name
    Throws:
      `IllegalArgumentException` - if nameValue is null

  - ### setSystemPropertyFromSafe

    public static String setSystemPropertyFromSafe​(String nameValue)
    Sets a system property from a `name=value` String. If no '=' is found, the property is assumed to be a Boolean flag with value `true`. Does nothing if a Security manager is in place which doesn't allow the operation.
    Parameters:
      `nameValue` - the non-null name=value String
    Returns:
      the found property name or null if the operation wasn't successful
    Throws:
      `IllegalArgumentException` - if nameValue is null

  - ### getSystemPropertySafe

    public static String getSystemPropertySafe​(String name, String defaultValue)
    Retrieves a System property, or returns some default value if:
    - the property isn't found
    - the property name is null or empty
    - if a security manager exists and its checkPropertyAccess method doesn't allow access to the specified system property.
    Parameters:
      `name` - the name of the system property.
      `defaultValue` - a default value.
    Returns:
      value of the system property or the default value

  - ### getSystemPropertySafe

    public static String getSystemPropertySafe​(String name)
    Retrieves a System property, or null if:
    - the property isn't found
    - the property name is null or empty
    - if a security manager exists and its checkPropertyAccess method doesn't allow access to the specified system property.
    Parameters:
      `name` - the name of the system property.
    Returns:
      value of the system property or null

  - ### getBooleanSafe

    public static boolean getBooleanSafe​(String name)
    Retrieves a Boolean System property, or returns false if:
    - the property isn't found
    - the property name is null or empty
    - if a security manager exists and its checkPropertyAccess method doesn't allow access to the specified system property.
    Parameters:
      `name` - the name of the system property.
    Returns:
      value of the Boolean system property or false

  - ### getIntegerSafe

    public static Integer getIntegerSafe​(String name, Integer def)
    Retrieves an Integer System property
    Parameters:
      `name` - the name of the system property.
      `def` - the default value
    Returns:
      value of the Integer system property or the default value

  - ### getLongSafe

    public static Long getLongSafe​(String name, Long def)
    Retrieves an Long System property
    Parameters:
      `name` - the name of the system property.
      `def` - the default value
    Returns:
      value of the Long system property or the default value