| MxInfo.java |
package org.jfox.mx;
import java.lang.reflect.Method;
import java.security.PrivilegedAction;
import java.security.AccessController;
import java.util.Map;
import java.util.WeakHashMap;
import java.util.Arrays;
/**
*
* @author <a href="mailto:young_yy@hotmail.com">Young Yang</a>
*
* <p>Describes the management interface exposed by an MBean; that is,
* the set of attributes and operations which are available for
* management operations. Instances of this class are immutable.
* Subclasses may be mutable but this is not recommended.</p>
*
* <p>The contents of the <code>MxInfo</code> for a Dynamic MBean
* are determined by its {@link org.jfox.mx.DynamicMBean#getMBeanInfo
* getMxInfo()} method. This includes Open MBeans and Model
* MBeans, which are kinds of Dynamic MBeans.</p>
*
* <p>The contents of the <code>MxInfo</code> for a Standard MBean
* are determined by the MBean server as follows:</p>
*
* <ul>
*
* <li>{@link #getClassName()} returns the Java class name of the MBean
* object;
*
* <li>{@link #getConstructors()} returns the list of all public
* constructors in that object;
*
* <li>{@link #getOperations()} returns the list of all methods in
* the MBean interface that do not represent attributes;
*
*
* </ul>
*
* <p>The remaining details of the <code>MxInfo</code> for a
* Standard MBean are not specified. This includes the description of
* the <code>MxInfo</code> and of any contained constructors,
* attributes, operations, and notifications; and the names and
* descriptions of parameters to constructors and operations.
*/
public class MxInfo implements Cloneable, java.io.Serializable {
/* Serial version */
static final long serialVersionUID = -6451021435135161911L;
/**
* @serial The human readable description of the class.
*/
private final String description;
/**
* @serial The MBean qualified name.
*/
private final String className;
/**
* @serial The MBean operation descriptors.
*/
private final MxOperationInfo[] operations;
/**
* @serial The MBean constructor descriptors.
*/
private final MxConstructorInfo[] constructors;
private transient int hashCode;
/**
* <p>True if this class is known not to override the getters of
* MxInfo. Obviously true for MxInfo itself, and true
* for a subclass where we succeed in reflecting on the methods
* and discover they are not overridden.</p>
*
* <p>The purpose of this variable is to avoid cloning the arrays
* when doing operations like {@link #equals} where we know they
* will not be changed. If a subclass overrides a getter, we
* cannot access the corresponding array directly.</p>
*/
private final transient boolean immutable;
/**
* Constructs an <CODE>MxInfo</CODE>.
*
* @param className The name of the Java class of the MBean described
* by this <CODE>MxInfo</CODE>. This value may be any
* syntactically legal Java class name. It does not have to be a
* Java class known to the MBean server or to the MBean's
* ClassLoader. If it is a Java class known to the MBean's
* ClassLoader, it is recommended but not required that the
* class's public methods include those that would appear in a
* Standard MBean implementing the attributes and operations in
* this MxInfo.
* @param description A human readable description of the MBean (optional).
* @param constructors The list of public constructors of the
* MBean. This may be null with the same effect as a zero-length
* array.
* @param operations The list of operations of the MBean. This
* may be null with the same effect as a zero-length array.
*
* @exception IllegalArgumentException if <code>className</code> is not
* a syntactically legal Java type name. Java reserved words are not
* considered illegal here.
*/
public MxInfo(String className,
String description,
MxConstructorInfo[] constructors,
MxOperationInfo[] operations)
throws IllegalArgumentException {
MxInfo.mustBeValidMBeanTypeName(className);
this.className = className;
this.description = description;
if (operations == null || operations.length == 0)
operations = MxOperationInfo.NO_OPERATIONS;
this.operations = operations;
if (constructors == null || constructors.length == 0)
constructors = MxConstructorInfo.NO_CONSTRUCTORS;
this.constructors = constructors;
this.immutable = isImmutableClass(this.getClass(), MxInfo.class);
}
/**
* <p>Returns a shallow clone of this instance.
* The clone is obtained by simply calling <tt>super.clone()</tt>,
* thus calling the default native shallow cloning mechanism
* implemented by <tt>Object.clone()</tt>.
* No deeper cloning of any internal field is made.</p>
*
* <p>Since this class is immutable, the clone method is chiefly of
* interest to subclasses.</p>
*/
public Object clone () {
try {
return super.clone() ;
} catch (CloneNotSupportedException e) {
// should not happen as this class is cloneable
return null;
}
}
/**
* Returns the name of the Java class of the MBean described by
* this <CODE>MxInfo</CODE>.
*
* @return the class name.
*/
public String getClassName() {
return className;
}
/**
* Returns a human readable description of the MBean.
*
* @return the description.
*/
public String getDescription() {
return description;
}
/**
* Returns the list of operations of the MBean.
* Each operation is described by an <CODE>MxOperationInfo</CODE> object.
*
* The returned array is a shallow copy of the internal array,
* which means that it is a copy of the internal array of
* references to the <CODE>MxOperationInfo</CODE> objects
* but that each referenced <CODE>MxOperationInfo</CODE> object is not copied.
*
* @return An array of <CODE>MxOperationInfo</CODE> objects.
*/
public MxOperationInfo[] getOperations() {
if (operations.length == 0)
return operations;
else
return (MxOperationInfo[]) operations.clone();
}
private MxOperationInfo[] fastGetOperations() {
if (immutable)
return operations;
else
return getOperations();
}
/**
* <p>Returns the list of the public constructors of the MBean.
* Each constructor is described by an
* <CODE>MxConstructorInfo</CODE> object.</p>
*
* <p>The returned array is a shallow copy of the internal array,
* which means that it is a copy of the internal array of
* references to the <CODE>MxConstructorInfo</CODE> objects but
* that each referenced <CODE>MxConstructorInfo</CODE> object
* is not copied.</p>
*
* <p>The returned list is not necessarily exhaustive. That is,
* the MBean may have a public constructor that is not in the
* list. In this case, the MBean server can construct another
* instance of this MBean's class using that constructor, even
* though it is not listed here.</p>
*
* @return An array of <CODE>MxConstructorInfo</CODE> objects.
*/
public MxConstructorInfo[] getConstructors() {
if (constructors.length == 0)
return constructors;
else
return (MxConstructorInfo[]) constructors.clone();
}
private MxConstructorInfo[] fastGetConstructors() {
if (immutable)
return constructors;
else
return getConstructors();
}
/**
* <p>Compare this MxInfo to another. Two MxInfo objects
* are equal iff they return equal values for {@link
* #getClassName()} and for {@link #getDescription()}, and the
* arrays returned by the two objects for {@link
* #getAttributes()}, {@link #getOperations()}, {@link
* #getConstructors()} equal. Here "equal" means {@link
* Object#equals(Object)}, not identity.</p>
*
* <p>If two MxInfo objects return the same values in one of
* their arrays but in a different order then they are not equal.</p>
*
* @param o the object to compare to.
*
* @return true iff <code>o</code> is an MxInfo that is equal
* to this one according to the rules above.
*/
public boolean equals(Object o) {
if (o == this)
return true;
if (!(o instanceof MxInfo))
return false;
MxInfo p = (MxInfo) o;
if (!p.getClassName().equals(getClassName()) ||
!p.getDescription().equals(getDescription()))
return false;
return
Arrays.equals(p.fastGetOperations(), fastGetOperations()) &&
Arrays.equals(p.fastGetConstructors(), fastGetConstructors());
}
public int hashCode() {
/* Since computing the hashCode is quite expensive, we cache it.
If by some terrible misfortune the computed value is 0, the
caching won't work and we will recompute it every time.
We don't bother synchronizing, because, at worst, n different
threads will compute the same hashCode at the same time. */
if (hashCode != 0)
return hashCode;
hashCode =
getClassName().hashCode() ^
arrayHashCode(fastGetOperations()) ^
arrayHashCode(fastGetConstructors());
return hashCode;
}
private static int arrayHashCode(Object[] array) {
int hash = 0;
for (int i = 0; i < array.length; i++)
hash ^= array[i].hashCode();
return hash;
}
/** @return true iff s is a syntactically valid Java identifier
without regard to Java reserved words. */
static boolean isValidJavaIdentifier(String s) {
if (s == null) return false;
final int len = s.length();
if (len == 0 || !Character.isJavaIdentifierStart(s.charAt(0)))
return false;
for (int i = 1; i < len; i++) {
if (!Character.isJavaIdentifierPart(s.charAt(i)))
return false;
}
return true;
}
/** @return true iff s is a syntactically valid Java type name,
including multidimensional arrays, and without regard to
Java reserved words. */
static boolean isValidJavaTypeName(String s) {
if (s == null) return false;
final int len = s.length();
// Arrays begin with a series of '['...
int i = 0;
while (i<len) {
if (s.charAt(i) == '[') i++;
else break;
}
// If i==len, we have only '[' characters => not a valid type.
if (i == len) return false;
// If i=0, the type doesn't start with '[', so it is not an array.
// => check that it is a valid Java type identifier
//
if (i == 0) return isValidJavaTypeIdentifier(s);
// We have an array.
//
final char c = s.charAt(i);
switch (c) {
case 'L':
// Check that we have stg like "[[[[Lxxx.yyyy.zzzz;"
if ((i<len-1) && s.charAt(len-1) == ';')
return isValidJavaTypeIdentifier(s.substring(i,len-1));
else
return false;
case 'B': case 'C': case 'D': case 'F':
case 'I': case 'J': case 'S': case 'Z':
if (i == len-1) return true;
else return false;
default:
return false;
}
}
/** @return true iff s is a syntactically valid Java type identifier,
excluding arrays, and without regard to Java reserved words. */
static boolean isValidJavaTypeIdentifier(String s) {
if (s == null) return false;
final int len = s.length();
boolean needLetter = true;
for (int i = 0; i < len; i++) {
final char c = s.charAt(i);
if (needLetter) {
if (!Character.isJavaIdentifierStart(c))
return false;
needLetter = false;
} else if (c == '.') {
needLetter = true;
} else if (!Character.isJavaIdentifierPart(c)) {
return false;
}
}
return !needLetter;
}
static void mustBeValidMBeanTypeName(String s)
throws IllegalArgumentException {
if (!isValidJavaTypeIdentifier(s)) throw new
IllegalArgumentException("Not a valid Java MBean type name: "
+ s);
}
static void mustBeValidJavaTypeName(String s)
throws IllegalArgumentException {
if (!isValidJavaTypeName(s)) {
throw new IllegalArgumentException("Not a valid Java type name: "
+ s);
}
}
static void mustBeValidJavaIdentifier(String s)
throws IllegalArgumentException {
if (!isValidJavaIdentifier(s)) {
throw new IllegalArgumentException("Not a valid Java identifier: "
+ s);
}
}
/**
* Cached results of previous calls to isImmutableClass. Maps
* Class to Boolean. This is a WeakHashMap so that we don't
* prevent a class from being garbage collected just because
* we know whether it's immutable.
*/
private static final Map immutability = new WeakHashMap();
/**
* Return true if <code>subclass</code> is known to preserve the
* immutability of <code>immutableClass</code>. The class
* <code>immutableClass</code> is a reference class that is known
* to be immutable. The subclass <code>subclass</code> is
* considered immutable if it does not override any public method
* of <code>immutableClass</code> whose name begins with "get" or
* "is". This is obviously not an infallible test for immutability,
* but it works for the public interfaces of the MBean*Info classes.
*/
static boolean isImmutableClass(Class subclass, Class immutableClass) {
if (subclass == immutableClass)
return true;
synchronized (immutability) {
Boolean immutable = (Boolean) immutability.get(subclass);
if (immutable == null) {
try {
PrivilegedAction immutabilityAction =
new ImmutabilityAction(subclass, immutableClass);
immutable = (Boolean)
AccessController.doPrivileged(immutabilityAction);
} catch (Exception e) { // e.g. SecurityException
/* We don't know, so we assume it isn't. */
immutable = Boolean.FALSE;
}
immutability.put(subclass, immutable);
}
return immutable.booleanValue();
}
}
/*
* The PrivilegedAction stuff is probably overkill. We can be
* pretty sure the caller does have the required privileges -- a
* JMX user that can't do reflection can't even use Standard
* MBeans! But there's probably a performance gain by not having
* to check the whole call stack.
*/
private static class ImmutabilityAction implements PrivilegedAction {
private final Class subclass;
private final Class immutableClass;
ImmutabilityAction(Class subclass, Class immutableClass) {
this.subclass = subclass;
this.immutableClass = immutableClass;
}
public Object run() {
Method[] methods = immutableClass.getMethods();
for (int i = 0; i < methods.length; i++) {
Method method = methods[i];
String methodName = method.getName();
if (methodName.startsWith("get")
|| methodName.startsWith("is")) {
Class[] paramTypes = method.getParameterTypes();
try {
Method submethod =
subclass.getMethod(methodName, paramTypes);
if (!submethod.equals(method))
return Boolean.FALSE;
} catch (NoSuchMethodException e) {
return Boolean.FALSE;
}
}
}
return Boolean.TRUE;
}
}
}