com.sun.jaw.reference.client.adaptor
Interface AdaptorMO

All Known Implementing Classes:
AdaptorClient, AdaptorClient, AdaptorClient

public abstract interface AdaptorMO
extends java.io.Serializable

This interface provides a means for accessing remote objects in a manner that is independent of the communication protocol.

The interface defines methods for:

This interface enables you to implement synchronous and asynchronous modes of access to managed objects. However an implementation does not need to support both modes. When a mode is not supported, the implementation will return an exception.


Fields inherited from class java.io.Serializable
serialVersionUID
 
Method Summary
 ObjectName addListener(ManagedObject mo, java.util.EventListener listen, java.lang.String name)
          Allows a listener for a managed object to be added.
 void cb_connect(ManagedObject cbean)
          Connect the C-bean to the adaptor.
 void cb_disconnect(ManagedObject cbean)
          Disconnect the C-bean from the adaptor.
 java.lang.Object cb_newDBMO(java.lang.String impl, ObjectName name, ModificationList list)
          Creates a persistent instance of a managed object in the remote object server.
 java.lang.Object cb_newDBMO(java.lang.String impl, ObjectName name, ModificationList list, ObjectName aLoader)
          Creates a persistent instance of a managed object in the remote object server.
 java.lang.Object cb_newMO(java.lang.String impl, ObjectName name, ModificationList list)
          Creates an instance of a managed object in the remote object server.
 java.lang.Object cb_newMO(java.lang.String impl, ObjectName name, ModificationList list, ObjectName aLoader)
          Creates an instance of a managed object in the remote object server.
 void connect(java.lang.Object context, java.lang.String host, int port, java.lang.String logicalName)
          Initializes the communication with the remote managed object server.
 void deleteMO(ObjectName name)
          Deletes an instance of a managed object in the remote object server.
 void disconnect()
          Terminates the communication with the remote managed object server.
 java.lang.String getAdaptorVersion()
          The method returns a string that represents the version of this JDMK adaptor.
 java.lang.ClassLoader getClassLoader()
          Gets the class loader used locally to retreive all MO and MOStub classes.
 java.lang.String getDomain()
          Allows the domain name of a server to be accessed.
 java.lang.Object getIndexedValue(ObjectName name, java.lang.String property, int pos)
          Allows the value of a specific indexed property within a managed object to be obtained.
 MapperSrvIf getMapperSrv()
          Gets the mapper used to derive the implementation name from an object name.
 java.util.Vector getObject(ObjectName name, QueryExp query)
          Gets handles on managed objects controlled by the remote managed object server.
 java.util.Vector getOnlyNames(ObjectName name, QueryExp query)
          Gets the names of managed objects controlled by the remote managed object server.
 java.lang.Object getValue(ObjectName name, java.lang.String property)
          Allows the value of a specific property within a managed object to be obtained.
 PropertyList getValues(ObjectName name, java.util.Vector propertyIdList)
          Allows the values of several properties within a managed object to be obtained.
 java.lang.Object invokePerform(ObjectName objName, java.lang.String pfname, java.lang.Object[] params, java.lang.String[] signature)
          Allows any method to be applied to a remote object.
 java.lang.Boolean isConnected()
          Checks whether the adaptor is connected.
 void newDBMO(java.lang.String impl, ObjectName name, ModificationList list)
          Creates a persistent instance of a managed object in the remote object server.
 void newDBMO(java.lang.String impl, ObjectName name, ModificationList list, ObjectName aLoader)
          Creates a persistent instance of a managed object in the remote object server.
 void newMO(java.lang.String impl, ObjectName name, ModificationList list)
          Creates an instance of a managed object in the remote object server.
 void newMO(java.lang.String impl, ObjectName name, ModificationList list, ObjectName aLoader)
          Creates an instance of a managed object in the remote object server.
 void newObj(java.lang.String className)
          Allows a Java object of a particular class to be instantiated in a remote managed object server.
 void newObj(java.lang.String className, ObjectName aLoader)
          Allows a Java object of a particular class to be instantiated in a remote managed object server.
 void removeListener(ManagedObject mo, ObjectName listenerName)
          Allows a listener for a managed object to be removed.
 void setClassLoader(java.lang.ClassLoader loader)
          Allows you to specify a class loader to retrieve MO and MOStub classes.
 java.lang.Object setIndexedValue(ObjectName name, java.lang.String prop, java.lang.Object value, java.lang.String op, int position)
          Allows the value of a specific indexed property within an object to be set.
 void setMapperSrv(MapperSrvIf mapper)
          Allows you to specify a mapper.
 int setup(java.lang.Object param)
          Configures the adaptor.
 java.lang.Object setValue(ObjectName name, java.lang.String prop, java.lang.Object value, java.lang.String op)
          Allows the value of a specific property within an object to be set.
 PropertyList setValues(ObjectName name, ModificationList modif)
          Allows the values of several properties within an object to be set.
 void transferObject(java.lang.Object object, ObjectName logicalName)
          Adds a named object under the control of the remote CMF.
 

Method Detail

setup

public int setup(java.lang.Object param)
Configures the adaptor.
Parameters:
param - Parameters to be set.

connect

public void connect(java.lang.Object context,
                    java.lang.String host,
                    int port,
                    java.lang.String logicalName)
Initializes the communication with the remote managed object server.
Parameters:
context - A context for the adaptor.
host - The host name of the server.
port - The port number of the server.
logicalName - The logical name of the server.

See Also:
disconnect()

disconnect

public void disconnect()
Terminates the communication with the remote managed object server.

See Also:
connect(java.lang.Object, java.lang.String, int, java.lang.String)

isConnected

public java.lang.Boolean isConnected()
Checks whether the adaptor is connected.
Returns:
True if the adaptor is connected, false otherwise.

getAdaptorVersion

public java.lang.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 java.lang.String getDomain()
Allows the domain name of a server to be accessed.
Returns:
The domain name of the server.

getClassLoader

public java.lang.ClassLoader getClassLoader()
Gets the class loader used locally to retreive all MO and MOStub classes.
Returns:
The ClassLoader used or null if it is the default loader.

setClassLoader

public void setClassLoader(java.lang.ClassLoader loader)
Allows you to specify a class loader to retrieve 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.

getOnlyNames

public java.util.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 be to obtained:

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 specified object does not exist in the repository.

newMO

public void newMO(java.lang.String impl,
                  ObjectName name,
                  ModificationList list)
           throws java.lang.IllegalAccessException,
                  java.lang.ClassNotFoundException,
                  InstanceAlreadyExistException,
                  java.lang.InstantiationException,
                  java.lang.reflect.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:
java.lang.ClassNotFoundException - The class to be instantiated could not be found by the class loader.
java.lang.InstantiationException - A new instance of the specified class could not be created.
java.lang.IllegalAccessException - Access denied.
InstanceAlreadyExistException - The managed object is already registered in the repository.
java.lang.reflect.InvocationTargetException - The exception contains the real exception emitted by the method of the remote m-bean.

newDBMO

public void newDBMO(java.lang.String impl,
                    ObjectName name,
                    ModificationList list)
             throws java.lang.IllegalAccessException,
                    java.lang.ClassNotFoundException,
                    InstanceAlreadyExistException,
                    java.lang.InstantiationException,
                    java.lang.reflect.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:
java.lang.ClassNotFoundException - The class to be instantiated could not be found by the class loader.
java.lang.InstantiationException - A new instance of the specified class could not be created.
java.lang.IllegalAccessException - Access denied.
InstanceAlreadyExistException - The managed object is already registered in the repository.
java.lang.reflect.InvocationTargetException - The exception contains the real exception emitted by the method of the remote m-bean.

newMO

public void newMO(java.lang.String impl,
                  ObjectName name,
                  ModificationList list,
                  ObjectName aLoader)
           throws java.lang.IllegalAccessException,
                  java.lang.ClassNotFoundException,
                  InstanceAlreadyExistException,
                  java.lang.InstantiationException,
                  java.lang.reflect.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.
aLoader - The name of a class loader to be used.
Throws:
java.lang.ClassNotFoundException - The class to be instantiated could not be found by the class loader.
java.lang.InstantiationException - A new instance of the specified class could not be created.
java.lang.IllegalAccessException - Access denied.
InstanceAlreadyExistException - object The managed object is already registered in the repository.
java.lang.reflect.InvocationTargetException - The exception contains the real exception emitted by the method of the remote m-bean.

newDBMO

public void newDBMO(java.lang.String impl,
                    ObjectName name,
                    ModificationList list,
                    ObjectName aLoader)
             throws java.lang.IllegalAccessException,
                    java.lang.ClassNotFoundException,
                    InstanceAlreadyExistException,
                    java.lang.InstantiationException,
                    java.lang.reflect.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 on the server to be used.
name - The name of the managed object to be created.
listThe - list of initial values of the properties of the new managed object.
aLoader - The name of the class loader to be used.
Throws:
java.lang.ClassNotFoundException - The class to be instantiated could not be found by the class loader.
java.lang.InstantiationException - A new instance of the specified class could not be created.
java.lang.IllegalAccessException - Access denied.
InstanceAlreadyExistException - The managed object is already registered in the repository.
java.lang.reflect.InvocationTargetException - The exception contains the real exception emitted by the method of the remote m-bean.

newObj

public void newObj(java.lang.String className)
            throws java.lang.IllegalAccessException,
                   java.lang.InstantiationException,
                   java.lang.ClassNotFoundException,
                   java.lang.reflect.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:
java.lang.ClassNotFoundException - The class to be instantiated could not be found by the class loader.
java.lang.IllegalAccessException - Access denied.
java.lang.InstantiationException - A new instance of the specified class could not be created.
java.lang.reflect.InvocationTargetException - The exception contains the real exception emitted by the method of the remote m-bean.

newObj

public void newObj(java.lang.String className,
                   ObjectName aLoader)
            throws java.lang.IllegalAccessException,
                   java.lang.InstantiationException,
                   java.lang.ClassNotFoundException,
                   java.lang.reflect.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 the class loader to be used.
Throws:
java.lang.IllegalAccessException - Access denied.
java.lang.InstantiationException - A new instance of the specified class could not be created.
java.lang.ClassNotFoundException - The class to be instantiated could not be found by the class loader.
java.lang.reflect.InvocationTargetException - The exception contains the real exception emitted by the method of the remote m-bean.

deleteMO

public void deleteMO(ObjectName name)
              throws InstanceNotFoundException,
                     java.lang.reflect.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 object does not exist in the repository.
java.lang.reflect.InvocationTargetException - The exception contains the real exception emitted by the method of the remote m-bean.

getValue

public java.lang.Object getValue(ObjectName name,
                                 java.lang.String property)
                          throws InstanceNotFoundException,
                                 PropertyNotFoundException,
                                 java.lang.reflect.InvocationTargetException
Allows the value of a specific property within a managed object to be obtained.
Parameters:
name - The name of the managed object from 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 object does not exist in the repository.
PropertyNotFoundException - The requested property is not supported by the managed object.
java.lang.reflect.InvocationTargetException - The exception contains the real exception emitted by the method of the remote m-bean.

getIndexedValue

public java.lang.Object getIndexedValue(ObjectName name,
                                        java.lang.String property,
                                        int pos)
                                 throws InstanceNotFoundException,
                                        PropertyNotFoundException,
                                        java.lang.reflect.InvocationTargetException
Allows the value of a specific indexed property within a managed object to be obtained.
Parameters:
name - The name of the object from which the property is to be retrieved.
property - The name of the property to be retrieved.
position - The position in the index of the value to be retrieved.
Returns:
The value of the retrieved property.
Throws:
InstanceNotFoundException - The object does not exist in the repository.
PropertyNotFoundException - The requested property is not supported by the managed object.
java.lang.reflect.InvocationTargetException - The exception contains the real exception emitted by the method of the remote m-bean..

getValues

public PropertyList getValues(ObjectName name,
                              java.util.Vector propertyIdList)
                       throws InstanceNotFoundException
Allows the values of several properties within a managed object to be obtained.
Parameters:
name - The name of the object from 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 object does not exist in the repository.

setValue

public java.lang.Object setValue(ObjectName name,
                                 java.lang.String prop,
                                 java.lang.Object value,
                                 java.lang.String op)
                          throws InstanceNotFoundException,
                                 java.lang.IllegalAccessException,
                                 PropertyNotFoundException,
                                 InvalidPropertyValueException,
                                 java.lang.ClassNotFoundException,
                                 java.lang.InstantiationException,
                                 java.lang.reflect.InvocationTargetException
Allows the value of a specific property within an object to be set. The value must support the Serializable interface.
Parameters:
name - The name of the object within which the property is to be set.
prop - 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.
Returns:
The value of the retrieved property.
Throws:
InstanceNotFoundException - The object does not exist in the repository.
PropertyNotFoundException - The requested property is not supported by the managed object.
InvalidPropertyValueException - The specified value is not a valid value for the property.
java.lang.ClassNotFoundException - The class to be instantiated could not be found by the class loader.
java.lang.InstantiationException - A new instance of the specified operator class could not be created.
java.lang.reflect.InvocationTargetException - The exception contains the real exception emitted by the method of the remote m-bean.

setIndexedValue

public java.lang.Object setIndexedValue(ObjectName name,
                                        java.lang.String prop,
                                        java.lang.Object value,
                                        java.lang.String op,
                                        int position)
                                 throws InstanceNotFoundException,
                                        java.lang.IllegalAccessException,
                                        PropertyNotFoundException,
                                        InvalidPropertyValueException,
                                        java.lang.ClassNotFoundException,
                                        java.lang.InstantiationException,
                                        java.lang.reflect.InvocationTargetException
Allows the value of a specific indexed property within an object to be set. The value must support the Serializable interface.
Parameters:
name - The name of the object within which the property is to be set.
prop - 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.
position - The position in the index of the value to be set.
Returns:
The value of the retrieved property.
Throws:
InstanceNotFoundException - The object does not exist in the repository.
java.lang.IllegalAccessException - Access denied.
PropertyNotFoundException - The requested property is not supported by the managed object.
InvalidPropertyValueException - The specified value is not a valid value for the property.
java.lang.ClassNotFoundException - The class to be instantiated could not be found by the class loader.
java.lang.InstantiationException - A new instance of the specified operator class could not be created.
java.lang.reflect.InvocationTargetException - The exception contains the real exception emitted by the method of the remote m-bean.

setValues

public PropertyList setValues(ObjectName name,
                              ModificationList modif)
                       throws InstanceNotFoundException,
                              java.lang.IllegalAccessException,
                              java.lang.reflect.InvocationTargetException
Allows the values of several properties within an object to be set. 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 object does not exist in the repository.
java.lang.IllegalAccessException - Access denied.
java.lang.reflect.InvocationTargetException - The exception contains the real exception emitted by the method of the remote m-bean.

transferObject

public void transferObject(java.lang.Object object,
                           ObjectName logicalName)
                    throws InstanceAlreadyExistException,
                           java.lang.reflect.InvocationTargetException
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 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.
java.lang.reflect.InvocationTargetException - The exception contains the real exception emitted by the method of the remote m-bean.

invokePerform

public java.lang.Object invokePerform(ObjectName objName,
                                      java.lang.String pfname,
                                      java.lang.Object[] params,
                                      java.lang.String[] signature)
                               throws InstanceNotFoundException,
                                      java.lang.NoSuchMethodException,
                                      java.lang.reflect.InvocationTargetException,
                                      java.lang.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 called method.
Throws:
InstanceNotFoundException - The object does not exist in the repository.
java.lang.NoSuchMethodException - The method specified is not defined.
java.lang.reflect.InvocationTargetException - The exception contains the real exception emitted by the method of the remote m-bean.
java.lang.IllegalAccessException - Access denied.

getObject

public java.util.Vector getObject(ObjectName name,
                                  QueryExp query)
                           throws InstanceNotFoundException,
                                  LocalException,
                                  java.lang.reflect.InvocationTargetException
Gets handles on managed objects controlled by the remote managed object server. The method enables any of the following be to obtained:

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).

The method attemps to instantiate the c-bean associated to each managed object: if one of the instantiation fails (because the c-bean class is not accessible), the method returns a ClassNotFoundException wrapped in a LocalException.

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 selected managed objects.
Throws:
InstanceNotFoundException - The specified object does not exist in the repository.
LocalException - A local problem occurred and is described by embedded exception.
java.lang.reflect.InvocationTargetException - The exception contains the real exception emitted by the method of the remote m-bean.

cb_newMO

public java.lang.Object cb_newMO(java.lang.String impl,
                                 ObjectName name,
                                 ModificationList list)
                          throws java.lang.IllegalAccessException,
                                 java.lang.ClassNotFoundException,
                                 InstanceAlreadyExistException,
                                 java.lang.InstantiationException,
                                 LocalException,
                                 java.lang.reflect.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.
Returns:
The newly created managed object.
Throws:
java.lang.ClassNotFoundException - The class to be instantiated could not be found by the class loader.
java.lang.InstantiationException - A new instance of the specified class could not be created.
java.lang.IllegalAccessException - Access denied.
InstanceAlreadyExistException - The managed object is already registered in the repository.
LocalException - A local problem occurred and is described by the embedded exception.
java.lang.reflect.InvocationTargetException - The exception contains the real exception emitted by the method of the remote m-bean.

cb_newDBMO

public java.lang.Object cb_newDBMO(java.lang.String impl,
                                   ObjectName name,
                                   ModificationList list)
                            throws java.lang.IllegalAccessException,
                                   java.lang.ClassNotFoundException,
                                   InstanceAlreadyExistException,
                                   java.lang.InstantiationException,
                                   LocalException,
                                   java.lang.reflect.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.
Returns:
The newly created managed object.
Throws:
java.lang.ClassNotFoundException - The class to be instantiated could not be found by the class loader.
java.lang.InstantiationException - A new instance of the specified class could not be created.
java.lang.IllegalAccessException - Access denied.
InstanceAlreadyExistException - The managed object is already registered in the repository.
LocalException - A local problem occurred and is described by the embedded exception.
java.lang.reflect.InvocationTargetException - The exception contains the real exception emitted by the method of the remote m-bean.

cb_newMO

public java.lang.Object cb_newMO(java.lang.String impl,
                                 ObjectName name,
                                 ModificationList list,
                                 ObjectName aLoader)
                          throws java.lang.IllegalAccessException,
                                 java.lang.ClassNotFoundException,
                                 InstanceAlreadyExistException,
                                 java.lang.InstantiationException,
                                 LocalException,
                                 java.lang.reflect.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.
aLoader - The name of the class loader to be used.
Returns:
The newly created managed object.
Throws:
java.lang.ClassNotFoundException - The class to be instantiated could not be found by the class loader.
java.lang.InstantiationException - A new instance of the specified class could not be created.
java.lang.IllegalAccessException - Access denied.
InstanceAlreadyExistException - object The managed object is already registered in the repository.
LocalException - A local problem occurred and is described by the embedded exception.
java.lang.reflect.InvocationTargetException - The exception contains the real exception emitted by the method of the remote m-bean.

cb_newDBMO

public java.lang.Object cb_newDBMO(java.lang.String impl,
                                   ObjectName name,
                                   ModificationList list,
                                   ObjectName aLoader)
                            throws java.lang.IllegalAccessException,
                                   java.lang.ClassNotFoundException,
                                   InstanceAlreadyExistException,
                                   java.lang.InstantiationException,
                                   LocalException,
                                   java.lang.reflect.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 on the server to be used.
name - The name of the managed object to be created.
listThe - list of initial values of the properties of the new managed object.
aLoader - The name of the class loader to be used.
Returns:
The newly created managed object.
Throws:
java.lang.ClassNotFoundException - The class to be instantiated could not be found by the class loader.
java.lang.InstantiationException - A new instance of the specified class could not be created.
java.lang.IllegalAccessException - Access denied.
InstanceAlreadyExistException - The managed object is already registered in the repository.
LocalException - A local problem occurred and is described by the embedded exception.
java.lang.reflect.InvocationTargetException - The exception contains the real exception emitted by the method of the remote m-bean.

addListener

public ObjectName addListener(ManagedObject mo,
                              java.util.EventListener listen,
                              java.lang.String name)
                       throws InstanceNotFoundException,
                              java.lang.IllegalAccessException,
                              java.lang.InstantiationException,
                              java.lang.ClassNotFoundException,
                              java.util.TooManyListenersException
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.
name - Class name of the remote listener to be created.
Returns:
The object name of the remote listener associated to the local listener.
Throws:
InstanceNotFoundException - The object does not exist in the repository.
java.lang.IllegalAccessException - Access denied.
java.lang.ClassNotFoundException - The class to be instantiated could not be found by the class loader.
java.lang.InstantiationException - A new instance of the specified operator class could not be created.
java.util.TooManyListenersException - Too many listeners have been added.

See Also:
removeListener(com.sun.jaw.reference.client.mo.ManagedObject, com.sun.jaw.reference.common.ObjectName)

removeListener

public void removeListener(ManagedObject mo,
                           ObjectName listenerName)
Allows a listener for a managed object to be removed.
Parameters:
mo - The name of the managed object for which the listener was operating.
listenerName - The name of the remote listener to be removed.

See Also:
addListener(com.sun.jaw.reference.client.mo.ManagedObject, java.util.EventListener, java.lang.String)

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.