EnvUtil (JKube Kit :: Common 1.16.1 API)

java.lang.Object
- org.eclipse.jkube.kit.common.util.EnvUtil

```
public class EnvUtil
extends Object
```
Since:

24.05.17

Author:

roland

Field Summary

Fields
Modifier and Type Field and Description

static String DOCKER_HTTP_PORT

static String MAVEN_PROPERTY_REGEXP

static String PROPERTY_COMBINE_POLICY_SUFFIX

Fields
Modifier and Type	Field and Description
`static String`	`DOCKER_HTTP_PORT`
`static String`	`MAVEN_PROPERTY_REGEXP`
`static String`	`PROPERTY_COMBINE_POLICY_SUFFIX`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static String`	`convertTcpToHttpUrl(String connect)`
`static String`	`ensureRegistryHttpUrl(String registry)`
`static List<String>`	`extractFromPropertiesAsList(String prefix, Properties properties)` Extract from given properties a list of string values.
`static Map<String,String>`	`extractFromPropertiesAsMap(String prefix, Properties properties)` Extract part of given properties as a map.
`static String`	`extractLargerVersion(String versionA, String versionB)` Compare to version strings and return the larger version strings.
`static String`	`extractMavenPropertyName(String propName)` Extract from a Maven property which is in the form ${name} the name.
`static File`	`findBinaryFileInUserPath(String binaryName)` Find a binary in user's path
`static String`	`firstRegistryOf(String... checkFirst)` Return the first non-null registry given.
`static String`	`fixupPath(String path)` Fix path on Windows machines, i.e.
`static String`	`formatDurationTill(long start)` Calculate the duration between now and the given time
`static String`	`getEnv(String variableName)` Return the value of the given environment variable or null if it is not set.
`static String`	`getEnvVarOrSystemProperty(String varName, String defaultValue)`
`static String`	`getEnvVarOrSystemProperty(String envVarName, String systemProperty, String defaultValue)`
`static String`	`getProcessorArchitecture()` Utility method to get underlying processor architecture
`static String`	`getProperty(String propertyName)`
`static File`	`getUserHome()` Return a `File` pointing to the user's home directory.
`static boolean`	`greaterOrEqualsVersion(String versionA, String versionB)` Check whether the first given API version is larger or equals the second given version
`static boolean`	`isMacOs()` Is underlying Operating System from Mac OS family.
`static boolean`	`isWindows()`
`static Date`	`loadTimestamp(File tsFile)`
`static void`	`overrideEnvGetter(UnaryOperator<String> getter)` Don't use in production code.
`static void`	`overridePropertyGetter(UnaryOperator<String> propsGetter)`
`static File`	`prepareAbsoluteOutputDirPath(String outputDirectory, String projectBaseDir, String dir, String path)`
`static File`	`prepareAbsoluteSourceDirPath(String sourceDirectory, String projectBaseDir, String path)`
`static List<String>`	`removeEmptyEntries(List<String> input)` Remove empty members of a list.
`static List<String>`	`splitAtCommasAndTrim(Iterable<String> input)` Split each element of an Iterable;<String;> at commas.
`static List<String[]>`	`splitOnLastColon(List<String> listToSplit)` Splits every element in the given list on the last colon in the name and returns a list with two elements: The left part before the colon and the right part after the colon.
`static String[]`	`splitOnSpaceWithEscape(String toSplit)`
`static void`	`storeTimestamp(File tsFile, Date buildDate)` Create a timestamp file holding time in epoch seconds.
`static String`	`stringJoin(List list, String separator)` Join a list of objects to a string with a given separator by calling Object.toString() on the elements.

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

- Field Detail
  - MAVEN_PROPERTY_REGEXP
```
public static final String MAVEN_PROPERTY_REGEXP
```
    See Also:
    
    Constant Field Values
  - DOCKER_HTTP_PORT
```
public static final String DOCKER_HTTP_PORT
```
    See Also:
    
    Constant Field Values
  - PROPERTY_COMBINE_POLICY_SUFFIX
```
public static final String PROPERTY_COMBINE_POLICY_SUFFIX
```
    See Also:
    
    Constant Field Values
- Method Detail
  - overrideEnvGetter
```
public static void overrideEnvGetter(UnaryOperator<String> getter)
```
    Don't use in production code. Only for testing purposes.
    
    Parameters:
    
    getter -
  - overridePropertyGetter
```
public static void overridePropertyGetter(UnaryOperator<String> propsGetter)
```
  - convertTcpToHttpUrl
```
public static String convertTcpToHttpUrl(String connect)
```
  - extractLargerVersion
```
public static String extractLargerVersion(String versionA,
                                          String versionB)
```
    Compare to version strings and return the larger version strings. This is used in calculating the minimal required API version for this plugin. Version strings must be comparable as floating numbers. The versions must be given in the format in a semantic version format (e.g. "1.23"
    If either version is null, the other version is returned (which can be null as well)
    
    Parameters:
    
    versionA - first version number
    
    versionB - second version number
    
    Returns:
    
    the larger version number
  - greaterOrEqualsVersion
```
public static boolean greaterOrEqualsVersion(String versionA,
                                             String versionB)
```
    Check whether the first given API version is larger or equals the second given version
    
    Parameters:
    
    versionA - first version to check against
    
    versionB - the second version
    
    Returns:
    
    true if versionA is greater or equals versionB, false otherwise
  - splitOnLastColon
```
public static List<String[]> splitOnLastColon(List<String> listToSplit)
```
    Splits every element in the given list on the last colon in the name and returns a list with two elements: The left part before the colon and the right part after the colon. If the string doesn't contain a colon, the value is used for both elements in the returned arrays.
    
    Parameters:
    
    listToSplit - list of strings to split
    
    Returns:
    
    return list of 2-element arrays or an empty list if the given list is empty or null
  - removeEmptyEntries
```
@Nonnull
public static List<String> removeEmptyEntries(@Nullable
                                                       List<String> input)
```
    Remove empty members of a list.
    
    Parameters:
    
    input - A list of String
    
    Returns:
    
    A list of Non-Empty (length ;> 0) String
  - splitAtCommasAndTrim
```
@Nonnull
public static List<String> splitAtCommasAndTrim(Iterable<String> input)
```
    Split each element of an Iterable;<String;> at commas.
    
    Parameters:
    
    input - Iterable over strings.
    
    Returns:
    
    An Iterable over string which breaks down each input element at comma boundaries
  - splitOnSpaceWithEscape
```
public static String[] splitOnSpaceWithEscape(String toSplit)
```
  - stringJoin
```
public static String stringJoin(List list,
                                String separator)
```
    Join a list of objects to a string with a given separator by calling Object.toString() on the elements.
    
    Parameters:
    
    list - to join
    
    separator - separator to use
    
    Returns:
    
    the joined string.
  - extractFromPropertiesAsMap
```
public static Map<String,String> extractFromPropertiesAsMap(String prefix,
                                                            Properties properties)
```
    Extract part of given properties as a map. The given prefix is used to find the properties, the rest of the property name is used as key for the map.
    NOTE: If key is "._combine" (PROPERTY_COMBINE_POLICY_SUFFIX) it is ignored! This is reserved for combine policy tweaking.
    
    Parameters:
    
    prefix - prefix which specifies the part which should be extracted as map
    
    properties - properties to extract from
    
    Returns:
    
    the extracted map or null if no such map exists
  - extractFromPropertiesAsList
```
public static List<String> extractFromPropertiesAsList(String prefix,
                                                       Properties properties)
```
    Extract from given properties a list of string values. The prefix is used to determine the subset of the given properties from which the list should be extracted, the rest is used as a numeric index. If the rest is not numeric, the order is not determined (all those props are appended to the end of the list)
    NOTE: If suffix/index is "._combine" (PROPERTY_COMBINE_POLICY_SUFFIX) it is ignored! This is reserved for combine policy tweaking.
    
    Parameters:
    
    prefix - for selecting the properties from which the list should be extracted
    
    properties - properties from which to extract from
    
    Returns:
    
    parsed list or null if no element with prefixes exists
  - extractMavenPropertyName
```
public static String extractMavenPropertyName(String propName)
```
    Extract from a Maven property which is in the form ${name} the name.
    
    Parameters:
    
    propName - property name to extract
    
    Returns:
    
    the pure name or null if this is not a property name
  - fixupPath
```
public static String fixupPath(String path)
```
    Fix path on Windows machines, i.e. convert 'c:\...\' to '/c/..../'
    
    Parameters:
    
    path - path to fix
    
    Returns:
    
    the fixed path
  - formatDurationTill
```
public static String formatDurationTill(long start)
```
    Calculate the duration between now and the given time
    Taken mostly from http://stackoverflow.com/a/5062810/207604 . Kudos to @dblevins
    
    Parameters:
    
    start - starting time (in milliseconds)
    
    Returns:
    
    time in seconds
  - firstRegistryOf
```
public static String firstRegistryOf(String... checkFirst)
```
    Return the first non-null registry given. Use the env var DOCKER_REGISTRY as final fallback
    
    Parameters:
    
    checkFirst - list of registries to check
    
    Returns:
    
    registry found or null if none.
  - ensureRegistryHttpUrl
```
public static String ensureRegistryHttpUrl(String registry)
```
  - prepareAbsoluteOutputDirPath
```
public static File prepareAbsoluteOutputDirPath(String outputDirectory,
                                                String projectBaseDir,
                                                String dir,
                                                String path)
```
  - prepareAbsoluteSourceDirPath
```
public static File prepareAbsoluteSourceDirPath(String sourceDirectory,
                                                String projectBaseDir,
                                                String path)
```
  - storeTimestamp
```
public static void storeTimestamp(File tsFile,
                                  Date buildDate)
                           throws IOException
```
    Create a timestamp file holding time in epoch seconds.
    
    Parameters:
    
    tsFile - the File to store the timestamp in.
    
    buildDate - the Date of the timestamp.
    
    Throws:
    
    IOException - if the timestamp cannot be created.
  - loadTimestamp
```
public static Date loadTimestamp(File tsFile)
                          throws IOException
```
    Throws:
    
    IOException
  - isWindows
```
public static boolean isWindows()
```
  - getUserHome
```
public static File getUserHome()
```
    Return a File pointing to the user's home directory.
    
    Returns:
    
    the user home directory.
  - getEnv
```
public static String getEnv(String variableName)
```
    Return the value of the given environment variable or null if it is not set.
    
    Parameters:
    
    variableName - name of the environment variable.
    
    Returns:
    
    the value of the environment variable or null if it is not set.
  - getProperty
```
public static String getProperty(String propertyName)
```
  - getEnvVarOrSystemProperty
```
public static String getEnvVarOrSystemProperty(String varName,
                                               String defaultValue)
```
  - getEnvVarOrSystemProperty
```
public static String getEnvVarOrSystemProperty(String envVarName,
                                               String systemProperty,
                                               String defaultValue)
```
  - getProcessorArchitecture
```
public static String getProcessorArchitecture()
```
    Utility method to get underlying processor architecture
    
    Returns:
    
    String value containing architecture
  - isMacOs
```
public static boolean isMacOs()
```
    Is underlying Operating System from Mac OS family.
    
    Returns:
    
    boolean value indicating whether Operating System is Mac or not.
  - findBinaryFileInUserPath
```
public static File findBinaryFileInUserPath(String binaryName)
```
    Find a binary in user's path
    
    Parameters:
    
    binaryName - name of file to find
    
    Returns:
    
    File containing binary's path, otherwise null.

Class EnvUtil

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

MAVEN_PROPERTY_REGEXP

DOCKER_HTTP_PORT

PROPERTY_COMBINE_POLICY_SUFFIX

Method Detail

overrideEnvGetter

overridePropertyGetter

convertTcpToHttpUrl

extractLargerVersion

greaterOrEqualsVersion

splitOnLastColon

removeEmptyEntries

splitAtCommasAndTrim

splitOnSpaceWithEscape

stringJoin

extractFromPropertiesAsMap

extractFromPropertiesAsList

extractMavenPropertyName

fixupPath

formatDurationTill

firstRegistryOf

ensureRegistryHttpUrl

prepareAbsoluteOutputDirPath

prepareAbsoluteSourceDirPath

storeTimestamp

loadTimestamp

isWindows

getUserHome

getEnv

getProperty

getEnvVarOrSystemProperty

getEnvVarOrSystemProperty

getProcessorArchitecture

isMacOs

findBinaryFileInUserPath