net.studioblueplanet.generics

Class ToolBox

java.lang.Object

net.studioblueplanet.generics.ToolBox

public class ToolBox
extends Object

Author:

jorgen.van.der.velde

Constructor Summary

Constructors

Constructor and Description
ToolBox()

Method Summary

Modifier and Type	Method and Description
static String	bytesToHexString(byte[] bytes, int stringLength) Convert byte array to hex string
static void	disableCertificateValidation() Disable SSL Certificate validation
static double	distance(double startLat, double startLong, double endLat, double endLong) Calculates the distance between two coordinates
static byte[]	getBytesFromInputStream(InputStream is) Reads all bytes from an input stream
static byte[]	getUUID() Return UUID as buffer of 16 bytes
static byte[]	hexStringToBytes(String hexString, int arraySize) Convert String to array of bytes
static byte[]	readBytesFromFile(String fileName) Reads byte array from file
static byte[]	readBytesFromUrl(String urlString) Reads bytes from indicated URL.
static float	readFloat(byte[] data, int offset, boolean isLittleEndian) Read a float value from the byte array.
static int	readInt(byte[] data, int offset, int bytes, boolean isLittleEndian) Read an signed integer value from the byte array
static String	readString(byte[] data, int offset, int chars) Reads a string from the input stream.
static String	readStringFromUrl(String urlString) Request page.
static String	readStringFromUtf8File(String fileName) Reads the content of a UTF-8 file into a string
static int	readUnsignedInt(byte[] data, int offset, int bytes, boolean isLittleEndian) Read an unsigned integer value from the byte array
static long	readUnsignedLong(byte[] data, int offset, int bytes, boolean isLittleEndian) Read an unsigned integer value from the byte array
static String	secondsToHours(int seconds) Returns the number of seconds as string in the format 5h03'02"
static boolean	writeBytesToFile(String fileName, byte[] bytes) This method writes the bytes to a binary file
static void	writeFloat(byte[] data, float value, int offset, boolean isLittleEndian) Writes a float to the byte array
static boolean	writeStringToFile(String fileName, String string) Write string to file
static boolean	writeStringToUtf8File(String fileName, String utf8String) Handy piece of code to write JSON as UTF-8 to file
static void	writeUnsignedInt(byte[] data, int value, int offset, int bytes, boolean isLittleEndian) Writes the given value (value) in the byte array (data) at given location (offset).
static void	writeUnsignedLong(byte[] data, long value, int offset, int bytes, boolean isLittleEndian) Writes the given value (value) in the byte array (data) at given location (offset).

Methods inherited from class java.lang.Object

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

Constructor Detail

ToolBox

public ToolBox()

Method Detail

disableCertificateValidation

public static void disableCertificateValidation()

Disable SSL Certificate validation

readUnsignedInt

public static int readUnsignedInt(byte[] data,
                                  int offset,
                                  int bytes,
                                  boolean isLittleEndian)

Read an unsigned integer value from the byte array

Parameters:

data - Byte array

offset - Offset where to start

bytes - Number of bytes to be read in the int

isLittleEndian - Indicates whether the byte array is LittleEndian or BigEndian

Returns:

The integer value

readUnsignedLong

public static long readUnsignedLong(byte[] data,
                                    int offset,
                                    int bytes,
                                    boolean isLittleEndian)

Read an unsigned integer value from the byte array

Parameters:

data - Byte array

offset - Offset where to start

bytes - Number of bytes to be read in the int

isLittleEndian - Indicates whether the byte array is LittleEndian or BigEndian

Returns:

The integer value

readInt

public static int readInt(byte[] data,
                          int offset,
                          int bytes,
                          boolean isLittleEndian)

Read an signed integer value from the byte array

Parameters:

data - Byte array

offset - Offset where to start

bytes - Number of bytes to be read in the int

isLittleEndian - Indicates whether the byte array is LittleEndian or BigEndian

Returns:

The integer value

readFloat

public static float readFloat(byte[] data,
                              int offset,
                              boolean isLittleEndian)

Read a float value from the byte array. A float value is constructed from 4 bytes

Parameters:

data - Byte array

offset - Offset where to start

isLittleEndian - Indicates whether the byte array is LittleEndian or BigEndian

Returns:

The float value

writeFloat

public static void writeFloat(byte[] data,
                              float value,
                              int offset,
                              boolean isLittleEndian)

Writes a float to the byte array

Parameters:

data - Byte array

value - Float value to write

offset - Offset in the byte array

isLittleEndian - Indicates whether the byte array is LittleEndian or BigEndian

readString

public static String readString(byte[] data,
                                int offset,
                                int chars)

Reads a string from the input stream.

Parameters:

data - Byte array containing the data

offset - Offset in the array

chars - Number of characters to read

Returns:

The string read or "Error" if failed

writeUnsignedInt

public static void writeUnsignedInt(byte[] data,
                                    int value,
                                    int offset,
                                    int bytes,
                                    boolean isLittleEndian)

Writes the given value (value) in the byte array (data) at given location (offset). The value is assumed to be (bytes) long. If isLittleEndian, the least significant byte (lsb) is written as the first byte in the byte array, followed by the higher significant bytes. If not isLittleEndian the most significant byte (msb) is written first, followed by the less significant bytes.

Parameters:

data - Array to write the value to

value - Value to write

offset - Offset in the byte array where the value is written

bytes - Number of bytes making up the integer value (1-4)

isLittleEndian - True for little endian, false for big endian

writeUnsignedLong

public static void writeUnsignedLong(byte[] data,
                                     long value,
                                     int offset,
                                     int bytes,
                                     boolean isLittleEndian)

Writes the given value (value) in the byte array (data) at given location (offset). The value is assumed to be (bytes) long. If isLittleEndian, the least significant byte (lsb) is written as the first byte in the byte array, followed by the higher significant bytes. If not isLittleEndian the most significant byte (msb) is written first, followed by the less significant bytes.

Parameters:

data - Array to write the value to

value - Value to write

offset - Offset in the byte array where the value is written

bytes - Number of bytes making up the integer value (1-4)

isLittleEndian - True for little endian, false for big endian

secondsToHours

public static String secondsToHours(int seconds)

Returns the number of seconds as string in the format 5h03'02"

Parameters:

seconds - The seconds to convert

Returns:

The string with the duration

readStringFromUrl

public static String readStringFromUrl(String urlString)

Request page. Applies to text, json, xml, etc files

Parameters:

urlString - URL of the page

Returns:

The page as string

readBytesFromUrl

public static byte[] readBytesFromUrl(String urlString)

Reads bytes from indicated URL. Applies to binary files

Parameters:

urlString - The URL to read from

Returns:

The byte array or null if something went wrong.

readBytesFromFile

public static byte[] readBytesFromFile(String fileName)

Reads byte array from file

Parameters:

fileName - The file to read

Returns:

The byte array or null if something went wrong

readStringFromUtf8File

public static String readStringFromUtf8File(String fileName)

Reads the content of a UTF-8 file into a string

Parameters:

fileName - Name of the UTF-8 encoded file

Returns:

The string read or null if not succeeded

writeBytesToFile

public static boolean writeBytesToFile(String fileName,
                                       byte[] bytes)

This method writes the bytes to a binary file

Parameters:

fileName - File name of the file to write to

bytes - Bytes to write

Returns:

False if all went ok, true if an error occurred

writeStringToFile

public static boolean writeStringToFile(String fileName,
                                        String string)

Write string to file

Parameters:

fileName - Filename to use

string - String to write

Returns:

False if all went ok, true if an error occurred

writeStringToUtf8File

public static boolean writeStringToUtf8File(String fileName,
                                            String utf8String)

Handy piece of code to write JSON as UTF-8 to file

Parameters:

fileName - Filename to write to

utf8String - String (JSON) to write

Returns:

True when an error occurred

getBytesFromInputStream

public static byte[] getBytesFromInputStream(InputStream is)

Reads all bytes from an input stream

Parameters:

is - Input stream

Returns:

Byte array containing the bytes or null if not successful

distance

public static double distance(double startLat,
                              double startLong,
                              double endLat,
                              double endLong)

Calculates the distance between two coordinates

Parameters:

startLat - First coordinate latitude

startLong - First coordinate longitude

endLat - Second coordinate latitude

endLong - Second coordinate longitude

Returns:

Distance in km

getUUID

public static byte[] getUUID()

Return UUID as buffer of 16 bytes

Returns:

UUID as 16 bytes

hexStringToBytes

public static byte[] hexStringToBytes(String hexString,
                                      int arraySize)

Convert String to array of bytes

Parameters:

hexString - String to convert

arraySize - Size of the byte array. Zero's are added at msb side

Returns:

Byte array

bytesToHexString

public static String bytesToHexString(byte[] bytes,
                                      int stringLength)

Convert byte array to hex string

Parameters:

bytes - Byte array to convert

stringLength - Length to which the string must be padded

Returns:

String