org.safs

Class Utils

java.lang.Object

org.safs.Utils

public abstract class Utils
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DEFAULT_JAVA_COMPILER 'javac' the default java compiler.
static java.lang.String	DEFAULT_OUTPUT_DIRECTORY 'bin' the sub-folder containing compiled classes.
static java.lang.String	DEFAULT_SOURCE_DIRECTORY 'src' the sub-folder containing java/groovy source code.
static java.lang.String	FILE_SUFFIX_GROOVY '.groovy' the suffix of groovy source code.
static java.lang.String	FILE_SUFFIX_JAVA '.java' the suffix of java source code.

Constructor Summary

Constructors

Constructor and Description
Utils()

Method Summary

Modifier and Type	Method and Description
static void	compile(java.lang.String classnames) Compile the java/groovy source code. NOTE: 1.
static void	compile(java.lang.String classnames, java.lang.String sourceDIR, java.lang.String outDIR, java.lang.String useClasspath) Compile java and/or groovy source code.
static boolean	equals(java.lang.Object value1, java.lang.Object value2) Compare 2 objects even they are multiple-dimension arrays.
static java.lang.Object[]	getArray(java.lang.Object array)
static java.lang.Object	getMapValue(java.util.Map<?,?> map, java.lang.Object key, java.lang.Object defaultValue) Get the value form the map according to a key. If the map is null or the value is null, then return the default value.
static boolean	getNumLock()
static void	main(java.lang.String[] params) java -ea org.safs.Utils
static void	makeRunAsAdministrator(java.lang.String lnkFileName) Change the windows .lnk file's property to make it "Run As Administrator".
static java.lang.Object	parseValue(java.lang.Class<?> expectedType, java.lang.Object value) Convert the parameter 'value' to an appropriate Object according to the expectedType.
static void	setNumLock(boolean onOff)
static java.lang.String	toString(java.lang.Object object) Convert an Object to a string, even this object is a multiple dimension array.

Methods inherited from class java.lang.Object

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

Field Detail

FILE_SUFFIX_JAVA

public static final java.lang.String FILE_SUFFIX_JAVA

'.java' the suffix of java source code.

See Also:

Constant Field Values

FILE_SUFFIX_GROOVY

public static final java.lang.String FILE_SUFFIX_GROOVY

'.groovy' the suffix of groovy source code.

See Also:

Constant Field Values

DEFAULT_SOURCE_DIRECTORY

public static final java.lang.String DEFAULT_SOURCE_DIRECTORY

'src' the sub-folder containing java/groovy source code.

See Also:

Constant Field Values

DEFAULT_OUTPUT_DIRECTORY

public static final java.lang.String DEFAULT_OUTPUT_DIRECTORY

'bin' the sub-folder containing compiled classes.

See Also:

Constant Field Values

DEFAULT_JAVA_COMPILER

public static final java.lang.String DEFAULT_JAVA_COMPILER

'javac' the default java compiler.

See Also:

Constant Field Values

Constructor Detail

Utils

public Utils()

Method Detail

setNumLock

public static void setNumLock(boolean onOff)

Parameters:

onOff - boolean, Set keyboard's 'NumLock' on or off.

getNumLock

public static boolean getNumLock()

Returns:

boolean, the current keyboard's 'NumLock' status.

compile

public static void compile(java.lang.String classnames)
                    throws SAFSException

Compile the java/groovy source code.
NOTE:
1. It is supposed the "source codes" resides in the "src" sub-folder of the root directory.
The "compiled classes" will be put the the "bin" sub-folder of the root directory.
2. Any dependency jars should be included in the environment "CLASSPATH" before this compilation.
File structure:

 root
   + "src" (source files folder)
      + package1
      + package2
   + "bin" (compiled classes go into this folder--which will be created if not already present.)
 

Parameters:

classnames - String, the class names to compile separated by space, such as my.package.ClassA my.pack2.ClassB
this parameter could be mixed with java and groovy class.
Note: For groovy, we have to specify all dependency classes in order.

Throws:

SAFSException - if the compilation failed for any reason--including bad parameter values.

compile

public static void compile(java.lang.String classnames,
                           java.lang.String sourceDIR,
                           java.lang.String outDIR,
                           java.lang.String useClasspath)
                    throws SAFSException

Compile java and/or groovy source code.

Parameters:

classnames - String, the class names to compile separated by space, such as my.package.ClassA my.pack2.ClassB
this parameter could be mixed with java and groovy class.
Note: For groovy, we have to specify all dependency classes in order.

sourceDIR - String, the root directory off which the sourcecode files reside.

outDIR - String, the root directory off which the compiled classes will be stored. The directory will be created, if necessary.

useClasspath - String, the semi-colon separated CLASSPATH to be used for the compile.

Throws:

SAFSException - if the compilation failed for any reason--including bad parameter values.

getMapValue

public static java.lang.Object getMapValue(java.util.Map<?,?> map,
                                           java.lang.Object key,
                                           java.lang.Object defaultValue)

Get the value form the map according to a key.
If the map is null or the value is null, then return the default value.

Parameters:

map - Map

key - Object,

defaultValue - Object,

Returns:

Object

parseValue

public static java.lang.Object parseValue(java.lang.Class<?> expectedType,
                                          java.lang.Object value)
                                   throws SAFSException

Convert the parameter 'value' to an appropriate Object according to the expectedType.

Parameters:

expectedType - Class, the expected field type

value - Object, the value to parse.

Returns:

Object, the converted Object.

Throws:

SAFSException

getArray

public static java.lang.Object[] getArray(java.lang.Object array)
                                   throws SAFSException

Parameters:

array - Object, an array object.

Returns:

Object[]

Throws:

SAFSException

toString

public static java.lang.String toString(java.lang.Object object)

Convert an Object to a string, even this object is a multiple dimension array.

Parameters:

object - Object

Returns:

String

equals

public static boolean equals(java.lang.Object value1,
                             java.lang.Object value2)

Compare 2 objects even they are multiple-dimension arrays.

Parameters:

value1 - Object

value2 - Object

Returns:

boolean

makeRunAsAdministrator

public static void makeRunAsAdministrator(java.lang.String lnkFileName)
                                   throws java.io.IOException

Change the windows .lnk file's property to make it "Run As Administrator".

Parameters:

lnkFileName - String, the full path to a link file

Throws:

java.io.IOException

main

public static void main(java.lang.String[] params)

java -ea org.safs.Utils