org.jboss.mx.remoting.tracker
Class MBeanTracker

java.lang.Object
  org.jboss.mx.remoting.tracker.MBeanTracker

All Implemented Interfaces:

java.util.EventListener, NotificationListener (src)

public class MBeanTracker

extends java.lang.Object

implements NotificationListener (src)

MBeanTracker is a utility class that will track MBeans on behalf of a user object.

MBeanTracker

public MBeanTracker(MBeanServer (src)  myserver,
                    java.lang.Class[] cl,
                    QueryExp (src)  query,
                    boolean localOnly,
                    MBeanTrackerAction (src)  action)
             throws java.lang.Exception

MBeanTracker

public MBeanTracker(MBeanServer (src)  myserver,
                    java.lang.Class[] cl,
                    QueryExp (src)  query,
                    boolean localOnly,
                    MBeanTrackerAction (src) [] actions)
             throws java.lang.Exception

MBeanTracker

public MBeanTracker(MBeanServer (src)  myserver,
                    java.lang.Class[] cl,
                    boolean localOnly,
                    MBeanTrackerAction (src)  action)
             throws java.lang.Exception

MBeanTracker

public MBeanTracker(MBeanServer (src)  myserver,
                    java.lang.Class[] cl,
                    boolean localOnly,
                    MBeanTrackerAction (src) [] actions)
             throws java.lang.Exception

MBeanTracker

public MBeanTracker(MBeanServer (src)  myserver,
                    java.lang.Class[] cl,
                    QueryExp (src)  query,
                    boolean localOnly,
                    NotificationFilter (src)  filter,
                    boolean wantNotifications,
                    MBeanTrackerAction (src)  action)
             throws java.lang.Exception

MBeanTracker

public MBeanTracker(MBeanServer (src)  myserver,
                    java.lang.Class[] cl,
                    QueryExp (src)  query,
                    boolean localOnly,
                    NotificationFilter (src)  filter,
                    boolean wantNotifications)
             throws java.lang.Exception

MBeanTracker

public MBeanTracker(MBeanServer (src)  myserver,
                    java.lang.Class[] cl,
                    QueryExp (src)  query,
                    boolean localOnly,
                    NotificationFilter (src)  filter,
                    boolean wantNotifications,
                    MBeanTrackerAction (src) [] actions)
             throws java.lang.Exception

create a tracker

Parameters:

myserver - local mbean server

cl - array of classes that mbeans implement that you want to track, or null to not look at class interfaces

query - query expression to apply when selecting mbeans or null to not use a query expression

localOnly - true to only search the local mbeanserver, false to search the entire network of mbeans servers

filter - filter to apply for receiving notifications or null to apply no filter

wantNotifications - if true, will also track notifications by the mbeans being tracked

actions - array of actions to automatically register as listeners, or null if none

Throws:

java.lang.Exception - raised on exception

addActionListener

public void addActionListener(MBeanTrackerAction (src)  action)

add a action listener. this method will automatically call register to your action on all the mbeans that are contained within it before this method returns.

Parameters:

action -

addActionListener

public void addActionListener(MBeanTrackerAction (src)  action,
                              boolean autoinitialregister)

add a action listener. this method will automatically call register to your action on all the mbeans that are contained within it before this method returns.

Parameters:

action -

removeActionListener

public void removeActionListener(MBeanTrackerAction (src)  action)

remove a action listener

Parameters:

action -

finalize

protected void finalize()
                 throws java.lang.Throwable

Throws:

java.lang.Throwable

destroy

public void destroy()

called to stop tracking and clean up internally held resources

isEmpty

public final boolean isEmpty()

returns true if no mbeans are found that are being tracked

Returns:

count

public final int count()

return the number of mbeans being tracked

Returns:

getMBeans

public final java.util.Set getMBeans()

return a copy of the internal mbeans being tracked

Returns:

iterator

public final java.util.Iterator iterator()

return an iterator to a copy of the internal mbeans being tracked

Returns:

handleNotification

public void handleNotification(Notification (src)  notification,
                               java.lang.Object o)

called for each notification

Specified by:

handleNotification in interface NotificationListener (src)

Parameters:

notification -

o -

fireNotification

protected void fireNotification(MBeanLocator (src)  locator,
                                Notification (src)  n,
                                java.lang.Object o)

fire a notification to actions

Parameters:

locator -

n -

o -

fireStateChange

protected void fireStateChange(MBeanLocator (src)  locator,
                               int ov,
                               int nv)

fire a state changed event to actions

Parameters:

locator -

ov -

nv -

fireUnregister

protected void fireUnregister(MBeanLocator (src)  locator)

fire unregister event to listeners

Parameters:

locator -

fireRegister

protected void fireRegister(MBeanLocator (src)  locator)

fire register event to listeners

Parameters:

locator -

foundMBeanServer

public void foundMBeanServer(MBeanServerLocator (src)  theserver)

fired when an MBeanServer is found

Parameters:

theserver -

lostMBeanServer

public void lostMBeanServer(MBeanServerLocator (src)  server)

fired when we lose an MBeanServer

Parameters:

server -