ArrayType(int dimension,
OpenType<?> elementType)
Constructs an ArrayType instance describing open data values which are
arrays with dimension dimension of elements whose open type is elementType.
ArrayType(SimpleType<?> elementType,
boolean primitiveArray)
Constructs a unidimensional ArrayType instance for the
supplied SimpleType.
Method Summary
boolean
equals(Object obj)
Compares the specified obj parameter with this
ArrayType instance for equality.
Constructs an ArrayType instance describing open data values which are
arrays with dimension dimension of elements whose open type is elementType.
When invoked on an ArrayType instance, the getClassName method
returns the class name of the array instances it describes (following the rules defined by the
getName method of java.lang.Class), not the class name of the array elements
(which is returned by a call to getElementOpenType().getClassName()).
The internal field corresponding to the type name of this ArrayType instance is also set to
the class name of the array instances it describes.
In other words, the methods getClassName and getTypeName return the same string value.
The internal field corresponding to the description of this ArrayType instance is set to a string value
which follows the following template:
if non-primitive array: <dimension>-dimension array of <element_class_name>
if primitive array: <dimension>-dimension array of <primitive_type_of_the_element_class_name>
As an example, the following piece of code:
ArrayType t = new ArrayType(3, SimpleType.STRING);
System.out.println("array class name = " + t.getClassName());
System.out.println("element class name = " + t.getElementOpenType().getClassName());
System.out.println("array type name = " + t.getTypeName());
System.out.println("array type description = " + t.getDescription());
would produce the following output:
array class name = [[[Ljava.lang.String;
element class name = java.lang.String
array type name = [[[Ljava.lang.String;
array type description = 3-dimension array of java.lang.String
And the following piece of code which is equivalent to the one listed
above would also produce the same output:
ArrayType t1 = new ArrayType(1, SimpleType.STRING);
ArrayType t2 = new ArrayType(1, t1);
ArrayType t3 = new ArrayType(1, t2);
System.out.println("array class name = " + t3.getClassName());
System.out.println("element class name = " + t3.getElementOpenType().getClassName());
System.out.println("array type name = " + t3.getTypeName());
System.out.println("array type description = " + t3.getDescription());
Parameters:
dimension - the dimension of arrays described by this ArrayType instance;
must be greater than or equal to 1.
elementType - the open type of element values contained
in the arrays described by this ArrayType
instance; must be an instance of either
SimpleType, CompositeType,
TabularType or another ArrayType
with a SimpleType, CompositeType
or TabularType as its elementType.
Constructs a unidimensional ArrayType instance for the
supplied SimpleType.
This constructor supports the creation of arrays of primitive
types when primitiveArray is true.
For primitive arrays the getElementOpenType() method
returns the SimpleType corresponding to the wrapper
type of the primitive type of the array.
When invoked on an ArrayType instance, the getClassName method
returns the class name of the array instances it describes (following the rules defined by the
getName method of java.lang.Class), not the class name of the array elements
(which is returned by a call to getElementOpenType().getClassName()).
The internal field corresponding to the type name of this ArrayType instance is also set to
the class name of the array instances it describes.
In other words, the methods getClassName and getTypeName return the same string value.
The internal field corresponding to the description of this ArrayType instance is set to a string value
which follows the following template:
if non-primitive array: 1-dimension array of <element_class_name>
if primitive array: 1-dimension array of <primitive_type_of_the_element_class_name>
As an example, the following piece of code:
ArrayType t = new ArrayType(SimpleType.INTEGER, true);
System.out.println("array class name = " + t.getClassName());
System.out.println("element class name = " + t.getElementOpenType().getClassName());
System.out.println("array type name = " + t.getTypeName());
System.out.println("array type description = " + t.getDescription());
would produce the following output:
array class name = [I
element class name = java.lang.Integer
array type name = [I
array type description = 1-dimension array of int
Parameters:
elementType - the SimpleType of the element values
contained in the arrays described by this
ArrayType instance.
primitiveArray - true when this array describes
primitive arrays.
Tests whether obj is a value for this ArrayType
instance.
This method returns true if and only if obj
is not null, obj is an array and any one of the following
is true:
if this ArrayType instance describes an array of
SimpleType elements or their corresponding primitive types,
obj's class name is the same as the className field defined
for this ArrayType instance (i.e. the class name returned
by the getClassName method, which
includes the dimension information),
if this ArrayType instance describes an array of
classes implementing the TabularData interface or the
CompositeData interface, obj is assignable to
such a declared array, and each element contained in obj
is either null or a valid value for the element's open type specified
by this ArrayType instance.
Compares the specified obj parameter with this
ArrayType instance for equality.
Two ArrayType instances are equal if and only if they
describe array instances which have the same dimension, elements'
open type and primitive array flag.
obj - the object to be compared for equality with this
ArrayType instance; if obj
is null or is not an instance of the
class ArrayType this method returns
false.
Returns:
true if the specified object is equal to
this ArrayType instance.
Returns the hash code value for this ArrayType instance.
The hash code of an ArrayType instance is the sum of the
hash codes of all the elements of information used in equals
comparisons (i.e. dimension, elements' open type and primitive array flag).
The hashcode for a primitive value is the hashcode of the corresponding boxed
object (e.g. the hashcode for true is Boolean.TRUE.hashCode()).
This ensures that t1.equals(t2) implies that
t1.hashCode()==t2.hashCode() for any two
ArrayType instances t1 and t2,
as required by the general contract of the method
Object.hashCode().
As ArrayType instances are immutable, the hash
code for this instance is calculated once, on the first call
to hashCode, and then the same value is returned
for subsequent calls.
Returns a string representation of this ArrayType instance.
The string representation consists of the name of this class (i.e.
javax.management.openmbean.ArrayType), the type name,
the dimension, the elements' open type and the primitive array flag
defined for this instance.
As ArrayType instances are immutable, the
string representation for this instance is calculated
once, on the first call to toString, and
then the same value is returned for subsequent calls.
Create an ArrayType instance in a type-safe manner.
Multidimensional arrays can be built up by calling this method as many
times as necessary.
Calling this method twice with the same parameters may return the same
object or two equal but not identical objects.
As an example, the following piece of code:
ArrayType t1 = ArrayType.getArrayType(SimpleType.STRING);
ArrayType t2 = ArrayType.getArrayType(t1);
ArrayType t3 = ArrayType.getArrayType(t2);
System.out.println("array class name = " + t3.getClassName());
System.out.println("element class name = " + t3.getElementOpenType().getClassName());
System.out.println("array type name = " + t3.getTypeName());
System.out.println("array type description = " + t3.getDescription());
would produce the following output:
array class name = [[[Ljava.lang.String;
element class name = java.lang.String
array type name = [[[Ljava.lang.String;
array type description = 3-dimension array of java.lang.String
Parameters:
elementType - the open type of element values contained
in the arrays described by this ArrayType
instance; must be an instance of either
SimpleType, CompositeType,
TabularType or another ArrayType
with a SimpleType, CompositeType
or TabularType as its elementType.
Throws:
OpenDataException - if elementType's className is not
one of the allowed Java class names for open
data.
Since:
1.6
getPrimitiveArrayType
public static <T> ArrayType<T> getPrimitiveArrayType(Class<T> arrayClass)
Create an ArrayType instance in a type-safe manner.
Calling this method twice with the same parameters may return the
same object or two equal but not identical objects.
As an example, the following piece of code:
ArrayType t = ArrayType.getPrimitiveArrayType(int[][][].class);
System.out.println("array class name = " + t.getClassName());
System.out.println("element class name = " + t.getElementOpenType().getClassName());
System.out.println("array type name = " + t.getTypeName());
System.out.println("array type description = " + t.getDescription());
would produce the following output:
array class name = [[[I
element class name = java.lang.Integer
array type name = [[[I
array type description = 3-dimension array of int
Parameters:
arrayClass - a primitive array class such as int[].class,
boolean[][].class, etc. The getElementOpenType() method of the returned
ArrayType returns the SimpleType
corresponding to the wrapper type of the primitive
type of the array.
For further API reference and developer documentation, see Java SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright 2008 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the .
javax.management.openmbean.OpenType<T>