Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
  /*
   * Copyright (c) OSGi Alliance (2007, 2012). All Rights Reserved.
   * 
   * Licensed under the Apache License, Version 2.0 (the "License");
   * you may not use this file except in compliance with the License.
   * You may obtain a copy of the License at
   *
   *      http://www.apache.org/licenses/LICENSE-2.0
   *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
 
 package org.osgi.util.tracker;
 
The BundleTrackerCustomizer interface allows a BundleTracker to customize the Bundles that are tracked. A BundleTrackerCustomizer is called when a bundle is being added to a BundleTracker. The BundleTrackerCustomizer can then return an object for the tracked bundle. A BundleTrackerCustomizer is also called when a tracked bundle is modified or has been removed from a BundleTracker.

The methods in this interface may be called as the result of a BundleEvent being received by a BundleTracker. Since BundleEvents are received synchronously by the BundleTracker, it is highly recommended that implementations of these methods do not alter bundle states while being synchronized on any object.

The BundleTracker class is thread-safe. It does not call a BundleTrackerCustomizer while holding any locks. BundleTrackerCustomizer implementations must also be thread-safe.

Parameters:
<T> The type of the tracked object.
Version:
$Id: 727e757d2fa2940c88c9b74c8d299de6b3a7d0d0 $
Since:
1.4
ThreadSafe:
 
 public interface BundleTrackerCustomizer<T> {
A bundle is being added to the BundleTracker.

This method is called before a bundle which matched the search parameters of the BundleTracker is added to the BundleTracker. This method should return the object to be tracked for the specified Bundle. The returned object is stored in the BundleTracker and is available from the getObject method.

Parameters:
bundle The Bundle being added to the BundleTracker .
event The bundle event which caused this customizer method to be called or null if there is no bundle event associated with the call to this method.
Returns:
The object to be tracked for the specified Bundle object or null if the specified Bundle object should not be tracked.
 
 	public T addingBundle(Bundle bundleBundleEvent event);

A bundle tracked by the BundleTracker has been modified.

This method is called when a bundle being tracked by the BundleTracker has had its state modified.

Parameters:
bundle The Bundle whose state has been modified.
event The bundle event which caused this customizer method to be called or null if there is no bundle event associated with the call to this method.
object The tracked object for the specified bundle.
 
 	public void modifiedBundle(Bundle bundleBundleEvent event, T object);

A bundle tracked by the BundleTracker has been removed.

This method is called after a bundle is no longer being tracked by the BundleTracker.

Parameters:
bundle The Bundle that has been removed.
event The bundle event which caused this customizer method to be called or null if there is no bundle event associated with the call to this method.
object The tracked object for the specified bundle.
 
 	public void removedBundle(Bundle bundleBundleEvent event, T object);
New to GrepCode? Check out our FAQ X