package de.intevation.flys.client.shared.model;

import java.io.Serializable;


/**
 * This interface describes an output mode of an artifact.
 *
 * @author <a href="mailto:ingo.weinzierl@intevation.de">Ingo Weinzierl</a>
 */
public interface OutputMode extends Serializable {

    /**
     * Retrieves the name of this mode.
     *
     * @return the name of this mode.
     */
    String getName();


    /**
     * Retrieves the description of this mode.
     *
     * @return the description of this mode.
     */
    String getDescription();


    /**
     * Retrieves the mime-type of this mode.
     *
     *
     * @return the mime-type of this mode.
     */
    String getMimeType();


    /**
     * Adds a new facet to this mode.
     *
     * @param facet The new facet.
     */
    void addFacet(Facet facet);


    /**
     * Returns the number of facets supported by this mode.
     *
     * @return the number of facets.
     */
    int getFacetCount();


    /**
     * Returns the facet at a given position.
     *
     * @param idx The position of a facet.
     *
     * @return a facet.
     */
    Facet getFacet(int idx);


    /**
     * Returns a facet based on its name.
     *
     * @param name The name of the facet.
     *
     * @return a facet or null if no such facet is available.
     */
    Facet getFacet(String name);
}
// vim:set ts=4 sw=4 si et sta sts=4 fenc=utf8 :