org.refcodes.runtime

Class SystemUtility

java.lang.Object

org.refcodes.runtime.SystemUtility

public final class SystemUtility
extends Object

Utility for acquiring system information on the machine this process is running in.

Method Summary

Modifier and Type	Method and Description
static String	exec(String aCommand) Executes a command and returns the output.
static String	getComputerName() Determines the computer's name.
static String	getLineBreak() Determines the operating system as of OperatingSystem.toOperatingSystem() and in case a OperatingSystem.WINDOWS is being detected, then \r\n" (CRLF) is returned, else "\n" (LF) is returned.
static String	getSystemEncoding() Determines the encoding of the system (system's console) in use as of System.out.
static File	getTempDir() Returns the operating saystem's temp folder.
static int	getTerminalHeight() Determines the height in characters of the system's terminal in use.
static int	getTerminalWidth() Determines the width in characters of the system's terminal in use.
static String	getUname() If on a *nix alike system, this method returns the output of the "uname -a" command: "uname" prints system information, "-a" instructs it to print all information.
static boolean	isAnsiTerminal() Determines whether ANSI escape sequences are supported by the terminal.
static boolean	isUseLineBreak(int aRowWidth) Determines whether wee need an explicit line-break for the given width on the current operating system and used terminal.
static boolean	toAnsiConsole() Determines whether ANSI escape sequences are forced to be supported or not by REFCODES.ORG artifacts.
static int	toConsoleHeight() Does some calculation to always return a sound console height (never returns -1).
static int	toConsoleWidth() Does some calculation to always return a sound console width (never returns -1).
static String	toLineBreak(int aRowWidth) Uses isUseLineBreak(int) to retrieve the character sequence required to suffix to a line in order to get a line break without risking any empty lines as of automatic line wrapping.
static String	toPropertyValue(String aDefaultValue, org.refcodes.data.SystemProperty aSystemProperty, org.refcodes.data.EnvironmentProperty... aEnvironmentProperties) Gets the value for the provided properties, if non was found then the default value is taken.
static String	toPropertyValue(org.refcodes.data.SystemProperty aSystemProperty, org.refcodes.data.EnvironmentProperty... aEnvironmentProperties) Gets the value for the provided properties, if non was found then null is returned.
static String	toSystemInfo() Prints out all available system information from this Artifac's point of view.

Methods inherited from class java.lang.Object

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

Method Detail

getLineBreak

public static String getLineBreak()

Determines the operating system as of OperatingSystem.toOperatingSystem() and in case a OperatingSystem.WINDOWS is being detected, then \r\n" (CRLF) is returned, else "\n" (LF) is returned. Can be overridden with the SystemProperty.CONSOLE_LINE_BREAK (java -Dconsole.lineBreak=...) and the EnvironmentProperty.CONSOLE_LINE_BREAK ("export CONSOLE_LINE_BREAK=...).

Returns:

The operating system's specific line break; on Windows it is "\r\n" (CRLF) and on all other operating systems it is "\n" (LF).

isUseLineBreak

public static boolean isUseLineBreak(int aRowWidth)

Determines whether wee need an explicit line-break for the given width on the current operating system and used terminal. E.g. on "win.cmd" we must not use a line-break in case our line is a s long as the console's width. There are some more such cases which this method tries to take into consideration.

Parameters:

aRowWidth - The row width you want to use when printing out to a console.

Returns:

True in case you should use a line-break.

toLineBreak

public static String toLineBreak(int aRowWidth)

Uses isUseLineBreak(int) to retrieve the character sequence required to suffix to a line in order to get a line break without risking any empty lines as of automatic line wrapping. Automatic line wrapping can happen on Windows environment when the console width is reached. A line break would cause a superfluous empty line (ugly).

Parameters:

aRowWidth - The row width you want to use when printing out to a console.

Returns:

The system's line break characters when a line break is emphasized or an empty string if no line break sequence is recommended.

getComputerName

public static String getComputerName()

Determines the computer's name. First it tries to get it from the InetAddress, if it fails it tries to get it from the system's environment using the EnvironmentProperty.COMPUTERNAME (on Windows machines only) and if both fails, it returns the default Literal.LOCALHOST identifier.

Returns:

The computer's name, as fallback, Literal.LOCALHOST ("localhost") is returned.

getUname

public static String getUname()

If on a *nix alike system, this method returns the output of the "uname -a" command: "uname" prints system information, "-a" instructs it to print all information.

Returns:

The "uname -a" output or null if "uname" is not known.

getTerminalWidth

public static int getTerminalWidth()

Determines the width in characters of the system's terminal in use.

Returns:

The width of the terminal in characters or -1 if the width cannot be determined.

getTerminalHeight

public static int getTerminalHeight()

Determines the height in characters of the system's terminal in use.

Returns:

The height of the terminal in characters or -1 if the height cannot be determined.

toConsoleWidth

public static int toConsoleWidth()

Does some calculation to always return a sound console width (never returns -1). Anything in the REFCODES.ORG artifacts which is intended to print to the console uses this method to determine some heuristic best console width.

Returns:

A sound heuristic console width.

toConsoleHeight

public static int toConsoleHeight()

Does some calculation to always return a sound console height (never returns -1). Anything in the REFCODES.ORG artifacts which is intended to print to the console uses this method to determine some heuristic best console height.

Returns:

A sound heuristic console height.

toPropertyValue

public static String toPropertyValue(String aDefaultValue,
                                     org.refcodes.data.SystemProperty aSystemProperty,
                                     org.refcodes.data.EnvironmentProperty... aEnvironmentProperties)

Gets the value for the provided properties, if non was found then the default value is taken. A SystemProperty elements wins over the EnvironmentProperty elements. The preceding EnvironmentProperty element wins over the succeeding EnvironmentProperty element. The default value is taken if non property had a value (a String with length > 0).

Parameters:

aDefaultValue - The default value to take when none other value was set.

aSystemProperty - The system-property passed via java -D<name>=<value>

aEnvironmentProperties - The properties looked for in the system's environment variables.

Returns:

The best fitting value.

toPropertyValue

public static String toPropertyValue(org.refcodes.data.SystemProperty aSystemProperty,
                                     org.refcodes.data.EnvironmentProperty... aEnvironmentProperties)

Gets the value for the provided properties, if non was found then null is returned. A SystemProperty elements wins over the EnvironmentProperty elements. The preceding EnvironmentProperty element wins over the succeeding EnvironmentProperty element. A null is taken if non property had a value (a String with length > 0).

Parameters:

aSystemProperty - The system-property passed via java -D<name>=<value>

aEnvironmentProperties - The properties looked for in the system's environment variables.

Returns:

The best fitting value or null if none was detected.

exec

public static String exec(String aCommand)
                   throws IOException,
                          InterruptedException

Executes a command and returns the output.

Parameters:

aCommand - the a command

Returns:

Null if execution failed, else the according output. An empty String stands fur successful execution.

Throws:

IOException - in case there were problems executing the command.

InterruptedException - thrown in case execution as been interrupted.

isAnsiTerminal

public static boolean isAnsiTerminal()

Determines whether ANSI escape sequences are supported by the terminal.

Returns:

True in case ANSI escape sequences are supported, else false.

toAnsiConsole

public static boolean toAnsiConsole()

Determines whether ANSI escape sequences are forced to be supported or not by REFCODES.ORG artifacts. This overrules isAnsiTerminal() for the REFCODES.ORG artifacts. Various settings such as SystemProperty.CONSOLE_ANSI and (in this order) EnvironmentProperty.CONSOLE_ANSI overrule isAnsiTerminal().

Returns:

True in case ANSI escape sequences are forced to be used by REFCODES.ORG artifacts or not.

getTempDir

public static File getTempDir()

Returns the operating saystem's temp folder.

Returns:

The folder used by the OS for storing temporary files.

getSystemEncoding

public static String getSystemEncoding()

Determines the encoding of the system (system's console) in use as of System.out.

Returns:

The encoding (of the console).

toSystemInfo

public static String toSystemInfo()

Prints out all available system information from this Artifac's point of view.

Returns:

A String having available information gathered.