|
|||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
java.lang.Objectcom.sun.jdmk.cascading.CascadingAgent
com.sun.jdmk.remote.cascading in
preference to classes in this package. This class may be removed
in a future version of Java DMK.
This class implements the cascading agent service.
Cascading agents enable you to implement a hierarchy of master agents and subagents.The MBeans in a subagent are mirrored in the master agent. A master agent can contain more than one cascading agent, but must contain one cascading agent for each subagent it communicates with.
When instantiating the cascading agent, the following parameters should be specified to the CascadingAgent constructor:
RmiConnectorAddress and for an HTTP connection
the HttpConnectorAddress.
| Constructor Summary | |
CascadingAgent()
Deprecated. Constructs a default CascadingAgent. |
|
CascadingAgent(ConnectorAddress remoteAddress)
Deprecated. Constructs a CascadingAgent. |
|
CascadingAgent(ConnectorAddress remoteAddress,
ObjectName pattern,
QueryExp query)
Deprecated. Constructs a CascadingAgent. |
|
CascadingAgent(ConnectorAddress remoteAddress,
RemoteMBeanServer conClient,
ObjectName pattern,
QueryExp query)
Deprecated. Constructs a CascadingAgent. |
|
CascadingAgent(ConnectorAddress addr,
String conClName)
Deprecated. Constructs a CascadingAgent. |
|
CascadingAgent(ConnectorAddress addr,
String conClName,
ObjectName pattern,
QueryExp query)
Deprecated. Constructs a CascadingAgent. |
|
CascadingAgent(ConnectorAddress addr,
String conClName,
ObjectName pattern,
QueryExp query,
int timeout)
Deprecated. Constructs a CascadingAgent. |
|
CascadingAgent(String localHost,
ConnectorAddress remoteAddress)
Deprecated. Constructs a CascadingAgent. |
|
CascadingAgent(String localHost,
ConnectorAddress remoteAddress,
ObjectName pattern,
QueryExp query)
Deprecated. Constructs a CascadingAgent. |
|
CascadingAgent(String localHost,
ConnectorAddress remoteAddress,
String conClName)
Deprecated. Constructs a CascadingAgent. |
|
CascadingAgent(String localHost,
ConnectorAddress remoteAddress,
String conClName,
ObjectName pattern,
QueryExp query)
Deprecated. Constructs a CascadingAgent. |
|
| Method Summary | |
ConnectorAddress |
getAddress()
Deprecated. Getter for the ConnectorAddress to which the CascadingAgent is connected. |
String |
getClientConnectorClassName()
Deprecated. Getter for the class name of the RemoteMBeanServer of the CascadingAgent. |
Integer |
getNbOfRemoteMBeans()
Deprecated. Getter for the number of MBeans "cascaded" by the CascadingAgent. |
ObjectName |
getPattern()
Deprecated. Getter for the ObjectName pattern to apply to the MBeans of the subagent. |
QueryExp |
getQuery()
Deprecated. Getter for the QueryExp query to apply to the MBeans of the subagent. |
Set |
getRemoteMBeans()
Deprecated. Getter for the MBeans "cascaded" by the CascadingAgent. |
RemoteMBeanServer |
getRemoteMBeanServer()
Deprecated. Getter for the RemoteMBeanServer of the CascadingAgent. |
void |
handleNotification(Notification notification,
Object handback)
Deprecated. Processes a MBean Server Notification emitted by the MBean Server. |
boolean |
isActive()
Deprecated. Tests if the CascadingAgent is active. |
boolean |
isNotificationEnabled(Notification notification)
Deprecated. Notification filter for local MBean Server Notifications Enables reception of MBean Server Notifications concerning "cascaded" MBeans. |
void |
postDeregister()
Deprecated. Unregisters all the objects cascaded by the cascading agent. |
void |
postRegister(Boolean registrationDone)
Deprecated. |
void |
preDeregister()
Deprecated. |
ObjectName |
preRegister(MBeanServer server,
ObjectName name)
Deprecated. Initializes the cascading agent. |
void |
setAddress(ConnectorAddress adr)
Deprecated. Setter for the ConnectorAddress to which the CascadingAgent is connected. |
void |
setClientConnectorClassName(String name)
Deprecated. Setter for the class name of the RemoteMBeanServer of the CascadingAgent. |
void |
start()
Deprecated. Activates the CascadingAgent MBean. |
void |
stop()
Deprecated. Deactivates the CascadingAgent MBean. |
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
public CascadingAgent()
CascadingAgent.
Initializes a newly created CascadingAgent with the following
default values:
defaultdomain:name=RmiConnectorServer.
public CascadingAgent(ConnectorAddress addr,
String conClName)
CascadingAgent.
In order to initialize the cascading agent, implementation names of the different services required by the MBean Server must be provided. All the MBeans in the subagent will be represented in the master agent.
addr - address to connect to in the cascading agentconClName - class name of the client connector to connect to the cascading agent.
public CascadingAgent(String localHost,
ConnectorAddress remoteAddress,
String conClName)
CascadingAgent.
In order to initialize the cascading agent, implementation names of the different services required by the MBean Server must be provided. All the MBeans in the subagent will be represented in the master agent.
localHost - name/address of local host.remoteAddress - address of the remote agent to connect to.conClName - class name of the client connector to connect to the cascading agent.
public CascadingAgent(ConnectorAddress addr,
String conClName,
ObjectName pattern,
QueryExp query)
CascadingAgent.
In order to initialize the cascading agent, implementation names of the different services required by the MBean Server must be provided.
addr - address to connect to in the cascading agentconClName - class name of the client connector to connect
to the cascading agent.pattern - the ObjectName pattern to apply to
the MBeans of the subagent. If the pattern is null or contains
an empty domain and key properties, all the MBeans in the
subagent will be selected.query - the query to apply to the MBeans of
the subagent. If null no query will be applied in the MBeans
of the subagent.
public CascadingAgent(String localHost,
ConnectorAddress remoteAddress,
String conClName,
ObjectName pattern,
QueryExp query)
CascadingAgent.
In order to initialize the cascading agent, implementation names of the different services required by the MBean Server must be provided.
localHost - name/address of local host.remoteAddress - address of the remote agent to connect to.conClName - class name of the client connector to connect
to the cascading agent.pattern - the ObjectName pattern to apply to
the MBeans of the subagent. If the pattern is null or contains
an empty domain and key properties, all the MBeans in the
subagent will be selected.query - the query to apply to the MBeans of
the subagent. If null no query will be applied in the MBeans
of the subagent.
public CascadingAgent(ConnectorAddress remoteAddress,
RemoteMBeanServer conClient,
ObjectName pattern,
QueryExp query)
CascadingAgent.
In order to initialize the cascading agent, implementation names of the different services required by the MBean Server must be provided.
remoteAddress - address of the remote agent to connect to.conClient - client connector to connect to the cascading agent.pattern - the ObjectName pattern to apply to
the MBeans of the subagent. If the pattern is null or contains
an empty domain and key properties, all the MBeans in the
subagent will be selected.query - the query to apply to the MBeans of
the subagent. If null no query will be applied in the MBeans
of the subagent.public CascadingAgent(ConnectorAddress remoteAddress)
CascadingAgent.
In order to initialize the cascading agent, implementation names of the
different services required by the MBean Server must be provided.
All the MBeans in the subagent will be represented in the master agent.
The client connector that will be used is the Java DMK connector client
corresponding to the protocol of the ConnectorAddress
parameter.
remoteAddress - address of the remote agent to connect to.
It can be an instance of
of com.sun.jdmk.comm.RmiConnectorClient,
com.sun.jdmk.comm.HttpConnectorAddress
or com.sun.jdmk.comm.HttpsConnectorAddress classes.
IllegalArgumentException - The address parameter
is not an instance of a valid class.
public CascadingAgent(String localHost,
ConnectorAddress remoteAddress)
CascadingAgent.
In order to initialize the cascading agent, implementation names of the
different services required by the MBean Server must be provided.
All the MBeans in the subagent will be represented in the master agent.
The client connector that will be used is the Java DMK connector client
corresponding to the protocol of the ConnectorAddress
parameter.
localHost - name/address of local host.remoteAddress - address of the remote agent to connect to.
It can be an instance of
of com.sun.jdmk.comm.RmiConnectorClient,
com.sun.jdmk.comm.HttpConnectorAddress
or com.sun.jdmk.comm.HttpsConnectorAddress classes.
IllegalArgumentException - The address parameter
is not an instance of a valid class.
public CascadingAgent(ConnectorAddress remoteAddress,
ObjectName pattern,
QueryExp query)
CascadingAgent.
In order to initialize the cascading agent, implementation names of the
different services required by the MBean Server must be provided.
The client connector that will be used is the Java DMK connector client
corresponding to the protocol of the ConnectorAddress parameter.
remoteAddress - address of the remote agent to connect to.
It can be an instance
of com.sun.jdmk.comm.RmiConnectorClient, com.sun.jdmk.comm.HttpConnectorAddress
or com.sun.jdmk.comm.HttpsConnectorAddress classes.pattern - the ObjectName pattern to apply to the MBeans of the subagent.
If the pattern is null or contains an empty domain and key properties,
all the MBeans in the subagent will be selected.query - the query to apply to the MBeans of the subagent.
If null no query will be applied in the MBeans of the subagent.
IllegalArgumentException - The address parameter is not an instance of a valid class.
public CascadingAgent(String localHost,
ConnectorAddress remoteAddress,
ObjectName pattern,
QueryExp query)
CascadingAgent.
In order to initialize the cascading agent, implementation names of the
different services required by the MBean Server must be provided.
The client connector that will be used is the Java DMK connector client
corresponding to the protocol of the ConnectorAddress parameter.
localHost - name/address of local host.remoteAddress - address of the remote agent to connect to.
It can be an instance
of com.sun.jdmk.comm.RmiConnectorClient, com.sun.jdmk.comm.HttpConnectorAddress
or com.sun.jdmk.comm.HttpsConnectorAddress classes.pattern - the ObjectName pattern to apply to the MBeans of the subagent.
If the pattern is null or contains an empty domain and key properties,
all the MBeans in the subagent will be selected.query - the query to apply to the MBeans of the subagent.
If null no query will be applied in the MBeans of the subagent.
IllegalArgumentException - The address parameter is not an instance of a valid class.
public CascadingAgent(ConnectorAddress addr,
String conClName,
ObjectName pattern,
QueryExp query,
int timeout)
throws IllegalArgumentException,
UnsupportedOperationException
CascadingAgent.
In order to initialize the cascading agent, implementation names of the different services required by the MBean Server must be provided.
addr - Address to connect to in the cascading agent.conClName - class name of the client connector to connect
to the cascading agent.pattern - the ObjectName pattern to apply to
the MBeans of the subagent. If the pattern is null or contains
an empty domain and key properties, all the MBeans in the
subagent will be selected.query - the query to apply to the MBeans of
the subagent. If null no query will be applied in the MBeans
of the subagent.timeout - Timeout between this cascading and the sub agent.
IllegalArgumentException - if timeout < 0.
UnsupportedOperationException - if the parameter addr
is not of type RmiConnectorAddress| Method Detail |
public boolean isNotificationEnabled(Notification notification)
isNotificationEnabled in interface NotificationFilter
public ObjectName preRegister(MBeanServer server,
ObjectName name)
throws Exception
preRegister in interface MBeanRegistrationserver - The MBean Server to register the service with.name - The object name of the MBean.
Exceptionpublic void postRegister(Boolean registrationDone)
postRegister in interface MBeanRegistration
public void preDeregister()
throws Exception
preDeregister in interface MBeanRegistrationExceptionpublic RemoteMBeanServer getRemoteMBeanServer()
RemoteMBeanServer of the CascadingAgent.
RemoteMBeanServer property.public ConnectorAddress getAddress()
ConnectorAddress to which the CascadingAgent is connected.
getAddress in interface CascadingAgentMBeanConnectorAddress property.public void setAddress(ConnectorAddress adr)
ConnectorAddress to which the CascadingAgent is connected.
setAddress in interface CascadingAgentMBeanIllegalStateException - The cascading agent is active.public String getClientConnectorClassName()
RemoteMBeanServer of the CascadingAgent.
getClientConnectorClassName in interface CascadingAgentMBeanRemoteMBeanServer.public void setClientConnectorClassName(String name)
RemoteMBeanServer of the CascadingAgent.
setClientConnectorClassName in interface CascadingAgentMBeanIllegalStateException - The cascading agent is active.public Integer getNbOfRemoteMBeans()
CascadingAgent.
getNbOfRemoteMBeans in interface CascadingAgentMBeanpublic Set getRemoteMBeans()
CascadingAgent.
getRemoteMBeans in interface CascadingAgentMBeanjava.util.Set containing all the "cascaded" MBeans.public ObjectName getPattern()
ObjectName pattern to apply to the MBeans of the subagent.
If no ObjectName pattern was specified in the CascadingAgent
constructor the method returns null.
getPattern in interface CascadingAgentMBeanpublic QueryExp getQuery()
QueryExp query to apply to the MBeans of the subagent.
If no QueryExp was specified in the CascadingAgent
constructor the method returns null.
getQuery in interface CascadingAgentMBean
public void handleNotification(Notification notification,
Object handback)
handleNotification in interface NotificationListenernotification - The MBean Server Notification to be processed.handback - The handback object.public void postDeregister()
postDeregister in interface MBeanRegistrationpublic void start()
CascadingAgent MBean.
start in interface CascadingAgentMBeanpublic void stop()
CascadingAgent MBean.
stop in interface CascadingAgentMBeanpublic boolean isActive()
CascadingAgent is active.
isActive in interface CascadingAgentMBean
|
FCS Release jdmk-5_1-b34.1 2005.02.10_16:46:09_MET |
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||