org.aspectj/org.aspectj.ajdt.core/src/main/java/org/aspectj/ajdt/internal/core/builder/IStateListener.java

/**
 * Copyright (c) 2005 IBM and other contributors
 * All rights reserved.
 * This program and the accompanying materials are made available
 * under the terms of the Eclipse Public License v 2.0
 * which accompanies this distribution and is available at
 * https://www.eclipse.org/org/documents/epl-2.0/EPL-2.0.txt
 *
 * Contributors:
 *     Andy Clement     initial implementation
 * ******************************************************************/

package org.aspectj.ajdt.internal.core.builder;

import java.io.File;
import java.util.List;

/**
 * Implementations of this interface get told interesting information about
 * decisions made in AjState objects.  Should help us improve incremental
 * compilation, and ease the testing of incremental compilation!
 *
 * Not yet complete, will expand as we determine what extra useful information
 * should be recorded.
 *
 * @author AndyClement
 */
public interface IStateListener {

	void detectedClassChangeInThisDir(File f);

	void aboutToCompareClasspaths(List<String> oldClasspath, List<String> newClasspath);

	void pathChangeDetected();

	/**
	 * Called if state processing detects a file was deleted that contained an aspect declaration.
	 * Incremental compilation will not be attempted if this occurs.
	 */
	void detectedAspectDeleted(File f);

	void buildSuccessful(boolean wasFullBuild);

	/**
	 * When a decision is made during compilation (such as needing to recompile some new file, or drop back to batch) this
	 * method is called with the decision.
	 */
	void recordDecision(String decision);

	/**
	 * Provides feedback during compilation on what stage we are at
	 */
	void recordInformation(String info);

}