Tools (MtGox Java API 0.1.8 API)

java.lang.Object
- org.jwebsocket.util.Tools

```
public class Tools
extends Object
```
Provides some convenience methods to support the web socket development.

Author:

aschulze

Field Summary

Fields
Modifier and Type Field and Description

static boolean EXPAND_CASE_INSENSITIVE

static boolean EXPAND_CASE_SENSITIVE

Fields
Modifier and Type	Field and Description
`static boolean`	`EXPAND_CASE_INSENSITIVE`
`static boolean`	`EXPAND_CASE_SENSITIVE`

Constructor Summary

Constructors
Constructor and Description

Tools()

Constructors
Constructor and Description
`Tools()`

Method Summary

Methods
Modifier and Type	Method and Description
`static String`	`appendTrailingSeparator(String aPath)` Checks if a path has trailing separator, if not it appends the correct one according to the operating system.
`static String`	`base64Encode(byte[] aBA)`
`static Object`	`castGenericToJava(Object aValue, String aFromType, String aToType)` Tries to convert a given object into the given java data type
`static String`	`DateToISO8601(Date aDate)`
`static String`	`DateToISO8601WithMillis(Date aDate)`
`static String`	`expandEnvVars(String aString)` Replaces all pattern ${name} in a string by the values of the corresponding environment variable.
`static String`	`expandEnvVarsAndProps(String aString)` Replaces all pattern ${name} in a string by the values of the corresponding environment variable or system property.
`static String`	`expandProps(String aString)` Replaces all pattern ${name} in a string by the values of the corresponding system property.
`static String`	`expandVars(String aString, Map<String,String> aVars, boolean aIgnoreCase)`
`static String`	`getGenericTypeStringFromJavaClassname(String aClassname)` Tries to convert a given object into the given java data type
`static String`	`getJavaClassnameFromGenericType(String aGenericType)` Tries to convert a generic type to the correspondant java type
`static String`	`getMD5(String aMsg)` Returns the MD5 sum of the given string.
`static String`	`getSHA1(String aMsg)` Returns the SHA1 sum of the given string.
`static Timer`	`getTimer()`
`static String`	`hexByteArrayToString(byte[] aByteArray)` From http://www.rgagnon.com/javadetails/java-0596.html
`static byte[]`	`hexStringToByteArray(String aString)` From http://stackoverflow.com/questions/140131/convert-a-string-representation-of-a-hex-dump-to-a-byte-array-using-java
`static String`	`intToHex(int aInt, int aLen)` Returns the hex value of the given int as a string.
`static String`	`intToString(int aInt, int aLen)` Returns the hex value of the given int as a string.
`static Object`	`invoke(Class aClass, String aMethodName, Object... aArgs)`
`static Object`	`invoke(Object aInstance, String aMethodName, Object... aArgs)`
`static Object`	`invoke(String aClassName, String aMethodName, Object... aArgs)`
`static Object`	`invokeUnique(Class aClass, String aMethodName, Object... aArgs)`
`static Object`	`invokeUnique(Class aClass, String aMethodName, Object[] aArgs, Class[] aClasses)`
`static boolean`	`isCookieValid(URI aURI, HttpCookie aCookie)` Indicates if a cookie is valid for a given URI
`static Date`	`ISO8601ToDate(String aISO8601Date)`
`static List<String>`	`parseStringArrayToList(String[] aArray)`
`static void`	`startUtilityTimer()`
`static void`	`stopUtilityTimer()`
`static int`	`stringToInt(String aString, int aDefault)` Converts a string into an integer value and automatically sets it to a given default value if the string could not be parsed.
`static long`	`stringToLong(String aString, long aDefault)` Converts a string into a long value and automatically sets it to a given default value if the string could not be parsed.

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

- Field Detail
  - EXPAND_CASE_SENSITIVE
```
public static final boolean EXPAND_CASE_SENSITIVE
```
    See Also:
    Constant Field Values
  - EXPAND_CASE_INSENSITIVE
```
public static final boolean EXPAND_CASE_INSENSITIVE
```
    See Also:
    Constant Field Values
- Constructor Detail
  - Tools
```
public Tools()
```
- Method Detail
  - getMD5
```
public static String getMD5(String aMsg)
```
    Returns the MD5 sum of the given string. The output always has 32 digits.
    
    Parameters:
    aMsg - String the string to calculate the MD5 sum for.
    
    Returns:
    MD5 sum of the given string.
  - getSHA1
```
public static String getSHA1(String aMsg)
```
    Returns the SHA1 sum of the given string. The output always has 32 digits.
    
    Parameters:
    aMsg - String the string to calculate the MD5 sum for.
    
    Returns:
    MD5 sum of the given string.
  - intToHex
```
public static String intToHex(int aInt,
              int aLen)
```
    Returns the hex value of the given int as a string. If aLen is greater than zero the output is cut or filled to the given length otherwise the exact number of digits is returned.
    
    Parameters:
    aInt - Integer to be converted into a hex-string.
    aLen - Number of hex digits (optionally filled or cut if needed)
    
    Returns:
    Hex-string of the given integer.
  - intToString
```
public static String intToString(int aInt,
                 int aLen)
```
    Returns the hex value of the given int as a string. If aLen is greater than zero the output is cut or filled to the given length otherwise the exact number of digits is returned.
    
    Parameters:
    aInt - Integer to be converted into a string.
    aLen - Number of digits (optionally filled or cut if needed)
    
    Returns:
    String of the given integer.
  - stringToInt
```
public static int stringToInt(String aString,
              int aDefault)
```
    Converts a string into an integer value and automatically sets it to a given default value if the string could not be parsed.
    
    Parameters:
    aString - string to be converted into an integer.
    aDefault - default value assigned to the result in case of an exception.
    
    Returns:
    integer value of string or given default value in case of exception.
  - stringToLong
```
public static long stringToLong(String aString,
                long aDefault)
```
    Converts a string into a long value and automatically sets it to a given default value if the string could not be parsed.
    
    Parameters:
    aString - string to be converted into a long.
    aDefault - default value assigned to the result in case of an exception.
    
    Returns:
    long value of string or given default value in case of exception.
  - ISO8601ToDate
```
public static Date ISO8601ToDate(String aISO8601Date)
```
    Parameters:
    aISO8601Date -
    
    Returns:
  - DateToISO8601
```
public static String DateToISO8601(Date aDate)
```
    Parameters:
    aDate -
    
    Returns:
  - DateToISO8601WithMillis
```
public static String DateToISO8601WithMillis(Date aDate)
```
    Parameters:
    aDate -
    
    Returns:
  - getJavaClassnameFromGenericType
```
public static String getJavaClassnameFromGenericType(String aGenericType)
```
    Tries to convert a generic type to the correspondant java type
    
    Parameters:
    aGenericType -
    
    Returns:
  - castGenericToJava
```
public static Object castGenericToJava(Object aValue,
                       String aFromType,
                       String aToType)
```
    Tries to convert a given object into the given java data type
    
    Parameters:
    aValue -
    aFromType -
    aToType -
    
    Returns:
  - getGenericTypeStringFromJavaClassname
```
public static String getGenericTypeStringFromJavaClassname(String aClassname)
```
    Tries to convert a given object into the given java data type
    
    Parameters:
    aClassname -
    
    Returns:
  - expandVars
```
public static String expandVars(String aString,
                Map<String,String> aVars,
                boolean aIgnoreCase)
```
    Parameters:
    aString -
    aVars -
    aIgnoreCase -
    
    Returns:
  - expandEnvVars
```
public static String expandEnvVars(String aString)
```
    Replaces all pattern ${name} in a string by the values of the corresponding environment variable.
    
    Parameters:
    aString -
    
    Returns:
  - expandProps
```
public static String expandProps(String aString)
```
    Replaces all pattern ${name} in a string by the values of the corresponding system property.
    
    Parameters:
    aString -
    
    Returns:
  - expandEnvVarsAndProps
```
public static String expandEnvVarsAndProps(String aString)
```
    Replaces all pattern ${name} in a string by the values of the corresponding environment variable or system property. The setting of a system property overrides the setting of the environment variable.
    
    Parameters:
    aString -
    
    Returns:
  - invoke
```
public static Object invoke(String aClassName,
            String aMethodName,
            Object... aArgs)
                     throws Exception
```
    Parameters:
    aClassName -
    aMethodName -
    aArgs -
    
    Returns:
    
    Throws:
    
    Exception
  - invoke
```
public static Object invoke(Class aClass,
            String aMethodName,
            Object... aArgs)
                     throws Exception
```
    Parameters:
    aClass -
    aMethodName -
    aArgs -
    
    Returns:
    
    Throws:
    
    Exception
  - invokeUnique
```
public static Object invokeUnique(Class aClass,
                  String aMethodName,
                  Object... aArgs)
                           throws Exception
```
    Parameters:
    aClass -
    aMethodName -
    aArgs -
    
    Returns:
    
    Throws:
    
    Exception
  - invokeUnique
```
public static Object invokeUnique(Class aClass,
                  String aMethodName,
                  Object[] aArgs,
                  Class[] aClasses)
                           throws Exception
```
    Parameters:
    aClass -
    aMethodName -
    aArgs -
    aClasses -
    
    Returns:
    
    Throws:
    
    Exception
  - invoke
```
public static Object invoke(Object aInstance,
            String aMethodName,
            Object... aArgs)
                     throws Exception
```
    Parameters:
    aInstance -
    aMethodName -
    aArgs -
    
    Returns:
    
    Throws:
    
    Exception
  - base64Encode
```
public static String base64Encode(byte[] aBA)
```
    Parameters:
    aBA -
    
    Returns:
  - parseStringArrayToList
```
public static List<String> parseStringArrayToList(String[] aArray)
```
    Parameters:
    aArray -
    
    Returns:
  - startUtilityTimer
```
public static void startUtilityTimer()
```
  - stopUtilityTimer
```
public static void stopUtilityTimer()
```
  - getTimer
```
public static Timer getTimer()
```
    Returns:
    A jWebSocket shared utility timer
  - hexStringToByteArray
```
public static byte[] hexStringToByteArray(String aString)
```
    From http://stackoverflow.com/questions/140131/convert-a-string-representation-of-a-hex-dump-to-a-byte-array-using-java
    
    Parameters:
    aString -
    
    Returns:
  - hexByteArrayToString
```
public static String hexByteArrayToString(byte[] aByteArray)
```
    From http://www.rgagnon.com/javadetails/java-0596.html
    
    Parameters:
    aByteArray -
    
    Returns:
  - isCookieValid
```
public static boolean isCookieValid(URI aURI,
                    HttpCookie aCookie)
```
    Indicates if a cookie is valid for a given URI
    
    Parameters:
    aURI -
    aCookie -
    
    Returns:
    TRUE if the cookie is valid, FALSE otherwise
  - appendTrailingSeparator
```
public static String appendTrailingSeparator(String aPath)
```
    Checks if a path has trailing separator, if not it appends the correct one according to the operating system.
    
    Parameters:
    aPath - the path to be checked for the trailing separator.
    
    Returns:
    the path ensuring the trailing separator or null if no path was given.

Class Tools

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

EXPAND_CASE_SENSITIVE

EXPAND_CASE_INSENSITIVE

Constructor Detail

Tools

Method Detail

getMD5

getSHA1

intToHex

intToString

stringToInt

stringToLong

ISO8601ToDate

DateToISO8601

DateToISO8601WithMillis

getJavaClassnameFromGenericType

castGenericToJava

getGenericTypeStringFromJavaClassname

expandVars

expandEnvVars

expandProps

expandEnvVarsAndProps

invoke

invoke

invokeUnique

invokeUnique

invoke

base64Encode

parseStringArrayToList

startUtilityTimer

stopUtilityTimer

getTimer

hexStringToByteArray

hexByteArrayToString

isCookieValid

appendTrailingSeparator