org.eclipse.jface.viewers.IContentProvider Maven / Gradle / Ivy
/*******************************************************************************
* Copyright (c) 2000, 2015 IBM Corporation and others.
*
* This program and the accompanying materials
* are made available under the terms of the Eclipse Public License 2.0
* which accompanies this distribution, and is available at
* https://www.eclipse.org/legal/epl-2.0/
*
* SPDX-License-Identifier: EPL-2.0
*
* Contributors:
* IBM Corporation - initial API and implementation
*******************************************************************************/
package org.eclipse.jface.viewers;
/**
* A content provider mediates between the viewer's model
* and the viewer itself.
*
* @see org.eclipse.jface.viewers.ContentViewer#setContentProvider(IContentProvider)
*/
public interface IContentProvider {
/**
* Disposes of this content provider.
* This is called by the viewer when it is disposed.
*
* The viewer should not be updated during this call, as it is in the process
* of being disposed.
*
*
* The default implementation does nothing.
*
*/
default void dispose() {
}
/**
* Notifies this content provider that the given viewer's input
* has been switched to a different element.
*
* A typical use for this method is registering the content provider as a listener
* to changes on the new input (using model-specific means), and deregistering the viewer
* from the old input. In response to these change notifications, the content provider
* should update the viewer (see the add, remove, update and refresh methods on the viewers).
*
*
* The viewer should not be updated during this call, as it might be in the process
* of being disposed.
*
*
* The default implementation does nothing.
*
*
* @param viewer the viewer
* @param oldInput the old input element, or null if the viewer
* did not previously have an input
* @param newInput the new input element, or null if the viewer
* does not have an input
*/
default void inputChanged(Viewer viewer, Object oldInput, Object newInput) {
}
}