Interface IRemoteServiceTrackerCustomizer
- 
- All Known Implementing Classes:
- RemoteServiceTracker
 
 public interface IRemoteServiceTrackerCustomizerTheIRemoteServiceTrackerCustomizerinterface allows aRemoteServiceTrackerobject to customize the service objects that are tracked. TheIRemoteServiceTrackerCustomizerobject is called when a service is being added to theRemoteServiceTrackerobject. TheIRemoteServiceTrackerCustomizercan then return an object for the tracked service. TheIRemoteServiceTrackerCustomizerobject is also called when a tracked service is modified or has been removed from theRemoteServiceTrackerobject.The methods in this interface may be called as the result of a IRemoteServiceEventbeing received by aRemoteServiceTrackerobject. SinceIRemoteServiceEvents are synchronously delivered by the Framework, it is highly recommended that implementations of these methods do not register (IRemoteServiceContainerAdapter.registerService), modify (IRemoteServiceRegistration.setProperties) or unregister (IRemoteServiceRegistration.unregister) a service while being synchronized on any object.The RemoteServiceTrackerclass is thread-safe. It does not call aIRemoteServiceTrackerCustomizerobject while holding any locks.IRemoteServiceTrackerCustomizerimplementations must also be thread-safe.- Since:
- 3.0
 
- 
- 
Method SummaryAll Methods Instance Methods Abstract Methods Modifier and Type Method Description IRemoteServiceaddingService(IRemoteServiceReference reference)A service is being added to theRemoteServiceTrackerobject.voidmodifiedService(IRemoteServiceReference reference, IRemoteService remoteService)A remote service tracked by theRemoteServiceTrackerobject has been modified.voidremovedService(IRemoteServiceReference reference, IRemoteService remoteService)A remote service tracked by theRemoteServiceTrackerobject has been removed.
 
- 
- 
- 
Method Detail- 
addingServiceIRemoteService addingService(IRemoteServiceReference reference) A service is being added to theRemoteServiceTrackerobject.This method is called before a remote service which matched the search parameters of the RemoteServiceTrackerobject is added to it. This method should return the IRemoteServic object to be tracked for thisIRemoteServiceReferenceobject. The returned remote service object is stored in theRemoteServiceTrackerobject and is available from thegetRemoteServiceandgetRemoteServicesmethods.- Parameters:
- reference- remote reference to remote service being added to the- RemoteServiceTrackerobject.
- Returns:
- The remote service object to be tracked for the
         IRemoteServiceReferenceobject ornullif theIRemoteServiceReferenceobject should not be tracked.
 
 - 
modifiedServicevoid modifiedService(IRemoteServiceReference reference, IRemoteService remoteService) A remote service tracked by theRemoteServiceTrackerobject has been modified.This method is called when a remote service being tracked by the RemoteServiceTrackerobject has had it properties modified.- Parameters:
- reference- IRemoteServiceReference to service that has been modified.
- remoteService- The remote service object for the modified remote service.
 
 - 
removedServicevoid removedService(IRemoteServiceReference reference, IRemoteService remoteService) A remote service tracked by theRemoteServiceTrackerobject has been removed.This method is called after a remote service is no longer being tracked by the RemoteServiceTrackerobject.- Parameters:
- reference- IRemoteServiceReference to remote service that has been removed.
- remoteService- The service object for the removed service.
 
 
- 
 
-