package com.onaro.util.jfc.browser;

import org.eclipse.core.runtime.IAdaptable;

/**
 * An interface for objects that support browsing
 * {@link IAdaptable} objects.
 */
public interface IBrowser {
    /**
     * Indicate if browsing to an adaptable is supported.
     * @param adaptable
     * @return {@code true} if browsing to the adaptable is supported.
     * This doesn't necessarily indicate a browse to that object
     * will succeed when {@link #browse} is invoked.
     */
    public boolean isBrowsable (IAdaptable adaptable);
    
    /**
     * Navigate to show the specified adaptable.
     * @param adaptable
     * @see #isBrowsable
     */
    public void browse (IAdaptable adaptable);
}