org.glassfish.admin.amx.core
Annotation Type AMXMBeanMetadata


@Retention(value=RUNTIME)
@Target(value={TYPE,ANNOTATION_TYPE})
@Documented
@Taxonomy(stability=UNCOMMITTED)
public @interface AMXMBeanMetadata

Holds meta information useful in generating and/or supplementing the default MBeanInfo as well as other runtime fields or optimizations. Depending on how the implementor generates MBeans, not all of this information is necessarily used; it could be ignored if there is a more authoritative source (eg internal @Configured interfaces that also have AMXConfig proxy interfaces).

In general, this annotation is used only by amx-core, amx-config and related built-in AMX modules.


Optional Element Summary
 boolean globalSingleton
          if true, the MBean is a global singleton, unique in type among all AMX MBeans.
 boolean immutableMBeanInfo
          If true, states that the MBeanInfo is immutable; that once MBeanInfo is obtained it may be cached, avoiding needless/repeated invocations of getMBeanInfo().
 boolean leaf
          If true, no children are allowed.
 boolean singleton
          if true, the MBean is a singleon within its parent's scope
 String type
          overrides default type to be used in ObjectName=, ignored if null or empty
 

immutableMBeanInfo

public abstract boolean immutableMBeanInfo
If true, states that the MBeanInfo is immutable; that once MBeanInfo is obtained it may be cached, avoiding needless/repeated invocations of getMBeanInfo(). Very few MBeans have mutable MBeanInfo, so this defaults to 'true'. The term is a misnomer; it should be invariantMBeanInfo(), but this name is used go be consistent with the JMX standard.

Default:
true

type

public abstract String type
overrides default type to be used in ObjectName=, ignored if null or empty

Default:
"\u0000"

leaf

public abstract boolean leaf
If true, no children are allowed.

Default:
false

singleton

public abstract boolean singleton
if true, the MBean is a singleon within its parent's scope

Default:
false

globalSingleton

public abstract boolean globalSingleton
if true, the MBean is a global singleton, unique in type among all AMX MBeans. Being a globalSingleton implies being a singleton

Default:
false


Submit a bug or feature

Copyright © 2009 Sun Microsystems, Inc. All Rights Reserved. Use is subject to license terms.

Generated on 12-March-2010 04:35