1 /******************************************************************************* 2 * Copyright (c) 2006, 2007 IBM Corporation and others. 3 * All rights reserved. This program and the accompanying materials 4 * are made available under the terms of the Eclipse Public License v1.0 5 * which accompanies this distribution, and is available at 6 * http://www.eclipse.org/legal/epl-v10.html 7 * 8 * Contributors: 9 * IBM Corporation - initial API and implementation 10 *******************************************************************************/ 11 12 package org.eclipse.core.databinding.observable; 13 14 /** 15 * Listener for staleness events. An observable object is stale if its state 16 * will change eventually. 17 * 18 * @since 1.0 19 */ 20 public interface IStaleListener extends IObservablesListener { 21 22 /** 23 * Handle the event that the given observable object is now stale. The given 24 * event object must only be used locally in this method because it may be 25 * reused for other change notifications. 26 * 27 * @param staleEvent 28 */ 29 public void handleStale(StaleEvent staleEvent); 30 31 } 32