org.pepsoft.util.swing.ProgressTask Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of WPUtils Show documentation

The newest version!

/*
 * To change this template, choose Tools | Templates
 * and open the template in the editor.
 */
package org.pepsoft.util.swing;

import org.pepsoft.util.ProgressReceiver;

/**
 * A named task which may report its progress and may return a value.
 *
 * @param  The return type of the task. Use {@link Void} if it does not
 *            return a value.
 * @author pepijn
 */
public interface ProgressTask {
    /**
     * Get the short descriptive name of the task.
     *
     * @return The name of the task.
     */
    String getName();

    /**
     * Perform the task, optionally reporting progress to a progress receiver
     * and optionally returning a value.
     *
     * @param progressReceiver The progress receiver to which to report
     *                         progress. May be {@code null}.
     * @return The result of the task, or {@code null} if it does not
     *     return a result.
     * @throws ProgressReceiver.OperationCancelled If the user cancelled the
     *     operation, as indicated by the progress receiver throwing an
     *     {@code OperationCancelled} exception.
     */
    T execute(ProgressReceiver progressReceiver) throws ProgressReceiver.OperationCancelled;
}