Package org.eclipse.jgit.util

Class SystemReader

java.lang.Object

org.eclipse.jgit.util.SystemReader

public abstract class SystemReader
extends Object

Interface to read values from the system.

When writing unit tests, extending this interface with a custom class permits to simulate an access to a system variable or property and permits to control the user's global configuration.

Constructor Summary

Constructors

Constructor	Description
SystemReader()

Method Summary

Modifier and Type	Method	Description
void	checkPath(String path)	Check tree path entry for validity.
abstract long	getCurrentTime()
DateFormat	getDateTimeInstance(int dateStyle, int timeStyle)	Returns a date/time format instance for the given styles.
abstract String	getenv(String variable)
abstract String	getHostname()	Gets the hostname of the local host.
static SystemReader	getInstance()
Locale	getLocale()
abstract String	getProperty(String key)
SimpleDateFormat	getSimpleDateFormat(String pattern)	Returns a simple date format instance as specified by the given pattern.
SimpleDateFormat	getSimpleDateFormat(String pattern, Locale locale)	Returns a simple date format instance as specified by the given pattern.
abstract int	getTimezone(long when)
TimeZone	getTimeZone()
boolean	isMacOS()
boolean	isWindows()
abstract FileBasedConfig	openSystemConfig(Config parent, FS fs)
abstract FileBasedConfig	openUserConfig(Config parent, FS fs)
static void	setInstance(SystemReader newReader)
protected void	setPlatformChecker()	Should be used in tests when the platform is explicitly changed.

Methods inherited from class java.lang.Object

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

Constructor Detail

SystemReader

public SystemReader()

Method Detail

getInstance

public static SystemReader getInstance()

Returns:

the live instance to read system properties.

setInstance

public static void setInstance(SystemReader newReader)

Parameters:

newReader - the new instance to use when accessing properties, or null for the default instance.

setPlatformChecker

protected final void setPlatformChecker()

Should be used in tests when the platform is explicitly changed.

Since:

3.6

getHostname

public abstract String getHostname()

Gets the hostname of the local host. If no hostname can be found, the hostname is set to the default value "localhost".

Returns:

the canonical hostname

getenv

public abstract String getenv(String variable)

Parameters:

variable - system variable to read

Returns:

value of the system variable

getProperty

public abstract String getProperty(String key)

Parameters:

key - of the system property to read

Returns:

value of the system property

openUserConfig

public abstract FileBasedConfig openUserConfig(Config parent,
                                               FS fs)

Parameters:

parent - a config with values not found directly in the returned config

fs - the file system abstraction which will be necessary to perform certain file system operations.

Returns:

the git configuration found in the user home

openSystemConfig

public abstract FileBasedConfig openSystemConfig(Config parent,
                                                 FS fs)

Parameters:

parent - a config with values not found directly in the returned config. Null is a reasonable value here.

fs - the file system abstraction which will be necessary to perform certain file system operations.

Returns:

the gitonfig configuration found in the system-wide "etc" directory

getCurrentTime

public abstract long getCurrentTime()

Returns:

the current system time

getTimezone

public abstract int getTimezone(long when)

Parameters:

when - TODO

Returns:

the local time zone

getTimeZone

public TimeZone getTimeZone()

Returns:

system time zone, possibly mocked for testing

Since:

1.2

getLocale

public Locale getLocale()

Returns:

the locale to use

Since:

1.2

getSimpleDateFormat

public SimpleDateFormat getSimpleDateFormat(String pattern)

Returns a simple date format instance as specified by the given pattern.

Parameters:

pattern - the pattern as defined in SimpleDateFormat(String)

Returns:

the simple date format

Since:

2.0

getSimpleDateFormat

public SimpleDateFormat getSimpleDateFormat(String pattern,
                                            Locale locale)

Returns a simple date format instance as specified by the given pattern.

Parameters:

pattern - the pattern as defined in SimpleDateFormat(String)

locale - locale to be used for the SimpleDateFormat

Returns:

the simple date format

Since:

3.2

getDateTimeInstance

public DateFormat getDateTimeInstance(int dateStyle,
                                      int timeStyle)

Returns a date/time format instance for the given styles.

Parameters:

dateStyle - the date style as specified in DateFormat.getDateTimeInstance(int, int)

timeStyle - the time style as specified in DateFormat.getDateTimeInstance(int, int)

Returns:

the date format

Since:

2.0

isWindows

public boolean isWindows()

Returns:

true if we are running on a Windows.

isMacOS

public boolean isMacOS()

Returns:

true if we are running on Mac OS X

checkPath

public void checkPath(String path)
               throws CorruptObjectException

Check tree path entry for validity.

Scans a multi-directory path string such as "src/main.c".

Parameters:

path - path string to scan.

Throws:

CorruptObjectException - path is invalid.

Since:

3.6