org.eclipse.core.filebuffers/src/org/eclipse/core/filebuffers/IFileBufferListener.java

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

import org.eclipse.core.runtime.IPath;

/**
 * Interface for listeners to file buffer changes.
 * 
 * @since 3.0
 */
public interface IFileBufferListener {

	/**
	 * Informs the listener about the creation of the given buffer.
	 * 
	 * @param buffer the created file buffer
	 */
	void bufferCreated(IFileBuffer buffer);
	
	/**
	 * Informs the listener about the disposal of the given buffer.
	 * 
	 * @param buffer the disposed file buffer
	 */
	void bufferDisposed(IFileBuffer buffer);

	/**
	 * Informs the listener about an upcoming replace of the contents of the given buffer.
	 * 
	 * @param buffer the effected file buffer
	 */
	void bufferContentAboutToBeReplaced(IFileBuffer buffer);
	
	/**
	 * Informs the listener that the buffer of the given buffer has been replaced.
	 * 
	 * @param buffer the effected file buffer
	 */
	void bufferContentReplaced(IFileBuffer buffer);

	/**
	 * Informs the listener about the start of a state changing operation on
	 * the given buffer.
	 * 
	 * @param buffer the effected file buffer
	 */
	void stateChanging(IFileBuffer buffer);
	
	/**
	 * Informs the listener that the dirty state of the given buffer changed
	 * to the specified value
	 * 
	 * @param buffer the effected file buffer
	 * @param isDirty <code>true</code> if the buffer is dirty, <code>false</code> otherwise
	 */
	void dirtyStateChanged(IFileBuffer buffer, boolean isDirty);
	
	/**
	 * Informs the listener that the state validation changed to the specified value.
	 * 
	 * @param buffer the effected file buffer
	 * @param isStateValidated <code>true</code> if the buffer state is validated, <code>false</code> otherwise
	 */
	void stateValidationChanged(IFileBuffer buffer, boolean isStateValidated);
	
	/**
	 * Informs the listener that the file underlying the given file buffer has been moved to the
	 * given location.
	 * 
	 * @param buffer the effected file buffer
	 * @param path the new location (not just the container)
	 */
	void underlyingFileMoved(IFileBuffer buffer, IPath path);
	
	/**
	 * Informs the listener that the file underlying the given file buffer has been deleted.
	 * 
	 * @param buffer the effected file buffer
	 */
	void underlyingFileDeleted(IFileBuffer buffer);
	
	/**
	 * Informs the listener that a state changing operation on the given
	 * file buffer failed.
	 * 
	 * @param buffer the effected file buffer
	 */
	void stateChangeFailed(IFileBuffer buffer);
}