/*******************************************************************************
 * Copyright (c) 2000, 2008 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.osgi.framework.adaptor;

import org.osgi.framework.Bundle;

/**
 * Watches bundle lifecyle processes.  This interface is different than that of
 * a BundleLisener because it gets notified before and after all lifecycle 
 * changes.  A bundle watcher acts as the main entry point for logging 
 * bundle activity.
 * <p>
 * Note that a bundle watcher is always notified of when a lifecycle processes 
 * has ended even in cases where the lifecycle process may have failed.  For 
 * example, if activating a bundle fails the {@link #END_ACTIVATION} flag will
 * still be sent to the bundle watcher to notify them that the activation 
 * process has ended.
 * </p>
 * <p>
 * Clients may implement this interface.
 * </p>
 * @since 3.1
 */
public interface BundleWatcher {
	/**
	 * The install process is beginning for a bundle
	 * @since 3.2
	 */
	public static final int START_INSTALLING = 0x0001;
	/**
	 * The install process has ended for a bundle
	 * @since 3.2
	 */
	public static final int END_INSTALLING = 0x0002;
	/**
	 * The activation process is beginning for a bundle
	 * @since 3.2
	 */
	public static final int START_ACTIVATION = 0x0004;
	/**
	 * The activation process has ended for a bundle
	 * @since 3.2
	 */
	public static final int END_ACTIVATION = 0x0008;
	/**
	 * The deactivation process is beginning for a bundle
	 * @since 3.2
	 */
	public static final int START_DEACTIVATION = 0x0010;
	/**
	 * The deactivation process has ended for a bundle
	 * @since 3.2
	 */
	public static final int END_DEACTIVATION = 0x0020;
	/**
	 * The uninstallation process is beginning for a bundle
	 * @since 3.2
	 */
	public static final int START_UNINSTALLING = 0x0040;
	/**
	 * The uninstallation process has ended for a bundle
	 * @since 3.2
	 */
	public static final int END_UNINSTALLING = 0x0080;

	/**
	 * Receives notification that a lifecycle change is going to start or has
	 * ended.
	 * @param bundle the bundle for which the lifecycle change is occurring on.
	 * @param type the type of lifecycle change which is occurring.
	 * @see #START_INSTALLING
	 * @see #END_INSTALLING
	 * @see #START_ACTIVATION
	 * @see #END_ACTIVATION
	 * @see #START_DEACTIVATION
	 * @see #END_DEACTIVATION
	 * @see #START_UNINSTALLING
	 * @see #END_UNINSTALLING
	 * @since 3.2
	 */
	public void watchBundle(Bundle bundle, int type);
}