Aplicación gvSIG con fines educativos » Interfaz de usuario

===============

gvSIG Educa

===============

---------------------

Vistas Portables

---------------------

Descripci?n

==============

Este directorio contiene los fuentes de la funcionalidad Vistas Portables.

Requisitos

==============

* Maven 2.6 or higher

* Java JDK 1.5 or higher

Para trabajar con eclipse

--------------------------

Ver `Gu?a del desarrollador en gvSIG.org <https://gvsig.org/web/projects/gvsig-desktop/docs/devel/gvsig-devel-guide/2.0.0/>`_ y el fichero ``REAME-ECLIPSE.txt``

Contenido

==========

org.gvsig.educa.portableview.lib

---------------------------------

Fuentes de la funcionalidad. Estos proyectos contienen los procesos y l?gica principal sin dependencias de interface de usuario.

org.gvsig.educa.portableview.swing

-------------------------------------

Componentes de interface de usuario para gestionar los servicios que ofrece la librer??a.

org.gvsig.educa.portableview.main

-----------------------------------

Peque?a aplicaci?n que permite ejecutar las funcionalidades y realizar pruebas funcionales.

Ver `Ejecutar aplicaci?n de pruebas`_ para saber como arrancarla.

pom.xml

---------

Archivo de definici?n de proyecto Maven.

README.txt LEEME.txt

----------------------

Este fichero (en formato reStructureText, para mas informaci?n sobre este ver el `portal de gvSIG <https://gvsig.org/web/projects/gvsig-desktop/docs/devel/guia-para-documentar/el-formato-restructuredtext>`_  en la `referencia de docUtils  <http://docutils.sourceforge.net/rst.html>`_)

Compilaci?n

================

Desde el shell

----------------

Ejecute este comando::

    org.gvsig.educa.portablewview$ mvn clean install

Desde eclipse

--------------

Ver `Trabajar con un proyecto de la gu?a de desarrollador en gvSIG.org <https://gvsig.org/web/projects/gvsig-desktop/docs/devel/gvsig-devel-guide/2.0.0/trabajar-con-un-proyecto>`_

En algunos proyectos puede que sea necesario user el comando ``mvn eclipse:clean eclipse:eclipse`` e importar como *Standar/Import existing project...* en vez de cargar como *Maven Project*. Esto es debido a que, en algunas circunstancias, parece que el plugin de Maven del eclipse no prepara el *classpath* de forma correcta.

Empaquetado

===============

Esta funcionalidad no tiene ning?n proyecto pensado para empaquetar de forma independiente.

Versionado

--------------

Para cambiar el n?mero de versi?n de los plugins solo es necesario ajustar la etiqueta ``project/version`` del fichero *pom.xml*. Los subproyectos heredar?n el valor.

La pol??tica de versi?n es la est?ndar. Los cambios en los numeroso son:

* tercer n?mero: Arreglo de errores y mejoras menores. Sin cambios en el API.

* segundo n?mero: Arreglo de erroes y mejoras. Pueden haber cambios menores en el API. Los elementos marcados como *deprecated* en versiones anteriores pueden eliminarse. Sin cambios de arquitectura.

* primer n?mero: Cambios mayores.

Crear un tag

------------------

TODO: usar el plugin *release* de maven

Usar el comando *svn copy*. El proceso podr?a ser:

#. Comprobar que no hay cambios en la copia local::

   svn up ; svn status

#. Comprobar que los proyecto compilan y pasan todas las bater?as de test::

   mvn clean install

#. Actualizar el fichero *pom.xml* con la versi?n de tag (normalmente quitando el sufijo *-SNAPSHOT*)

#. Crear el directorio para el tag en el servidor::

   svn mkdir -m "Create {version} tag folder" https://devel.gvsig.org/svn/gvsig-educa/org.gvsig.educa.portablewview.app/tags/{version}

#. Subir la copia local al directorio del tag en el servidor::

   svn copy -m "Create {version} tag" * https://devel.gvsig.org/svn/gvsig-educa/org.gvsig.educa.portablewview.app/tags/{version}

#. Actualizar el *pom.xml* a la siguiente version (y a?adirle el sufijo *-SNAPSHOT*)

#. Subir los cambios del *pom.xml*::

   svn commit -m "Set new version {version}-SNAPSHOT" pom.xml

i18n

======

Los ficheros de internacionalizaci?n se pueden encontrar en los directorios:

+ */org.gvsig.educa.portableview.swing/org.gvsig.educa.portableview.swing.impl/src/main/resources/org/gvsig/educa/portableview/swing/impl/i18n*

+ *org.gvsig.educa.portableview.lib/org.gvsig.educa.portableview.lib.impl/src/main/resources/org/gvsig/educa/portableview/impl/i18n*

La internacionalizaci?n est? basada en el mecanismo est?ndar de los *resource bundle*. Para a?adir un nuevo idioma es necesario a?adir el fichero de propiedades en todos los directorio con el codigo de idioma adecuado.

Ejecutar aplicaci?n de pruebas

=================================

Desde el Shell

----------------

Despu?s del proceso de `Compilaci?n`_ , ejecute estos comandos::

    org.gvsig.educa.portablewview$ cd org.gvsig.educa.portablewview.main

    org.gvsig.educa.portablewview/org.gvsig.educa.portablewview.main$ mvn exec:java

Desde el eclipse

------------------

Seleccione el proyecto ``org.gvsig.educa.portableview.main`` en el *Project tree* de la *Java perspective*, haga click con el bot?n derecho y seleccione ``Run as.../Java application``. Seleccione la clase ``Main`` del propio proyecto.

Si tiene problemas al ejecutar, compruebe la nota de la secci?n `Compilaci?n`_ sobre la importaci?n del proyecto.

<?xml version="1.0" encoding="ISO-8859-1"?>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

	<modelVersion>4.0.0</modelVersion>

	<groupId>org.gvsig</groupId>

	<artifactId>org.gvsig.educa.portableview.app</artifactId>

	<packaging>pom</packaging>

	<name>org.gvsig.educa.portableview.app</name>

	<description>Educa.PortableView plugins</description>

	<parent>

            <groupId>org.gvsig</groupId>

            <artifactId>org.gvsig.educa.portableview</artifactId>

            <version>1.0.12</version> 

	</parent>

	<properties>

		<gvsig.package.info.poolURL>https://devel.gvsig.org/download/projects/gvsig-educa/pool</gvsig.package.info.poolURL>

	</properties>

	<dependencies>

		<dependency>

			<groupId>org.slf4j</groupId>

			<artifactId>slf4j-api</artifactId>

			<scope>compile</scope>

		</dependency>

	</dependencies>

	<modules>

		<module>org.gvsig.educa.portableview.app.viewer</module>

		<module>org.gvsig.educa.portableview.app.editor</module>

	</modules>

</project>

#Tue May 19 12:18:52 CEST 2015

buildNumber=22

org.gvsig.educa.portableview.app.editor.PortableViewEditorLibrary

org.gvsig.educa.portableview.app.editor.impl.PortableViewEditorDefaultImplLibrary

<assembly>

	<id>gvsig-plugin-package</id>

	<formats>

		<format>zip</format>

	</formats>

	<baseDirectory>${project.artifactId}</baseDirectory>

	<includeBaseDirectory>true</includeBaseDirectory>

	<files>

		<file>

			<source>target/${project.artifactId}-${project.version}.jar</source>

			<outputDirectory>lib</outputDirectory>

		</file>

		<file>

			<source>target/package.info</source>

		</file>

	</files>

	<fileSets>

		<fileSet>

			<directory>src/main/resources-plugin</directory>

			<outputDirectory>.</outputDirectory>

		</fileSet>

	</fileSets>

	<dependencySets>

		<dependencySet>

			<useProjectArtifact>false</useProjectArtifact>

			<useTransitiveDependencies>false</useTransitiveDependencies>

			<outputDirectory>lib</outputDirectory>

			<includes>

				<include>org.gvsig:org.gvsig.educa.portableview.app.editor</include>

			</includes>

		</dependencySet>

	</dependencySets>

</assembly>

/* 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.portableview.app.editor;

import java.io.File;

import javax.swing.SwingUtilities;

import org.gvsig.andami.PluginServices;

import org.gvsig.andami.messages.NotificationManager;

import org.gvsig.andami.plugins.Extension;

import org.gvsig.andami.ui.mdiManager.IWindow;

import org.gvsig.educa.portableview.app.viewer.PortableViewDocument;

import org.gvsig.educa.portableview.app.viewer.ui.PortableViewDocumentViewer;

import org.gvsig.educa.portableview.swing.PortableViewSwingLocator;

import org.gvsig.educa.portableview.swing.PortableViewSwingManager;

import org.gvsig.educa.portableview.swing.PortableViewWindowManager.MESSAGE_DIALOG_TYPE;

/**

 * Andami extension to create a gvSIG package of a Portable View.

 *

 * @author gvSIG Team

 * @version $Id$

 */

public class GeneratePackagePortableViewExtension extends Extension {

    private PortableViewEditorManager editorManager;

    private PortableViewSwingManager swingManager;

    public void initialize() {

        // Do nothing

    }

    @Override

    public void postInitialize() {

        editorManager = PortableViewEditorLocator.getManager();

        swingManager = PortableViewSwingLocator.getSwingManager();

    }

    public void execute(String actionCommand) {

        IWindow window = PluginServices.getMDIManager().getActiveWindow();

        if (!(window instanceof PortableViewDocumentViewer)) {

            return;

        }

        final PortableViewDocument tmDocument =

            ((PortableViewDocumentViewer) window).getPortableViewDocument();

        SwingUtilities.invokeLater(new Runnable() {

            public void run() {

                try {

                    File file = editorManager.generatePackage(tmDocument);

                    if (file != null) {

                        swingManager.getWindowManager().showMessageDialog(

                            swingManager.getTranslation("generate_package"),

                            swingManager.getTranslation("generated_file")

                                .concat(":").concat(file.getAbsolutePath()),

                            MESSAGE_DIALOG_TYPE.INFO);

                    }

                } catch (Exception ex) {

                    NotificationManager.addError(

                        swingManager

                            .getTranslation("problems_exporting_portable_view_to_view"),

                        ex);

                }

            }

        });

    }

    public boolean isEnabled() {

        return true;

    }

    public boolean isVisible() {

        IWindow window = PluginServices.getMDIManager().getActiveWindow();

        return window instanceof PortableViewDocumentViewer;

    }

}

/* 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.portableview.app.editor;

import java.util.ArrayList;

import java.util.List;

import org.gvsig.about.AboutManager;

import org.gvsig.about.AboutParticipant;

import org.gvsig.andami.plugins.Extension;

import org.gvsig.app.ApplicationLocator;

import org.gvsig.app.ApplicationManager;

import org.gvsig.app.project.ProjectManager;

import org.gvsig.app.project.documents.view.ViewManager;

import org.gvsig.educa.portableview.app.editor.document.GeneratePackageOfPortableViewAction;

import org.gvsig.educa.portableview.app.editor.document.OpenRelatedPortableViewAction;

import org.gvsig.educa.portableview.app.editor.document.OpenSourceViewAction;

import org.gvsig.educa.portableview.app.editor.document.RegeneratePortableViewFromViewAction;

import org.gvsig.educa.portableview.app.editor.document.PortableViewToViewAction;

import org.gvsig.educa.portableview.app.editor.document.ViewToPortableViewAction;

import org.gvsig.educa.portableview.app.viewer.PortableViewDocumentManager;

import org.gvsig.educa.portableview.app.viewer.PortableViewExtension;

/**

 * Andami extension which initializes the document actions related to

 * PortableView creation, editing and share.

 *

 * @author gvSIG Team

 * @version $Id$

 */

public class PortableViewEditorExtension extends Extension {

    public void initialize() {

        // Do nothing

    }

    @Override

    public void postInitialize() {

        super.postInitialize();

        // Register Document action

        ProjectManager projectManager = ProjectManager.getInstance();

        // Actions for PortableViewDocuments:

        // Create from view

        projectManager.registerDocumentAction(

            PortableViewDocumentManager.TYPENAME, new PortableViewToViewAction());

        // Open Related document

        projectManager.registerDocumentAction(

            PortableViewDocumentManager.TYPENAME, new OpenSourceViewAction());

        // Regenerate from the view

        projectManager.registerDocumentAction(

            PortableViewDocumentManager.TYPENAME,

            new RegeneratePortableViewFromViewAction());

        // Export to a view

        projectManager.registerDocumentAction(

            PortableViewDocumentManager.TYPENAME,

            new GeneratePackageOfPortableViewAction());

        // Actions for ViewDocuments:

        // Create a Portable View

        projectManager.registerDocumentAction(ViewManager.TYPENAME,

            new ViewToPortableViewAction());

        // Open Related document

        projectManager.registerDocumentAction(ViewManager.TYPENAME,

            new OpenRelatedPortableViewAction());

        // Update the Portable View contents

        projectManager.registerDocumentAction(ViewManager.TYPENAME,

            new RegeneratePortableViewFromViewAction());

        registerAbout();

    }

    /**

    *

    */

    private void registerAbout() {

        // Register the about panel

        ApplicationManager application = ApplicationLocator.getManager();

        AboutManager about = application.getAbout();

        List<AboutParticipant> participants = new ArrayList<AboutParticipant>();

        participants.add(about.addDeveloper("DISID", PortableViewExtension.class

            .getClassLoader().getResource("about/disid.html"), 1));

        participants.add(about.addDeveloper(

            "UdelaR.uy",

            PortableViewExtension.class.getClassLoader().getResource(

                "about/universidad.edu.uy.html"), 1));

        participants.add(about.addSponsor(

            "MTOP.gub.uy",

            PortableViewExtension.class.getClassLoader().getResource(

                "about/MTOP.html"), 1));

        for (AboutParticipant participant : participants) {

            participant

                .addContribution(

                    "PortableViewEditorExtension",

                    "Provides tools to create and generate packages of Portable View",

                    2011, 11, 1, 2012, 2, 29);

        }

    }

    /** {@inheridDoc} */

    public boolean isEnabled() {

        return true;

    }

    /** {@inheridDoc} */

    public boolean isVisible() {

        return true;

    }

    /** {@inheridDoc} */

    public void execute(String actionCommand) {

    }

}

/* 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.portableview.app.editor;

import javax.swing.SwingUtilities;

import org.gvsig.andami.PluginServices;

import org.gvsig.andami.messages.NotificationManager;

import org.gvsig.andami.plugins.Extension;

import org.gvsig.andami.ui.mdiManager.IWindow;

import org.gvsig.app.project.documents.view.ViewDocument;

import org.gvsig.app.project.documents.view.gui.IView;

import org.gvsig.educa.portableview.swing.PortableViewSwingLocator;

import org.gvsig.educa.portableview.swing.PortableViewSwingManager;

/**

 * Andami extension to create a Portable view from a View.

 *

 * @author gvSIG Team

 * @version $Id$

 */

public class NewPortableViewExtension extends Extension {

    private PortableViewEditorManager editorManager;

    private PortableViewSwingManager swingManager;

    public void initialize() {

        // Do nothing

    }

    @Override

    public void postInitialize() {

        editorManager = PortableViewEditorLocator.getManager();

        swingManager = PortableViewSwingLocator.getSwingManager();

    }

    public void execute(String actionCommand) {

        IWindow window = PluginServices.getMDIManager().getActiveWindow();

        if (!(window instanceof IView)) {

            return;

        }

        IView view = (IView) window;

        final ViewDocument viewDocument = (ViewDocument) view.getDocument();

        SwingUtilities.invokeLater(new Runnable() {

            public void run() {

                try {

                    editorManager.createPortableViewFromView(viewDocument, null,

                        true);

                } catch (Exception ex) {

                    NotificationManager.addError(

                        swingManager

                            .getTranslation("problems_creating_portable_view_from_a_view"),

                        ex);

                }

            }

        });

    }

    public boolean isEnabled() {

        return true;

    }

    public boolean isVisible() {

        IWindow window = PluginServices.getMDIManager().getActiveWindow();

        return window instanceof IView;

    }

}

/* 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.portableview.app.editor;

import org.gvsig.andami.PluginServices;

import org.gvsig.andami.ui.mdiManager.IWindow;

import org.gvsig.educa.portableview.app.viewer.ui.PortableViewDocumentViewer;

/**

 * Andami extension which opens source view of a portable view

 *

 * @author gvSIG Team

 * @version $Id$

 *

 */

public class OpenSourceViewExtension extends OpenRelatedDocumentExtension {

    @Override

    public boolean isVisible() {

        IWindow window = PluginServices.getMDIManager().getActiveWindow();

        return window instanceof PortableViewDocumentViewer && super.isVisible();

    }

}

/* 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.portableview.app.editor;

import javax.swing.SwingUtilities;

import org.gvsig.andami.PluginServices;

import org.gvsig.andami.plugins.Extension;

import org.gvsig.andami.ui.mdiManager.IWindow;

import org.gvsig.app.project.documents.Document;

import org.gvsig.app.project.documents.view.gui.IView;

import org.gvsig.educa.portableview.app.viewer.ui.PortableViewDocumentViewer;

/**

 * Abstract Andami extension which opens a the related document: source view of

 * a portable view or related portable view of a view

 *

 * @author gvSIG Team

 * @version $Id$

 */

public abstract class OpenRelatedDocumentExtension extends Extension {

    private PortableViewEditorManager editorManager;

    public void initialize() {

        // Do nothing

    }

    @Override

    public void postInitialize() {

        editorManager = PortableViewEditorLocator.getManager();

    }

    public void execute(String actionCommand) {

        IWindow window = PluginServices.getMDIManager().getActiveWindow();

        final Document docToShow = getRelatedDocument(window);

        if (docToShow == null) {

            return;

        }

        SwingUtilities.invokeLater(new Runnable() {

            public void run() {

                PluginServices.getMDIManager().addWindow(

                    docToShow.getFactory().getMainWindow(docToShow));

            }

        });

    }

    public boolean isEnabled() {

        IWindow window = PluginServices.getMDIManager().getActiveWindow();

        return getRelatedDocument(window) != null;

    }

    /**

     * <p>

     * Returns related document to window

     * </p>

     * <p>

     * if window is a view return the Portable View. if it's a Portable view

     * returns a view.

     * </p>

     *

     * @param window

     * @return

     */

    private Document getRelatedDocument(IWindow window) {

        if (editorManager == null) {

            // initialization process not finished yet

            return null;

        }

        if (window instanceof IView) {

            return editorManager.getPortableViewDocumentByView(((IView) window)

                .getViewDocument());

        } else

            if (window instanceof PortableViewDocumentViewer) {

                return ((PortableViewDocumentViewer) window)

                    .getPortableViewDocument().getSourceView();

            }

        return null;

    }

    public boolean isVisible() {

        IWindow window = PluginServices.getMDIManager().getActiveWindow();

        return window instanceof IView

            || window instanceof PortableViewDocumentViewer;

    }

}

/* 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.portableview.app.editor;

import org.gvsig.educa.portableview.map.PortableView;

import org.gvsig.tools.locator.BaseLocator;

import org.gvsig.tools.locator.Locator;

import org.gvsig.tools.locator.LocatorException;

/**

 * Locator which provide access to the services to create, modify and share

 * {@link PortableView}

 *

 * @author gvSIG team

 * @version $Id$

 */

public class PortableViewEditorLocator extends BaseLocator {

    /**

     * PortableView manager name.

     */

    public static final String MANAGER_NAME = "PortableViewEditor.manager";

    /**

     * PortableView manager description.

     */

    public static final String MANAGER_DESCRIPTION =

        "PortableView Editor Manager";

    private static final String LOCATOR_NAME = "PortableViewEditor.locator";

    /**

     * Unique instance.

     */

    private static final PortableViewEditorLocator INSTANCE =

        new PortableViewEditorLocator();

    /**

     * Return the singleton instance.

     *

     * @return the singleton instance

     */

    public static PortableViewEditorLocator getInstance() {

        return INSTANCE;

    }

    /**

     * Return the Locator's name.

     *

     * @return a String with the Locator's name

     */

    @Override

    public final String getLocatorName() {

        return LOCATOR_NAME;

    }

    /**

     * Return a reference to the PortableViewEditorManager.

     *

     * @return a reference to the PortableViewEditorManager

     * @throws LocatorException

     *             if there is no access to the class or the class cannot be

     *             instantiated

     * @see Locator#get(String)

     */

    public static PortableViewEditorManager getManager() throws LocatorException {

        return (PortableViewEditorManager) getInstance().get(MANAGER_NAME);

    }

    /**

     * Registers the Class implementing the PortableViewEditorManager interface.

     *

     * @param clazz

     *            implementing the PortableViewManager interface

     */

    public static void registerManager(

        Class<? extends PortableViewEditorManager> clazz) {

        getInstance().register(MANAGER_NAME, MANAGER_DESCRIPTION, clazz);

    }

}

/* 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.portableview.app.editor.document;

import java.util.List;

import javax.swing.SwingUtilities;

import org.gvsig.andami.PluginServices;

import org.gvsig.andami.messages.NotificationManager;

import org.gvsig.app.project.ProjectManager;

import org.gvsig.app.project.documents.AbstractDocumentAction;

import org.gvsig.app.project.documents.Document;

import org.gvsig.app.project.documents.view.ViewDocument;

import org.gvsig.educa.portableview.app.editor.PortableViewEditorLocator;

import org.gvsig.educa.portableview.app.editor.PortableViewEditorManager;

import org.gvsig.educa.portableview.app.viewer.PortableViewDocument;

/**

 * <p>

 * Document action which regenerates a Portable View from a View

 * </p>

 *

 * <p>

 * This action can be set on PortableViewDocuments or ViewDocuments

 * </p>

 *

 * @author gvSIG Team

 * @version $Id$

 *

 */

public class RegeneratePortableViewFromViewAction extends AbstractDocumentAction {

    private final PortableViewEditorManager editorManager;

    /**

     *

     */

    public RegeneratePortableViewFromViewAction() {

        super("RegeneratePortableViewFromView");

        this.order = 0;

        this.title =

            PluginServices.getText(this, "regenerate_portable_view_from_a_view");

        this.group =

            ProjectManager.getInstance().addDocumentActionGroup(

                "PortableViewActions", "Portable View actions", null, 0);

        editorManager = PortableViewEditorLocator.getManager();

    }

    /** {@inheridDoc} */

    public boolean isVisible(Document document, List<Document> documents) {

        if (document != null || documents.size() != 1) {

            return false;

        }

        return true;

    }

    /** {@inheridDoc} */

    public boolean isAvailable(Document document, List<Document> documents) {

        Document doc = null;

        if (document != null) {

            doc = document;

        } else {

            if (documents != null && !documents.isEmpty()) {

                doc = documents.get(0);

            }

        }

        if (doc == null) {

            return false;

        }

        if (doc instanceof PortableViewDocument) {

            return ((PortableViewDocument) doc).getSourceView() != null;

        } else

            if (doc instanceof ViewDocument) {

                return editorManager

                    .getPortableViewDocumentByView((ViewDocument) doc) != null;

            }

        return false;

    }

    /** {@inheridDoc} */

    public void execute(Document document, List<Document> documents) {

        Document doc;

        final PortableViewDocument tmDocument;

        if (document != null) {

            doc = document;

        } else {

            if (documents.size() != 1) {

                return;

            }

            doc = documents.get(0);

        }

        if (doc instanceof PortableViewDocument) {

            tmDocument = ((PortableViewDocument) doc);

        } else

            if (doc instanceof ViewDocument) {

                tmDocument =

                    editorManager

                        .getPortableViewDocumentByView((ViewDocument) doc);

                if (tmDocument == null) {

                    return;

                }

            } else {

                return;

            }

        SwingUtilities.invokeLater(new Runnable() {

            public void run() {

                try {

                    editorManager.regeneratePortableView(tmDocument, null, true);

                } catch (Exception ex) {

                    NotificationManager.addError(

                        "problems_exporting_portable_view_to_view", ex);

                }

            }

        });

    }

}

/* 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.portableview.app.editor.document;

import java.util.List;

import javax.swing.SwingUtilities;

import org.gvsig.andami.PluginServices;

import org.gvsig.andami.ui.mdiManager.IWindow;

import org.gvsig.app.project.ProjectManager;

import org.gvsig.app.project.documents.AbstractDocumentAction;

import org.gvsig.app.project.documents.Document;

import org.gvsig.app.project.documents.view.ViewDocument;

import org.gvsig.educa.portableview.app.editor.PortableViewEditorLocator;

import org.gvsig.educa.portableview.app.editor.PortableViewEditorManager;

import org.gvsig.educa.portableview.app.viewer.PortableViewDocument;

/**

 * <p>

 * Document action which opens the Portable View related to a View

 * </p>

 *

 * <p>

 * This action can be set on PortableViewDocuments or ViewDocuments

 * </p>

 *

 * @author gvSIG Team

 * @version $Id$

 *

 */

public class OpenRelatedPortableViewAction extends AbstractDocumentAction {

    private final PortableViewEditorManager editorManager;

    /**

     *

     */

    public OpenRelatedPortableViewAction() {

        super("OpenRelatedPortableView");

        this.order = 0;

        this.title = PluginServices.getText(this, "open_related_portable_view");

        this.group =

            ProjectManager.getInstance().addDocumentActionGroup(

                "PortableViewActions", "Portable View actions", null, 0);

        editorManager = PortableViewEditorLocator.getManager();

    }

    /** {@inheridDoc} */

    public boolean isVisible(Document document, List<Document> documents) {

        if (document != null || documents.size() != 1) {

            return false;

        }

        return true;

    }

    /** {@inheridDoc} */

    public boolean isAvailable(Document document, List<Document> documents) {

        Document doc = null;

        if (document != null) {

            doc = document;

        } else {

            if (documents != null && !documents.isEmpty()) {

                doc = documents.get(0);

            }

        }

        if (doc == null) {

            return false;

        }

        if (doc instanceof ViewDocument) {

            return editorManager

                .getPortableViewDocumentByView((ViewDocument) doc) != null;

        }

        return false;

    }

    /** {@inheridDoc} */

    public void execute(Document document, List<Document> documents) {

        Document doc;

        final IWindow window;

        if (document != null) {

            doc = document;

        } else {

            if (documents.size() != 1) {

                return;

            }

            doc = documents.get(0);

        }

        PortableViewDocument tmDocument;

        if (doc instanceof ViewDocument) {

            tmDocument =

                editorManager.getPortableViewDocumentByView((ViewDocument) doc);

            if (tmDocument == null) {

                return;

            }

            window = tmDocument.getFactory().getMainWindow(tmDocument);

        } else {

            return;

        }

        SwingUtilities.invokeLater(new Runnable() {

            public void run() {

                PluginServices.getMDIManager().addWindow(window);

            }

        });

    }

}

/* 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.portableview.app.editor.document;

import java.util.List;

import javax.swing.SwingUtilities;

import org.gvsig.andami.PluginServices;

import org.gvsig.andami.ui.mdiManager.IWindow;

import org.gvsig.app.project.ProjectManager;

import org.gvsig.app.project.documents.AbstractDocumentAction;

import org.gvsig.app.project.documents.Document;

import org.gvsig.app.project.documents.view.ViewDocument;

import org.gvsig.educa.portableview.app.viewer.PortableViewDocument;

/**

 * <p>

 * Document action which opens the source View of a Portable View

 * </p>

 *

 * <p>

 * This action can be set on PortableViewDocuments or ViewDocuments

 * </p>

 *

 * @author gvSIG Team

 * @version $Id$

 *

 */

public class OpenSourceViewAction extends AbstractDocumentAction {

    /**

     *

     */

    public OpenSourceViewAction() {

        super("OpenSourceViewExtension");

        this.order = 0;

        this.title = PluginServices.getText(this, "open_source_view");

        this.group =

            ProjectManager.getInstance().addDocumentActionGroup(

                "PortableViewActions", "Portable View actions", null, 0);

    }

    /** {@inheridDoc} */

    public boolean isVisible(Document document, List<Document> documents) {

        if (document != null || documents.size() != 1) {

            return false;

        }

        return true;

    }

    /** {@inheridDoc} */

    public boolean isAvailable(Document document, List<Document> documents) {

        Document doc = null;

        if (document != null) {

            doc = document;

        } else {

            if (documents != null && !documents.isEmpty()) {

                doc = documents.get(0);

            }

        }

        if (doc == null) {

            return false;

        }

        if (doc instanceof PortableViewDocument) {

            return ((PortableViewDocument) doc).getSourceView() != null;

        }

        return false;

    }

    /** {@inheridDoc} */

    public void execute(Document document, List<Document> documents) {

        Document doc;

        final IWindow window;

        if (document != null) {

            doc = document;

        } else {

            if (documents.size() != 1) {

                return;

            }

            doc = documents.get(0);

        }

        PortableViewDocument tmDocument;

        if (doc instanceof PortableViewDocument) {

            tmDocument = ((PortableViewDocument) doc);

            ViewDocument view = tmDocument.getSourceView();

            if (view == null) {

                return;

            }

            window = view.getFactory().getMainWindow(view);

        } else {

            return;

        }

        SwingUtilities.invokeLater(new Runnable() {

            public void run() {

                PluginServices.getMDIManager().addWindow(window);

            }

        });

    }

}

/* 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.portableview.app.editor.document;

import java.io.File;

import java.util.List;

import javax.swing.SwingUtilities;

import org.gvsig.andami.PluginServices;

import org.gvsig.andami.messages.NotificationManager;

import org.gvsig.app.project.ProjectManager;

import org.gvsig.app.project.documents.AbstractDocumentAction;

import org.gvsig.app.project.documents.Document;

import org.gvsig.educa.portableview.app.editor.PortableViewEditorLocator;

import org.gvsig.educa.portableview.app.editor.PortableViewEditorManager;

import org.gvsig.educa.portableview.app.viewer.PortableViewDocument;

import org.gvsig.educa.portableview.swing.PortableViewSwingLocator;

import org.gvsig.educa.portableview.swing.PortableViewSwingManager;

import org.gvsig.educa.portableview.swing.PortableViewWindowManager.MESSAGE_DIALOG_TYPE;

/**

 * Document action which launch the process to generate a <i>gvpkg</i> of a

 * Portable View

 *

 * @author gvSIG Team

 * @version $Id$

 *

 */

public class GeneratePackageOfPortableViewAction extends AbstractDocumentAction {

    private final PortableViewEditorManager editorManager;

    private final PortableViewSwingManager swingManager;

    /**

     *

     */

    public GeneratePackageOfPortableViewAction() {

        super("GeneratePackageOfPortableView");

        this.order = 0;

        this.title = PluginServices.getText(this, "generate_package");

        this.group =

            ProjectManager.getInstance().addDocumentActionGroup(

                "PortableViewActions", "Portable View actions", null, 0);

        editorManager = PortableViewEditorLocator.getManager();

        swingManager = PortableViewSwingLocator.getSwingManager();

    }

    /** {@inheridDoc} */

    public boolean isVisible(Document document, List<Document> documents) {

        if (document != null || documents.size() != 1) {

            return false;

        }

        return true;

    }

    /** {@inheridDoc} */

    public boolean isAvailable(Document document, List<Document> documents) {

        return true;

    }

    /** {@inheridDoc} */

    public void execute(Document document, List<Document> documents) {

        final PortableViewDocument tmDocument;

        if (document != null) {

            tmDocument = (PortableViewDocument) document;

        } else {

            if (documents.size() != 1) {

                return;

            }

            tmDocument = (PortableViewDocument) documents.get(0);

        }

        SwingUtilities.invokeLater(new Runnable() {

            public void run() {

                try {

                    File file = editorManager.generatePackage(tmDocument);

                    if (file != null) {

                        swingManager.getWindowManager().showMessageDialog(

                            swingManager.getTranslation("generate_package"),

                            swingManager.getTranslation("generated_file")

                                .concat(":").concat(file.getAbsolutePath()),

                            MESSAGE_DIALOG_TYPE.INFO);

                    }

                } catch (Exception ex) {

                    NotificationManager.addError(

                        "problems_exporting_portable_view_to_view", ex);

                }

            }

        });

    }

}

/* 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.portableview.app.editor.document;

import java.util.List;

import javax.swing.SwingUtilities;

import org.gvsig.andami.PluginServices;

import org.gvsig.andami.messages.NotificationManager;

import org.gvsig.app.project.ProjectManager;

import org.gvsig.app.project.documents.AbstractDocumentAction;

import org.gvsig.app.project.documents.Document;

import org.gvsig.educa.portableview.app.editor.PortableViewEditorLocator;

import org.gvsig.educa.portableview.app.editor.PortableViewEditorManager;

import org.gvsig.educa.portableview.app.viewer.PortableViewDocument;

import org.gvsig.educa.portableview.swing.PortableViewSwingLocator;

import org.gvsig.educa.portableview.swing.PortableViewSwingManager;

/**

 * Document action which exports a Portable View into a view

 *

 * @author gvSIG Team

 * @version $Id$

 *

 */

public class PortableViewToViewAction extends AbstractDocumentAction {

    private final PortableViewEditorManager editorManager;

    private final PortableViewSwingManager swingManager;

    /**

     *

     */

    public PortableViewToViewAction() {

        super("PortableViewToView");

        this.order = 0;

        this.title = PluginServices.getText(this, "export_to_view");

        this.group =

            ProjectManager.getInstance().addDocumentActionGroup(

                "PortableViewActions", "Portable View actions", null, 0);

        editorManager = PortableViewEditorLocator.getManager();

        swingManager = PortableViewSwingLocator.getSwingManager();

    }

    /** {@inheridDoc} */

    public boolean isVisible(Document document, List<Document> documents) {

        if (document != null || documents.size() != 1) {

            return false;

        }

        return true;

    }

    /** {@inheridDoc} */

    public boolean isAvailable(Document document, List<Document> documents) {

        return true;

    }

    /** {@inheridDoc} */

    public void execute(Document document, List<Document> documents) {

        final PortableViewDocument tmDoc;

        if (document != null) {

            tmDoc = (PortableViewDocument) document;

        } else {

            if (documents.size() != 1) {

                return;

            }

            tmDoc = (PortableViewDocument) documents.get(0);

        }

        SwingUtilities.invokeLater(new Runnable() {

            public void run() {

                try {

                    editorManager.exportPortableViewToView(tmDoc, true);

                } catch (Exception ex) {

                    NotificationManager.addError(

                        swingManager

                            .getTranslation("problems_exporting_portable_view_to_view"),

                        ex);