Application: gvSIG desktop

<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.6-SNAPSHOT" />

	<property name="build.jar.file" 

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

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

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

		       dest="${workspace.basedir}">

		    <patternset>

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

		    </patternset>

		</unzip>	

	</target>

	<target name="get-maven-base-build-remote" 

			depends="check-maven-base-build-available"

			unless="maven-base-build-available">

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

		<get src="http://gvsig-desktop.forge.osor.eu/downloads/pub/projects/gvSIG-desktop/maven-repository/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 -->

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

		       dest="${workspace.basedir}">

		    <patternset>

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

		    </patternset>

		</unzip>	

	</target>

	<target name="prepare-workspace" depends="get-maven-base-build-local,get-maven-base-build-remote">

		<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"/>

		</copy>

		<!-- 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" target="initialize"/>

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

	<groupId>org.gvsig</groupId>

	<artifactId>org.gvsig.annotation</artifactId>

	<packaging>pom</packaging>

	<version>1.0.0-SNAPSHOT</version>

	<name>org.gvsig.annotation</name>

	<description>Annotation example project</description>

	<url>http://gvsig-desktop.forge.osor.eu/downloads/pub/projects/gvSIG-desktop/docs/reference/org.gvsig.annotation/${pom.version}/basic/org.gvsig.annotation</url>

	<parent>

		<groupId>org.gvsig</groupId>

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

		<version>1.0.6-SNAPSHOT</version>

	</parent>

	<scm>

		<connection>scm:svn:https://svn.forge.osor.eu/svn/gvsig-annotation/org.gvsig.annotation/library/trunk</connection>

		<developerConnection>scm:svn:https://svn.forge.osor.eu/svn/gvsig-annotation/org.gvsig.annotation/library/trunk</developerConnection>

		<url>https://forge.osor.eu/plugins/scmsvn/viewcvs.php/org.gvsig.annotation/library/trunk/?root=gvsig-annotation</url>

	</scm>

	<developers>

		<developer>

			<id>jpiera</id>

			<name>Jorge Piera</name>

			<email>jpiera@gvsig.org</email>

			<roles>

				<role>Architect</role>

				<role>Developer</role>

			</roles>

		</developer>

		<developer>

			<id>jjdelcerro</id>

			<name>Joaqu?n Jos? del Cerro</name>

			<email>jjdelcerro@gvsig.org</email>

			<roles>

				<role>Architect</role>			

			</roles>

		</developer>		

	</developers>

	<distributionManagement>

		<site>

			<id>gvsig-repository</id>

			<url>scp://shell.forge.osor.eu/home/groups/gvsig-desktop/www/downloads/pub/projects/gvSIG-desktop/docs/reference/org.gvsig.annotation/${pom.version}/basic/org.gvsig.annotation</url>

		</site>

	</distributionManagement>

	<repositories>

		<repository>

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

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

			<url>http://gvsig-desktop.forge.osor.eu/downloads/pub/projects/gvSIG-desktop/maven-repository</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://svn.forge.osor.eu/svn/gvsig-annotation/org.gvsig.annotation/library/tags</tagBase>

				</configuration>

			</plugin>

		</plugins>

	</build>

	<dependencyManagement>

		<dependencies>

			<dependency>

				<groupId>org.gvsig</groupId>

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

				<version>2.0-SNAPSHOT</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

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

				<version>2.0-SNAPSHOT</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

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

				<version>2.0-SNAPSHOT</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

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

				<version>2.0-SNAPSHOT</version>	

				<classifier>store.shp</classifier>		

			</dependency>	

			<dependency>

				<groupId>org.gvsig</groupId>

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

				<version>2.0-SNAPSHOT</version>	

				<classifier>store.dbf</classifier>		

			</dependency>			

			<dependency>

				<groupId>org.gvsig</groupId>

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

				<version>2.0-SNAPSHOT</version>	

				<classifier>spi</classifier>		

			</dependency>		

			<dependency>

				<groupId>org.gvsig</groupId>

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

				<version>2.0-SNAPSHOT</version>	

				<classifier>impl</classifier>		

			</dependency>	

			<dependency>

				<groupId>org.gvsig</groupId>

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

				<version>2.0-SNAPSHOT</version>	

				<classifier>tests</classifier>		

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.metadata</artifactId>

				<version>2.0-SNAPSHOT</version>					

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

				<artifactId>org.gvsig.metadata</artifactId>

				<version>2.0-SNAPSHOT</version>

				<classifier>simple</classifier>				

			</dependency>

			<dependency>

            	<groupId>org.gvsig</groupId>

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

            	<version>2.0-SNAPSHOT</version>

            	<classifier>cresques-impl</classifier>            	

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

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

				<version>2.0-SNAPSHOT</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

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

				<version>2.0-SNAPSHOT</version>

				<classifier>impl</classifier>				

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

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

				<version>2.0-SNAPSHOT</version>

				<classifier>operation</classifier>				

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

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

				<version>2.0-SNAPSHOT</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

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

				<version>2.0-SNAPSHOT</version>

				<classifier>se</classifier>				

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

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

				<version>2.1.0-SNAPSHOT</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

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

				<type>test-jar</type>

				<version>2.1.0-SNAPSHOT</version>

			</dependency>	

			<dependency>

				<groupId>jwizardcomponent</groupId>

				<artifactId>jwizardcomponent</artifactId>

				<version>1.2.2</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

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

				<version>2.0-SNAPSHOT</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

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

				<version>2.0-SNAPSHOT</version>

			</dependency>				

			<dependency>

				<groupId>org.gvsig</groupId>

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

				<version>2.0-SNAPSHOT</version>

				<classifier>jts</classifier>	

			</dependency>	

			<!-- 

			<dependency>

				<groupId>org.gvsig</groupId>

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

				<version>2.1.0-SNAPSHOT</version>

			</dependency>

			<dependency>

				<groupId>org.gvsig</groupId>

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

				<version>2.1.0-SNAPSHOT</version>

				<scope>test</scope>

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

	</dependencies>

	<modules>

		<module>org.gvsig.annotation.lib</module>

		<module>org.gvsig.annotation.swing</module>

		<module>org.gvsig.annotation.main</module>

	</modules>

</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.     

<?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.annotation package documentation</title>

</head>

<body>

	<p>Annotation 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.annotation.main;

import org.gvsig.annotation.AnnotationCreationService;

import org.gvsig.annotation.AnnotationLocator;

import org.gvsig.annotation.AnnotationManager;

import org.gvsig.annotation.swing.AnnotationSwingLocator;

import org.gvsig.annotation.swing.AnnotationSwingManager;

import org.gvsig.annotation.swing.AnnotationWindowManager;

import org.gvsig.annotation.swing.JAnnotationCreationServicePanel;

import org.gvsig.fmap.crs.CRSFactory;

import org.gvsig.fmap.dal.DALLocator;

import org.gvsig.fmap.dal.DataManager;

import org.gvsig.fmap.dal.DataStoreParameters;

import org.gvsig.fmap.dal.feature.FeatureStore;

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

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

/**

 * Main executable class for testing the Annotation library.

 * 

 * @author gvSIG Team

 * @version $Id$

 */

public class Main {

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

    private AnnotationManager annotationManager;

    private AnnotationSwingManager annotationSwingManager;

    private DataManager dataManager;

    public static void main(String args[]) throws Exception {

        new DefaultLibrariesInitializer().fullInitialize();

        Main main = new Main();

        main.show();

    }    

    @SuppressWarnings("serial")

    public void show() throws Exception {

        annotationManager = AnnotationLocator.getManager();

        annotationSwingManager = AnnotationSwingLocator.getSwingManager();

        dataManager = DALLocator.getDataManager();

        JAnnotationCreationServicePanel annotationCreationService = annotationSwingManager.createAnnotation(createService());

        annotationSwingManager.getWindowManager().showWindow(annotationCreationService, "Annotation App. example", AnnotationWindowManager.MODE_DIALOG);

    }   

    /**

     * Returns an instance of the {@link AnnotationCreationService}.

     * 

     * @return a {@link AnnotationCreationService} instance

     * @throws Exception

     *             if there is any error creating the instance

     */

    protected AnnotationCreationService createService() throws Exception {

    	String sourceFileName = getClass().getClassLoader().getResource("org/gvsig/annotation/data/andalucia.shp").getFile();

    	DataStoreParameters sourceParameters = dataManager.createStoreParameters("Shape");

     	sourceParameters.setDynValue("shpfile", sourceFileName);

     	sourceParameters.setDynValue("crs", CRSFactory.getCRS("EPSG:23030"));

     	FeatureStore sourceStore = (FeatureStore) dataManager.openStore("Shape", sourceParameters);

    	return annotationManager.getAnnotationCreationService(sourceStore);

    }

}

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

import org.gvsig.annotation.AnnotationCreationService;

import org.gvsig.annotation.AnnotationLocator;

import org.gvsig.annotation.AnnotationManager;

import org.gvsig.annotation.swing.AnnotationSwingLocator;

import org.gvsig.annotation.swing.AnnotationSwingManager;

import org.gvsig.annotation.swing.AnnotationWindowManager;

import org.gvsig.annotation.swing.JAnnotationPreferencesPanel;

import org.gvsig.fmap.crs.CRSFactory;

import org.gvsig.fmap.dal.DALLocator;

import org.gvsig.fmap.dal.DataManager;

import org.gvsig.fmap.dal.DataStoreParameters;

import org.gvsig.fmap.dal.feature.FeatureStore;

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

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

/**

 * Main executable class for testing the Annotation library.

 * 

 * @author gvSIG Team

 * @version $Id$

 */

public class PreferencesMain {

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

    private AnnotationManager annotationManager;

    private AnnotationSwingManager annotationSwingManager;

    private DataManager dataManager;

    public static void main(String args[]) throws Exception {

        new DefaultLibrariesInitializer().fullInitialize();

        PreferencesMain main = new PreferencesMain();

        main.show();

    }    

    @SuppressWarnings("serial")

    public void show() throws Exception {

        annotationManager = AnnotationLocator.getManager();

        annotationSwingManager = AnnotationSwingLocator.getSwingManager();

        dataManager = DALLocator.getDataManager();

        JAnnotationPreferencesPanel annotationPreferencesPanel = annotationSwingManager.createAnnotationPreferences();

        annotationSwingManager.getWindowManager().showPreferencesWindow(annotationPreferencesPanel, "Annotation Preferences. example", AnnotationWindowManager.MODE_DIALOG);

    }   

    /**

     * Returns an instance of the {@link AnnotationCreationService}.

     * 

     * @return a {@link AnnotationCreationService} instance

     * @throws Exception

     *             if there is any error creating the instance

     */

    protected AnnotationCreationService createService() throws Exception {

    	String sourceFileName = getClass().getClassLoader().getResource("org/gvsig/annotation/data/andalucia.shp").getFile();

    	DataStoreParameters sourceParameters = dataManager.createStoreParameters("Shape");

     	sourceParameters.setDynValue("shpfile", sourceFileName);

     	sourceParameters.setDynValue("crs", CRSFactory.getCRS("EPSG:23030"));

     	FeatureStore sourceStore = (FeatureStore) dataManager.openStore("Shape", sourceParameters);

    	return annotationManager.getAnnotationCreationService(sourceStore);

    }

}

Put into this folder the resources needed by your classes.

This folder is added to the classpath, so you can load any resources 

through the ClassLoader.

By default, in this folder you can find an example of log4j configuration,

prepared to log messages through the console, so logging works when you

run your classes.

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

<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">

<!-- 

Log4J configuration file for unit tests execution.

 -->

<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">

	<!-- Appender configuration to show logging messages through the console -->

	<appender name="CONSOLE" class="org.apache.log4j.ConsoleAppender">

		<layout class="org.apache.log4j.PatternLayout">

			<param name="ConversionPattern" value="%d{HH:mm:ss,SSS} %-5p [%c{2}.%M()]\n  %m%n" />

		</layout>

	</appender>

	<!-- 

	Activate logging messages of DEBUG level of higher only for the

	org.gvsig.tools packages.

	You can put full classes names or packages instead, to configure

	logging for all the classes and subpackages of the package.

	-->

	<category name="org.gvsig.tools">

		<priority value="DEBUG" />

	</category>

	<category name="org.gvsig.annotation">

		<priority value="DEBUG" />

	</category>

	<!-- 

	By default, show only logging messages of INFO level or higher, 

	through the previously configured CONSOLE appender. 

	-->

	<root>

		<priority value="INFO" />

		<appender-ref ref="CONSOLE" />

	</root>

</log4j:configuration>

<?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/maven-v4_0_0.xsd">

	<modelVersion>4.0.0</modelVersion>

	<artifactId>org.gvsig.annotation.main</artifactId>

	<packaging>jar</packaging>

	<name>org.gvsig.annotation.main</name>

	<parent>

		<groupId>org.gvsig</groupId>

		<artifactId>org.gvsig.annotation</artifactId>

		<version>1.0.0-SNAPSHOT</version>

	</parent>

	<dependencies>

		<dependency>

			<groupId>org.gvsig</groupId>

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

			<version>1.0.0-SNAPSHOT</version>

		</dependency>

		<dependency>

			<groupId>org.gvsig</groupId>

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

			<version>1.0.0-SNAPSHOT</version>

			<scope>runtime</scope>

		</dependency>

		<dependency>

			<groupId>org.gvsig</groupId>

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

			<version>1.0.0-SNAPSHOT</version>

		</dependency>

		<dependency>

			<groupId>org.gvsig</groupId>

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

			<version>1.0.0-SNAPSHOT</version>

			<scope>runtime</scope>

		</dependency>

	</dependencies>

</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.annotation.lib</artifactId>

	<packaging>pom</packaging>

	<name>org.gvsig.annotation.lib</name>

	<parent>

		<groupId>org.gvsig</groupId>

		<artifactId>org.gvsig.annotation</artifactId>

		<version>1.0.0-SNAPSHOT</version>

	</parent>

	<modules>

		<module>org.gvsig.annotation.lib.api</module>

		<module>org.gvsig.annotation.lib.impl</module>

	</modules>

</project>

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

import java.io.File;

import java.util.ArrayList;

import java.util.List;

import org.gvsig.fmap.crs.CRSFactory;

import org.gvsig.fmap.dal.DALLocator;

import org.gvsig.fmap.dal.DataManager;

import org.gvsig.fmap.dal.DataStoreParameters;

import org.gvsig.fmap.dal.feature.Feature;

import org.gvsig.fmap.dal.feature.FeatureSet;

import org.gvsig.fmap.dal.feature.FeatureStore;

import org.gvsig.fmap.dal.feature.FeatureType;

import org.gvsig.fmap.geom.Geometry;

import org.gvsig.fmap.geom.exception.CreateGeometryException;

import org.gvsig.fmap.geom.primitive.Point;

import org.gvsig.i18n.Messages;

import org.gvsig.tools.dispose.DisposableIterator;

import org.gvsig.tools.junit.AbstractLibraryAutoInitTestCase;

/**

 * API compatibility tests for {@link AnnotationCreationService} implementations.

 * 

 * @author gvSIG Team

 * @version $Id$

 */

public abstract class AnnotationCreationServiceTest extends

    AbstractLibraryAutoInitTestCase {

    protected AnnotationManager manager;

    protected DataManager dataManager;

    @Override

    protected void doSetUp() throws Exception {

        manager = AnnotationLocator.getManager();

        dataManager = DALLocator.getDataManager();

    }

    /**

     * Returns an instance of the {@link AnnotationCreationService}.

     * 

     * @return a {@link AnnotationCreationService} instance

     * @throws Exception

     *             if there is any error creating the instance

     */

    protected AnnotationCreationService createService() throws Exception {

    	String sourceFileName = getClass().getClassLoader().getResource("org/gvsig/annotation/data/andalucia.shp").getFile();

    	DataStoreParameters sourceParameters = dataManager.createStoreParameters("Shape");

     	sourceParameters.setDynValue("shpfile", sourceFileName);

     	sourceParameters.setDynValue("crs", CRSFactory.getCRS("EPSG:23030"));

     	FeatureStore sourceStore = (FeatureStore) dataManager.openStore("Shape", sourceParameters);

    	return manager.getAnnotationCreationService(sourceStore);

    }

    /**

     * Test for the {@link AnnotationCreationService#getMessage()} method.

     * 

     * @throws Exception

     *             if there is any error in the tests

     */

    public void testAnnotationServiceMessage() throws Exception {

        AnnotationCreationService annotationCreationService = createService();

        File temporalFolder = new File(System.getProperty("java.io.tmpdir") +  File.separator + "tmp_gvsig_annotation");

        if (!temporalFolder.exists()){

        	if (!temporalFolder.mkdir()){

        		throw new Exception("Impossible to create the destination folder");

        	}

        }

        String destinationFileName =  temporalFolder.getAbsolutePath() + File.separator + Math.random() + ".shp";		

        annotationCreationService.createAnnotationStore(destinationFileName, 1);

        DataStoreParameters destinationParameters = dataManager.createStoreParameters("Shape");

        destinationParameters.setDynValue("shpfile", destinationFileName);

        destinationParameters.setDynValue("crs", CRSFactory.getCRS("EPSG:23030"));

    	FeatureStore destinationStore = (FeatureStore) dataManager.openStore("Shape", destinationParameters);

    	assertNotNull(destinationStore);

    	FeatureType featureType = destinationStore.getDefaultFeatureType();

    	assertEquals(7, featureType.getAttributeDescriptors().length);

     	assertEquals(destinationStore.getFeatureCount(), annotationCreationService.getFeatureStore().getFeatureCount());

    	assertNotNull(featureType.getDefaultGeometryAttribute());

    	assertEquals(featureType.getDefaultGeometryAttribute().getGeometryType(), Geometry.TYPES.POINT);

    	//Check the geometries

    	FeatureSet featureSet = destinationStore.getFeatureSet();

    	DisposableIterator iterator = featureSet.iterator();

    	Feature feature;

    	TextPointPairList textPointPairList = getResult();

    	while (iterator.hasNext()){

    		feature = (Feature)iterator.next();

    		assertNotNull(feature.get(Messages.getText(AnnotationManager.TEXTVALUE_ATTRIBUTE_NAME)));

    		String text = feature.getString(AnnotationManager.TEXTVALUE_ATTRIBUTE_NAME);

    		TextPointPair textPointPair = textPointPairList.search(text);

    		if (textPointPair != null){

	    		//Check the geometry

	    		Point point = (Point)feature.getDefaultGeometry();

	    		assertEquals(point.getX(), textPointPair.getPoint().getX(), 0.01);

	    		assertEquals(point.getY(), textPointPair.getPoint().getY(), 0.01);

	    	}

    		int color = feature.getInt(AnnotationManager.FONTCOLOR_ATTRIBUTE_NAME);

    		assertEquals(color, manager.getDefaultFontColor()); 

    		double heigth = feature.getDouble(AnnotationManager.FONTHEGTH_ATTRIBUTE_NAME);

    		assertEquals(heigth, manager.getDefaultFontHeight()); 

    		double rotation = feature.getDouble(AnnotationManager.FONTROTATION_ATTRIBUTE_NAME);

    		assertEquals(rotation, manager.getDefaultFontRotation()); 

    		String type = feature.getString(AnnotationManager.FONTTYPE_ATTRIBUTE_NAME);

    		assertEquals(type, manager.getDefaultFontType()); 

    		String style = feature.getString(AnnotationManager.FONTSTYLE_ATTRIBUTE_NAME);

    		assertEquals(style, manager.getDefaultFontStyle());     		

    	}

    	destinationStore.dispose();

    	annotationCreationService.getFeatureStore().dispose();

    }

    public abstract TextPointPairList getResult() throws CreateGeometryException;

    public class TextPointPairList{

    	List<TextPointPair> textPointPairs = new ArrayList<TextPointPair>();

		public TextPointPairList() {

			super();

		}

		public void addPoint(String text, Point point){

			textPointPairs.add(new TextPointPair(text, point));

		}

		public TextPointPair search(String text){

			for (TextPointPair textPointPair : textPointPairs) {

				if (textPointPair.getText().equals(text)){

					return textPointPair;

				}

			}

			return null;

		}    	

    }

    private class TextPointPair{

    	private String text;

		private Point point;

    	public TextPointPair(String text, Point point) {

			super();

			this.text = text;

			this.point = point;

		}

    	public String getText() {

			return text;

		}

		public Point getPoint() {

			return point;

		}    	

    }

    /**

     * Test for the {@link AnnotationCreationService#getManager()} method.

     * 

     * @throws Exception

     *             if there is any error in the tests

     */

    public void testAnnotationServiceManager() throws Exception {

        AnnotationCreationService annotationCreationService = createService();

        assertEquals(manager, annotationCreationService.getManager());

    }

}

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

import org.gvsig.tools.junit.AbstractLibraryAutoInitTestCase;

/**

 * API compatibility tests for {@link AnnotationManager} implementations.

 * 

 * @author gvSIG Team

 * @version $Id$

 */

public abstract class AnnotationManagerTest extends

    AbstractLibraryAutoInitTestCase {

    protected AnnotationManager manager;

    @Override

    protected void doSetUp() throws Exception {

        manager = AnnotationLocator.getManager();

    }

    /**

     * Test for the {@link AnnotationManager#getAnnotationCreationService()}

     * method.

     * 

     * @throws Exception

     *             if there is any error in the tests

     */

    public void testGetAnnotationCreationService() throws Exception {

    }

}

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

import java.awt.Color;

import java.util.List;

import org.gvsig.annotation.calculator.AnnotationPositionCalculator;

import org.gvsig.annotation.calculator.AnnotationPositionCalculatorCreationException;

import org.gvsig.fmap.dal.feature.FeatureStore;

import org.gvsig.i18n.Messages;

import org.gvsig.tools.service.ServiceException;

/**

 * This class is responsible of the management of the library's business logic.

 * It is the library's main entry point, and provides all the services to manage

 * {@link AnnotationCreationService}s.

 * 

 * @see AnnotationCreationService

 * @author gvSIG team

 * @version $Id$

 */

public interface AnnotationManager {

	/**

	 * Name of the datastore attribute that contains the text

	 * of the annotation.

	 */

	public static final String TEXTVALUE_ATTRIBUTE_NAME = "Text";

	/**

	 * Name of the datastore attribute that contains the font type

	 * of the annotation.

	 */

	public static final String FONTTYPE_ATTRIBUTE_NAME = "FontType";

	/**

	 * Name of the datastore attribute that contains the font style

	 * of the annotation.

	 */

	public static final String FONTSTYLE_ATTRIBUTE_NAME = "FontStyle";

	/**

	 * Name of the datastore attribute that contains the font color

	 * of the annotation.

	 */

	public static final String FONTCOLOR_ATTRIBUTE_NAME = "FontColor";

	/**

	 * Name of the datastore attribute that contains the font rotation

	 * of the annotation.

	 */

	public static final String FONTROTATION_ATTRIBUTE_NAME = "Rotation";

	/**

	 * Name of the datastore attribute that contains the font heigth

	 * of the annotation.

	 */

	public static final String FONTHEGTH_ATTRIBUTE_NAME = "Heigth";

	/**

	 * Create an instance of a {@link AnnotationCreationService}.

	 * 

	 * @param the feature store that is used like input.

	 * @return {@link AnnotationCreationService}

	 * @throws ServiceException

	 *             if there is an error getting the service

	 */

	public AnnotationCreationService getAnnotationCreationService(FeatureStore featureStore)

	throws ServiceException;

	/**

	 * It registers a class that can be used to caclulate the position of an

	 * annotation.

	 * @param name

	 * The name used to register the class.

	 * @param annotationPositionCalculatorClass

	 * The class that is able to calculate an annotation point.

	 */

	public void registerAnnotationPositionCalculator(String name, Class annotationPositionCalculatorClass);

	/**

	 * It registers the default implementation of an {@link AnnotationPositionCalculator}

	 * class. It will be used by default if the user don't specify any of them.

	 * @param annotationPositionCalculatorClass

	 * A class that is able to calculate an annotation point.

	 */

	public void registerDefaultAnnotationPositionCalculator(Class annotationPositionCalculatorClass);

	/**

	 * It returns an object that can be used to create the point

	 * where the annotation is displayed.

	 * @param name

	 * the name used to register the class.

	 * @return

	 * a class that is able to calculate an annotation point.

	 * @throws AnnotationPositionCalculatorCreationException

	 * if is not possible to create the object.

	 */

	public AnnotationPositionCalculator getAnnotationPositionCalculator(String name) throws AnnotationPositionCalculatorCreationException;

	/**

	 * It returns the default {@link AnnotationPositionCalculator}.

	 * @return

	 * the default {@link AnnotationPositionCalculator}.

	 * @throws AnnotationPositionCalculatorCreationException

	 * if is not possible to create the object.

	 */

	public AnnotationPositionCalculator getDefaultAnnotationPositionCalculator() throws AnnotationPositionCalculatorCreationException;

	/**

	 * @return

	 * the list of the names used to register the {@link AnnotationPositionCalculator} classes.

	 */

	public List<String> getAnnotationPositionCalculatorList();

	/**

	 * Value used like the default value for the text field.

	 * @return

	 * the default text value.

	 */

	public String getDefaultTextValue();

	/**

	 * Set the default value for the text field.

	 * @param textValue

	 * the default text value.

	 */

	public void setDefaultTextValue(String textValue);

	/**

	 * Value used like the default value for the font type field.

	 * @return

	 * the default font type value.

	 */

	public String getDefaultFontType();

	/**

	 * Set the default value for the font type field.

	 * @param fontType

	 * the default font type value.

	 */

	public void setDefaultFontType(String fontType);

	/**

	 * @return

	 * the list of possible values for the font type field.

	 */

	public List<String> getFontTypes();

	/**

	 * It adds a new value for the font type field.

	 * @param fontType

	 * the new font type.

	 */

	public void addFontType(String fontType);

	/**

	 * Value used like the default value for the font style field.

	 * @return

	 * the default font style value.

	 */

	public String getDefaultFontStyle();

	/**

	 * Set the default value for the font style field.

	 * @param fontStyle

	 * the default font style value.

	 */

	public void setDefaultFontStyle(String fontStyle);

	/**

	 * @return

	 * the list of possible values for the font style field.

	 */

	public List<String> getFontStyles();

	/**

	 * It adds a new value for the font style field.

	 * @param fontStyle

	 * the new font style.

	 */

	public void addFontStyle(String fontStyle);

	/**

	 * Value used like the default value for the font color field.

	 * @return

	 * the default font color value.

	 */

	public int getDefaultFontColor();

	/**

	 * Set the default value for the font color field.

	 * @param fontColor

	 * the default font color value.

	 */

	public void setDefaultFontColor(int fontColor);

	/**

	 * Set the default value for the font color field.

	 * @param fontColor

	 * the default font color value.

	 */

	public void setDefaultFontColor(Color fontColor);

	/**

	 * Value used like the default value for the font height field.

	 * @return

	 * the default font height value.

	 */

	public double getDefaultFontHeight();

	/**

	 * Set the default value for the font height field.

	 * @param fontHeight

	 * the default font height value.

	 */

	public void setDefaultFontHeight(double fontHeight);

	/**

	 * Value used like the default value for the font rotation field.

	 * @return

	 * the default font rotation value.

	 */

	public double getDefaultFontRotation();

	/**

	 * Set the default value for the font rotation field.

	 * @param fontRotation

	 * the default font rotation value.

	 */

	public void setDefaultFontRotation(double fontRotation);        

}

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

* 

*/

/*

* AUTHORS (In addition to CIT):

* 2010 {Prodevelop}   {Task}

*/

package org.gvsig.annotation;

import org.gvsig.fmap.dal.feature.Feature;

/**

 * It is used to notify the status of the annotation creation progress.

 * 

 * @author <a href="mailto:jpiera@gvsig.org">Jorge Piera Llodr&aacute;</a>

 */

public interface AnnotationCreationServiceNotification {

	/**

	 * This method is called when the annotation creation service is

	 * initialized.

	 */

	public void initializing();

	/**

	 * This method is called when the annotation creation service is

	 * finished.

	 */

	public void finished();

	/**

	 * This method is called when a {@link Feature} has been processed

	 * and the annotation point has been calculated.

	 */

	public void next();

	/**

	 * This method allows to cancel the process.

	 * @return

	 * If the annotation creation process has to be cancel.

	 */

	public boolean isCanceled();

}

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

 * 

 */

/*

 * AUTHORS (In addition to CIT):

 * 2010 {Prodevelop}   {Task}

 */

package org.gvsig.annotation;

import org.gvsig.fmap.dal.DataStore;

import org.gvsig.fmap.dal.DataTypes;

/**

 * DataTypes for the fields that are created in an annotation {@link DataStore}.

 * 

 * @author <a href="mailto:jpiera@gvsig.org">Jorge Piera Llodr&aacute;</a>

 */

public class AnnotationDataTypes {

	public static int TEXT = DataTypes.STRING;

	public static int FONTROTATION = DataTypes.DOUBLE;

	public static int FONTCOLOR = DataTypes.INT;

	public static int FONTHEIGHT = DataTypes.DOUBLE;

	public static int FONTTYPE = DataTypes.STRING;

	public static int FONTSTYLE = DataTypes.STRING;

}