All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class com.sun.jaw.reference.agent.cmf.Framework

java.lang.Object
   |
   +----com.sun.jaw.reference.agent.cmf.Framework

public class Framework

extends Object

The Framework class offers services to enable m-beans dynamically to obtain information on and control other m-beans in the same Java Dynamic Management agent. The services offered are defined in the com.sun.jaw.reference.agent.services package. Default implementations of these services are provided in the packages under com.sun.jaw.impl.agent.services.

Framework()

Enables the core management framework to be initialized.

Framework(MoRepSrvIf, String)

Enables the core management framework to be initialized with a specific m-bean repository.

Framework(String)

Enables the core management framework to be initialized with a specific domain.

addDBObject(Object, ObjectName)

Adds a persistent named m-bean under the control of the core management framework.

addFrameworkListener(FrameworkListener)

Allows you to register a listener to receive FrameworkEvents.

addListener(ObjectName, Object, String)

Enables a listener for a named m-bean to be added.

addObject(Object)

Adds an m-bean under the control of the core management framework.

addObject(Object, ObjectName)

Adds a named m-bean under the control of the core management framework.

addRelation(RelationIf, ObjectName)

Adds a relation under the control of the core management framework.

contains(Object)

Checks whether an m-bean is already controlled by the core management framework.

contains(ObjectName)

Checks whether an m-bean is already controlled by the core management framework.

delObject(Object)

Removes an m-bean from the m-bean repository by using a reference to the m-bean.

delObject(ObjectName)

Removes an m-bean from the m-bean repository.

fastDelObject(ObjectName)

Removes an m-bean from the m-bean repository.

getClass(String)

Enables a Java class to be retrieved from its Java class name.

getClass(String, ObjectName)

Enables the Java class to be obtained from the class name by using a specific class loader.

getClassLoader()

Returns the network class loader associated with the core management framework.

getClassVersion()

Returns the version of this class.

getDomain()

Returns the domain assigned to the core management framework.

getFilterSrvIf()

Returns the filtering service associated with the core management framework.

getIndexedValue(Object, String, int)

Gets the value of a specific indexed property within an m-bean.

getIndexedValue(ObjectName, String, int)

Gets the value of a specific indexed property within a named m-bean.

getJdmkVersion()

Returns the string representing the version of JDMK.

getMetaDataSrvIf()

Returns the metadata service associated with the core management framework.

getMoRepSrvIf()

Returns the m-bean repository associated with the core management framework.

getNbElements()

Returns the number of objects controlled by the framework.

getObject(ObjectName, QueryExp)

Gets handles on m-beans controlled by the core management framework.

getRelations(ObjectName, ObjectName, int)

Get handles on relations of a given class with a given role at a given rank.

getRelationSrvIf()

Returns the relationship service associated with the core management framework.

getValue(Object, String)

Gets the value of a specific property within an m-bean.

getValue(ObjectName, String)

Gets the value of a specific property within a named m-bean.

getValues(ObjectName, Vector)

Enables the values of several properties within an m-bean to be obtained.

initCmfInvoker(Object, ObjectName, boolean, ModificationList)

The method invokes the initCmf method of an object.

invokePerform(Object, String, Object[], String[])

invokePerform(ObjectName, String, Object[], String[])

Invokes a performer method on an m-bean.

newDBObject(String, ObjectName, ModificationList)

Instantiates and then adds a persistent m-bean under the control of the core management framework.

newDBObject(String, ObjectName, ObjectName, ModificationList)

Uses a specific class loader to instantiate and then add a persistent m-bean under the control of the core management framework.

newDBObject(String, String, ModificationList)

Instantiates and then adds a persistent m-bean under the control of the core management framework.

newDBObject(String, String, ObjectName, ModificationList)

Uses a specific class loader to instantiate and then add a persistent m-bean under the control of the core management framework.

newObj(String)

Instantiates an m-bean in the Java VM on which the core management framework is running.

newObj(String, ObjectName)

Uses a specific class loader to instantiate an m-bean in the Java VM on which the core management framework is running.

newObject(String, ObjectName, ModificationList)

Instantiates and then adds a nonpersistent m-bean under the control of the core management framework.

newObject(String, ObjectName, ObjectName, ModificationList)

Uses a specific class loader to instantiate and then add a nonpersistent m-bean under the control of the core management framework.

newObject(String, String, ModificationList)

Instantiates and then adds a nonpersistent m-bean under the control of the core management framework.

newObject(String, String, ObjectName, ModificationList)

Uses a specific class loader to instantiate and then add a nonpersistent m-bean under the control of the core management framework.

newRelation(String, ObjectName, ObjectName[], ObjectName)

Instantiates and then adds a relation under the control of the core management framework.

removeFrameworkListener(FrameworkListener)

Removes a listener.

removeListener(Object, Object, String, Class)

Enables a listener for an m-bean to be removed.

retrieveObject(ObjectName)

The method allows to retrieve an object from the repository.

sendEvent(EventObject, ObjectName)

Enables an m-bean to send an EventObject.

setClassLoader(ClassLoader)

Sets the network class loader associated with the core management framework.

setFilterSrvIf(FilterSrvIf)

Sets the filtering service associated with the core management framework.

setIndexedValue(Object, String, Object, int)

Sets the value of an indexed property of a given m-bean.

setIndexedValue(ObjectName, String, Object, String, int)

Sets the value of a specific indexed property of a named m-bean.

setMetaDataSrvIf(MetaDataSrvIf)

Sets the metadata service associated with the core management framework.

setRelationSrvIf(RelationSrvIf)

Sets the relationship service associated with the core management framework.

setValue(Object, String, Object)

Sets the value of a specific property of a given m-bean.

setValue(ObjectName, String, Object, String)

Sets the value of a specific property of a named m-bean.

setValues(ObjectName, ModificationList)

Enables the values of several properties within an m-bean to be set.

setValues(ObjectName, ModificationList, Object)

Enables the values of several properties within an m-bean to be set.

 public Framework()

Enables the core management framework to be initialized.

 public Framework(String domain)

Enables the core management framework to be initialized with a specific domain.

 public Framework(MoRepSrvIf repository,
                  String domain)

Enables the core management framework to be initialized with a specific m-bean repository.

Parameters:

repository - The m-bean repository to be used for initializing the core management framework.

domain - The name of the default domain to be controlled by the core management framework. The domain provides a structure for the naming space within a Java Dynamic Management agent or within a global management domain.

 public Vector getObject(ObjectName name,
                         QueryExp query) throws InstanceNotFoundException

Gets handles on m-beans controlled by the core management framework. The method enables any of the following be to obtained:

• A specific m-bean
• All m-beans
• A subset specified through a query

To obtain all m-beans, make sure that the class name and instance name in the object name are empty, and specify a null query expression. To obtain a subset, specify a nonnull query expression.

Parameters:

name - The object names of the m-beans to be retrieved.

query - The query expression to be applied for selecting m-beans.

Returns:

A list containing the selected m-beans.

Throws: InstanceNotFoundException

The specified m-bean does not exist in the m-bean repository.

 public boolean contains(Object object)

Checks whether an m-bean is already controlled by the core management framework. The method does this by querying the repository to find out whether the m-bean is registered.

This method is to be used only with a singleton, that is, only one instance of that class is permitted within the repository for a given domain.

Parameters:

object - The m-bean to be checked.

Returns:

True if the m-bean is already controlled by the core management framework, false otherwise.

 public boolean contains(ObjectName objectName)

Checks whether an m-bean is already controlled by the core management framework.

Parameters:

objectName - The object name of the m-bean to be checked.

Returns:

True if the m-bean is already controlled by the core management framework, false otherwise.

 public Object retrieveObject(ObjectName name) throws InstanceNotFoundException

The method allows to retrieve an object from the repository. If the object is not found, the method throws a InstanceNotFoundException.

Throws: InstanceNotFoundException

The m-bean does not exist in the repository.

 public Class getClass(String className) throws ClassNotFoundException

Enables a Java class to be retrieved from its Java class name.

Parameters:

className - The name of the Java class to be retrieved.

Returns:

The requested Java class.

Throws: ClassNotFoundException

No definition for the class with the specified name could be found.

 public Class getClass(String className,
                       ObjectName aLoader) throws ClassNotFoundException

Enables the Java class to be obtained from the class name by using a specific class loader. The class loader is identified by its object name.

Parameters:

className - The name of the class to be retrieved.

aLoader - The name of the class loader to be used.

Returns:

The requested Java class.

Throws: ClassNotFoundException

No definition for the class with the specified name could be found.

 public ObjectName addObject(Object object) throws InstanceAlreadyExistException

Adds an m-bean under the control of the core management framework. When you call this method, the core management framework builds a name for the m-bean:

• The default domain name is used as the domain.
• The Java class name is used as the class. To obtain the Java class name, call the getName method of this class.

Parameters:

object - The m-bean to be added to the repository.

Returns:

The object name of the m-bean that has been added to the repository.

Throws: InstanceAlreadyExistException

The m-bean is already registered in the repository.

 public void addObject(Object object,
                       ObjectName logicalName) throws InstanceAlreadyExistException

Adds a named m-bean under the control of the core management framework.

Parameters:

object - The m-bean to be added to the repository.

logicalName - The object name of the m-bean to be added.

Throws: InstanceAlreadyExistException

The m-bean is already registered in the repository.

 public void addDBObject(Object object,
                         ObjectName logicalName) throws InstanceAlreadyExistException

Adds a persistent named m-bean under the control of the core management framework.

Parameters:

object - The m-bean to be added to the repository.

logicalName - The object name of the m-bean.

Throws: InstanceAlreadyExistException

The m-bean is already registered in the repository.

 public Object newObject(String className,
                         ObjectName localName,
                         ModificationList list) throws IllegalAccessException, ClassNotFoundException, InstantiationException, InstanceAlreadyExistException, InvocationTargetException

Instantiates and then adds a nonpersistent m-bean under the control of the core management framework. An object name can be associated with the m-bean. The method creates a new instance of the m-bean and then initializes it. To initialize the m-bean, the core management framework executes the initCmf method of the m-bean that has just been created.

Parameters:

className - The class name of the m-bean to be instantiated.

localName - The object name of the m-bean.

list - The modification list to use for setting up parameters

Returns:

The newly instantiated m-bean.

Throws: ClassNotFoundException

The class loader could not find the class to be instantiated.

Throws: InstantiationException

A new instance of the specified class could not be created.

Throws: InvocationTargetException

The initialization method (initCmf) of the specified class could not be executed.

Throws: IllegalAccessException

The method cannot access the class definition of the specified m-bean.

Throws: InstanceAlreadyExistException

The m-bean is already registered in the repository.

 public Object newDBObject(String className,
                           ObjectName localName,
                           ModificationList list) throws IllegalAccessException, ClassNotFoundException, InstantiationException, InstanceAlreadyExistException, InvocationTargetException

Instantiates and then adds a persistent m-bean under the control of the core management framework. An object name can be associated with the m-bean. The method creates a new instance of the m-bean and then initializes it. To initialize the m-bean, the core management framework executes the initCmf method of the m-bean that has just been created.

Parameters:

className - The class name of the m-bean to be instantiated.

localName - The object name of the m-bean.

list - The modification list to use for setting up parameters

Returns:

The newly instantiated m-bean.

Throws: ClassNotFoundException

The class loader could not find the class to be instantiated.

Throws: InstantiationException

A new instance of the specified class could not be created.

Throws: InvocationTargetException

The initialization method (initCmf) of the specified class could not be executed.

Throws: IllegalAccessException

The method cannot access the class definition of the specified m-bean.

Throws: InstanceAlreadyExistException

The m-bean is already registered in the repository.

 public Object newDBObject(String className,
                           String localName,
                           ModificationList list) throws IllegalAccessException, ClassNotFoundException, InstantiationException, InstanceAlreadyExistException, InvocationTargetException

Instantiates and then adds a persistent m-bean under the control of the core management framework. An object name can be associated with the m-bean. The method creates a new instance of the m-bean and then initializes it. To initialize the m-bean, the core management framework executes the initCmf method of the m-bean that has just been created.

Parameters:

className - The class of the m-bean to be instantiated.

localName - A string representation of the object name of the m-bean to be instantiated.

list - The modification list to use for setting up parameters

Returns:

The newly instantiated m-bean.

Throws: ClassNotFoundException

The class loader could not find the class to be instantiated.

Throws: InstantiationException

A new instance of the specified class could not be created.

Throws: InvocationTargetException

The initialization method (initCmf) of the specified class could not be executed.

Throws: IllegalAccessException

The method cannot access the class definition of the specified m-bean.

Throws: InstanceAlreadyExistException

The m-bean is already registered in the repository.

 public Object newObject(String className,
                         String localName,
                         ModificationList list) throws IllegalAccessException, ClassNotFoundException, InstantiationException, InstanceAlreadyExistException, InvocationTargetException

Instantiates and then adds a nonpersistent m-bean under the control of the core management framework. An object name can be associated with the m-bean. The method creates a new instance of the m-bean and then initializes it. To initialize the m-bean, the core management framework executes the initCmf method of the m-bean that has just been instantiated.

Parameters:

className - The class name of the m-bean to be instantiated.

localName - A string representation of the object name of the m-bean to be instantiated.

list - The modification list to use for setting up parameters

Returns:

The newly instantiated m-bean.

Throws: ClassNotFoundException

The class loader could not find the class to be instantiated.

Throws: InstantiationException

A new instance of the specified class could not be created.

Throws: InvocationTargetException

The initialization method (initCmf) of the specified class could not be executed.

Throws: IllegalAccessException

The method cannot access the class definition of the specified m-bean.

Throws: InstanceAlreadyExistException

The m-bean is already registered in the repository.

 public Object newObj(String className) throws IllegalAccessException, ClassNotFoundException, InstantiationException

Instantiates an m-bean in the Java VM on which the core management framework is running.

Parameters:

className - The class of the m-bean to be instantiated.

Returns:

The newly instantiated object.

Throws: ClassNotFoundException

The class loader could not find the class to be instantiated.

Throws: InstantiationException

A new instance of the specified class could not be created.

Throws: IllegalAccessException

The method cannot access the class definition of the specified m-bean.

 public Object newObject(String className,
                         ObjectName localName,
                         ObjectName aLoader,
                         ModificationList list) throws IllegalAccessException, ClassNotFoundException, InstantiationException, InstanceAlreadyExistException, InvocationTargetException

Uses a specific class loader to instantiate and then add a nonpersistent m-bean under the control of the core management framework. The class loader is identified by its object name. An object name can be associated with the m-bean. The method creates a new instance of the m-bean and then initializes it. To initialize the m-bean, the core management framework executes the initCmf method of the m-bean that has just been created.

Parameters:

className - The class name of the m-bean to be instantiated.

localName - The object name of the m-bean.

aLoader - The name of the class loader to be used.

list - The modification list to use for setting up parameters

Returns:

The newly instantiated m-bean.

Throws: ClassNotFoundException

The class loader could not find the class to be instantiated.

Throws: InstantiationException

A new instance of the specified class could not be created.

Throws: InvocationTargetException

The initialization method (initCmf) of the specified class could not be executed.

Throws: IllegalAccessException

The method cannot access the class definition of the specified m-bean.

Throws: InstanceAlreadyExistException

The m-bean is already registered in the repository.

 public Object newDBObject(String className,
                           ObjectName localName,
                           ObjectName aLoader,
                           ModificationList list) throws IllegalAccessException, ClassNotFoundException, InstantiationException, InstanceAlreadyExistException, InvocationTargetException

Uses a specific class loader to instantiate and then add a persistent m-bean under the control of the core management framework. The class loader is identified by its object name. An object name can be associated with the m-bean. The method creates a new instance of the m-bean and then initializes it. To initialize the m-bean, the core management framework executes the initCmf method of the m-bean that has just been instantiated.

Parameters:

className - The class of the m-bean to be instantiated.

localName - The object name of the m-bean.

aLoader - The object name of a class loader to be used.

Returns:

The newly instantiated m-bean.

Throws: ClassNotFoundException

The class loader could not find the class to be instantiated.

Throws: InstantiationException

A new instance of the specified class could not be created.

Throws: InvocationTargetException

The initialization method (initCmf) of the specified class could not be executed.

Throws: IllegalAccessException

The method cannot access the class definition of the specified m-bean.

Throws: InstanceAlreadyExistException

The m-bean is already registered in the repository.

 public Object newDBObject(String className,
                           String localName,
                           ObjectName aLoader,
                           ModificationList list) throws IllegalAccessException, ClassNotFoundException, InstantiationException, InstanceAlreadyExistException, InvocationTargetException

Uses a specific class loader to instantiate and then add a persistent m-bean under the control of the core management framework. The class loader is identified by its object name. An object name can be associated with the m-bean.

The method creates a new instance of the m-bean and then initializes it. To initialize the m-bean, the core management framework executes the initCmf method of the m-bean that has just been created.

Parameters:

className - The class of the m-bean to be instantiated.

localName - A string representation of the object name of the m-bean to be instantiated.

aLoader - The name of a class loader to be used.

list - The modification list to use for setting up parameters

Returns:

The newly instantiated m-bean.

Throws: ClassNotFoundException

The class loader could not find the class to be instantiated.

Throws: InstantiationException

A new instance of the specified class could not be created.

Throws: InvocationTargetException

The initialization method (initCmf) of the specified class could not be executed.

Throws: IllegalAccessException

The method cannot access the class definition of the specified m-bean.

Throws: InstanceAlreadyExistException

The m-bean is already registered in the m-bean repository.

 public Object newObject(String className,
                         String localName,
                         ObjectName aLoader,
                         ModificationList list) throws IllegalAccessException, ClassNotFoundException, InstantiationException, InstanceAlreadyExistException, InvocationTargetException

Uses a specific class loader to instantiate and then add a nonpersistent m-bean under the control of the core management framework. The class loader is identified by its object name. An object name can be associated with the m-bean.

The method creates a new instance of the m-bean and then initializes it. To initialize the m-bean, the core management framework invokes the initCmf method of the m-bean that has just been created.

Parameters:

className - The class name of the m-bean to be instantiated.

localName - A string representation of the object name of the m-bean to be instantiated.

aLoader - The name of a class loader to be used.

list - The modification list to use for setting up parameters

Returns:

The newly instantiated m-bean.

Throws: ClassNotFoundException

The class loader could not find the class to be instantiated.

Throws: InstantiationException

A new instance of the specified class could not be created.

Throws: InvocationTargetException

The initialization method (initCmf) of the specified class could not be executed.

Throws: IllegalAccessException

The method cannot access the class definition of the specified m-bean.

Throws: InstanceAlreadyExistException

The m-bean is already registered in the repository.

 public Object newObj(String className,
                      ObjectName aLoader) throws IllegalAccessException, ClassNotFoundException, InstantiationException

Uses a specific class loader to instantiate an m-bean in the Java VM on which the core management framework is running. The class loader is identified by its object name.

Parameters:

className - The class name of the m-bean to be instantiated.

aLoader - The object name of a class loader to be used.

Returns:

The newly instantiated object.

Throws: ClassNotFoundException

The class loader could not find the class to be instantiated.

Throws: InstantiationException

A new instance of the specified class could not be created.

Throws: IllegalAccessException

The method cannot access the class definition of the specified m-bean.

 public void initCmfInvoker(Object moi,
                            ObjectName name,
                            boolean db,
                            ModificationList list) throws InstanceAlreadyExistException, InvocationTargetException, IllegalAccessException

The method invokes the initCmf method of an object. If the method is not available, the method will register the object into the framework. Otherwise it is the responsibility of the object to register itself.

There are two possible signatures for an initCmf method:

• initCmf(Framework cmf, ObjectName name, boolean db, ModificationList list)
• initCmf(Framework cmf, ObjectName name)

Parameters:

moi - the object on which the initCmf method should be invoked.

name - the name to use for registering the object.

db - indicates if a persistent storage is required.

list - modification list.

Throws: InvocationTargetException

The initialization method (initCmf) of the specified class could not be executed.

Throws: IllegalAccessException

The method cannot access the class definition of the specified m-bean.

Throws: InstanceAlreadyExistException

The m-bean is already registered in the repository.

 public void delObject(Object object) throws InstanceNotFoundException, InvocationTargetException

Removes an m-bean from the m-bean repository by using a reference to the m-bean. Once the method has been invoked, the m-bean cannot be accessed via its object name. The m-bean is shut down. If a deleteCmf method is defined for the m-bean, it is invoked to remove the m-bean.

This method is to be used only for deleting a singleton, that is, only one instance of that class is permitted within the repository for a given domain.

Parameters:

object - A reference to the m-bean to be removed from the m-bean repository.

Throws: InstanceNotFoundException

The m-bean does not exist in the repository.

Throws: InvocationTargetException

It is a checked exception that wraps an exception thrown by an invoked method or constructor.

 public void delObject(ObjectName name) throws InstanceNotFoundException, InvocationTargetException

Removes an m-bean from the m-bean repository. The m-bean is identified by its object name. Once the method has been invoked, the m-bean cannot be accessed via its object name. The m-bean is shut down. If a deleteCmf method is defined for the m-bean, it is invoked to remove the m-bean.

Parameters:

name - The object name of the m-bean to be removed.

Throws: InstanceNotFoundException

The m-bean does not exist in the repository.

Throws: InvocationTargetException

It is a checked exception that wraps an exception thrown by an invoked method or constructor.

 public void fastDelObject(ObjectName name) throws InstanceNotFoundException, InvocationTargetException

Removes an m-bean from the m-bean repository. The m-bean is identified by its object name. Once the method has been invoked, the m-bean cannot be accessed via its object name. The m-bean is not shut down, but continues to run after this method has been invoked.

Parameters:

name - The object name of the m-bean to be removed.

Throws: InstanceNotFoundException

The m-bean does not exist in the repository.

Throws: InvocationTargetException

It is a checked exception that wraps an exception thrown by an invoked method or constructor.

 public ObjectName addRelation(RelationIf rel,
                               ObjectName relName) throws InstanceAlreadyExistException, InstanceNotFoundException

Adds a relation under the control of the core management framework. The method enables you to give an object name to the relation. If you want the object name to be generated by the core management framework, specify a null object for the relName parameter.

Parameters:

rel - The relation to be added to the repository.

relName - The object name of the relation to be added. If you want the object name to be generated by the core management framework, specify a null object for this parameter.

Returns:

The ObjectName of the instantiated relation.

Throws: InstanceAlreadyExistException

The relation is already registered in the repository.

Throws: InstanceNotFoundException

One or more roles in the relation are not registered in the repository.

 public ObjectName newRelation(String relClassName,
                               ObjectName relName,
                               ObjectName roleNames[],
                               ObjectName aLoader) throws IllegalAccessException, InstantiationException, InstanceAlreadyExistException, ClassNotFoundException, InstanceNotFoundException, InvalidPropertyValueException

Instantiates and then adds a relation under the control of the core management framework. The method enables you to give an object name to the relation. If you want the object name to be generated by the core management framework, specify a null object for the relName parameter.

Parameters:

relClassName - The class name of the relation to be instantiated.

relName - The object name of the relation. If you want the object name to be generated by the core management framework, specify a null object for this parameter.

roleNames - An ordered array of the names of the roles of the relation.

aLoader - The name of the class loader to be used.

Returns:

The ObjectName of the instantiated relation.

Throws: IllegalAccessException

The method cannot access the class definition of the specified relation.

Throws: InstanceAlreadyExistException

The relation is already registered in the repository.

Throws: InstanceNotFoundException

One or more roles in the relation are not registered in repository.

Throws: ClassNotFoundException

The class loader could not find the class to be instantiated.

Throws: InstantiationException

A new instance of the specified class could not be created.

Throws: InvalidPropertyValueException

The number of roles in the relation is not equal to the degree of the relation.

 public Vector getRelations(ObjectName relClassName,
                            ObjectName roleName,
                            int roleRank) throws InstanceNotFoundException

Get handles on relations of a given class with a given role at a given rank. The role name need not be specified. Then all relations of the given class are returned. The rank is ignored. When the role name is specified, the role rank may not be specified. In this case, the role name can appear anywhere in the relation.

Parameters:

relClassName - name of the relation instance

roleName - name of a role in the relation instances

roleRank - which role in the relation

Returns:

A list containing the selected relations.

Throws: InstanceNotFoundException

One or more roles in the relation are not registered in repository.

 public Object getValue(ObjectName name,
                        String property) throws InvocationTargetException, PropertyNotFoundException, InstanceNotFoundException

Gets the value of a specific property within a named m-bean. The m-bean is identified by its object name.

Parameters:

name - The object name of the m-bean from within which the property is to be retrieved.

property - The name of the property to be retrieved.

Returns:

The value of the retrieved property.

Throws: InvocationTargetException

The initialization method (initCmf) of the specified class could not be executed.

Throws: InstanceNotFoundException

The m-bean does not exist in the repository.

Throws: PropertyNotFoundException

The specified property does not exist or cannot be retrieved.

 public Object getIndexedValue(ObjectName name,
                               String property,
                               int pos) throws InvocationTargetException, PropertyNotFoundException, InstanceNotFoundException

Gets the value of a specific indexed property within a named m-bean. The m-bean is identified by its object name.

Parameters:

name - The object name of the m-bean from within which the property is to be retrieved.

property - The name of the property to be retrieved.

pos - The position in the index of the value to be retrieved.

Returns:

The value of the retrieved property.

Throws: InvocationTargetException

The initialization method (initCmf) of the specified class could not be executed.

Throws: InstanceNotFoundException

The m-bean does not exist in the repository.

Throws: PropertyNotFoundException

The specified property does not exist or cannot be retrieved.

 public PropertyList getValues(ObjectName name,
                               Vector propertyIdList) throws InstanceNotFoundException

Enables the values of several properties within an m-bean to be obtained.

Parameters:

name - The object name of the m-bean from within which the properties are to be retrieved.

propertyIdList - A list of the properties to be retrieved. The list is permitted to contain String or PropertyName objects.

Returns:

The values of the retrieved properties.

Throws: InstanceNotFoundException

The m-bean does not exist in the repository.

 public Object getValue(Object instance,
                        String property) throws InvocationTargetException, PropertyNotFoundException

Gets the value of a specific property within an m-bean.

Parameters:

instance - The m-bean from within which the property is to be retrieved.

property - The name of the property to be retrieved.

Returns:

The value of the retrieved property.

Throws: InvocationTargetException

The initialization method (initCmf) of the specified class could not be executed.

Throws: PropertyNotFoundException

The specified property does not exist or cannot be retrieved.

 public Object getIndexedValue(Object instance,
                               String property,
                               int pos) throws InvocationTargetException, PropertyNotFoundException

Gets the value of a specific indexed property within an m-bean.

Parameters:

instance - The m-bean from within which the property is to be retrieved.

property - The name of the property to be retrieved.

pos - The position in the index of the value to be retrieved.

Returns:

The value of the retrieved property.

Throws: InvocationTargetException

The initialization method (initCmf) of the specified class could not be executed.

Throws: PropertyNotFoundException

The specified property does not exist or cannot be retrieved.

 public Object setValue(ObjectName name,
                        String id,
                        Object val,
                        String op) throws InvocationTargetException, InstanceNotFoundException, PropertyNotFoundException, InvalidPropertyValueException, InstantiationException, ClassNotFoundException, IllegalAccessException

Sets the value of a specific property of a named m-bean. The m-bean is identified by its object name.

Parameters:

name - The name of the m-bean within which the property is to be set.

id - The name of the property to be set.

val - The value that the property is to be set to.

op - The Java class name of the operator to be applied to the property. The class must implement the OperatorSrvIf interface.

Returns:

The value of the property that has been set.

Throws: PropertyNotFoundException

The specified property does not exist or cannot be retrieved.

Throws: InvocationTargetException

The initialization method (initCmf) of the specified class could not be executed.

Throws: InvalidPropertyValueException

The specified value is not a valid value for the property.

Throws: IllegalAccessException

The method cannot access the class definition of the specified m-bean.

Throws: InstanceNotFoundException

The specified m-bean does not exist in the repository.

Throws: ClassNotFoundException

The class loader could not find the class to be instantiated.

Throws: InstantiationException

A new instance of the specified class could not be created.

 public Object setIndexedValue(ObjectName name,
                               String id,
                               Object val,
                               String op,
                               int pos) throws IllegalAccessException, InvocationTargetException, PropertyNotFoundException, InstanceNotFoundException, InvalidPropertyValueException, InstantiationException, ClassNotFoundException

Sets the value of a specific indexed property of a named m-bean. The m-bean is identified by its object name.

Parameters:

name - The name of the m-bean within which the property is to be set.

id - The name of the property to be set.

value - The value that the property is to be set to.

op - The Java class name of the operator to be applied to the property. The class must implement the OperatorSrvIf interface.

pos - The position in the index of the value to be set.

Returns:

The value of the property that has been set.

Throws: IllegalAccessException

The method cannot access the class definition of the specified m-bean.

Throws: InvocationTargetException

The initialization method (initCmf) of the specified class could not be executed.

Throws: PropertyNotFoundException

The specified property does not exist or cannot be retrieved.

Throws: InstanceNotFoundException

The specified m-bean does not exist in the repository.

Throws: InvalidPropertyValueException

The specified value is not a valid value for the property.

Throws: ClassNotFoundException

The class loader could not find the class to be instantiated.

Throws: InstantiationException

A new instance of the specified class could not be created.

 public Object setValue(Object instance,
                        String property,
                        Object value) throws InvocationTargetException, PropertyNotFoundException, InvalidPropertyValueException

Sets the value of a specific property of a given m-bean. This method does not update the repository, but gives control to the user when to update the repository. This is because the method does not take the object name of an m-bean as a parameter.

Parameters:

instance - The m-bean within which the property is to be set.

property - The property to be set.

value - The value that the property is to be set to.

Returns:

The value of the property that has been set. definition of the specified m-bean.

Throws: InvocationTargetException

The initialization method (initCmf) of the specified class could not be executed.

Throws: PropertyNotFoundException

The specified property does not exist or cannot be retrieved.

Throws: InvalidPropertyValueException

The specified value is not a valid value for the property.

 public Object setIndexedValue(Object instance,
                               String property,
                               Object value,
                               int pos) throws IllegalAccessException, InvocationTargetException, ServiceNotFoundException, PropertyNotFoundException, InvalidPropertyValueException

Sets the value of an indexed property of a given m-bean. This method does not update the repository, but gives control to the user when to update the repository. This is because the method does not take the object name of an m-bean as a parameter.

Parameters:

instance - The m-bean within which the property is to be set.

property - The property to be set.

value - The value that the property is to be set to.

pos - The position in the index of the value to be set.

Returns:

The value of the property that has been set.

Throws: IllegalAccessException

The method cannot access the class definition of the specified m-bean.

Throws: InvocationTargetException

The initialization method (initCmf) of the specified class could not be executed.

Throws: PropertyNotFoundException

The specified property does not exist or cannot be retrieved.

Throws: InvalidPropertyValueException

The specified value is not a valid value for the property.

Throws: ServiceNotFoundException

The requested service is not supported.

 public PropertyList setValues(ObjectName name,
                               ModificationList modifList) throws InstanceNotFoundException

Enables the values of several properties within an m-bean to be set. Each value must support the Serializable interface.

Parameters:

name - The object name of the m-bean within which the properties are to be set.

modifList - A list of the properties to be set and the values to which they are to be set.

Returns:

The values of the properties that were set.

Throws: InstanceNotFoundException

The specified m-bean does not exist in the repository.

 public PropertyList setValues(ObjectName name,
                               ModificationList modifList,
                               Object obj) throws InstanceNotFoundException

Enables the values of several properties within an m-bean to be set. This method does not update the repository, but gives control to the user when to update the repository. Each value must support the Serializable interface. The object name of an m-bean is used by the Operator service to perform operations on m-bean properties.

Parameters:

name - The object name of the m-bean within which the properties are to be set.

modifList - A list of the properties to be set and the values to which they are to be set.

obj - The m-bean within which the properties are to be set.

Returns:

The values of the properties that were set.

Throws: InstanceNotFoundException

The specified m-bean does not exist in the repository.

See Also:

OperatorSrvIf

 public void sendEvent(EventObject event,
                       ObjectName source) throws ServiceNotFoundException

Enables an m-bean to send an EventObject. The EventObject is then forwarded to all Java objects that implement the EventHandlingIf interface.

Parameters:

event - The event object to be sent. definition of the specified m-bean.

Throws: ServiceNotFoundException

The requested service is not supported.

 public Vector addListener(ObjectName mo,
                           Object obj,
                           String listen) throws InstanceNotFoundException, IllegalAccessException, ServiceNotFoundException, ClassNotFoundException, InstantiationException, InvocationTargetException

Enables a listener for a named m-bean to be added.

Parameters:

name - The name of the m-bean to be listened to.

- obj The m-bean to be listened to.

listen - The listener to be instantiated.

Returns:

A vector containing, in the order listed, these elements:

• The listener created
• The local name of the interface (without the package prefix and the stub)
• The full name of the interface (without the stub)

The purpose of returning all the information is to speed up deletion.

Throws: ServiceNotFoundException

The requested service is not supported.

Throws: IllegalAccessException

The method cannot access the class definition of the specified m-bean.

Throws: InvocationTargetException

The initialization method (initCmf) of the specified class could not be executed.

Throws: InstanceNotFoundException

The specified m-bean does not exist in the repository.

Throws: ClassNotFoundException

The class loader could not find the class to be instantiated.

Throws: InstantiationException

A new instance of the specified class could not be created.

 public void removeListener(Object source,
                            Object listen,
                            String ifName,
                            Class ifClass) throws InvocationTargetException, IllegalAccessException

Enables a listener for an m-bean to be removed.

Parameters:

source - The name of the m-bean for which the listener was operating.

listen - The listener to be removed.

ifName - The local interface name.

ifClass - The class of the interface implemented by the listener.

Throws: InvocationTargetException

The initialization method (initCmf) of the specified class could not be executed.

Throws: IllegalAccessException

The method has tried to access a class that is not public and in another package.

 public Object invokePerform(ObjectName objName,
                             String pfName,
                             Object params[],
                             String sig[]) throws InvocationTargetException, NoSuchMethodException, InstanceNotFoundException, IllegalAccessException

Invokes a performer method on an m-bean.

Parameters:

objName - The object name of the m-bean on which the performer is to be invoked.

pfName - The name of the performer method to be invoked.

params - An array containing the parameters to be set when the performer method is invoked.

sig - An array containing the signature of the performer method. The class objects will be loaded through the same class loader as the one used for loading the m-bean on which the performer method is invoked.

Returns:

The object returned by the performer method, which represents the result of invoking the performer method on the specified m-bean.

Throws: InstanceNotFoundException

The specified m-bean does not exist in the repository.

Throws: InvocationTargetException

The initialization method (initCmf) of the specified class could not be executed.

Throws: NoSuchMethodException

The specified performer method is not a method in the m-bean.

Throws: IllegalAccessException

The method has tried to access a class that is not public and in another package.

 public Object invokePerform(Object obj,
                             String pfName,
                             Object params[],
                             String sig[]) throws InvocationTargetException, NoSuchMethodException, InstanceNotFoundException, IllegalAccessException

Throws: InvocationTargetException

It is a checked exception that wraps an exception thrown by an invoked method or constructor.

Throws: NoSuchMethodException

The specified method could not be found.

Throws: InstanceNotFoundException

The m-bean does not exist in the repository.

Throws: IllegalAccessException

The method has tried to access a class that is not public and in another package.

 public MoRepSrvIf getMoRepSrvIf()

Returns the m-bean repository associated with the core management framework.

Returns:

The m-bean repository.

 public ClassLoader getClassLoader()

Returns the network class loader associated with the core management framework.

Returns:

The network class loader.

 public void setClassLoader(ClassLoader service)

Sets the network class loader associated with the core management framework.

Parameters:

service - The network class loader.

 public MetaDataSrvIf getMetaDataSrvIf()

Returns the metadata service associated with the core management framework.

Returns:

The metadata service.

 public void setMetaDataSrvIf(MetaDataSrvIf service)

Sets the metadata service associated with the core management framework.

 public FilterSrvIf getFilterSrvIf()

Returns the filtering service associated with the core management framework.

Returns:

The filtering service.

 public void setFilterSrvIf(FilterSrvIf service)

Sets the filtering service associated with the core management framework.

 public RelationSrvIf getRelationSrvIf()

Returns the relationship service associated with the core management framework.

Returns:

The relationship serrvice.

 public void setRelationSrvIf(RelationSrvIf service)

Sets the relationship service associated with the core management framework.

 public String getClassVersion()

Returns the version of this class.

Returns:

The version of the class.

 public String getDomain()

Returns the domain assigned to the core management framework.

Returns:

The assigned domain.

 public Integer getNbElements()

Returns the number of objects controlled by the framework.

Returns:

The number of objects.

 public String getJdmkVersion()

Returns the string representing the version of JDMK.

Returns:

the string representing the version of JDMK.

 public synchronized void addFrameworkListener(FrameworkListener x)

Allows you to register a listener to receive FrameworkEvents. The method is compliant with the Bean design pattern.

Parameters:

x - The listener you want to add.

 public synchronized void removeFrameworkListener(FrameworkListener x)

Removes a listener.

Parameters:

x - The listener you want to remove.

All Packages  Class Hierarchy  This Package  Previous  Next  Index