package io.dropwizard.servlets.tasks;

import com.google.common.collect.ImmutableMultimap;

import java.io.PrintWriter;

An arbitrary administrative task which can be performed via the admin interface.
See Also:
TaskServlet/**
 * An arbitrary administrative task which can be performed via the admin interface.
 *
 * @see TaskServlet
 */
public abstract class Task {
    private final String name;

    
Create a new task with the given name.
Params:
name – the task's name/**
     * Create a new task with the given name.
     *
     * @param name the task's name
     */
    protected Task(String name) {
        this.name = name;
    }

    
Returns the task's name,
Returns:
the task's name/**
     * Returns the task's name,
     *
     * @return the task's name
     */
    public String getName() {
        return name;
    }

    
Executes the task.
Params:
parameters – the query string parameters
output –  a PrintWriter wrapping the output stream of the task
Throws:
Exception – if something goes wrong/**
     * Executes the task.
     *
     * @param parameters the query string parameters
     * @param output     a {@link PrintWriter} wrapping the output stream of the task
     * @throws Exception if something goes wrong
     */
    public abstract void execute(ImmutableMultimap<String, String> parameters,
                                 PrintWriter output) throws Exception;
}