| /******************************************************************************* |
| * Copyright (c) 2010, 2011 IBM Corporation and others. |
| * All rights reserved. This program and the accompanying materials |
| * are made available under the terms of the Eclipse Public License v2.0 |
| * which accompanies this distribution, and is available at |
| * https://www.eclipse.org/legal/epl-2.0/ |
| * |
| * Contributors: |
| * IBM Corporation - initial API and implementation |
| *******************************************************************************/ |
| package org.eclipse.wst.common.componentcore.internal.builder; |
| |
| import java.util.Map; |
| import java.util.Set; |
| |
| import org.eclipse.core.resources.IProject; |
| |
| public interface IDependencyGraphUpdateEvent { |
| |
| int ADDED = 1; |
| int REMOVED = 2; |
| |
| |
| /** |
| * Returns a bitwise or of the reference change types. |
| * |
| * @see {@link #ADDED} {@link #REMOVED} |
| * @return |
| */ |
| int getType(); |
| |
| /** |
| * Returns the modification stamp for the last update change in the |
| * {@link IDependencyGraph} being notified by this event. |
| * |
| * <p>Note that updates to the {@link IDependencyGraph} may be queued so |
| * several are handled by a single event. |
| * |
| * @see IDependencyGraph#getModStamp() |
| * |
| * @return |
| */ |
| long getModStamp(); |
| |
| /** |
| * The key contains the referenced component, the value contains the set of |
| * referencing components recently added. This map will only contain the |
| * changes since the last event was fired. If {@link #getType()} | |
| * {@link #ADDED} != {@link #ADDED} then this will be an empty map. |
| * |
| * <p>Note that the changes specified by this map do not necessarily reflect |
| * the current state of the {@link IDependencyGraph} because it is possible |
| * that additional changes have occurred since this event was fired. |
| * {@link IDependencyGraph#getReferencingComponents(IProject)} will return |
| * the current reference state. |
| * |
| * @return |
| */ |
| Map<IProject, Set<IProject>> getAddedReferences(); |
| |
| /** |
| * The key contains the referenced component, the value contains the set of |
| * referencing components recently removed. This map will only contain the |
| * changes since the last event was fired. If {@link #getType()} | |
| * {@link #REMOVED} != {@link #REMOVED} then this will be an empty map. |
| * |
| * <p>Note that the changes specified by this map do not necessarily reflect |
| * the current state of the {@link IDependencyGraph} because it is possible |
| * that additional changes have occurred since this event was fired. |
| * {@link IDependencyGraph#getReferencingComponents(IProject)} will return |
| * the current reference state. |
| * |
| * @return |
| */ |
| Map<IProject, Set<IProject>> getRemovedReferences(); |
| |
| } |