com.mockrunner.util.common

Class ArrayUtil

java.lang.Object

com.mockrunner.util.common.ArrayUtil

public class ArrayUtil
extends Object

Util class for arrays

Constructor Summary

Constructors

Constructor and Description
ArrayUtil()

Method Summary

Methods

Modifier and Type	Method and Description
static void	addBytesToList(byte[] data, int offset, int len, List<Byte> list, int index) Copies the bytes from the specified array to the specified List as Byte objects starting at the specified index.
static void	addBytesToList(byte[] data, List<Byte> list, int index) Copies the bytes from the specified array to the specified List as Byte objects starting at the specified index.
static boolean	areArraysEqual(Object array1, Object array2) Compares the two specified arrays.
static int	computeHashCode(Object array) Returns a suitable hash code for the specified array.
static Object	convertToArray(Object object) Creates an array with a single object as component.
static Object[]	convertToObjectArray(Object sourceArray) Returns an object array by wrapping primitive types.
static Object	convertToPrimitiveArray(Object[] sourceArray) Returns a primitive array by unwrapping the corresponding types.
static Object	copyArray(Object array) Returns a copy of the specified array.
static void	ensureUnique(String[] values) Ensures that each entry in the specified string array is unique by adding a number to duplicate entries.
static byte[]	getByteArrayFromList(List<Byte> data) Returns a byte array containing the bytes from the List.
static byte[]	getByteArrayFromList(List<Byte> data, int index) Returns a byte array containing the bytes from the List.
static byte[]	getByteArrayFromList(List<Byte> data, int index, int len) Returns a byte array containing the bytes from the List.
static List<Byte>	getListFromByteArray(byte[] data) Returns a List containing the bytes from the specified array as Byte objects.
static int	indexOf(byte[] source, byte[] bytes) Returns the index of the first occurence of the array bytes in the array source.
static int	indexOf(byte[] source, byte[] bytes, int index) Returns the index of the first occurence of the array bytes in the array source.
static Object	truncateArray(Object sourceArray, int len) Returns a truncated copy of sourceArray.
static Object	truncateArray(Object sourceArray, int index, int len) Returns a truncated copy of sourceArray.

Methods inherited from class java.lang.Object

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

Constructor Detail

ArrayUtil

public ArrayUtil()

Method Detail

getListFromByteArray

public static List<Byte> getListFromByteArray(byte[] data)

Returns a List containing the bytes from the specified array as Byte objects.

Parameters:

data - the byte data

Returns:

the List with the Byte objects

getByteArrayFromList

public static byte[] getByteArrayFromList(List<Byte> data)

Returns a byte array containing the bytes from the List. The List must contain Byte objects. null entries in the List are allowed, the resulting byte will be 0.

Parameters:

data - the List

Returns:

the resulting byte array

getByteArrayFromList

public static byte[] getByteArrayFromList(List<Byte> data,
                          int index)

Returns a byte array containing the bytes from the List. The List must contain Byte objects. null entries in the List are allowed, the resulting byte will be 0.

Parameters:

data - the List

index - the index at which to start

Returns:

the resulting byte array

getByteArrayFromList

public static byte[] getByteArrayFromList(List<Byte> data,
                          int index,
                          int len)

Returns a byte array containing the bytes from the List. The List must contain Byte objects. null entries in the List are allowed, the resulting byte will be 0.

Parameters:

data - the List

index - the index at which to start

len - the number of bytes

Returns:

the resulting byte array

addBytesToList

public static void addBytesToList(byte[] data,
                  List<Byte> list,
                  int index)

Copies the bytes from the specified array to the specified List as Byte objects starting at the specified index. Grows the list if necessary. index must be a valid index in the list.

Parameters:

data - the byte data

list - the List

index - the index at which to start copying

addBytesToList

public static void addBytesToList(byte[] data,
                  int offset,
                  int len,
                  List<Byte> list,
                  int index)

Copies the bytes from the specified array to the specified List as Byte objects starting at the specified index. Grows the list if necessary. index must be a valid index in the list.

Parameters:

data - the byte data

offset - the offset into the byte array at which to start

len - the number of bytes to copy

list - the List

index - the index at which to start copying

truncateArray

public static Object truncateArray(Object sourceArray,
                   int len)

Returns a truncated copy of sourceArray. len entries are copied.

Parameters:

sourceArray - the source array

len - the truncate length

Returns:

the truncated array

Throws:

IllegalArgumentException - if the specified object is not an array (either of reference or primitive component type)

truncateArray

public static Object truncateArray(Object sourceArray,
                   int index,
                   int len)

Returns a truncated copy of sourceArray. len entries are copied starting at the specified index.

Parameters:

sourceArray - the source array

index - the start index

len - the truncate length

Returns:

the truncated array

Throws:

IllegalArgumentException - if the specified object is not an array (either of reference or primitive component type)

copyArray

public static Object copyArray(Object array)

Returns a copy of the specified array. If array is not an array, the object itself will be returned. Otherwise a copy of the array will be returned. The components themselves are not cloned.

Parameters:

array - the array

Returns:

the copy of the array

convertToObjectArray

public static Object[] convertToObjectArray(Object sourceArray)

Returns an object array by wrapping primitive types. If the specified array is of primitive component type, an Object[] with the corresponding wrapper component type is returned. If the specified array is already an object array, the instance is returned unchanged.

Parameters:

sourceArray - the array

Returns:

the corresponding object array

Throws:

IllegalArgumentException - if the specified object is not an array (either of reference or primitive component type)

convertToPrimitiveArray

public static Object convertToPrimitiveArray(Object[] sourceArray)

Returns a primitive array by unwrapping the corresponding types. If the specified array is not an array of primitive wrapper types (e.g. Integer[]), an IllegalArgumentException will be thrown. If an array element is null, an IllegalArgumentException will be thrown.

Parameters:

sourceArray - the array

Returns:

the corresponding primitive array

Throws:

IllegalArgumentException - if the specified array is not an array of primitive wrapper types or if an array element is null

convertToArray

public static Object convertToArray(Object object)

Creates an array with a single object as component. If the specified object is an array, it will be returned unchanged. Otherwise an array with the specified object as the single element will be returned.

Parameters:

object - the object

Returns:

the corresponding array

areArraysEqual

public static boolean areArraysEqual(Object array1,
                     Object array2)

Compares the two specified arrays. If both passed objects are null, true is returned. If both passed objects are not arrays, they are compared using equals. Otherwise all array elements are compared using equals. This method does not handle multidimensional arrays, i.e. if an array contains another array, comparison is based on identity.

Parameters:

array1 - the first array

array2 - the second array

Returns:

true if the arrays are equal, false otherwise

computeHashCode

public static int computeHashCode(Object array)

Returns a suitable hash code for the specified array. If the passed object is null, 0 is returned. It is allowed to pass an object that is not an array, in this case, the hash code of the object will be returned. Otherwise the hash code will be based on the array elements. null elements are allowed. This method does not handle multidimensional arrays, i.e. if an array contains another array, the hash code is based on identity.

Parameters:

array - the array

Returns:

a suitable hash code

indexOf

public static int indexOf(byte[] source,
          byte[] bytes)

Returns the index of the first occurence of the array bytes in the array source.

Parameters:

source - the array in which to search

bytes - the array to search

Returns:

the index of the first occurence or -1, if source does not contain bytes

indexOf

public static int indexOf(byte[] source,
          byte[] bytes,
          int index)

Returns the index of the first occurence of the array bytes in the array source.

Parameters:

source - the array in which to search

bytes - the array to search

index - the index where to begin the search

Returns:

the index of the first occurence or -1, if source does not contain bytes

ensureUnique

public static void ensureUnique(String[] values)

Ensures that each entry in the specified string array is unique by adding a number to duplicate entries. I.e. if the string "entry" occurs three times, the three entries will be renamed to "entry1", "entry2" and "entry3".

Parameters:

values - the array of strings