newInstance

Creates a new array
with the specified component type and dimensions.
If componentType
represents a non-array class or interface, the new array
has dimensions.length dimensions and
componentType as its component type. If
componentType represents an array class, the
number of dimensions of the new array is equal to the sum
of dimensions.length and the number of
dimensions of componentType. In this case, the
component type of the new array is the component type of
componentType.

The number of dimensions of the new array must not
exceed the number of array dimensions supported by the
implementation (typically 255).

Parameters:

componentType - the Class object representing the component
type of the new array

dimensions - an array of int representing the dimensions of
the new array

IllegalArgumentException - if the specified dimensions
argument is a zero-dimensional array, or if the number of
requested dimensions exceeds the limit on the number of array dimensions
supported by the implementation (typically 255), or if componentType
is Void.TYPE.

IllegalArgumentException - If the specified object argument
is not an array, or if the specified value cannot be converted
to the underlying array's component type by an identity or a
primitive widening conversion

IllegalArgumentException - If the specified object argument
is not an array, or if the specified value cannot be converted
to the underlying array's component type by an identity or a
primitive widening conversion

IllegalArgumentException - If the specified object argument
is not an array, or if the specified value cannot be converted
to the underlying array's component type by an identity or a
primitive widening conversion

IllegalArgumentException - If the specified object argument
is not an array, or if the specified value cannot be converted
to the underlying array's component type by an identity or a
primitive widening conversion

IllegalArgumentException - If the specified object argument
is not an array, or if the specified value cannot be converted
to the underlying array's component type by an identity or a
primitive widening conversion

IllegalArgumentException - If the specified object argument
is not an array, or if the specified value cannot be converted
to the underlying array's component type by an identity or a
primitive widening conversion

IllegalArgumentException - If the specified object argument
is not an array, or if the specified value cannot be converted
to the underlying array's component type by an identity or a
primitive widening conversion

IllegalArgumentException - If the specified object argument
is not an array, or if the specified value cannot be converted
to the underlying array's component type by an identity or a
primitive widening conversion