public class AxisServiceTracker extends Object
Tracks services deployed in a given
The tracker is configured with references to three objects:
AxisServiceFilterrestricting the services to track.
AxisServiceTrackerListenerreceiving tracking events.
An instance of this class maintains an up-to-date list of services satisfying all of the following criteria:
Whenever a service appears on the list, the tracker will call
AxisServiceTrackerListener.serviceAdded(AxisService). When a service disappears, it
When the tracker is created, it is initially in the stopped state. In this state no
events will be sent to the listener. It can be started using
start() and stopped again
stop(). The tracker list is defined to be empty when the tracker is in the
stopped state. This implies that a call to
start() will generate
AxisServiceTrackerListener.serviceAdded(AxisService) events for all services that meet
the above criteria at that point in time. In the same way,
stop() will generate
AxisServiceTrackerListener.serviceRemoved(AxisService) events for the current entries
in the list.
As a corollary the tracker guarantees that during a complete lifecycle (start-stop),
there will be exactly one
AxisServiceTrackerListener.serviceAdded(AxisService) event and vice-versa.
This property is important when the tracker is used to allocate resources for a dynamic set
The tracker is not able to detect property changes on services. E.g. if a service initially matches the filter criteria, but later changes so that it doesn't match the criteria any more, the tracker will not be able to detect this and the service will not be removed from the tracker list.
|Constructor and Description|
|Modifier and Type||Method and Description|
Check whether the tracker is started.
Start the tracker.
Stop the tracker.
public boolean isStarted()
trueif the tracker is started
public void start()
IllegalStateException- if the tracker has already been started
public void stop()
IllegalStateException- if the tracker is not started
Copyright © The Apache Software Foundation. All Rights Reserved.