Aplicación gvSIG con fines educativos

<project name="org.gvsig.initial.build" default="prepare-workspace">

	<dirname property="org.gvsig.initial.build.basedir" file="${ant.file.org.gvsig.initial.build}" />

	<property name="workspace.basedir" value="${org.gvsig.initial.build.basedir}/.." />

	<property name="build.basedir" value="${workspace.basedir}/org.gvsig.maven.base.build" description="Eclipse workspace location" />

	<property name="build.jar.version" value="1.0.8-SNAPSHOT" />

	<property name="build.jar.file" value="org.gvsig.maven.base.build-${build.jar.version}.jar" />

	<property name="ant.libs.dir" location="${build.basedir}" description="Additional ant tasks libs folder" />

	<target name="check-maven-base-build-available">

		<available file="${user.home}/.m2/repository/org/gvsig/org.gvsig.maven.base.build/${build.jar.version}/${build.jar.file}" property="maven-base-build-available" />

	</target>

	<target name="get-maven-base-build-local" depends="check-maven-base-build-available" if="maven-base-build-available">

		<!-- Unzip de build jar file from the maven repository into the workspace root folder -->

		<copy todir="${workspace.basedir}" preservelastmodified="false" filtering="false">

			<zipfileset src="${user.home}/.m2/repository/org/gvsig/org.gvsig.maven.base.build/${build.jar.version}/${build.jar.file}">

				<patternset>

					<exclude name="META-INF/**" />

				</patternset>

			</zipfileset>

		</copy>

	</target>

	<target name="get-maven-base-build-remote" depends="check-maven-base-build-available" unless="maven-base-build-available">

		<mkdir dir="target" />

		<!-- Download the build jar file -->

		<get src="http://devel.gvsig.org/m2repo/j2se/org/gvsig/org.gvsig.maven.base.build/${build.jar.version}/${build.jar.file}" dest="target/${build.jar.file}" verbose="true" />

		<!-- Unzip de build jar file into the workspace root folder -->

		<copy todir="${workspace.basedir}" preservelastmodified="false" filtering="false">

			<zipfileset src="target/${build.jar.file}">

				<patternset>

					<exclude name="META-INF/**" />

				</patternset>

			</zipfileset>

		</copy>

	</target>

	<target name="find.depends.natives.file">

	    <condition property="depends.natives.file.exists">

            <available file="${org.gvsig.initial.build.basedir}/DEPENDS_ON_NATIVE_LIBRARIES"/>

	    </condition>	

	</target>

	<target name="find.gvsig.platform.properties.file" 

			depends="find.depends.natives.file"

			if="depends.natives.file.exists">

	    <condition property="gvsig.platform.exists">

            <available file="${user.home}/.gvsig.platform.properties"/>

	    </condition>	

	</target>

	<target name="check.gvsig.platform.properties" 

			depends="find.gvsig.platform.properties.file">

		<fail if="depends.natives.file.exists" unless="gvsig.platform.exists">

ERROR!!

You have to define your gvSIG platform properties, 

by creating the file: ${user.home}/.gvsig.platform.properties

with the following content:

native_platform=linux

native_distribution=all

native_compiler=gcc4

native_arch=i386

native_libraryType=dynamic

export native_classifier=${native_platform}-${native_distribution}-${native_compiler}-${native_arch}-${native_libraryType}

Replace the fifth initial variables values with the ones appropiate 

to your platform.

If you use maven in the command line, you can use the previous file also

to define the MAVEN_OPTS environment variable, by adding to your 

.bash_rc file something like this:

if [ -f "${HOME}/.gvsig.platform.properties" ]

then

    . ${HOME}/.gvsig.platform.properties

    export MAVEN_OPTS="-Xmx256M -XX:MaxPermSize=64m -Dnative-classifier=${native_classifier}"

else

    export MAVEN_OPTS="-Xmx256M -XX:MaxPermSize=64m"

fi

It will work if you use the bash shell. In any other case or platform, you'll

have to define your MAVEN_OPTS environment variable and set the 

"native-classifier" parameter directly.

		</fail>			

	</target>

	<target name="prepare-workspace" depends="get-maven-base-build-local,get-maven-base-build-remote,check.gvsig.platform.properties">

		<mkdir dir="target" />

		<chmod dir="${build.basedir}/maven/bin" perm="u+x" includes="m2,mvn,mvnDebug" />

		<!-- Copy the maven launchers to the workspace metadata folder -->

		<copy todir="${workspace.basedir}/.metadata">

			<fileset dir="${build.basedir}/eclipse-launchers">

				<exclude name="**/org.eclipse.jdt.core.prefs" />

				<exclude name="**/org.eclipse.core.variables.prefs" />

			</fileset>

		</copy>

		<concat destfile="${workspace.basedir}/.metadata/.plugins/org.eclipse.core.runtime/.settings/org.eclipse.jdt.core.prefs" append="true">

			<filelist dir="${build.basedir}/eclipse-launchers/.plugins/org.eclipse.core.runtime/.settings" files="org.eclipse.jdt.core.prefs" />

		</concat>

		<concat destfile="${workspace.basedir}/.metadata/.plugins/org.eclipse.core.runtime/.settings/org.eclipse.core.variables.prefs" append="true">

			<filelist dir="${build.basedir}/eclipse-launchers/.plugins/org.eclipse.core.runtime/.settings" files="org.eclipse.core.variables.prefs" />

		</concat>

		<!-- Configure the eclipse workspace -->

		<ant antfile="${build.basedir}/maven-goals.xml" target="mvn-configure-eclipse-workspace" />

		<!-- Configure the gvSIG profile -->

		<ant antfile="${build.basedir}/check-gvsig-profile.xml" />

		<property name="user-settings-file-location" value="${user.home}/.m2/settings.xml" />

		<taskdef name="xmltask" classname="com.oopsconsultancy.xmltask.ant.XmlTask">

			<classpath>

				<pathelement location="${ant.libs.dir}/com.oopsconsultancy.xmltask-1.16.1.jar" />

			</classpath>

		</taskdef>

		<xmltask source="${user-settings-file-location}" dest="${user-settings-file-location}">

			<copy path="//:settings/:profiles/:profile[:id/text() = 'gvsig-install']/:properties/:gvsig.install.dir/text()" property="current-gvsig-location" />

		</xmltask>

		<replace file="${workspace.basedir}/.metadata/.plugins/org.eclipse.core.runtime/.settings/org.eclipse.jdt.core.prefs" token="@GVSIG_HOME@" value="${current-gvsig-location}" />

		<replace file="${workspace.basedir}/.metadata/.plugins/org.eclipse.core.runtime/.settings/org.eclipse.core.variables.prefs" token="@GVSIG_HOME@" value="${current-gvsig-location}" />

		<!-- Compile, install and generate eclipse projects -->

		<ant antfile="${build.basedir}/maven-goals.xml" target="mvn-install-and-eclipse-eclipse" />

		<echo>INFORMATION!!!</echo>

		<echo>Restart eclipse and then proceed to import the subprojects contained into the main project</echo>

		<!-- TODO: copiar al proyecto de configuración general -->

	</target>

	<target name="clean">

		<delete dir="target" />

	</target>

</project>

<?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>

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

	<packaging>pom</packaging>

	<version>1.0.0-beta1</version>

	<name>org.gvsig.educa.thematicmap</name>

	<description>ThematicMap example project</description>

	<parent>

		<groupId>org.gvsig</groupId>

		<artifactId>org.gvsig.maven.base.pom</artifactId>

		<version>1.0.8-SNAPSHOT</version>

	</parent>

	<properties>

		<thematicmap.version>${project.version}</thematicmap.version>

		<gvsig.version>2.0-SNAPSHOT</gvsig.version>

		<gvsig.i18n.version>2.0.1-SNAPSHOT</gvsig.i18n.version>

		<gvsig.symbology.version>2.0.0-SNAPSHOT</gvsig.symbology.version>

		<gvsig.ui.version>2.0.1-SNAPSHOT</gvsig.ui.version>

		<gvsig.tools.version>3.0.0-SNAPSHOT</gvsig.tools.version>

		<gvsig.timesupport>1.0.0-SNAPSHOT</gvsig.timesupport>

		<gvsig.installer.version>1.0.1-SNAPSHOT</gvsig.installer.version>

		<apache.commons-io.version>1.3.2</apache.commons-io.version>

		<apache.commons-lang3.version>3.1</apache.commons-lang3.version>

	</properties>	

	<scm>

		<connection>scm:svn:https://devel.gvsig.org/svn/gvsig-educa/org.gvsig.educa.thematicmap/trunk/org.gvsig.educa.thematicmap</connection>

		<developerConnection>scm:svn:https://devel.gvsig.org/svn/gvsig-educa/org.gvsig.educa.thematicmap/trunk/org.gvsig.educa.thematicmap</developerConnection>

		<url>https://devel.gvsig.org/redmine/projects/gvsig-educa/repository/show/org.gvsig.educa.thematicmap/trunk/org.gvsig.educa.thematicmap</url>

	</scm>

	<developers>

		<developer>

			<id>cordinyana</id>

			<name>C?sar Ordi?ana</name>

			<email>cordinyana@gvsig.com</email>

			<roles>

				<role>Architect</role>

				<role>Developer</role>

			</roles>

		</developer>

		<developer>

			<id>jmvivo</id>

			<name>Jose Manuel Viv? Arnal</name>

			<email>jmvivo@disid.com</email>

			<roles>

				<role>Analyst</role>

				<role>Developer</role>

			</roles>

		</developer>

	</developers>

	<repositories>

		<repository>

			<id>gvsig-public-http-repository</id>

			<name>gvSIG maven public HTTP repository</name>

			<url>http://devel.gvsig.org/m2repo/j2se</url>

			<releases>

				<enabled>true</enabled>

				<updatePolicy>daily</updatePolicy>

				<checksumPolicy>warn</checksumPolicy>

			</releases>

			<snapshots>

				<enabled>true</enabled>

				<updatePolicy>daily</updatePolicy>

				<checksumPolicy>warn</checksumPolicy>

			</snapshots>

		</repository>

	</repositories>

	<build>

		<plugins>

			<plugin>

				<groupId>org.apache.maven.plugins</groupId>

				<artifactId>maven-release-plugin</artifactId>

				<configuration>

					<tagBase>https://devel.gvsig.org/svn/gvsig-educa/org.gvsig.educa.thematicmap/tags</tagBase>

				</configuration>

			</plugin>

		</plugins>

	</build>

	<dependencyManagement>

		<dependencies>

			<!-- gvSIG educa -->

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.educa.thematicmap.lib.api</artifactId>

				<version>${thematicmap.version}</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.educa.thematicmap.lib.api</artifactId>

				<version>${thematicmap.version}</version>

				<type>test-jar</type>

				<scope>test</scope>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.educa.thematicmap.lib.impl</artifactId>

				<version>${thematicmap.version}</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.educa.thematicmap.lib.prov.installer</artifactId>

				<version>${thematicmap.version}</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.educa.thematicmap.swing.api</artifactId>

				<version>${thematicmap.version}</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.educa.thematicmap.swing.api</artifactId>

				<version>${thematicmap.version}</version>

				<type>test-jar</type>

				<scope>test</scope>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.educa.thematicmap.swing.impl</artifactId>

				<version>${thematicmap.version}</version>

			</dependency>

			<!-- gvSIG -->

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.i18n</artifactId>

				<version>${gvsig.i18n.version}</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.tools.lib</artifactId>

				<version>${gvsig.tools.version}</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.tools.lib</artifactId>

				<version>${gvsig.tools.version}</version>

				<type>test-jar</type>

				<scope>test</scope>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.tools.swing.api</artifactId>

				<version>${gvsig.tools.version}</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.tools.swing.impl</artifactId>

				<version>${gvsig.tools.version}</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.utils</artifactId>

				<version>${gvsig.version}</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.fmap.geometry</artifactId>

				<version>${gvsig.version}</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.fmap.dal</artifactId>

				<version>${gvsig.version}</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.compat</artifactId>

				<version>${gvsig.version}</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.compat</artifactId>

				<version>${gvsig.version}</version>

				<classifier>se</classifier>

				<scope>runtime</scope>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.fmap.mapcontext</artifactId>

				<version>${gvsig.version}</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.fmap.control</artifactId>

				<version>${gvsig.version}</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.symbology.lib.api</artifactId>

				<version>${gvsig.symbology.version}</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.symbology.lib.impl</artifactId>

				<version>${gvsig.symbology.version}</version>

				<scope>runtime</scope>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.fmap.dal.file</artifactId>

				<version>${gvsig.version}</version>

				<scope>compile</scope>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.fmap.dal.file</artifactId>

				<version>${gvsig.version}</version>

				<classifier>store.dbf</classifier>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.fmap.dal.file</artifactId>

				<version>${gvsig.version}</version>

				<classifier>store.shp</classifier>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.fmap.geometry</artifactId>

				<version>${gvsig.version}</version>

				<classifier>impl</classifier>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.projection</artifactId>

				<version>${gvsig.version}</version>

				<classifier>cresques-impl</classifier>

				<scope>test</scope>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.timesupport.lib.impl</artifactId>

				<version>${gvsig.timesupport}</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.ui</artifactId>

				<version>${gvsig.ui.version}</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.fmap.dal.db</artifactId>

				<version>${gvsig.version}</version>

				<scope>runtime</scope>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.fmap.dal.db</artifactId>

				<version>${gvsig.version}</version>

				<classifier>store.jdbc</classifier>

				<scope>runtime</scope>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.fmap.dal.db</artifactId>

				<version>${gvsig.version}</version>

				<classifier>store.postgresql</classifier>

				<scope>runtime</scope>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.fmap.dal.db</artifactId>

				<version>${gvsig.version}</version>

				<classifier>store.mysql</classifier>

				<scope>runtime</scope>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.installer.lib.api</artifactId>

				<version>${gvsig.installer.version}</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.installer.lib.spi</artifactId>

				<version>${gvsig.installer.version}</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.installer.lib.impl</artifactId>

				<version>${gvsig.installer.version}</version>

				<scope>runtime</scope>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.installer.swing.api</artifactId>

				<version>${gvsig.installer.version}</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.installer.swing.impl</artifactId>

				<version>${gvsig.installer.version}</version>

				<scope>runtime</scope>

			</dependency>

			<!-- apache commons -->

			<dependency>

				<groupId>org.apache.commons</groupId>

				<artifactId>commons-io</artifactId>

				<version>${apache.commons-io.version}</version>

			</dependency>

			<dependency>

				<groupId>org.apache.commons</groupId>

				<artifactId>commons-lang3</artifactId>

				<version>${apache.commons-lang3.version}</version>

			</dependency>

		</dependencies>

	</dependencyManagement>

	<dependencies>

		<dependency>

			<groupId>org.gvsig</groupId>

			<artifactId>org.gvsig.tools.lib</artifactId>

		</dependency>

		<dependency>

			<groupId>org.gvsig</groupId>

			<artifactId>org.gvsig.tools.lib</artifactId>

			<type>test-jar</type>

		</dependency>

		<dependency>

			<groupId>org.slf4j</groupId>

			<artifactId>slf4j-api</artifactId>

			<scope>compile</scope>

		</dependency>

	</dependencies>

	<modules>

		<module>org.gvsig.educa.thematicmap.lib</module>

		<module>org.gvsig.educa.thematicmap.swing</module>

		<module>org.gvsig.educa.thematicmap.main</module>

	</modules>

</project>

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

gvSIG Educa

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

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

Thematic Map

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

Description

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

This folder contains the sources of the Thematic Map functionality.

Requirements

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

* Maven 2.6 or higher

* Java JDK 1.5 or higher

For eclipse

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

See `developer guide at gvSIG.org <https://gvsig.org/web/projects/gvsig-desktop/docs/devel/gvsig-devel-guide/2.0.0/>`_ and the file ``REAME-ECLIPSE.txt``

Contents

==========

org.gvsig.educa.thematicmap.lib

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

Functionality sources. This project just contain the main process and the logic without any dependency with User Interface.

org.gvsig.educa.thematicmap.swing

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

User Interface components to access a manage the application services.

org.gvsig.educa.thematicmap.main

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

Little test application which allow run the main functionality of application.

See `Execute little test application`_ to know how run it.

pom.xml

---------

Maven project definition file

prepare-workspace.xml and README-ECLIPSE.txt

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

Instructions and utilities to work with eclipse

README.rst

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

This file (in reStructureText format, for more info this format look at `gvSIG portal <https://gvsig.org/web/projects/gvsig-desktop/docs/devel/guia-para-documentar/el-formato-restructuredtext>`_  or at `docUtils reference <http://docutils.sourceforge.net/rst.html>`_)

Compilation

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

From shell

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

Execute this command::

    org.gvsig.educa.thematicmap$ mvn clean install

From eclipse

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

See `work in a proyect of the developer guide at gvSIG.org <https://gvsig.org/web/projects/gvsig-desktop/docs/devel/gvsig-devel-guide/2.0.0/trabajar-con-un-proyecto>`_

In some project, could be better use ``mvn eclipse:clean eclipse:eclipse``  than import project as a *Maven project*. Maven plugin of eclipse does not set classpath correctly in some project. 

Packing

========

This functionality has no stand-alone packing process.

Version 

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

To changes version number just set in in ``project/version`` tag of *pom.xml* in this folder. Sub-projects will inherit it.

Version polity is the standard in project. Changes in version number:

* third number: Bug fixes and minors improvements. API must have no changes from previous version.

* second number: Bug fixes and mayor improvements. API can have minor changes. Previously deprecated classes could be removed. No architectural changes.

* first number: Mayor changes.

Create a tag

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

TODO: use *maven release* plugin

Use svn copy command to copy version in server. Process could be like this:

#. Check that there ins no changes in workspace::

   svn up ; svn status

#. Check that project compiles and passes all test.

   mvn clean install

#. Update *pom.xml* to set version of tag (usually removing *-SNAPSHOT*)

#. create tag folder on server::

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

#. Copy current workcopy to tag folder::

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

#. Update *pom.xml* to next version

#. Commit *pom.xml* changes::

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

i18n

======

The files for internationalization can be found in this folders:

+ *org.gvsig.educa.thematicmap.app.viewer/src/main/resources*

+ *org.gvsig.educa.thematicmap.app.editor/src/main/resources*

The internationalization of this application is based on standard java resource bundle mechanism. So, to add a new language just add the file with the language code to every related folder.

Execute little test application

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

From shell

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

After compile the application, execute this command::

    org.gvsig.educa.thematicmap$ cd org.gvsig.educa.thematicmap.main

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

Form eclipse

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

Select ``org.gvsig.educa.thematicmap.main`` project in *Project tree* using *Java perspective*, click with right mouse button and select ``Run as.../Java application``. Select ``Main`` class for project.

The first time you checkout the current project to a new workspace, 

you have to prepare it to be able to work easily with maven from

eclipse itself.

Perform the following steps:

1.- Launch the *prepare-workspace.xml* ant build file. 

    You can do it by loading the file into the ant view, 

    and running the default task, or right-clicking the 

    file from the package explorer or the navigator and

    select the option: *Run as > Ant build*. 

2.- Restart eclipse.

3.- Import the subprojects of the project you have just checked out.

Those steps are only needed once per workspace.     

/* 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.main;

import java.awt.BorderLayout;

import java.awt.Dimension;

import java.awt.event.ActionEvent;

import java.util.ArrayList;

import java.util.List;

import javax.swing.AbstractAction;

import javax.swing.Box;

import javax.swing.BoxLayout;

import javax.swing.JButton;

import javax.swing.JLabel;

import javax.swing.JList;

import javax.swing.JPanel;

import javax.swing.JScrollPane;

import javax.swing.ListSelectionModel;

import javax.swing.event.ListSelectionEvent;

import javax.swing.event.ListSelectionListener;

import org.gvsig.educa.thematicmap.map.ThematicMap;

import org.gvsig.educa.thematicmap.swing.ThematicMapSwingLocator;

import org.gvsig.educa.thematicmap.swing.ThematicMapSwingManager;

import org.gvsig.educa.thematicmap.swing.viewer.ThematicMapInforamtionViewer;

import org.gvsig.tools.swing.api.ToolsSwingLocator;

import org.gvsig.tools.swing.api.dynobject.DynObjectSwingManager;

import org.gvsig.tools.swing.api.usability.UsabilitySwingManager;

/**

 * Open Thematic Map dialog

 * 

 * @author gvSIG Team

 * @version $Id$

 * 

 */

public class OpenThematicMap extends JPanel implements ListSelectionListener {

    /**

     *

     */

    private static final long serialVersionUID = 1L;

    private static final org.slf4j.Logger LOG = org.slf4j.LoggerFactory

        .getLogger(OpenThematicMap.class);

    private final ThematicMapSwingManager swingManager;

    private final DynObjectSwingManager dynSwingManager;

    private final UsabilitySwingManager usabManager;

    private final Main main;

    private List<ThematicMap> maps;

    private final List<String> mapNames;

    private JPanel listPanel;

    private JList list;

    private JPanel informationPanel;

    private ThematicMapInforamtionViewer information;

    private JPanel actionPanel;

    private JButton botOpen;

    private JButton botCancel;

    private ThematicMap curMap;

    private int lastSelectedIndex;

    private JPanel container;

    public OpenThematicMap(Main main, List<ThematicMap> installedMaps) {

        super();

        this.main = main;

        swingManager = ThematicMapSwingLocator.getSwingManager();

        dynSwingManager = ToolsSwingLocator.getDynObjectSwingManager();

        usabManager = ToolsSwingLocator.getUsabilitySwingManager();

        maps = installedMaps;

        mapNames = new ArrayList<String>(installedMaps.size());

        for (ThematicMap map : maps) {

            mapNames.add(map.getInformation().getName());

        }

        curMap = null;

        lastSelectedIndex = -1;

        initializeUI();

    }

    /**

     * Initialize user interface

     * 

     */

    private void initializeUI() {

        setLayout(new BorderLayout(5, 5));

        setMaximumSize(new Dimension(300, 200));

        setPreferredSize(new Dimension(800, 600));

        list = new JList(mapNames.toArray());

        list.setSelectionMode(ListSelectionModel.SINGLE_SELECTION);

        list.addListSelectionListener(this);

        listPanel = new JPanel();

        listPanel.setLayout(new BorderLayout(5, 5));

        listPanel.add(new JLabel("Thematic Maps availables:"),

            BorderLayout.NORTH);

        listPanel.add(list, BorderLayout.CENTER);

        add(new JScrollPane(listPanel), BorderLayout.WEST);

        informationPanel = new JPanel();

        informationPanel.setLayout(new BorderLayout(5, 5));

        informationPanel.add(new JLabel("Thematic Map information:"),

            BorderLayout.NORTH);

        information = swingManager.newInformationViewer();

        informationPanel.add(information.getSwingComponent(),

            BorderLayout.CENTER);

        add(informationPanel, BorderLayout.CENTER);

        actionPanel = new JPanel();

        BoxLayout actionPanelLayout =

            new BoxLayout(actionPanel, BoxLayout.X_AXIS);

        actionPanel.setLayout(actionPanelLayout);

        actionPanel.add(Box.createHorizontalGlue());

        botOpen = usabManager.createJButton(new AbstractAction("Open Map") {

            /**

             *

             */

            private static final long serialVersionUID = -3437007146684939225L;

            public void actionPerformed(ActionEvent e) {

                openSelected();

            }

        });

        botOpen.setEnabled(false);

        botCancel = usabManager.createJButton(new AbstractAction("Cancel") {

            /**

             *

             */

            private static final long serialVersionUID = -2227776656041247582L;

            public void actionPerformed(ActionEvent e) {

                close();

            }

        });

        actionPanel.add(botOpen);

        actionPanel.add(Box.createHorizontalStrut(10));

        actionPanel.add(botCancel);

        actionPanel.add(Box.createHorizontalStrut(5));

        add(actionPanel, BorderLayout.SOUTH);

    }

    /**

     * Opens selected thematic map

     */

    private void openSelected() {

        if (curMap == null) {

            return;

        }

        main.openMap(curMap);

        close();

    }

    /**

     * Close this dialog

     */

    private void close() {

        this.setVisible(false);

        maps = null;

        curMap = null;

    }

    /**

     * Update UI with Thematic list selection

     */

    public void valueChanged(ListSelectionEvent e) {

        int index = list.getSelectedIndex();

        if (index == lastSelectedIndex) {

            return;

        }

        lastSelectedIndex = index;

        if (index < 0) {

            if (information != null) {

                information.clean();

            }

            botOpen.setEnabled(false);

            return;

        }

        botOpen.setEnabled(true);

        curMap = maps.get(index);

        information.loadMapInfromation(curMap);

    }

}

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">

<head>

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />

<title>org.gvsig.educa.thematicmap package documentation</title>

</head>

<body>

	<p>ThematicMap library testing and demo application.</p>

</body>

</html>

/* 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.main;

import org.gvsig.educa.thematicmap.swing.viewer.MapControlToolRegistrant;

import org.gvsig.fmap.mapcontrol.MapControl;

import org.gvsig.fmap.mapcontrol.tools.PanListenerImpl;

import org.gvsig.fmap.mapcontrol.tools.ZoomInListenerImpl;

import org.gvsig.fmap.mapcontrol.tools.ZoomOutRightButtonListener;

import org.gvsig.fmap.mapcontrol.tools.Behavior.Behavior;

import org.gvsig.fmap.mapcontrol.tools.Behavior.MouseWheelBehavior;

import org.gvsig.fmap.mapcontrol.tools.Behavior.MoveBehavior;

import org.gvsig.fmap.mapcontrol.tools.Behavior.PointBehavior;

import org.gvsig.fmap.mapcontrol.tools.Behavior.RectangleBehavior;

/**

 * @author gvSIG Team

 * @version $Id$

 * 

 */

public class MapToolsRegistrant implements MapControlToolRegistrant {

    public static final String TOOL_ZOOM_ID = "zoom";

    public static final String TOOL_PAN_ID = "pan";

    public void registerTools(MapControl mapControl) {

        // Adds tools to mapControl

        // mouseWhell

        mapControl.addCombinedBehavior(new MouseWheelBehavior());

        // zoom

        mapControl.addBehavior(TOOL_ZOOM_ID, new Behavior[] {

            new RectangleBehavior(new ZoomInListenerImpl(mapControl)),

            new PointBehavior(new ZoomOutRightButtonListener(mapControl)) });

        // pan

        mapControl.addBehavior(TOOL_PAN_ID, new MoveBehavior(

            new PanListenerImpl(mapControl)));

        mapControl.setTool(TOOL_PAN_ID);

    }

}

/* 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.main;

import java.awt.BorderLayout;

import java.awt.Dimension;

import java.awt.event.ActionEvent;

import java.io.File;

import java.io.IOException;

import java.net.URL;

import java.util.List;

import javax.swing.AbstractAction;

import javax.swing.Box;

import javax.swing.JButton;

import javax.swing.JFileChooser;

import javax.swing.JFrame;

import javax.swing.JMenu;

import javax.swing.JMenuBar;

import javax.swing.JMenuItem;

import javax.swing.JToolBar;

import javax.swing.WindowConstants;

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

import org.gvsig.educa.thematicmap.ThematicMapLocator;

import org.gvsig.educa.thematicmap.ThematicMapManager;

import org.gvsig.educa.thematicmap.compilation.ThematicMapCompilation;

import org.gvsig.educa.thematicmap.compilation.ThematicMapCompiler;

import org.gvsig.educa.thematicmap.compilation.ThematicMapCompilerListener;

import org.gvsig.educa.thematicmap.compilation.ThematicMapCompilerStatus;

import org.gvsig.educa.thematicmap.map.ThematicMap;

import org.gvsig.educa.thematicmap.swing.ThematicMapSwingLocator;

import org.gvsig.educa.thematicmap.swing.ThematicMapSwingManager;

import org.gvsig.educa.thematicmap.swing.ThematicMapWindowManager;

import org.gvsig.educa.thematicmap.swing.ThematicMapWindowManager.CONFIRM_DIALOG_OPTION;

import org.gvsig.educa.thematicmap.swing.ThematicMapWindowManager.CONFIRM_DIALOG_TYPE;

import org.gvsig.educa.thematicmap.swing.ThematicMapWindowManager.MESSAGE_DIALOG_TYPE;

import org.gvsig.educa.thematicmap.swing.editor.ThematicMapCompilationEditor;

import org.gvsig.educa.thematicmap.swing.editor.ThematicMapCompilationEditorListener;

import org.gvsig.educa.thematicmap.swing.viewer.ThematicMapViewer;

import org.gvsig.installer.swing.api.SwingInstallerLocator;

import org.gvsig.installer.swing.api.SwingInstallerManager;

import org.gvsig.installer.swing.api.execution.InstallPackageWizardException;

import org.gvsig.installer.swing.api.wizard.AbstractInstallerWizard;

import org.gvsig.tools.ToolsLocator;

import org.gvsig.tools.dispose.DisposableManager;

import org.gvsig.tools.exception.BaseException;

import org.gvsig.tools.library.impl.DefaultLibrariesInitializer;

import org.gvsig.tools.swing.api.ToolsSwingLocator;

import org.gvsig.tools.swing.api.usability.UsabilitySwingManager;

import org.gvsig.tools.swing.api.windowmanager.WindowManager.MODE;

/**

 * Main executable class for testing the ThematicMap library.

 * 

 * @author gvSIG Team

 * @version $Id$

 */

public class Main {

    private static final Logger LOG = LoggerFactory.getLogger(Main.class);

    private final ThematicMapManager manager;

    private final ThematicMapSwingManager swingManager;

    private final ThematicMapWindowManager winManager;

    private final UsabilitySwingManager usabManager;

    private final DisposableManager disposeManager;

    private final SwingInstallerManager swingInstallerManager;

    private final JFileChooser fileChooser;

    private JFrame mainFrame;

    private ThematicMapViewer curViewer = null;

    private AbstractAction setPanToolAction;

    private AbstractAction setZoomToolAction;

    private AbstractAction zoomAllAction;

    private AbstractAction setThematiMapFolderAction;

    private AbstractAction showOpenThematicMapDialogAction;

    private AbstractAction exitAction;

    private AbstractAction closeThematicMapAction;

    private AbstractAction createCompilationAction;

    private AbstractAction createCompilationFromMapAction;

    private AbstractAction installThematicMaps;

    private AbstractAction addInstallUrl;

    public static void main(String args[]) {

        new DefaultLibrariesInitializer().fullInitialize();

        Main main = new Main();

        main.show();

    }

    /**

     * New instance of Main

     */

    public Main() {

        manager = ThematicMapLocator.getManager();

        swingManager = ThematicMapSwingLocator.getSwingManager();

        winManager = swingManager.getWindowManager();

        usabManager = ToolsSwingLocator.getUsabilitySwingManager();

        disposeManager = ToolsLocator.getDisposableManager();

        swingInstallerManager =

            SwingInstallerLocator.getSwingInstallerManager();

        String defaultFolderPath =

            "gvSIG/plugins/org.gvsig.educa.thematicmap.app.viewer/thematicMaps";

        File defaultFolder =

            new File(System.getProperty("user.home"), defaultFolderPath);

        if (defaultFolder.exists() && defaultFolder.isDirectory()) {

            manager.setInstallationMapFolder(defaultFolder.getAbsolutePath());

        }

        swingManager.addMapControlRegistrant(new MapToolsRegistrant());

        fileChooser = new JFileChooser();

    }

    /**

     * Shows main frame

     */

    public void show() {

        // Create actions

        createActions();

        // Create JFrame to show data

        mainFrame = new JFrame("ThematicMap example app");

        mainFrame.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);

        mainFrame.setLayout(new BorderLayout(10, 10));

        // Create menu bar

        createMenu();

        // Create tools bar

        createToolBar();

        updateControls();

        // Display the window.

        mainFrame.pack();

        mainFrame.setSize(800, 600);

        mainFrame.setVisible(true);

    }

    /**

     * Creates all the action for menu and tools bar

     * 

     */

    @SuppressWarnings("serial")

    private void createActions() {

        setThematiMapFolderAction =

            new AbstractAction("Set thematic map folder") {

                public void actionPerformed(ActionEvent e) {

                    setThematicMapFolder();

                }

            };

        showOpenThematicMapDialogAction =

            new AbstractAction("Open a Thematic Map") {

                public void actionPerformed(ActionEvent e) {

                    showOpenThematicMapDialog();

                }

            };

        showOpenThematicMapDialogAction.setEnabled(false);

        setZoomToolAction = new AbstractAction("Tool Zoom") {

            public void actionPerformed(ActionEvent e) {

                setZoomTool();

            }

        };

        setZoomToolAction.setEnabled(false);

        setPanToolAction = new AbstractAction("Tool Pan") {

            public void actionPerformed(ActionEvent e) {

                setPanTool();

            }

        };

        setPanToolAction.setEnabled(false);

        zoomAllAction = new AbstractAction("Zoom all") {

            public void actionPerformed(ActionEvent e) {

                zoomAll();

            }

        };

        zoomAllAction.setEnabled(false);

        closeThematicMapAction = new AbstractAction("Close Map") {

            public void actionPerformed(ActionEvent e) {

                closeMap();

            }

        };

        closeThematicMapAction.setEnabled(false);

        exitAction = new AbstractAction("Exit") {

            public void actionPerformed(ActionEvent e) {

                exit();

            }

        };

        createCompilationAction = new AbstractAction("Create a compilation") {

            public void actionPerformed(ActionEvent e) {

                createCompilation();

            }

        };

        createCompilationAction.setEnabled(false);

        createCompilationFromMapAction =

            new AbstractAction("Create compilation from current map") {

                public void actionPerformed(ActionEvent e) {

                    createCompilationFromMap();

                }

            };

        createCompilationFromMapAction.setEnabled(false);

        addInstallUrl = new AbstractAction("Add a ThematicMap install URL") {

            public void actionPerformed(ActionEvent e) {

                addThematicMapUrl();

            }

        };

        installThematicMaps = new AbstractAction("Install ThematicMaps") {

            public void actionPerformed(ActionEvent e) {

                installThematicMap();

            }

        };

        installThematicMaps.setEnabled(false);

    }

    /**

     * Creates the menu bar

     */

    private void createMenu() {

        // Create the menu bar.

        JMenuBar menuBar = new JMenuBar();

        // Build the menu.

        JMenu menuFile = new JMenu("File");

        menuFile.add(new JMenuItem(setThematiMapFolderAction));

        menuFile.addSeparator();

        menuFile.add(new JMenuItem(showOpenThematicMapDialogAction));

        menuFile.add(new JMenuItem(closeThematicMapAction));

        menuFile.addSeparator();

        menuFile.add(new JMenuItem(createCompilationAction));

        menuFile.add(new JMenuItem(createCompilationFromMapAction));

        menuFile.addSeparator();

        menuFile.add(new JMenuItem(addInstallUrl));

        menuFile.add(new JMenuItem(installThematicMaps));

        menuFile.addSeparator();

        menuFile.add(new JMenuItem(exitAction));

        JMenu menuViewer = new JMenu("Viewer");

        menuViewer.add(setPanToolAction);

        menuViewer.add(setZoomToolAction);

        menuViewer.addSeparator();

        menuViewer.add(zoomAllAction);

        menuBar.add(menuFile);

        menuBar.add(menuViewer);

        mainFrame.setJMenuBar(menuBar);

    }

    /**

     * Creates the tools bar

     */

    private void createToolBar() {

        Dimension sepSize = new Dimension(20, 5);

        JToolBar toolBar = new JToolBar();

        toolBar.add(usabManager.createJButton(showOpenThematicMapDialogAction));

        toolBar.add(usabManager.createJButton(closeThematicMapAction));

        toolBar.addSeparator(sepSize);

        toolBar.add(usabManager.createJButton(setPanToolAction));

        toolBar.add(usabManager.createJButton(setZoomToolAction));

        toolBar.addSeparator(sepSize);

        toolBar.add(usabManager.createJButton(zoomAllAction));

        toolBar.add(Box.createHorizontalGlue());

        toolBar.add(new JButton(exitAction));

        mainFrame.add(toolBar, BorderLayout.PAGE_START);

    }

    /**

     * Shows file chooser to select thematic map folder

     */

    public void setThematicMapFolder() {

        fileChooser.setFileSelectionMode(JFileChooser.DIRECTORIES_ONLY);

        int result =

            fileChooser.showDialog(mainFrame, "Select ThematicMap folder");

        if (result != JFileChooser.APPROVE_OPTION) {

            return;

        }

        File folder = fileChooser.getSelectedFile();

        List<ThematicMap> maps =

            manager.getInstalledMaps(folder.getAbsolutePath());

        if (maps.isEmpty()) {

            LOG.info("No maps foudn in required folder: {}",

                folder.getAbsolutePath());

            CONFIRM_DIALOG_OPTION resp =

                winManager.showConfirmDialog(mainFrame,

                    "No maps found. Select this folder anyway?",

                    "Set ThematicMap folder", CONFIRM_DIALOG_TYPE.YES_NO,

                    MESSAGE_DIALOG_TYPE.WARNING);

            if (resp != CONFIRM_DIALOG_OPTION.OK_YES) {

                return;

            }

        }

        LOG.info("Selected map folder: {}", folder.getAbsolutePath());

        try {

            manager.setInstallationMapFolder(folder.getAbsolutePath());

        } catch (Exception e) {

            LOG.error("Error setting thematic map folder", e);

            winManager

                .showMessageDialog(

                    mainFrame,

                    "Setting folder",

                    "Problem foudn setting Thematic Map folder (See log for more information)",

                    MESSAGE_DIALOG_TYPE.ERROR);

        }

        updateControls();

    }

    /**

     * Shows a dialog to select a Thematic Map to open

     */

    public void showOpenThematicMapDialog() {

        if (manager.getInstallationMapFolder() == null) {

            LOG.warn("thematic map folder not set on open Thematic Map request");

            winManager.showMessageDialog(mainFrame, "Open a Thematic Map",

                "Select a Thematic Map folder first", MESSAGE_DIALOG_TYPE.INFO);

            return;

        }

        OpenThematicMap openThematicMap =

            new OpenThematicMap(this, manager.getInstalledMaps());

        winManager.showWindow(openThematicMap, "Open a Thematic Map...",

            MODE.DIALOG);

    }

    /**

     * Opens a thematic map in main frame

     * 

     * @param curMap

     * @return

     */

    public boolean openMap(ThematicMap curMap) {

        ThematicMapViewer viewer;

        try {

            viewer = swingManager.getViewer(curMap);

        } catch (Exception e) {

            LOG.error("Can't open map", e);

            winManager.showMessageDialog(mainFrame, "Open Thematic map",

                "Problem found opening map (see log for details)",

                MESSAGE_DIALOG_TYPE.ERROR);

            return false;

        }

        doCloseMap();

        mainFrame.add(viewer.getSwingComponent(), BorderLayout.CENTER);

        curViewer = viewer;

        updateControls();

        return true;

    }

    /**

     * Closes the current thematic map

     */

    public void closeMap() {

        doCloseMap();

        updateControls();

    }

    /**

     * Removes thematic map view from main frame

     */

    private void doCloseMap() {

        if (curViewer != null) {

            mainFrame.remove(curViewer.getSwingComponent());

            try {

                curViewer.getThematicMap().close();

            } catch (IOException e) {

                LOG.warn("Exception clossing map", e);

            }

            curViewer = null;

        }

    }

    /**

     * Update actions ability and updates main frame content

     */

    public void updateControls() {

        showOpenThematicMapDialogAction.setEnabled(manager

            .getInstallationMapFolder() != null);

        createCompilationAction

            .setEnabled(manager.getInstallationMapFolder() != null);

        createCompilationFromMapAction.setEnabled(curViewer != null);

        setZoomToolAction.setEnabled(curViewer != null);

        setPanToolAction.setEnabled(curViewer != null);

        closeThematicMapAction.setEnabled(curViewer != null);

        zoomAllAction.setEnabled(curViewer != null);

        installThematicMaps

            .setEnabled(manager.getInstallationMapFolder() != null);

        mainFrame.getContentPane().invalidate();

        mainFrame.doLayout();

        Dimension d = mainFrame.getSize();

        d.width--;

        mainFrame.setSize(d);

        d.width++;

        mainFrame.setSize(d);

    }

    /**

     * Sets the zoom tool

     */

    public void setZoomTool() {

        if (curViewer != null) {

            curViewer.setTool(MapToolsRegistrant.TOOL_ZOOM_ID);

        }

    }

    /**

     * Sets the pan tool

     */

    public void setPanTool() {

        if (curViewer != null) {

            curViewer.setTool(MapToolsRegistrant.TOOL_PAN_ID);

        }

    }

    /**

     * Zoom to all thematic map contents

     */

    public void zoomAll() {

        if (curViewer != null) {

            curViewer.zoomAll();

        }

    }

    /**

     * Exit from app

     */

    public void exit() {

        // Close current thematic map

        closeMap();

        // clean resources

        try {

            disposeManager.releaseAll();

        } catch (BaseException e) {

            LOG.warn("Problems dispossing", e);

        }

        try {

            Thread.sleep(200);

        } catch (InterruptedException e) {

            // Do nothing

        }