javax.management.remote.rmi
Interface RMIConnection

All Superinterfaces:

Remote

All Known Implementing Classes:

RMIConnectionImpl , RMIConnectionImpl_Stub

public interface RMIConnection
extends Remote   

RMI object used to forward an MBeanServer request from a client to its MBeanServer implementation on the server side. There is one Remote object implementing this interface for each remote client connected to an RMI connector.

User code does not usually refer to this interface. It is specified as part of the public API so that different implementations of that API will interoperate.

To ensure that client parameters will be deserialized at the server side with the correct classloader, client parameters such as parameters used to invoke a method are wrapped in a MarshalledObject . An implementation of this interface must first get the appropriate class loader for the operation and its target, then deserialize the marshalled parameters with this classloader. Except as noted, a parameter that is a MarshalledObject or MarshalledObject[] must not be null; the behavior is unspecified if it is.

Class loading aspects are detailed in the companion document JMX Remote API, which completes this documentation. It should be available as a PDF document in the same place as this Javadoc specification.

Since:

1.5

Method Summary

void	addNotificationListener (ObjectName name, ObjectName listener, MarshalledObject filter, MarshalledObject handback, Subject delegationSubject) Handles the method MBeanServerConnection.addNotificationListener(ObjectName, ObjectName, NotificationFilter, Object) .
Integer []	addNotificationListeners (ObjectName [] names, MarshalledObject [] filters, Subject [] delegationSubjects) Handles the method MBeanServerConnection.addNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object) .
void	close () Closes this connection.
ObjectInstance	createMBean (String className, ObjectName name, MarshalledObject params, String [] signature, Subject delegationSubject) Handles the method MBeanServerConnection.createMBean(String, ObjectName, Object[], String[]) .
ObjectInstance	createMBean (String className, ObjectName name, ObjectName loaderName, MarshalledObject params, String [] signature, Subject delegationSubject) Handles the method MBeanServerConnection.createMBean(String, ObjectName, ObjectName, Object[], String[]) .
ObjectInstance	createMBean (String className, ObjectName name, ObjectName loaderName, Subject delegationSubject) Handles the method MBeanServerConnection.createMBean(String, ObjectName, ObjectName) .
ObjectInstance	createMBean (String className, ObjectName name, Subject delegationSubject) Handles the method MBeanServerConnection.createMBean(String, ObjectName) .
NotificationResult	fetchNotifications (long clientSequenceNumber, int maxNotifications, long timeout) Retrieves notifications from the connector server.
Object	getAttribute (ObjectName name, String attribute, Subject delegationSubject) Handles the method MBeanServerConnection.getAttribute(ObjectName, String) .
AttributeList	getAttributes (ObjectName name, String [] attributes, Subject delegationSubject) Handles the method MBeanServerConnection.getAttributes(ObjectName, String[]) .
String	getConnectionId () Returns the connection ID.
String	getDefaultDomain (Subject delegationSubject) Handles the method MBeanServerConnection.getDefaultDomain() .
String []	getDomains (Subject delegationSubject) Handles the method MBeanServerConnection.getDomains() .
Integer	getMBeanCount (Subject delegationSubject) Handles the method MBeanServerConnection.getMBeanCount() .
MBeanInfo	getMBeanInfo (ObjectName name, Subject delegationSubject) Handles the method MBeanServerConnection.getMBeanInfo(ObjectName) .
ObjectInstance	getObjectInstance (ObjectName name, Subject delegationSubject) Handles the method MBeanServerConnection.getObjectInstance(ObjectName) .
Object	invoke (ObjectName name, String operationName, MarshalledObject params, String [] signature, Subject delegationSubject) Handles the method MBeanServerConnection.invoke(ObjectName, String, Object[], String[]) .
boolean	isInstanceOf (ObjectName name, String className, Subject delegationSubject) Handles the method MBeanServerConnection.isInstanceOf(ObjectName, String) .
boolean	isRegistered (ObjectName name, Subject delegationSubject) Handles the method MBeanServerConnection.isRegistered(ObjectName) .
Set <ObjectInstance >	queryMBeans (ObjectName name, MarshalledObject query, Subject delegationSubject) Handles the method MBeanServerConnection.queryMBeans(ObjectName, QueryExp) .
Set <ObjectName >	queryNames (ObjectName name, MarshalledObject query, Subject delegationSubject) Handles the method MBeanServerConnection.queryNames(ObjectName, QueryExp) .
void	removeNotificationListener (ObjectName name, ObjectName listener, MarshalledObject filter, MarshalledObject handback, Subject delegationSubject) Handles the method MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName, NotificationFilter, Object) .
void	removeNotificationListener (ObjectName name, ObjectName listener, Subject delegationSubject) Handles the method MBeanServerConnection.removeNotificationListener(ObjectName, ObjectName) .
void	removeNotificationListeners (ObjectName name, Integer [] listenerIDs, Subject delegationSubject) Handles the removeNotificationListener(ObjectName, NotificationListener) and removeNotificationListener(ObjectName, NotificationListener, NotificationFilter, Object) methods.