Aplicación gvSIG con fines educativos

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.educa.thematicmap.map;

import java.io.IOException;

import org.gvsig.educa.thematicmap.ThematicMapManager;

import org.gvsig.fmap.mapcontext.MapContext;

import org.gvsig.tools.dispose.Disposable;

import org.gvsig.tools.dynobject.DynObject;

/**

 * <i>Thematic Map</i> instance.

 * </p>

 * This class' instances contains information about a installed <i>Thematic

 * Map</i>

 * 

 * @author <a href="http://www.disid.com">DiSiD Technologies S.L.</a>

 * @version $Rev$

 * @since {version}

 */

public interface ThematicMap extends Disposable {

    /**

     * Gets information about this <i>Thematic Map</i>

     * 

     * @return

     */

    ThematicMapInformation getInformation();

    /**

     * Opens this <i>Thematic Map</i>

     * </p>

     * This unzip <i>Thematic Map</i> contents into temporal folder (if it isn't

     * created yet)

     * and prepares data

     * </p>

     * unzip folder is defined in {@link ThematicMapManager#getTemporalFolder()}

     * </p>

     * 

     * @throws InvalidThematicMapFormatException

     * @throws CantLoadContextException

     * @throws IOException

     */

    void open() throws InvalidThematicMapFormatException,

        CantLoadContextException, IOException;

    /**

     * Informs if <i>Thematic Map</i> it's already opened or not

     * 

     * @return if it's opened

     */

    boolean isOpen();

    /**

     * Unloads all data loaded in memory and cleans its temporal folder

     * 

     * @throws IOException

     *             if any problem is found cleaning temporal folder

     * 

     */

    void close() throws IOException;

    /**

     * Gets MapContext with <i>Thematic Map</i> representation

     * 

     * @return MapContext instance

     * @throws IllegalStateException

     *             if {@link #isOpen()} == false

     */

    MapContext getMapContext();

    /**

     * Gets the file which ThematicMap data

     * 

     * @return

     */

    String getSourceFilePath();

    public void executeGame(DynObject pareameters);

}