SysProps (getdown 1.5 API)

java.lang.Object
- com.threerings.getdown.data.SysProps

```
public class SysProps
extends Object
```
This class encapsulates all system properties that are read and processed by Getdown. Don't stick a call to System.getProperty randomly into the code, put it in here and give it an accessor so that it's easy to see all of the secret system property arguments that Getdown makes use of.

Constructor Summary

Constructors
Constructor and Description

SysProps()

Constructors
Constructor and Description
`SysProps()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static String`	`appBase()` Configures the appbase (in lieu of providing a skeleton getdown.txt, and as a last resort fallback).
`static String`	`appbaseDomain()` Overrides the domain on `appbase`.
`static String`	`appDir()` Configures the appdir (in lieu of passing it in argv).
`static String`	`appId()` Configures the appid (in lieu of passing it in argv).
`static int`	`connectTimeout()` Specifies the connection timeout (in seconds) to use when downloading control files from the server.
`static boolean`	`direct()` If true, Getdown will run the application in the same VM in which Getdown is running.
`static boolean`	`launchInSilent()` If true, Getdown installs the app without ever bringing up a UI and then launches it.
`static boolean`	`noLogRedir()` If true, disables redirection of logging into `launcher.log`.
`static boolean`	`noUnpack()` If true, Getdown will not unpack `uresource` jars.
`static long`	`parseJavaVersion(String propName, String propRegex)` Parses a Java version system property using the supplied regular expression.
`static boolean`	`silent()` If true, Getdown installs the app without ever bringing up a UI, except in the event of an error.
`static int`	`startDelay()` Specifies the a delay (in minutes) to wait before starting the update and install process.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - SysProps
```
public SysProps()
```
- Method Detail
  - appDir
```
public static String appDir()
```
    Configures the appdir (in lieu of passing it in argv). Usage: -Dappdir=foo.
  - appId
```
public static String appId()
```
    Configures the appid (in lieu of passing it in argv). Usage: -Dappid=foo.
  - appBase
```
public static String appBase()
```
    Configures the appbase (in lieu of providing a skeleton getdown.txt, and as a last resort fallback). Usage: -Dappbase=someurl.
  - noLogRedir
```
public static boolean noLogRedir()
```
    If true, disables redirection of logging into launcher.log. Usage: -Dno_log_redir.
  - appbaseDomain
```
public static String appbaseDomain()
```
    Overrides the domain on appbase. Usage: -Dappbase_domain=foo.
  - silent
```
public static boolean silent()
```
    If true, Getdown installs the app without ever bringing up a UI, except in the event of an error. NOTE: it does not launch the app. See launchInSilent(). Usage: -Dsilent.
  - launchInSilent
```
public static boolean launchInSilent()
```
    If true, Getdown installs the app without ever bringing up a UI and then launches it. Usage: -Dsilent=launch.
  - startDelay
```
public static int startDelay()
```
    Specifies the a delay (in minutes) to wait before starting the update and install process. Usage: -Ddelay=N.
  - noUnpack
```
public static boolean noUnpack()
```
    If true, Getdown will not unpack uresource jars. Usage: -Dno_unpack.
  - direct
```
public static boolean direct()
```
    If true, Getdown will run the application in the same VM in which Getdown is running. If false (the default), Getdown will fork a new VM. Note that reusing the same VM prevents Getdown from configuring some launch-time-only VM parameters (like -mxN etc.). Usage: -Ddirect.
  - connectTimeout
```
public static int connectTimeout()
```
    Specifies the connection timeout (in seconds) to use when downloading control files from the server. This is chiefly useful when you are running in versionless mode and want Getdown to more quickly timeout its startup update check if the server with which it is communicating is not available. Usage: -Dconnect_timeout=N.
  - parseJavaVersion
```
public static long parseJavaVersion(String propName,
                                    String propRegex)
```
    Parses a Java version system property using the supplied regular expression. The numbers extracted from the regexp will be placed in each consecutive hundreds position in the returned value.
    For example, java.version takes the form 1.8.0_31, and with the regexp (\d+)\.(\d+)\.(\d+)(_\d+)? we would parse 1, 8, 0, 31 and combine them into the final value 1080031.
    Note that non-numeric characters matched by the regular expression will simply be ignored, and optional groups which do not match are treated as zero in the final version calculation.
    One can instead parse java.runtime.version which takes the form 1.8.0_31-b13. Using regexp (\d+)\.(\d+)\.(\d+)_(\d+)-b(\d+) we would parse 1, 8, 0, 31, 13 and combine them into a final value 108003113.
    Other (or future) JVMs may provide different version properties which can be parsed as desired using this general scheme as long as the numbers appear from left to right in order of significance.
    
    Throws:
    
    IllegalArgumentException - if no system named propName exists, or if propRegex does not match the returned version string.

Class SysProps

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

SysProps

Method Detail

appDir

appId

appBase

noLogRedir

appbaseDomain

silent

launchInSilent

startDelay

noUnpack

direct

connectTimeout

parseJavaVersion