|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
This interface provides a means for accessing remote objects in a manner that is independent of the communication protocol.
The interface defines methods for:
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 |
public int setup(java.lang.Object param)
param
- Parameters to be set.public void connect(java.lang.Object context, java.lang.String host, int port, java.lang.String logicalName)
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.
disconnect()
public void disconnect()
connect(java.lang.Object, java.lang.String, int, java.lang.String)
public java.lang.Boolean isConnected()
public java.lang.String getAdaptorVersion()
public java.lang.String getDomain()
public java.lang.ClassLoader getClassLoader()
public void setClassLoader(java.lang.ClassLoader loader)
loader
- the instance of ClassLoader.public MapperSrvIf getMapperSrv()
public void setMapperSrv(MapperSrvIf mapper)
mapper
- The instance of mapping service to be used.public java.util.Vector getOnlyNames(ObjectName name, QueryExp query) throws InstanceNotFoundException
name
- The names of the managed objects to be retrieved.query
- The query to be applied for selecting managed
objects.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
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.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
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.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
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.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
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.public void newObj(java.lang.String className) throws java.lang.IllegalAccessException, java.lang.InstantiationException, java.lang.ClassNotFoundException, java.lang.reflect.InvocationTargetException
className
- The Java class name of the object to be
created.public void newObj(java.lang.String className, ObjectName aLoader) throws java.lang.IllegalAccessException, java.lang.InstantiationException, java.lang.ClassNotFoundException, java.lang.reflect.InvocationTargetException
className
- The Java class name of the object to be created.aLoader
- The name of the class loader to be used.public void deleteMO(ObjectName name) throws InstanceNotFoundException, java.lang.reflect.InvocationTargetException
name
- The name of the managed object to be deleted.public java.lang.Object getValue(ObjectName name, java.lang.String property) throws InstanceNotFoundException, PropertyNotFoundException, java.lang.reflect.InvocationTargetException
name
- The name of the managed object from which
the property is to be retrieved.property
- The name of the property to be retrieved.public java.lang.Object getIndexedValue(ObjectName name, java.lang.String property, int pos) throws InstanceNotFoundException, PropertyNotFoundException, java.lang.reflect.InvocationTargetException
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.public PropertyList getValues(ObjectName name, java.util.Vector propertyIdList) throws InstanceNotFoundException
name
- The name of the object from which
the properties are to be retrieved.propertyIdList
- A list of the properties to be retrieved.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
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.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
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.public PropertyList setValues(ObjectName name, ModificationList modif) throws InstanceNotFoundException, java.lang.IllegalAccessException, java.lang.reflect.InvocationTargetException
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.public void transferObject(java.lang.Object object, ObjectName logicalName) throws InstanceAlreadyExistException, java.lang.reflect.InvocationTargetException
Use this method with care because it moves an instance remotely. All methods of this instance are executed on the remote agent.
object
- The object to be added to the remote repository.logicalName
- The logical name of the object.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
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.public java.util.Vector getObject(ObjectName name, QueryExp query) throws InstanceNotFoundException, LocalException, java.lang.reflect.InvocationTargetException
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
.
name
- The names of the managed objects to be retrieved.query
- The query to be applied for selecting managed
objects.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
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.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
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.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
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.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
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.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
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.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.removeListener(com.sun.jaw.reference.client.mo.ManagedObject, com.sun.jaw.reference.common.ObjectName)
public void removeListener(ManagedObject mo, ObjectName listenerName)
mo
- The name of the managed object for which the
listener was operating.listenerName
- The name of the remote listener
to be removed.
addListener(com.sun.jaw.reference.client.mo.ManagedObject, java.util.EventListener, java.lang.String)
public void cb_connect(ManagedObject cbean)
cbean
- The C-bean to be connected.public void cb_disconnect(ManagedObject cbean)
cbean
- The C-bean to be disconnected.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |