All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class com.sun.jaw.impl.adaptor.rmi.AdaptorClient

java.lang.Object
   |
   +----com.sun.jaw.impl.adaptor.rmi.AdaptorClient

public class AdaptorClient
extends Object
implements AdaptorMO

The AdaptorClient class provides an implementation of the AdaptorMO interface based on the Java remote method invocation (RMI) system.

In order to identify the Java Dynamic Management agent the adaptor needs to communicate with, the method connect needs to be invoked with the RMI identity of the RMI Adaptor server.

See Also:: AdaptorMO, AdaptorClientRO

AdaptorClient(): Constructs an adaptor client.

addListener(ManagedObject, EventListener, String): Allows a listener for a managed object to be added.
cb_connect(ManagedObject): Connect the C-bean to the adaptor.
cb_disconnect(ManagedObject): Disconnect the C-bean from the adaptor.
cb_newDBMO(String, ObjectName, ModificationList): Creates a persistent instance of a managed object in the remote object server.
cb_newDBMO(String, ObjectName, ModificationList, ObjectName): Creates a persistent instance of a managed object in the remote object server.
cb_newMO(String, ObjectName, ModificationList): Creates an instance of a managed object in the remote object server.
cb_newMO(String, ObjectName, ModificationList, ObjectName): Creates an instance of a managed object in the remote object server.
connect(Object, String, int, String): Initializes the communications with a remote managed object server.
deleteMO(ObjectName): Deletes an instance of a managed object in the remote object server.
disconnect(): Terminates the communication with the remote managed object server.
getAdaptorVersion(): The method returns a string that represents the version of this JDMK adaptor.
getClassLoader(): Get the class loader used to retreive all MO and MOStub classes
getClassVersion(): Returns the version of this class.
getDomain(): Returns the name of the domain controlled by the managed object server.
getIndexedValue(ObjectName, String, int): Allows the value of a specific indexed property within a managed object to be obtained.
getMapperSrv(): Gets the mapper used to derive the implementation name from an object name.
getObject(ObjectName, QueryExp): Gets handles on managed objects controlled by the remote managed object server.
getObjectFromCache(ObjectName): Returns the local managed object associated with name.
getOnlyNames(ObjectName, QueryExp): Gets the names of managed objects controlled by the remote managed object server.
getValue(ObjectName, String): Allows the value of a specific property within a managed object to be obtained.
getValues(ObjectName, Vector): Allows the values of several properties within a managed object to be obtained.
giveListener(ObjectName, ObjectName): Retrieves the the given listener associated to the managed object.
invokePerform(ObjectName, String, Object[], String[]): Allows any method to be applied to a remote object.
isConnected(): Checks whether the managed object adaptor is connected to the remote managed object server.
newDBMO(String, ObjectName, ModificationList): Creates a persistent instance of a managed object in the remote object server.
newDBMO(String, ObjectName, ModificationList, ObjectName): Creates a persistent instance of a managed object in the remote object server.
newMO(String, ObjectName, ModificationList): Creates an instance of a managed object in the remote object server.
newMO(String, ObjectName, ModificationList, ObjectName): Creates an instance of a managed object in the remote object server.
newObj(String): Allows a Java object of a particular class to be instantiated in a remote managed object server.
newObj(String, ObjectName): Allows a Java object of a particular class to be instantiated in a remote managed object server.
removeListener(ManagedObject, ObjectName): Allows a listener for a managed object to be removed.
setClassLoader(ClassLoader): Allows to specify a class loader to retreive MO and MOStub classes
setIndexedValue(ObjectName, String, Object, String, int): Sets the value of a specific indexed property of a named managed object.
setMapperSrv(MapperSrvIf): Allows you to specify a mapper.
setup(Object): Configures the RMI Client Adaptor.
setValue(ObjectName, String, Object, String): Sets the value of a specific property of a named managed object.
setValues(ObjectName, ModificationList): Sets the value of several properties within a managed object.
transferObject(Object, ObjectName): Adds a named object under the control of the remote CMF.

AdaptorClient

 public AdaptorClient()

Constructs an adaptor client.

setup

 public int setup(Object param)

Configures the RMI Client Adaptor.

Parameters:: param - Parameters to be set.

connect

 public void connect(Object context,
                     String host,
                     int port,
                     String logicalName) throws CommunicationException, SecurityException

Initializes the communications with a remote managed object server.

Parameters:: context - Not used by the RMI adaptor.; host - The host name of the server.; port - The port number of the server.; logicalName - The logical name of the server.
Throws: CommunicationException: A communications problem occurred.
Throws: SecurityException: A security violation has occurred.

disconnect

 public void disconnect()

Terminates the communication with the remote managed object server.

isConnected

 public Boolean isConnected()

Checks whether the managed object adaptor is connected to the remote managed object server.

Returns:: True if the managed object adaptor is connected, false otherwise.

getOnlyNames

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

Gets the names of managed objects controlled by the remote managed object server.

The method enables any of the following things be obtained:

The names of all the managed objects.
The names of a subset specified through a query.
The name of a specific instance.

When the class name and instance name are empty, it means that all the objects are to be selected (and filtered if a query is specified).

Parameters:: name - The names of the managed objects to be retrieved.; query - The query to be applied for selecting managed objects.
Returns:: A list containing the object names of the selected managed objects.
Throws: InstanceNotFoundException: The m-bean does not exist in the repository.

getObject

 public Vector getObject(ObjectName name,
                         QueryExp filter) throws LocalException, InstanceNotFoundException, InvocationTargetException

Gets handles on managed objects controlled by the remote managed object server. The method enables any of the following things to be obtained:

All the managed objects.
A subset specified through a filter.
A specific instance.

Parameters:: name - The names of the managed objects to be retrieved.; filter - The filter to be applied for selecting managed objects.
Returns:: A list containing the selected managed objects.
Throws: LocalException: An error has occurred on the client side.
Throws: InstanceNotFoundException: The m-bean does not exist in the repository.
Throws: InvocationTargetException: An exception has been thrown by the user code on the remote agent. The exception is wrapped by the InvocationTargetException.

getValue

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

Allows the value of a specific property within a managed object to be obtained.

Parameters:: name - The name of the managed object 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: InstanceNotFoundException: The m-bean does not exist in the repository.
Throws: PropertyNotFoundException: The specified property is not defined for the object.
Throws: InvocationTargetException: It is a checked exception that wraps an exception thrown by an invoked method or constructor.

getIndexedValue

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

Allows the value of a specific indexed property within a managed object to be obtained.

Parameters:: name - The name of the managed object 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: InstanceNotFoundException: The m-bean does not exist in the repository.
Throws: PropertyNotFoundException: The specified property is not defined for the object.
Throws: InvocationTargetException: It is a checked exception that wraps an exception thrown by an invoked method or constructor.

getValues

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

Allows the values of several properties within a managed object to be obtained.

Parameters:: name - The names of the objects from within which the properties are to be retrieved.; propertyIdList - A list of the properties to be retrieved.
Returns:: The values of the retrieved properties.
Throws: InstanceNotFoundException: The m-bean does not exist in the repository.

setValue

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

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

Parameters:: name - The name of the object within which the property is to be set.; id - 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.
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: 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.
Throws: ClassNotFoundException: The specified class could not be found.
Throws: InstantiationException: A new instance of the specified class could not be created.
Throws: InvocationTargetException: It is a checked exception that wraps an exception thrown by an invoked method or constructor.

setIndexedValue

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

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

Parameters:: name - The name of the object within which the property is to be set.; id - The property to be set.; val - The value that the property is to be set to.; pos - The position in the index of the value to be set.
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: 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.
Throws: ClassNotFoundException: The specified class could not be found.
Throws: InstantiationException: A new instance of the specified class could not be created.
Throws: InvocationTargetException: It is a checked exception that wraps an exception thrown by an invoked method or constructor.

setValues

 public PropertyList setValues(ObjectName name,
                               ModificationList modif) throws InstanceNotFoundException, IllegalAccessException, InvocationTargetException

Sets the value of several properties within a managed object. The value must support the Serializable interface.

Parameters:: name - The name of the object within which the properties are to be set.; modif - 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 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.
Throws: InvocationTargetException: It is a checked exception that wraps an exception thrown by an invoked method or constructor.

getObjectFromCache

 public ManagedObject getObjectFromCache(ObjectName name)

Returns the local managed object associated with name.

Parameters:: name - The name of the local managed object to be accessed.
Returns:: The local object the name of which is name.

addListener

 public ObjectName addListener(ManagedObject mo,
                               EventListener listen,
                               String listenerType) throws InstanceNotFoundException, IllegalAccessException, ClassNotFoundException, InstantiationException

Allows a listener for a managed object to be added. Transparently to the caller, the adaptor creates and registers a listener for the object within the managed object server. The managed object to be listened to is specified by the mo parameter. When the remote object fires an event by calling a method of the remote listener, the corresponding method in the local listener is called.

Parameters:: mo - The name of the managed object to be listened to.; listen - The listener to be added.; listenerType - Class name of the remote listener to be created.
Returns:: The name of the remote listener.
Throws: InstanceNotFoundException: The object does not exist in the repository.
Throws: IllegalAccessException: Access denied.
Throws: ClassNotFoundException: The class to be instantiated could not be found by the class loader.
Throws: InstantiationException: A new instance of the specified operator class could not be created.
See Also:: removeListener

removeListener

 public void removeListener(ManagedObject mo,
                            ObjectName name)

Allows a listener for a managed object to be removed.

Parameters:: mo - The name of the managed object for which the listener was operating.; name - The name of the remote listener to be removed.

giveListener

 public EventListener giveListener(ObjectName mo,
                                   ObjectName listener)

Retrieves the the given listener associated to the managed object.

Parameters:: mo - The name of the managed object for which the listener was operating.; name - The name of the remote listener to be retrieved.
Returns:: The event listener.

newObj

 public void newObj(String className) throws IllegalAccessException, InstantiationException, ClassNotFoundException, InvocationTargetException

Allows a Java object of a particular class to be instantiated in a remote managed object server.

Parameters:: className - The Java class name of the object to be created.
Throws: IllegalAccessException: The method has tried to access a class that is not public and in another package.
Throws: InstantiationException: A new instance of the specified class could not be created.
Throws: ClassNotFoundException: The specified class could not be found.
Throws: InvocationTargetException: It is a checked exception that wraps an exception thrown by an invoked method or constructor.

newMO

 public void newMO(String impl,
                   ObjectName name,
                   ModificationList list) throws IllegalAccessException, ClassNotFoundException, InstanceAlreadyExistException, InstantiationException, InvocationTargetException

Creates an instance of a managed object in the remote object server. When calling the method, you can optionally provide the class name of the Java implementation to be used for instantiating the new object.

Parameters:: impl - The name of the Java implementation to be used on the server.; name - The name of the managed object to be created.; list - The list of initial values of the properties of the new managed object.
Throws: ClassNotFoundException: The class to be instantiated could not be found by the class loader.
Throws: InstantiationException: A new instance of the specified class could not be created.
Throws: IllegalAccessException: The method has tried to access a class that is not public and in another package.
Throws: InstanceAlreadyExistException: The managed object is already registered in the repository.
Throws: InvocationTargetException: It is a checked exception that wraps an exception thrown by an invoked method or constructor.

newDBMO

 public void newDBMO(String impl,
                     ObjectName name,
                     ModificationList list) throws IllegalAccessException, ClassNotFoundException, InstanceAlreadyExistException, InstantiationException, InvocationTargetException

Creates a persistent instance of a managed object in the remote object server. When calling the method, you can optionally provide the class name of the Java implementation to be used for instantiating the new object.

Parameters:: impl - The name of the Java implementation to be used on the server.; name - The name of the managed object to be created.; list - The list of initial values of the properties of the new managed object.
Throws: ClassNotFoundException: The class to be instantiated could not be found by the class loader.
Throws: InstantiationException: A new instance of the specified class could not be created.
Throws: IllegalAccessException: The method has tried to access a class that is not public and in another package.
Throws: InstanceAlreadyExistException: The managed object is already registered in the repository.
Throws: InvocationTargetException: It is a checked exception that wraps an exception thrown by an invoked method or constructor.

cb_newMO

 public Object cb_newMO(String impl,
                        ObjectName name,
                        ModificationList list) throws IllegalAccessException, ClassNotFoundException, InstanceAlreadyExistException, InstantiationException, LocalException, InvocationTargetException

Parameters:: impl - The name of the Java implementation to be used on the server.; name - The name of the managed object to be created.; list - The list of initial values of the properties of the new managed object.
Returns:: The newly created managed object.
Throws: ClassNotFoundException: The class to be instantiated could not be found by the class loader.
Throws: InstantiationException: A new instance of the specified class could not be created.
Throws: IllegalAccessException: The method has tried to access a class that is not public and in another package.
Throws: InstanceAlreadyExistException: The managed object is already registered in the repository.
Throws: LocalException: An error has occurred on the client side.
Throws: InvocationTargetException: It is a checked exception that wraps an exception thrown by an invoked method or constructor.

cb_newDBMO

 public Object cb_newDBMO(String impl,
                          ObjectName name,
                          ModificationList list) throws IllegalAccessException, ClassNotFoundException, InstanceAlreadyExistException, InstantiationException, LocalException, InvocationTargetException

Parameters:: impl - The name of the Java implementation to be used on the server.; name - The name of the managed object to be created.; list - The list of initial values of the properties of the new managed object.
Returns:: The newly created managed object.
Throws: ClassNotFoundException: The class to be instantiated could not be found by the class loader.
Throws: InstantiationException: A new instance of the specified class could not be created.
Throws: IllegalAccessException: The method has tried to access a class that is not public and in another package.
Throws: InstanceAlreadyExistException: The managed object is already registered in the repository.
Throws: LocalException: An error has occurred on the client side.
Throws: InvocationTargetException: It is a checked exception that wraps an exception thrown by an invoked method or constructor.

newObj

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

Allows a Java object of a particular class to be instantiated in a remote managed object server.

Parameters:: className - The Java class name of the object to be created.; aLoader - The name of a class loader to be used.
Throws: IllegalAccessException: The method has tried to access a class that is not public and in another package.
Throws: InstantiationException: A new instance of the specified class could not be created.
Throws: ClassNotFoundException: The specified class could not be found.
Throws: InvocationTargetException: It is a checked exception that wraps an exception thrown by an invoked method or constructor.

newMO

 public void newMO(String impl,
                   ObjectName name,
                   ModificationList list,
                   ObjectName aLoader) throws IllegalAccessException, ClassNotFoundException, InstanceAlreadyExistException, InstantiationException, InvocationTargetException

Parameters:: impl - The name of the Java implementation to be used on the server.; name - The name of the managed object to be created.; list - The list of initial values of the properties of the new managed object.; aLoader - The name of a class loader to be used.
Throws: ClassNotFoundException: The class to be instantiated could not be found by the class loader.
Throws: InstantiationException: A new instance of the specified class could not be created.
Throws: IllegalAccessException: The method has tried to access a class that is not public and in another package.
Throws: InstanceAlreadyExistException: The managed object is already registered in the repository.
Throws: InvocationTargetException: It is a checked exception that wraps an exception thrown by an invoked method or constructor.

newDBMO

 public void newDBMO(String impl,
                     ObjectName name,
                     ModificationList list,
                     ObjectName aLoader) throws IllegalAccessException, ClassNotFoundException, InstanceAlreadyExistException, InstantiationException, InvocationTargetException

Parameters:: impl - The name of the Java implementation to be used on the server.; name - The name of the managed object to be created.; list - The list of initial values of the properties of the new managed object.; aLoader - The name of a class loader to be used.
Throws: ClassNotFoundException: The class to be instantiated could not be found by the class loader.
Throws: InstantiationException: A new instance of the specified class could not be created.
Throws: IllegalAccessException: The method has tried to access a class that is not public and in another package.
Throws: InstanceAlreadyExistException: The managed object is already registered in the repository.
Throws: InvocationTargetException: It is a checked exception that wraps an exception thrown by an invoked method or constructor.

cb_newMO

 public Object cb_newMO(String impl,
                        ObjectName name,
                        ModificationList list,
                        ObjectName aLoader) throws IllegalAccessException, ClassNotFoundException, InstanceAlreadyExistException, InstantiationException, LocalException, InvocationTargetException

Parameters:: impl - The name of the Java implementation to be used on the server.; name - The name of the managed object to be created.; list - The list of initial values of the properties of the new managed object.; aLoader - The name of a class loader to be used.
Returns:: The newly created managed object.
Throws: ClassNotFoundException: The class to be instantiated could not be found by the class loader.
Throws: InstantiationException: A new instance of the specified class could not be created.
Throws: IllegalAccessException: The method has tried to access a class that is not public and in another package.
Throws: InstanceAlreadyExistException: The managed object is already registered in the repository.
Throws: LocalException: An error has occurred on the client side.
Throws: InvocationTargetException: It is a checked exception that wraps an exception thrown by an invoked method or constructor.

cb_newDBMO

 public Object cb_newDBMO(String impl,
                          ObjectName name,
                          ModificationList list,
                          ObjectName aLoader) throws IllegalAccessException, ClassNotFoundException, InstanceAlreadyExistException, InstantiationException, LocalException, InvocationTargetException

Parameters:: impl - The name of the Java implementation to be used on the server.; name - The name of the managed object to be created.; list - The list of initial values of the properties of the new managed object.; aLoader - The name of a class loader to be used.
Returns:: The newly created managed object.
Throws: ClassNotFoundException: The class to be instantiated could not be found by the class loader.
Throws: InstantiationException: A new instance of the specified class could not be created.
Throws: IllegalAccessException: The method has tried to access a class that is not public and in another package.
Throws: InstanceAlreadyExistException: The managed object is already registered in the repository.
Throws: LocalException: An error has occurred on the client side.
Throws: InvocationTargetException: It is a checked exception that wraps an exception thrown by an invoked method or constructor.

transferObject

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

Adds a named object under the control of the remote CMF.

Use this method with care, because it moves an instance remotely. All methods of this instance are executed locally on the remote agent.

Parameters:: object - The object to be added to the remote repository.; logicalName - The logical name of the object.
Throws: InstanceAlreadyExistException: The managed object is already registered in the repository.

deleteMO

 public void deleteMO(ObjectName name) throws InstanceNotFoundException, InvocationTargetException

Deletes an instance of a managed object in the remote object server.

Parameters:: name - The name of the managed object to be deleted.
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.

invokePerform

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

Allows any method to be applied to a remote object.

Parameters:: objName - The name of the remote object.; pfName - The name of the method to be applied.; params - An array containing the parameters to be passed to the method.; signature - The signature of the method to be called.
Returns:: The value of the method applied.
Throws: InstanceNotFoundException: The object does not exist in the repository.
Throws: NoSuchMethodException: The method specified is not defined.
Throws: InvocationTargetException: It is a checked exception that wraps an exception thrown by an invoked method or constructor.
Throws: IllegalAccessException: The method has tried to access a class that is not public and in another package.

cb_connect

 public void cb_connect(ManagedObject cbean)

Connect the C-bean to the adaptor. If a C-bean with the same object name is already known by the adaptor, then the connection will fail.

Parameters:: cbean - The C-bean to be connected.

cb_disconnect

 public void cb_disconnect(ManagedObject cbean)

Disconnect the C-bean from the adaptor.

Parameters:: cbean - The C-bean to be disconnected.

getClassVersion

 public static String getClassVersion()

Returns the version of this class.

getAdaptorVersion

 public String getAdaptorVersion()

The method returns a string that represents the version of this JDMK adaptor.

Returns:: a string representation of the version of this JDMK adaptor.

getDomain

 public String getDomain() throws CommunicationException

Returns the name of the domain controlled by the managed object server.

Throws: CommunicationException: A communications problem occurred.

getClassLoader

 public ClassLoader getClassLoader()

Get the class loader used to retreive all MO and MOStub classes

Returns:: the ClassLoader used or null if it is the default loader

setClassLoader

 public void setClassLoader(ClassLoader loader)

Allows to specify a class loader to retreive MO and MOStub classes

Parameters:: loader - the instance of ClassLoader

getMapperSrv

 public MapperSrvIf getMapperSrv()

Gets the mapper used to derive the implementation name from an object name.

Returns:: The mapping service used or null if it is the default mapper.

setMapperSrv

 public void setMapperSrv(MapperSrvIf mapper)

Allows you to specify a mapper.

Parameters:: mapper - The instance of mapping service to be used.

All Packages  Class Hierarchy  This Package  Previous  Next  Index