FileDocCategorySizeDatePackage
BulkAccess.javaAPI DocGlassfish v2 API6765Fri May 04 22:30:30 BST 2007com.sun.appserv.management.base

BulkAccess

public interface BulkAccess implements Utility, Singleton, com.sun.appserv.management.base.AMX
Bulk access to various JMX constructs. The term "bulk" refers to the fact the multiple MBeans are accessed together on the server side, to minimize remote invocation of many MBeans.

Because a failure can occur with a particular MBeans, results or failures are communicated back in an array of the exact size of the original ObjectName[]. Examining the results array yields either the result, or a Throwable, if one occured. This is why all results are of type Object[].

Clients wishing to use this interface should note that they may first need to obtain an ObjectName[] from a Set or Map of {@link AMX}. The easiest way to do this is to use {@link Util#toObjectNames} followed by conversion of the Set to an ObjectName[].

Fields Summary
public static final String
J2EE_TYPE
The j2eeType as returned by {@link com.sun.appserv.management.base.AMX#getJ2EEType}.
Constructors Summary
Methods Summary
public java.lang.Object[]bulkGetAttribute(javax.management.ObjectName[] objectNames, java.lang.String attributeName)
Call getAttribute( attributeName ) for multiple MBeans. For objectNames[ i ], results[ i ] will be the resulting value, or contain a Throwable if something was thrown..

param
objectNames
param
attributeName
return
array of Object, which may be the Attribute value, or a Throwable

public java.lang.Object[]bulkGetAttributeNames(javax.management.ObjectName[] objectNames)
Call getMBeanInfo().getAttributes() for multiple MBeans, then extracts the
Attribute name from each Attribute.
For objectNames[ i ], results[ i ] will be the resulting String[], consisting
of all Attribute names for that MBean,
or contain a Throwable if something was thrown.
param
objectNames
return
Object[][], one String[] for each objectName, null if not found, or a Throwable
public java.lang.Object[]bulkGetAttributes(javax.management.ObjectName[] objectNames, java.lang.String[] attributeNames)
Call getAttributes( attributeNames ) for multiple MBeans.
For objectNames[ i ], results[ i ] will contain the resulting
AttributeList, or a Throwable if unsuccessful.
return
array of Object, which may be the AttributeList, or a Throwable
public java.lang.Object[]bulkGetMBeanAttributeInfo(javax.management.ObjectName[] objectNames)
Call getMBeanInfo().getAttributes() for multiple MBeans.
For objectNames[ i ], results[ i ] will be the resulting MBeanAttributeInfo[],
or contain a Throwable if something was thrown.
param
objectNames
return
AttributeInfo[][], one AttributeInfo[] for each objectName, null if not found
public java.lang.Object[]bulkGetMBeanInfo(javax.management.ObjectName[] objectNames)
Call getMBeanInfo() for multiple MBeans.
For objectNames[ i ], results[ i ] will be the resulting MBeanInfo[],
or contain a Throwable if something was thrown.
param
objectNames
return
Info[], one for each objectName, null if not found
public java.lang.Object[]bulkGetMBeanOperationInfo(javax.management.ObjectName[] objectNames)
Call getMBeanInfo().getOperations() for multiple MBeans.
For objectNames[ i ], results[ i ] will be the resulting MBeanOperationInfo[],
or contain a Throwable if something was thrown.
param
objectNames
return
OperationInfo[][], one OperationInfo[] for each objectName, null if not found
public java.lang.Object[]bulkInvoke(javax.management.ObjectName[] objectNames, java.lang.String operationName, java.lang.Object[] args, java.lang.String[] types)
Call invoke( ... ) for multiple MBeans.
For objectNames[ i ], results[ i ] will be the result,
or contain a Throwable if something was thrown..


WARNING: No guarantee can be made that the MBeans being
invoked will not alter their arguments, thus altering the
parameters that subsequent MBeans receive when invoked.
param
objectNames
param
operationName
param
args
param
types
return
array of Object, which will be the result of the invoke, or a Throwable
public java.lang.Object[]bulkSetAttribute(javax.management.ObjectName[] objectNames, javax.management.Attribute attr)
Call setAttribute( attr ) for multiple MBeans.
For objectNames[ i ], results[ i ] will be null if successful,
or contain a Throwable if not.
param
objectNames
param
attr
return
array of Object, each is null or a Throwable