jsimple.util

Class PlatformUtils

java.lang.Object

jsimple.util.PlatformUtilsBase

jsimple.util.PlatformUtils

public class PlatformUtils
extends PlatformUtilsBase

Since:

10/21/12 10:39 PM

Field Summary

Fields inherited from class jsimple.util.PlatformUtilsBase

currentTimeOverride

Constructor Summary

Constructors

Constructor and Description
PlatformUtils()

Method Summary

Modifier and Type	Method and Description
static void	arraycopy(java.lang.Object src, int srcPos, java.lang.Object dest, int destPos, int length) Copies the number of length elements of the Array src starting at the offset srcPos into the Array dest at the position destPos.
static void	copyBytes(byte[] src, int srcPos, byte[] dest, int destPos, int length) Copy data from source byte array to destination byte array.
static void	copyChars(char[] src, int srcPos, char[] dest, int destPos, int length) Copy data from source char array to destination char array.
static void	copyChars(java.lang.String src, int srcPos, char[] dest, int destPos, int length) Copy characters from source string to destination char array.
static <T> T	defaultValue()
static long	doubleToRawLongBits(double value) Encode a double in a long.
static void	exit(int code) Causes the virtual machine to stop running and the program to exit.
static java.lang.String	getExceptionDescription(java.lang.Throwable e) Get the message + stack trace associated with this exception.
static java.lang.String	getLineSeparator() Get the default line separator (typically newline or carriage return/newline) for the platform.
static long	platformGetCurrentTimeMillis() Get the number of milliseconds since Jan 1, 1970, UTC time.
static double	rawLongBitsToDouble(long value) Encode a long in a double.
static void	sleep(int sleepTimeInMilliseconds) Make the current thread sleep for the specified number of milliseconds.
static void	useSystemProxy() Use the whatever proxy settings are configured in the OS.

Methods inherited from class jsimple.util.PlatformUtilsBase

getCurrentTimeMillis, setCurrentTimeOverride

Methods inherited from class java.lang.Object

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

Constructor Detail

PlatformUtils

public PlatformUtils()

Method Detail

platformGetCurrentTimeMillis

public static long platformGetCurrentTimeMillis()

Get the number of milliseconds since Jan 1, 1970, UTC time. That's also known as epoch time. It's the time unit we generally use in JSimple.

Returns:

number of milliseconds since 1/1/70 UTC/GMT

getLineSeparator

public static java.lang.String getLineSeparator()

Get the default line separator (typically newline or carriage return/newline) for the platform.

Returns:

default line separator for the platform

getExceptionDescription

public static java.lang.String getExceptionDescription(java.lang.Throwable e)

Get the message + stack trace associated with this exception.

Parameters:

e - throwable in question

Returns:

string containing the message & stack trace for the exception

sleep

public static void sleep(int sleepTimeInMilliseconds)

Make the current thread sleep for the specified number of milliseconds.

Parameters:

sleepTimeInMilliseconds - time to sleep, in milliseconds

copyBytes

public static void copyBytes(byte[] src,
                             int srcPos,
                             byte[] dest,
                             int destPos,
                             int length)

Copy data from source byte array to destination byte array.

Parameters:

src - source array

srcPos - starting position in source array

dest - destination array

destPos - position in destination array

length - number of elements to copy

copyChars

public static void copyChars(char[] src,
                             int srcPos,
                             char[] dest,
                             int destPos,
                             int length)

Copy data from source char array to destination char array.

Parameters:

src - source array

srcPos - starting position in source array

dest - destination array

destPos - position in destination array

length - number of elements to copy

copyChars

public static void copyChars(java.lang.String src,
                             int srcPos,
                             char[] dest,
                             int destPos,
                             int length)

Copy characters from source string to destination char array.

Parameters:

src - source string

srcPos - starting position in source string

dest - destination array

destPos - position in destination array

length - number of elements to copy

useSystemProxy

public static void useSystemProxy()

Use the whatever proxy settings are configured in the OS. On some platform, by default no web proxy is used. Calling this method causes the OS proxy default to be used instead.

doubleToRawLongBits

public static long doubleToRawLongBits(double value)

Encode a double in a long. The precise format of the bits in the long are platform dependent; for most platforms it's IEEE 754 but that's not guaranteed (e.g. a future Java -> C++ translator wouldn't guarantee that). The only guarantee made here is that rawLlongBitsToDouble(doubleToRawLongBits(x)) should produce the original x input.

Parameters:

value - input double value

Returns:

long representation of that double

rawLongBitsToDouble

public static double rawLongBitsToDouble(long value)

Encode a long in a double. The precise format of the bits in the double are platform dependent. The only guarantee made here is that rawLongBitsToDouble(doubleToRawLongBits(x)) should produce the original x input.

Parameters:

value - input long value

Returns:

double representation of that value, undoing the transformation done by doubleToRawLongBits

defaultValue

public static <T> T defaultValue()

arraycopy

public static void arraycopy(java.lang.Object src,
                             int srcPos,
                             java.lang.Object dest,
                             int destPos,
                             int length)

Copies the number of length elements of the Array src starting at the offset srcPos into the Array dest at the position destPos.

Parameters:

src - the source array to copy the content.

srcPos - the starting index of the content in src.

dest - * the destination array to copy the data into.

destPos - the starting index for the copied content in dest.

length - the number of elements of the array1 content they have to be copied.

exit

public static void exit(int code)

Causes the virtual machine to stop running and the program to exit. If #runFinalizersOnExit(boolean) has been previously invoked with a true argument, then all objects will be properly garbage-collected and finalized first.

Parameters:

code - the return code.

Throws:

java.lang.SecurityException - if the running thread has not enough permission to exit the virtual machine.

See Also:

SecurityManager.checkExit(int)