Package org.glassfish.admin.amx.base

Interface SystemInfo

All Superinterfaces:

AMX_SPI, AMXProxy, Singleton, Utility

@Taxonomy(stability=UNCOMMITTED)
@AMXMBeanMetadata(singleton=true,
                  globalSingleton=true,
                  leaf=true)
public interface SystemInfo
extends AMXProxy, Singleton, Utility

Provides information about the capabilities of the running server. Callers should check only for specific capabilities, never whether the server is PE/SE/EE, since the feature assortment could vary with release.

Field Summary

Fields

Modifier and Type	Field	Description
static String	CLUSTERS_FEATURE	Call supportsFeature() with this value to determine if the server supports clusters.
static String	HADB_CONFIG_FEATURE	Call supportsFeature() with this value to determine if the high availability feature (HADB) is available.
static String	MULTIPLE_SERVERS_FEATURE	Call supportsFeature() with this value to determine if the server supports more than one server.
static String	RUNNING_IN_DAS_FEATURE	Call supportsFeature() with this value to determine if this MBean is running in the Domain Admin Server.
static String	STARTUP_SEQUENCE_MILLIS_KEY	Key for time for server to complete its startup sequence.

Method Summary

Modifier and Type	Method	Description
String[]	getFeatureNames()	Return all features names.
Map<String,Long>	getPerformanceMillis()	Return a Map keyed by an arbitrary String denoting some feature.
boolean	supportsFeature(String key)	Query whether a feature is supported.

Methods inherited from interface org.glassfish.admin.amx.core.AMX_SPI

getChildren, getName, getParent

Methods inherited from interface org.glassfish.admin.amx.core.AMXProxy

as, attributeNames, attributesMap, attributesMap, child, child, childrenMap, childrenMap, childrenMaps, childrenSet, extra, invokeOp, invokeOp, java, nameProp, objectName, parent, parentPath, path, type, valid

Field Detail

CLUSTERS_FEATURE

static final String CLUSTERS_FEATURE

Call supportsFeature() with this value to determine if the server supports clusters.

See Also:

Constant Field Values

MULTIPLE_SERVERS_FEATURE

static final String MULTIPLE_SERVERS_FEATURE

Call supportsFeature() with this value to determine if the server supports more than one server.

See Also:

Constant Field Values

RUNNING_IN_DAS_FEATURE

static final String RUNNING_IN_DAS_FEATURE

Call supportsFeature() with this value to determine if this MBean is running in the Domain Admin Server.

See Also:

Constant Field Values

HADB_CONFIG_FEATURE

static final String HADB_CONFIG_FEATURE

Call supportsFeature() with this value to determine if the high availability feature (HADB) is available.

See Also:

Constant Field Values

STARTUP_SEQUENCE_MILLIS_KEY

static final String STARTUP_SEQUENCE_MILLIS_KEY

Key for time for server to complete its startup sequence. The presence of this item in the Map returned by getPerformanceMillis() indicates that the server has completed its startup sequence. However, some server features might still be initializing asynchronously, or might be lazily loaded.

See Also:

getPerformanceMillis(), Constant Field Values

Method Detail

supportsFeature

boolean supportsFeature(String key)

Query whether a feature is supported. Features require the use of a key, which may be any of:

• #CLUSTERS_FEATURE
• #MULTIPLE_SERVERS_FEATURE
• #RUNNING_IN_DAS_FEATURE
• any dynamically-added feature (see getFeatureNames())

Other features might also be added dynamically, see getFeatureNames().

Parameters:

key - the feature name to query

getFeatureNames

@ManagedAttribute
String[] getFeatureNames()

Return all features names.

Returns:

Set

getPerformanceMillis

@ManagedAttribute
Map<String,Long> getPerformanceMillis()

Return a Map keyed by an arbitrary String denoting some feature. The value is the time in milliseconds. Code should not rely on the keys as they are subject to changes, additions, or removal at any time, except as otherwise documented. Even documented items should be used only for informational purposes, such as assessing performance.

Returns:

Map