All Packages  Class Hierarchy  This Package  Previous  Next  Index

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

java.lang.Object
   |
   +----com.sun.jaw.impl.adaptor.iiop.AdaptorClient
public class AdaptorClient
extends Object
implements AdaptorMO
The AdaptorClient class provides an implementation of the AdaptorMO interface based on the Internet Inter ORB Protocol (IIOP) system.

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

See Also:
AdaptorMO

Constructor Index

o AdaptorClient()

Method Index

o addListener(ManagedObject, EventListener, String)
Adds a managed object listener.
o cb_connect(ManagedObject)
Connects a C-bean to the adaptor.
o cb_disconnect(ManagedObject)
Disconnects a C-bean from the adaptor.
o cb_newDBMO(String, ObjectName, ModificationList)
Creates a persistent instance of a managed object on the remote object server.
o cb_newDBMO(String, ObjectName, ModificationList, ObjectName)
Creates a persistent instance of a managed object on the remote object server.
o cb_newMO(String, ObjectName, ModificationList)
Creates an instance of a managed object on the remote object server.
o cb_newMO(String, ObjectName, ModificationList, ObjectName)
Creates an instance of a managed object on the remote object server.
o connect(Object, String, int, String)
Initializes the communications with a remote managed object server.
o deleteMO(ObjectName)
Deletes an instance of a managed object in the remote object server.
o disconnect()
Terminates the communications with the remote managed object server.
o getAdaptorVersion()
The method returns a string that represents the version of this JDMK adaptor.
o getClassLoader()
Gets the class loader used to retrieve all MO and MOStub classes.
o getClassVersion()
Returns the version of this class.
o getDomain()
Returns the name of the domain controlled by the managed object server.
o getIndexedValue(ObjectName, String, int)
Gets the value of a specific indexed property in a managed object.
o getMapperSrv()
Gets the class loader used to retrieve all MO and MOStub classes.
o getObject(ObjectName, QueryExp)
Gets handles on managed objects controlled by the remote managed object server.
o getObjectFromCache(ObjectName)
Returns the local managed object associated with name.
o getOnlyNames(ObjectName, QueryExp)
Gets the names of managed objects controlled by the remote managed object server.
o getValue(ObjectName, String)
Gets the value of a specific property in a managed object.
o getValues(ObjectName, Vector)
Gets the values of several properties in a managed object.
o giveListener(ObjectName, ObjectName)
o invokePerform(ObjectName, String, Object[], String[])
Invokes a specific method on a remote object.
o isConnected()
Checks whether the managed object adaptor is connected to the remote managed object server.
o newDBMO(String, ObjectName, ModificationList)
Creates a persistent instance of a managed object on the remote object server.
o newDBMO(String, ObjectName, ModificationList, ObjectName)
Creates a persistent instance of a managed object on the remote object server.
o newMO(String, ObjectName, ModificationList)
Creates an instance of a managed object on the remote object server.
o newMO(String, ObjectName, ModificationList, ObjectName)
Creates an instance of a managed object on the remote object server.
o newObj(String)
Instantiates a Java object of a specific class on a remote managed object server.
o newObj(String, ObjectName)
Instantiates a Java object of a specific class on a remote managed object server.
o removeListener(ManagedObject, ObjectName)
Removes a managed object listener.
o setClassLoader(ClassLoader)
Specifies a class loader to retrieve MO and MOStub classes.
o setIndexedValue(ObjectName, String, Object, String, int)
Sets the value of a specific indexed property of a named managed object.
o setMapperSrv(MapperSrvIf)
Specifies a class loader to retrieve MO and MOStub classes.
o setup(Object)
Specifies the location of the CORBA naming service.
o setValue(ObjectName, String, Object, String)
Sets a property of a named managed object to a specific value.
o setValues(ObjectName, ModificationList)
Sets the value of several properties within a managed object.
o transferObject(Object, ObjectName)
Creates a copy of a named object and adds it to the remote repository.

Constructors

o AdaptorClient 
 public AdaptorClient()

Methods

o setup 
 public int setup(Object param)
Specifies the location of the CORBA naming service.

Parameters:
param - A String object containing the hostname on which the Corba naming service is running and port number on which the Corba naming service listens (for instance sky:9500).
Returns:
Negative if the setup fails.
o 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 IIOP adaptor.
host - The host name of the server.
port - Not used.
logicalName - The logical name of the adaptor.
Throws: CommunicationException
Communications problem.
Throws: SecurityException
A security violation has occurred.
o disconnect 
 public void disconnect()
Terminates the communications with the remote managed object server.

o 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.
o 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 obtains the following:

When the class name and instance name are null, all objects are 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 object does not exist in the repository.
o 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 be to obtained:

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 exception has been thrown by the client. The exception is wrapped by the LocalException.
Throws: InstanceNotFoundException
The object 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.
o getValue 
 public Object getValue(ObjectName name,
                        String property) throws InstanceNotFoundException, PropertyNotFoundException, InvocationTargetException
Gets the value of a specific property in a managed object.

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.
Throws: PropertyNotFoundException
The specified property does not exist or cannot be retrieved.
Throws: InvocationTargetException
An exception has been thrown by the user code on the remote agent. The exception is wrapped by the InvocationTargetException.
o getIndexedValue 
 public Object getIndexedValue(ObjectName name,
                               String property,
                               int pos) throws InstanceNotFoundException, PropertyNotFoundException, InvocationTargetException
Gets the value of a specific indexed property in a managed object.

Parameters:
name - The names of the object from 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 object does not exist in the repository.
Throws: PropertyNotFoundException
The specified property does not exist or cannot be retrieved.
Throws: InvocationTargetException
An exception has been thrown by the user code on the remote agent. The exception is wrapped by the InvocationTargetException.
o getValues 
 public PropertyList getValues(ObjectName name,
                               Vector propertyIdList) throws InstanceNotFoundException
Gets the values of several properties in a managed object.

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 retrieved properties.
Throws: InstanceNotFoundException
The object does not exist in the repository.
o setValue 
 public Object setValue(ObjectName name,
                        String property,
                        Object value,
                        String op) throws InstanceNotFoundException, IllegalAccessException, PropertyNotFoundException, InvalidPropertyValueException, ClassNotFoundException, InstantiationException, InvocationTargetException
Sets a property of a named managed object to a specific value. The managed object is identified by its object name.

Parameters:
name - The name of the object in which the property is to be set.
property - 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.
Throws: InstanceNotFoundException
The object does not exist in the repository.
Throws: IllegalAccessException
Access denied.
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: 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.
Throws: InvocationTargetException
An exception has been thrown by the user code on the remote agent. The exception is wrapped by the InvocationTargetException.
o setIndexedValue 
 public Object setIndexedValue(ObjectName name,
                               String property,
                               Object value,
                               String op,
                               int pos) throws InstanceNotFoundException, InvocationTargetException, IllegalAccessException, ServiceNotFoundException, PropertyNotFoundException, InvalidPropertyValueException, InstantiationException, ClassNotFoundException
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 in which the property is to be set.
property - 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 property to be set.
Throws: InstanceNotFoundException
The object does not exist in the repository.
Throws: IllegalAccessException
Access denied.
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: 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.
Throws: InvocationTargetException
An exception has been thrown by the user code on the remote agent. The exception is wrapped by the InvocationTargetException.
Throws: ServiceNotFoundException
The requested service is not supported.
o 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 in which the properties are to be set.
ModificationList - 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.
Throws: IllegalAccessException
Access denied.
Throws: InvocationTargetException
An exception has been thrown by the user code on the remote agent. The exception is wrapped by the InvocationTargetException.
o 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.
o addListener 
 public ObjectName addListener(ManagedObject mo,
                               EventListener listen,
                               String listenerType) throws InstanceNotFoundException, IllegalAccessException, ClassNotFoundException, InstantiationException
Adds a managed object listener. The function is not supported and always throws an 'ServiceNotFoundException' exception.

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:
always throws an 'ServiceNotFoundException' exception.
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
o removeListener 
 public void removeListener(ManagedObject mo,
                            ObjectName name)
Removes a managed object listener.

Parameters:
name - The name of the remote listener to be removed.
o giveListener 
 public EventListener giveListener(ObjectName mo,
                                   ObjectName listener)
o newObj 
 public void newObj(String className) throws IllegalAccessException, InstantiationException, ClassNotFoundException, InvocationTargetException
Instantiates a Java object of a specific class on a remote managed object server.

Parameters:
className - The Java class name of the object to be created.
Throws: IllegalAccessException
Access denied.
Throws: InstantiationException
A new instance of the specified operator class could not be created.
Throws: ClassNotFoundException
The class to be instantiated could not be found by the class loader.
Throws: InvocationTargetException
An exception has been thrown by the user code on the remote agent. The exception is wrapped by the InvocationTargetException.
o newMO 
 public void newMO(String impl,
                   ObjectName name,
                   ModificationList list) throws IllegalAccessException, ClassNotFoundException, InstanceAlreadyExistException, InstantiationException, InvocationTargetException
Creates an instance of a managed object on 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: IllegalAccessException
Access denied.
Throws: ClassNotFoundException
The class to be instantiated could not be found by the class loader.
Throws: InstanceAlreadyExistException
The managed object is already registered in the repository.
Throws: InstantiationException
A new instance of the specified class could not be created.
Throws: InvocationTargetException
An exception has been thrown by the user code on the remote agent. The exception is wrapped by the InvocationTargetException.
o newDBMO 
 public void newDBMO(String impl,
                     ObjectName name,
                     ModificationList list) throws IllegalAccessException, ClassNotFoundException, InstanceAlreadyExistException, InstantiationException, InvocationTargetException
Creates a persistent instance of a managed object on 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: IllegalAccessException
Access denied.
Throws: ClassNotFoundException
The class to be instantiated could not be found by the class loader.
Throws: InstanceAlreadyExistException
The managed object is already registered in the repository.
Throws: InstantiationException
A new instance of the specified class could not be created.
Throws: InvocationTargetException
An exception has been thrown by the user code on the remote agent. The exception is wrapped by the InvocationTargetException.
o cb_newMO 
 public Object cb_newMO(String impl,
                        ObjectName name,
                        ModificationList list) throws IllegalAccessException, ClassNotFoundException, InstanceAlreadyExistException, InstantiationException, LocalException, InvocationTargetException
Creates an instance of a managed object on 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: IllegalAccessException
Access denied.
Throws: ClassNotFoundException
The class to be instantiated could not be found by the class loader.
Throws: InstanceAlreadyExistException
The managed object is already registered in the repository.
Throws: InstantiationException
A new instance of the specified class could not be created.
Throws: LocalException
An exception has been thrown by the client. The exception is wrapped by the LocalException.
Throws: InvocationTargetException
An exception has been thrown by the user code on the remote agent. The exception is wrapped by the InvocationTargetException.
o cb_newDBMO 
 public Object cb_newDBMO(String impl,
                          ObjectName name,
                          ModificationList list) throws IllegalAccessException, ClassNotFoundException, InstanceAlreadyExistException, InstantiationException, LocalException, InvocationTargetException
Creates a persistent instance of a managed object on 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: IllegalAccessException
Access denied.
Throws: ClassNotFoundException
The class to be instantiated could not be found by the class loader.
Throws: InstanceAlreadyExistException
The managed object is already registered in the repository.
Throws: InstantiationException
A new instance of the specified class could not be created.
Throws: LocalException
An exception has been thrown by the client. The exception is wrapped by the LocalException.
Throws: InvocationTargetException
An exception has been thrown by the user code on the remote agent. The exception is wrapped by the InvocationTargetException.
o newObj 
 public void newObj(String className,
                    ObjectName aLoader) throws IllegalAccessException, InstantiationException, ClassNotFoundException, InvocationTargetException
Instantiates a Java object of a specific class on 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
Access denied.
Throws: InstantiationException
A new instance of the specified class could not be created.
Throws: ClassNotFoundException
The class to be instantiated could not be found by the class loader.
Throws: InvocationTargetException
An exception has been thrown by the user code on the remote agent. The exception is wrapped by the InvocationTargetException.
o newMO 
 public void newMO(String impl,
                   ObjectName name,
                   ModificationList list,
                   ObjectName aLoader) throws IllegalAccessException, ClassNotFoundException, InstanceAlreadyExistException, InstantiationException, InvocationTargetException
Creates an instance of a managed object on 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.
Throws: IllegalAccessException
Access denied.
Throws: ClassNotFoundException
The class to be instantiated could not be found by the class loader.
Throws: InstanceAlreadyExistException
The managed object is already registered in the repository.
Throws: InstantiationException
A new instance of the specified class could not be created.
Throws: InvocationTargetException
An exception has been thrown by the user code on the remote agent. The exception is wrapped by the InvocationTargetException.
o newDBMO 
 public void newDBMO(String impl,
                     ObjectName name,
                     ModificationList list,
                     ObjectName aLoader) throws IllegalAccessException, ClassNotFoundException, InstanceAlreadyExistException, InstantiationException, InvocationTargetException
Creates a persistent instance of a managed object on 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.
Throws: IllegalAccessException
Access denied.
Throws: ClassNotFoundException
The class to be instantiated could not be found by the class loader.
Throws: InstanceAlreadyExistException
The managed object is already registered in the repository.
Throws: InstantiationException
A new instance of the specified class could not be created.
Throws: InvocationTargetException
An exception has been thrown by the user code on the remote agent. The exception is wrapped by the InvocationTargetException.
o cb_newMO 
 public Object cb_newMO(String impl,
                        ObjectName name,
                        ModificationList list,
                        ObjectName aLoader) throws IllegalAccessException, ClassNotFoundException, InstanceAlreadyExistException, InstantiationException, LocalException, InvocationTargetException
Creates an instance of a managed object on 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.
Returns:
The newly created managed object.
Throws: IllegalAccessException
Access denied.
Throws: ClassNotFoundException
The class to be instantiated could not be found by the class loader.
Throws: InstanceAlreadyExistException
The managed object is already registered in the repository.
Throws: InstantiationException
A new instance of the specified class could not be created.
Throws: LocalException
An exception has been thrown by the client. The exception is wrapped by the LocalException.
Throws: InvocationTargetException
An exception has been thrown by the user code on the remote agent. The exception is wrapped by the InvocationTargetException.
o cb_newDBMO 
 public Object cb_newDBMO(String impl,
                          ObjectName name,
                          ModificationList list,
                          ObjectName aLoader) throws IllegalAccessException, ClassNotFoundException, InstanceAlreadyExistException, InstantiationException, LocalException, InvocationTargetException
Creates a persistent instance of a managed object on 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.
Returns:
The newly created managed object.
Throws: IllegalAccessException
Access denied.
Throws: ClassNotFoundException
The class to be instantiated could not be found by the class loader.
Throws: InstanceAlreadyExistException
The managed object is already registered in the repository.
Throws: InstantiationException
A new instance of the specified class could not be created.
Throws: LocalException
An exception has been thrown by the client. The exception is wrapped by the LocalException.
Throws: InvocationTargetException
An exception has been thrown by the user code on the remote agent. The exception is wrapped by the InvocationTargetException.
o transferObject 
 public void transferObject(Object object,
                            ObjectName logicalName) throws InstanceAlreadyExistException
Creates a copy of a named object and adds it to the remote repository. The new object is then managed by the remote repository.

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 remote repository.
o 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.
o invokePerform 
 public Object invokePerform(ObjectName objName,
                             String pfName,
                             Object params[],
                             String signature[]) throws InstanceNotFoundException, NoSuchMethodException, InvocationTargetException, IllegalAccessException
Invokes a specific method on a remote object.

Parameters:
objName - The name of the remote object.
pfName - The name of the method to be invoked.
params - An array containing the parameters to be passed to the method.
signature - The signature of the method to be invoked.
Returns:
The return value of the method invoked.
Throws: InstanceNotFoundException
The object does not exist in the repository.
Throws: NoSuchMethodException
The method specified is not defined.
Throws: InvocationTargetException
An exception has been thrown by the user code on the remote agent. The exception is wrapped by the InvocationTargetException.
Throws: IllegalAccessException
Access denied.
o cb_connect 
 public void cb_connect(ManagedObject cbean)
Connects a 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
Throws: CommunicationException
Communications problem.
o cb_disconnect 
 public void cb_disconnect(ManagedObject cbean)
Disconnects a C-bean from the adaptor.

Parameters:
cbean - The C-bean to be disconnected.
o getClassVersion 
 public static String getClassVersion()
Returns the version of this class.

o 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.
o getDomain 
 public String getDomain() throws CommunicationException
Returns the name of the domain controlled by the managed object server.

Throws: CommunicationException
Communications problem.
o getClassLoader 
 public ClassLoader getClassLoader()
Gets the class loader used to retrieve all MO and MOStub classes.

Returns:
The ClassLoader used or null if it is the default loader.
o setClassLoader 
 public void setClassLoader(ClassLoader loader)
Specifies a class loader to retrieve MO and MOStub classes.

Parameters:
loader - The instance of ClassLoader.
o getMapperSrv 
 public MapperSrvIf getMapperSrv()
Gets the class loader used to retrieve all MO and MOStub classes.

Returns:
The ClassLoader used or null if it is the default loader.
o setMapperSrv 
 public void setMapperSrv(MapperSrvIf mapper)
Specifies a class loader to retrieve MO and MOStub classes.

Parameters:
loader - The instance of ClassLoader. 
All Packages  Class Hierarchy  This Package  Previous  Next  Index