core/plugins/org.eclipse.dltk.ui/src/org/eclipse/dltk/internal/ui/wizards/buildpath/newsourcepage/BuildpathModifierAction.java

/*******************************************************************************
 * Copyright (c) 2000, 2017 IBM Corporation and others.
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Public License v. 2.0 which is available at
 * http://www.eclipse.org/legal/epl-2.0.
 * 
 * SPDX-License-Identifier: EPL-2.0
 *
 *******************************************************************************/
package org.eclipse.dltk.internal.ui.wizards.buildpath.newsourcepage;

import java.lang.reflect.InvocationTargetException;
import java.util.List;

import org.eclipse.dltk.core.ModelException;
import org.eclipse.dltk.internal.corext.buildpath.BuildpathModifierOperation;
import org.eclipse.dltk.ui.DLTKUIPlugin;
import org.eclipse.jface.action.Action;
import org.eclipse.jface.resource.ImageDescriptor;

/**
 * Action which is used when operations on the buildpath
 * are executed.
 */
public class BuildpathModifierAction extends Action {
    private BuildpathModifierOperation fOperation;

    /**
     * Constructor to create a buildpath modifier action.
     *
     * @param operation the operation to execute inside the action
     * @param imageDescriptor the image descriptor for the icon
     * @param disabledImageDescriptor the image descriptor for the disabled icon
     * @param text the text to be set as label for the action
     * @param tooltip the text to be set as tool tip
     *
     * @see BuildpathModifierOperation
     */
    public BuildpathModifierAction(BuildpathModifierOperation operation, ImageDescriptor imageDescriptor, ImageDescriptor disabledImageDescriptor, String text, String tooltip, int style) {
        super(text, style);
        setImageDescriptor(imageDescriptor);
        setDisabledImageDescriptor(disabledImageDescriptor);
        setText(text);
        setToolTipText(tooltip);
        fOperation= operation;
    }

    @Override
	public void run() {
        try {
            fOperation.run(null);
            setEnabled(fOperation.isValid());
        } catch (InvocationTargetException e) {
            // nothing to do
        } catch (InterruptedException e) {
            // nothing to do
        } catch (ModelException e) {
			DLTKUIPlugin.log(e);
		}
        // Remark: there is nothing to do because the operation that is executed
        // ensures that the object receiving the result should do the exception handling
        // because it needs to implement interface IBuildpathInformationProvider
    }

    /**
     * Find out whether this operation can be executed on
     * the provided list of elements.
     *
     * @param selectedElements a list of elements
     * @param types an array of types for each element, that is,
     * the type at position 'i' belongs to the selected element
     * at position 'i'
     *
     * @return <code>true</code> if the operation can be
     * executed on the provided list of elements, <code>
     * false</code> otherwise.
     *
     * @throws ModelException
     */
    public boolean isValid(List selectedElements, int[] types) throws ModelException {
        return fOperation.isValid(selectedElements, types);
    }

    /**
     * Getter for the operation.
     *
     * @return the operation that is executed within this action
     *
     * @see BuildpathModifierOperation
     */
    public BuildpathModifierOperation getOperation() {
        return fOperation;
    }

    /**
     * Get the description suitable to the provided type
     *
     * @param type the type of the selected element(s), must be a constant of
     * <code>DialogPackageActionGroup</code>.
     * @return a short description of the operation.
     *
     * @see BuildpathModifierOperation#getDescription(int)
     * @see DialogPackageExplorerActionGroup
     */
    public String getDescription(int type) {
        return fOperation.getDescription(type);
    }

    @Override
	public String getId() {
        return fOperation.getId();
    }

    /**
     * Get the action's name.
     *
     * @return a human readable name for the operation/action executed
     */
    public String getName() {
        return fOperation.getName();
    }
}