|
|||||||||||
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 MBeanRegistration
server
- The MBean Server to register the service with.name
- The object name of the MBean.
Exception
public void postRegister(Boolean registrationDone)
postRegister
in interface MBeanRegistration
public void preDeregister() throws Exception
preDeregister
in interface MBeanRegistration
Exception
public RemoteMBeanServer getRemoteMBeanServer()
RemoteMBeanServer
of the CascadingAgent
.
RemoteMBeanServer
property.public ConnectorAddress getAddress()
ConnectorAddress
to which the CascadingAgent
is connected.
getAddress
in interface CascadingAgentMBean
ConnectorAddress
property.public void setAddress(ConnectorAddress adr)
ConnectorAddress
to which the CascadingAgent
is connected.
setAddress
in interface CascadingAgentMBean
IllegalStateException
- The cascading agent is active.public String getClientConnectorClassName()
RemoteMBeanServer
of the CascadingAgent
.
getClientConnectorClassName
in interface CascadingAgentMBean
RemoteMBeanServer
.public void setClientConnectorClassName(String name)
RemoteMBeanServer
of the CascadingAgent
.
setClientConnectorClassName
in interface CascadingAgentMBean
IllegalStateException
- The cascading agent is active.public Integer getNbOfRemoteMBeans()
CascadingAgent
.
getNbOfRemoteMBeans
in interface CascadingAgentMBean
public Set getRemoteMBeans()
CascadingAgent
.
getRemoteMBeans
in interface CascadingAgentMBean
java.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 CascadingAgentMBean
public 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 NotificationListener
notification
- The MBean Server Notification to be processed.handback
- The handback object.public void postDeregister()
postDeregister
in interface MBeanRegistration
public void start()
CascadingAgent
MBean.
start
in interface CascadingAgentMBean
public void stop()
CascadingAgent
MBean.
stop
in interface CascadingAgentMBean
public boolean isActive()
CascadingAgent
is active.
isActive
in interface CascadingAgentMBean
|
FCS Release jdmk-5_1-b34.2 2005.11.29_16:24:00_MET |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |