|
JavaTM 2 Platform Ent. Ed. v1.4 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object javax.management.openmbean.OpenType javax.management.openmbean.ArrayType
The ArrayType
class is the open type class whose instances describe
all open data values which are n-dimensional arrays of open data values.
Field Summary |
Fields inherited from class javax.management.openmbean.OpenType |
ALLOWED_CLASSNAMES |
Constructor Summary | |
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. |
Method Summary | |
boolean |
equals(Object obj)
Compares the specified obj parameter with this ArrayType instance for equality.
|
int |
getDimension()
Returns the dimension of arrays described by this ArrayType instance. |
OpenType |
getElementOpenType()
Returns the open type of element values contained in the arrays described by this ArrayType instance. |
int |
hashCode()
Returns the hash code value for this ArrayType instance.
|
boolean |
isValue(Object obj)
Tests whether obj is a value for this ArrayType instance.
|
String |
toString()
Returns a string representation of this ArrayType instance.
|
Methods inherited from class javax.management.openmbean.OpenType |
getClassName, getDescription, getTypeName, isArray |
Methods inherited from class java.lang.Object |
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Constructor Detail |
public ArrayType(int dimension, OpenType elementType) throws OpenDataException
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:
<dimension>-dimension array of <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 = [[[java.lang.String; element class name = java.lang.String array type name = [[[java.lang.String; array type description = 3-dimension array of java.lang.String
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 or TabularType.
IllegalArgumentException
- if dimension is not a positive integer
OpenDataException
- if elementType is an instance of ArrayTypeMethod Detail |
public int getDimension()
public OpenType getElementOpenType()
public boolean isValue(Object obj)
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:
ArrayType
instance describes an array of SimpleType elements,
obj's class name is the same as the className field defined for this ArrayType
instance
(ie the class name returned by the getClassName
method,
which includes the dimension information),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.
obj
- the object to be tested.
true
if obj is a value for this ArrayType
instance.public boolean equals(Object obj)
obj
parameter with this ArrayType
instance for equality.
Two ArrayType
instances are equal if and only if they describes array instances
which have the same dimension and elements' open type.
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
,
equals
returns false
.
true
if the specified object is equal to this ArrayType
instance.public int hashCode()
ArrayType
instance.
The hash code of a ArrayType
instance is the sum of the hash codes
of all elements of information used in equals
comparisons
(ie: dimension and elements' type).
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.
ArrayType
instancepublic String toString()
ArrayType
instance.
The string representation consists of
the name of this class (ie javax.management.openmbean.ArrayType
), the type name,
the dimension and elements' type 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.
ArrayType
instance
|
JavaTM 2 Platform Ent. Ed. v1.4 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright 2003 Sun Microsystems, Inc. All rights reserved.