Package org.eclipse.jgit.util
Class SystemReader
java.lang.Object
org.eclipse.jgit.util.SystemReader
- Direct Known Subclasses:
MockSystemReader
,SystemReader.Default
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.
-
Nested Class Summary
Nested Classes -
Field Summary
FieldsModifier and TypeFieldDescriptionprivate static final SystemReader
private static SystemReader
private static Boolean
private static Boolean
private AtomicReference
<FileBasedConfig> private static final org.slf4j.Logger
private ObjectChecker
private AtomicReference
<FileBasedConfig> private AtomicReference
<FileBasedConfig> -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
checkPath
(byte[] path) Check tree path entry for validity.void
Check tree path entry for validity.getClock()
Get clock instance preferred by this system.abstract long
Get the current system timegetDateTimeInstance
(int dateStyle, int timeStyle) Returns a date/time format instance for the given styles.abstract String
Get value of the system variableabstract String
Gets the hostname of the local host.static SystemReader
Get the current SystemReader instanceGet the jgit configuration located at $XDG_CONFIG_HOME/jgit/config.Get the locale to useprivate String
abstract String
getProperty
(String key) Get value of the system propertygetSimpleDateFormat
(String pattern) Returns a simple date format instance as specified by the given pattern.getSimpleDateFormat
(String pattern, Locale locale) Returns a simple date format instance as specified by the given pattern.Get the gitconfig configuration found in the system-wide "etc" directory.abstract int
getTimezone
(long when) Get the local time zoneGet system time zone, possibly mocked for testingGet the git configuration found in the user home.private void
init()
boolean
isMacOS()
Whether we are running on Mac OS Xboolean
Whether we are running on Windows.abstract FileBasedConfig
openJGitConfig
(Config parent, FS fs) Open the jgit configuration located at $XDG_CONFIG_HOME/jgit/config.abstract FileBasedConfig
openSystemConfig
(Config parent, FS fs) Open the gitconfig configuration found in the system-wide "etc" directory.abstract FileBasedConfig
openUserConfig
(Config parent, FS fs) Open the git configuration found in the user home.static void
setInstance
(SystemReader newReader) Set a new SystemReader instance to use when accessing properties.protected final void
Should be used in tests when the platform is explicitly changed.private void
Update config and its parents if they seem modified
-
Field Details
-
LOG
private static final org.slf4j.Logger LOG -
DEFAULT
-
isMacOS
-
isWindows
-
INSTANCE
-
platformChecker
-
systemConfig
-
userConfig
-
jgitConfig
-
-
Constructor Details
-
SystemReader
public SystemReader()
-
-
Method Details
-
getInstance
Get the current SystemReader instance- Returns:
- the current SystemReader instance.
-
setInstance
Set a new SystemReader instance to use when accessing properties.- Parameters:
newReader
- the new instance to use when accessing properties, or null for the default instance.
-
init
private void init() -
setPlatformChecker
protected final void setPlatformChecker()Should be used in tests when the platform is explicitly changed.- Since:
- 3.6
-
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
Get value of the system variable- Parameters:
variable
- system variable to read- Returns:
- value of the system variable
-
getProperty
Get value of the system property- Parameters:
key
- of the system property to read- Returns:
- value of the system property
-
openUserConfig
Open the git configuration found in the user home. UsegetUserConfig()
to get the current git configuration in the user home since it manages automatic reloading when the gitconfig file was modified and avoids unnecessary reloads.- Parameters:
parent
- a config with values not found directly in the returned configfs
- the file system abstraction which will be necessary to perform certain file system operations.- Returns:
- the git configuration found in the user home
-
openSystemConfig
Open the gitconfig configuration found in the system-wide "etc" directory. UsegetSystemConfig()
to get the current system-wide git configuration since it manages automatic reloading when the gitconfig file was modified and avoids unnecessary reloads.- 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 gitconfig configuration found in the system-wide "etc" directory
-
openJGitConfig
Open the jgit configuration located at $XDG_CONFIG_HOME/jgit/config. UsegetJGitConfig()
to get the current jgit configuration in the user home since it manages automatic reloading when the jgit config file was modified and avoids unnecessary reloads.- Parameters:
parent
- a config with values not found directly in the returned configfs
- the file system abstraction which will be necessary to perform certain file system operations.- Returns:
- the jgit configuration located at $XDG_CONFIG_HOME/jgit/config
- Since:
- 5.5.2
-
getUserConfig
Get the git configuration found in the user home. The configuration will be reloaded automatically if the configuration file was modified. Also reloads the system config if the system config file was modified. If the configuration file wasn't modified returns the cached configuration.- Returns:
- the git configuration found in the user home
- Throws:
ConfigInvalidException
- if configuration is invalidIOException
- if something went wrong when reading files- Since:
- 5.1.9
-
getJGitConfig
Get the jgit configuration located at $XDG_CONFIG_HOME/jgit/config. The configuration will be reloaded automatically if the configuration file was modified. If the configuration file wasn't modified returns the cached configuration.- Returns:
- the jgit configuration located at $XDG_CONFIG_HOME/jgit/config
- Throws:
ConfigInvalidException
- if configuration is invalidIOException
- if something went wrong when reading files- Since:
- 5.5.2
-
getSystemConfig
Get the gitconfig configuration found in the system-wide "etc" directory. The configuration will be reloaded automatically if the configuration file was modified otherwise returns the cached system level config.- Returns:
- the gitconfig configuration found in the system-wide "etc" directory
- Throws:
ConfigInvalidException
- if configuration is invalidIOException
- if something went wrong when reading files- Since:
- 5.1.9
-
updateAll
Update config and its parents if they seem modified- Parameters:
config
- configuration to reload if outdated- Throws:
ConfigInvalidException
- if configuration is invalidIOException
- if something went wrong when reading files
-
getCurrentTime
public abstract long getCurrentTime()Get the current system time- Returns:
- the current system time
-
getClock
Get clock instance preferred by this system.- Returns:
- clock instance preferred by this system.
- Since:
- 4.6
-
getTimezone
public abstract int getTimezone(long when) Get the local time zone- Parameters:
when
- a system timestamp- Returns:
- the local time zone
-
getTimeZone
Get system time zone, possibly mocked for testing- Returns:
- system time zone, possibly mocked for testing
- Since:
- 1.2
-
getLocale
Get the locale to use- Returns:
- the locale to use
- Since:
- 1.2
-
getSimpleDateFormat
Returns a simple date format instance as specified by the given pattern.- Parameters:
pattern
- the pattern as defined inSimpleDateFormat(String)
- Returns:
- the simple date format
- Since:
- 2.0
-
getSimpleDateFormat
Returns a simple date format instance as specified by the given pattern.- Parameters:
pattern
- the pattern as defined inSimpleDateFormat(String)
locale
- locale to be used for theSimpleDateFormat
- Returns:
- the simple date format
- Since:
- 3.2
-
getDateTimeInstance
Returns a date/time format instance for the given styles.- Parameters:
dateStyle
- the date style as specified inDateFormat.getDateTimeInstance(int, int)
timeStyle
- the time style as specified inDateFormat.getDateTimeInstance(int, int)
- Returns:
- the date format
- Since:
- 2.0
-
isWindows
public boolean isWindows()Whether we are running on Windows.- Returns:
- true if we are running on Windows.
-
isMacOS
public boolean isMacOS()Whether we are running on Mac OS X- Returns:
- true if we are running on Mac OS X
-
getOsName
-
checkPath
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
-
checkPath
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:
- 4.2
-