io.nem.symbol.core.utils

Class ConvertUtils

java.lang.Object

io.nem.symbol.core.utils.ConvertUtils

public class ConvertUtils
extends java.lang.Object

Static class that contains utility functions for converting hex strings to and from bytes.

Method Summary

Modifier and Type	Method and Description
static byte[]	fromHexToBytes(java.lang.String hexString) Converts an hex back to an byte array.
static java.lang.String	fromHexToString(java.lang.String hexString) Converts hex string to a plain string
static java.lang.String	fromStringToHex(java.lang.String plainText) Converts plain string to an hex string
static byte[]	getBytes(java.lang.String hexString) Converts a hex string to a byte array.
static boolean	isHexString(java.lang.String input) Determines whether or not a string is a hex string.
static java.lang.String	padHex(java.lang.String hex, int hexStringSize) Adds 0 to the left of the hex to convert the hex to the right size.
static java.lang.String	reverseHexString(java.lang.String hex) Reversed conversion of an hex string to a new hex
static java.lang.String	toHex(byte[] bytes) Converts a byte array to a hex string.
static java.lang.String	toSize16Hex(java.math.BigInteger number) Converts a number to hex padding zeros up to size 16.
static java.lang.String	toString(java.math.BigInteger number) Converts a BigInteger to an string.
static java.math.BigInteger	toUnsignedBigInteger(java.math.BigInteger value) It converts a signed BigInteger into an unsigned BigInteger.
static java.math.BigInteger	toUnsignedBigInteger(long value) It converts a signed long into an unsigned BigInteger.
static void	validateIsHexString(java.lang.String input) Validates that an input is a valid hex .
static void	validateIsHexString(java.lang.String input, java.lang.Integer size) Validates that an input is a valid hex and of the given size.
static void	validateNotNegative(java.math.BigInteger number) Validates that the provided number is not negative
static void	validateNotNegative(long number) Validates that the provided number is not negative
static byte[]	xor(byte[] b1, byte[] b2) It xors two bytes array into one.
static org.apache.commons.lang3.tuple.Pair<java.lang.String,java.lang.Integer>	xorValues(java.lang.String originalValue, java.lang.String newValue) A method that XORs to values.

Methods inherited from class java.lang.Object

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

Method Detail

getBytes

public static byte[] getBytes(java.lang.String hexString)

Converts a hex string to a byte array.

Parameters:

hexString - The input hex string.

Returns:

The output byte array.

toHex

public static java.lang.String toHex(byte[] bytes)

Converts a byte array to a hex string.

Parameters:

bytes - The input byte array.

Returns:

The output hex string.

padHex

public static java.lang.String padHex(java.lang.String hex,
                                      int hexStringSize)

Adds 0 to the left of the hex to convert the hex to the right size.

Parameters:

hex - the hex

hexStringSize - the expected hex string size

Returns:

the hex with 0.

fromHexToBytes

public static byte[] fromHexToBytes(java.lang.String hexString)

Converts an hex back to an byte array.

Parameters:

hexString - the hex string input

Returns:

the byte array.

xorValues

public static org.apache.commons.lang3.tuple.Pair<java.lang.String,java.lang.Integer> xorValues(java.lang.String originalValue,
                                                                                                java.lang.String newValue)

A method that XORs to values.

Parameters:

originalValue - the original value

newValue - the new value

Returns:

the xor plus the delta.

fromHexToString

public static java.lang.String fromHexToString(java.lang.String hexString)

Converts hex string to a plain string

Parameters:

hexString - The input string.

Returns:

The output plain string.

fromStringToHex

public static java.lang.String fromStringToHex(java.lang.String plainText)

Converts plain string to an hex string

Parameters:

plainText - The plain input string.

Returns:

The output hex string.

toSize16Hex

public static java.lang.String toSize16Hex(java.math.BigInteger number)

Converts a number to hex padding zeros up to size 16.

Parameters:

number - The input number.

Returns:

the hex 16 characters

validateNotNegative

public static void validateNotNegative(java.math.BigInteger number)

Validates that the provided number is not negative

Parameters:

number - the number to be tested.

Throws:

java.lang.IllegalArgumentException - if the number is null or negative

validateNotNegative

public static void validateNotNegative(long number)

Validates that the provided number is not negative

Parameters:

number - the number to be tested.

Throws:

java.lang.IllegalArgumentException - if the number is negative

toString

public static java.lang.String toString(java.math.BigInteger number)

Converts a BigInteger to an string.

Parameters:

number - the input

Returns:

String.

toUnsignedBigInteger

public static java.math.BigInteger toUnsignedBigInteger(long value)

It converts a signed long into an unsigned BigInteger. It fixes overflow problems that could happen when working with unsigned int 64.

Parameters:

value - the value, positive or negative.

Returns:

the positive BigInteger.

toUnsignedBigInteger

public static java.math.BigInteger toUnsignedBigInteger(java.math.BigInteger value)

It converts a signed BigInteger into an unsigned BigInteger. It fixes overflow problems that could happen when working with unsigned int 64.

Parameters:

value - the value, positive or negative.

Returns:

the positive BigInteger.

isHexString

public static boolean isHexString(java.lang.String input)

Determines whether or not a string is a hex string.

Parameters:

input - The string to test.

Returns:

boolean true if the input is a hex string, false otherwise.

validateIsHexString

public static void validateIsHexString(java.lang.String input)

Validates that an input is a valid hex . If not, it raises a IllegalArgumentException

Parameters:

input - the string input

Throws:

java.lang.IllegalArgumentException - if the input is null or not an hex.

validateIsHexString

public static void validateIsHexString(java.lang.String input,
                                       java.lang.Integer size)

Validates that an input is a valid hex and of the given size. If not, it raises a IllegalArgumentException

Parameters:

input - the string input

size - the expected hex size.

Throws:

java.lang.IllegalArgumentException - if the input is null, not an hex or it has an invalid size.

reverseHexString

public static java.lang.String reverseHexString(java.lang.String hex)

Reversed conversion of an hex string to a new hex

Parameters:

hex - the hex string.

Returns:

the new hex string.

xor

public static byte[] xor(byte[] b1,
                         byte[] b2)

It xors two bytes array into one.

Parameters:

b1 - the first byte array

b2 - the second byte array

Returns:

the bite array with a size of the biggest parameter.