Application: gvSIG desktop

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

	<packaging>pom</packaging>

	<version>1.0.0-SNAPSHOT</version>

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

	<description>Annotation example project</description>

    <parent>

        <groupId>org.gvsig</groupId>

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

        <version>1.0.8-SNAPSHOT</version>

    </parent>

	<scm>

		<connection>scm:svn:https://devel.gvsig.org/svn/gvsig-desktop/branches/v2_0_0_prep/libraries/org.gvsig.annotation</connection>

		<developerConnection>scm:svn:https://devel.gvsig.org/svn/gvsig-desktop/branches/v2_0_0_prep/libraries/org.gvsig.annotation</developerConnection>

		<url>https://devel.gvsig.org/redmine/projects/gvsig-desktop/repository/show/branches/v2_0_0_prep/libraries/org.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>

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

            <!-- TODO: MAKE TESTS WORK AND REMOVE THIS OPTION -->

            <plugin>

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

                <artifactId>maven-surefire-plugin</artifactId>

                <configuration>

                    <skipTests>true</skipTests>

                </configuration>

            </plugin>

        </plugins>        

	</build>

    <dependencyManagement>

        <dependencies>          

            <dependency>

                <groupId>org.gvsig</groupId>

                <artifactId>org.gvsig.core.maven.dependencies</artifactId>

                <version>2.0.1-SNAPSHOT</version>

                <type>pom</type>

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

        <dependency>

            <groupId>org.slf4j</groupId>

            <artifactId>slf4j-api</artifactId>

            <scope>compile</scope>

        </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.slf4j.Logger;

import org.slf4j.LoggerFactory;

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;

/**

 * 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.slf4j.Logger;

import org.slf4j.LoggerFactory;

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;

/**

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

            <scope>compile</scope>

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

            <scope>compile</scope>

		</dependency>

		<dependency>

			<groupId>org.gvsig</groupId>

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

			<version>1.0.0-SNAPSHOT</version>

			<scope>runtime</scope>

		</dependency>

        <dependency>

            <groupId>org.gvsig</groupId>

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

            <scope>compile</scope>

        </dependency>

        <dependency>

            <groupId>org.gvsig</groupId>

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

            <scope>runtime</scope>

        </dependency>

        <dependency>

            <groupId>org.gvsig</groupId>

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

            <scope>compile</scope>

        </dependency>

        <dependency>

            <groupId>org.gvsig</groupId>

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

            <scope>compile</scope>

        </dependency>

        <dependency>

            <groupId>org.gvsig</groupId>

            <artifactId>org.gvsig.metadata.lib.basic.api</artifactId>

            <scope>compile</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 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.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());

    }

}

org.gvsig.annotation.AnnotationLibrary

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

/**

 * Exception thrown when there is an error creating an Annotation layer.

 * 

 * @author gvSIG team

 * @version $Id$

 */

public class AnnotationCreationException extends AnnotationException {

    private static final long serialVersionUID = -4051458353306878010L;

    private static final String MESSAGE =

        "An error has been produced " + "creating the Annotation layer";

    private static final String KEY = "_AnnotationCreationException";

    /**

     * Creates a new {@link AnnotationCreationException}.

     * 

     * @param cause

     *            the original cause

     */

    public AnnotationCreationException(Throwable cause) {

        super(MESSAGE, cause, KEY, serialVersionUID);

    }

    public AnnotationCreationException(String message) {

        super(message, KEY, serialVersionUID);

    }

}

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

/**

 * Action that can be executed at the end of the annotation 

 * creation process. An example of action can be load the destination

 * {@link FeatureStore} like a layer in a view.

 * 

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

 */

public interface AnnotationCreationFinishAction {

	/**

	 * This method is called at the end of an annotation

	 * creation process.

	 * @param featureStore

	 * the destination store.

	 */

	public void finished(FeatureStore featureStore);

}

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

import org.gvsig.tools.locator.Locator;

import org.gvsig.tools.locator.LocatorException;

/**

 * This locator is the entry point for the Annotation library, providing

 * access to all Annotation services through the {@link AnnotationManager}

 * .

 * 

 * @author gvSIG team

 * @version $Id$

 */

public class AnnotationLocator extends BaseLocator {

    /**

     * Annotation manager name.

     */

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

    /**

     * Annotation manager description.

     */

    public static final String MANAGER_DESCRIPTION = "Annotation Manager";

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

    /**

     * Unique instance.

     */

    private static final AnnotationLocator INSTANCE =

        new AnnotationLocator();

    /**

     * Return the singleton instance.

     * 

     * @return the singleton instance

     */

    public static AnnotationLocator getInstance() {

        return INSTANCE;

    }

    /**

     * Return the Locator's name.

     * 

     * @return a String with the Locator's name

     */

    public final String getLocatorName() {

        return LOCATOR_NAME;

    }

    /**

     * Return a reference to the AnnotationManager.

     * 

     * @return a reference to the AnnotationManager

     * @throws LocatorException

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

     *             instantiated

     * @see Locator#get(String)

     */

    public static AnnotationManager getManager() throws LocatorException {

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

    }

    /**

     * Registers the Class implementing the AnnotationManager interface.

     * 

     * @param clazz

     *            implementing the AnnotationManager interface

     */

    public static void registerManager(

        Class<? extends AnnotationManager> clazz) {

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

    }

}

<?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 API.</p>

	<p>

	It allows to get new Annotation and get their text.

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

* 

*/

/*

* AUTHORS (In addition to CIT):

* 2010 {Prodevelop}   {Task}

*/

package org.gvsig.annotation;

import org.gvsig.tools.service.ServiceException;

/**

 * Exception thrown by the {@link AnnotationCreationService}.

 * 

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

 */

public class AnnotationCreationServiceException extends ServiceException {

	private static final long serialVersionUID = -4200816057552322619L;

	private final static String MESSAGE_KEY = "_AnnotationCreationServiceException";	

	public AnnotationCreationServiceException(String message, Throwable e) {

		super(message, e, MESSAGE_KEY, serialVersionUID);

		this.initCause(e);		

	}

}

/* 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.fmap.dal.DALLibrary;

import org.gvsig.tools.library.AbstractLibrary;

import org.gvsig.tools.library.LibraryException;

import org.gvsig.tools.locator.ReferenceNotRegisteredException;

/**

 * Library for API initialization and configuration.

 * 

 * @author gvSIG team

 * @version $Id$

 */

public class AnnotationLibrary extends AbstractLibrary {

    @Override

    public void doRegistration() {

        registerAsAPI(AnnotationLibrary.class);

        require(DALLibrary.class);

    }

	@Override

    protected void doInitialize() throws LibraryException {

        // Do nothing

    }

    @Override

    protected void doPostInitialize() throws LibraryException {

    	// Validate there is any implementation registered.

        AnnotationManager manager = AnnotationLocator.getManager();

        if (manager == null) {

            throw new ReferenceNotRegisteredException(

                AnnotationLocator.MANAGER_NAME, AnnotationLocator

                    .getInstance());

        }

    }

}

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

import org.gvsig.fmap.dal.exception.DataException;

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

import org.gvsig.tools.task.MonitorableTask;

/**

 * <p>

 * This service is used to create an annotation layer.

 * </p>

 * <p>

 * It inherits if {@link MonitorableTask}, and it means that the annotation 

 * process can be monitorized by one or more observers that can listen

 * all the export events.

 * <p>

 * @author gvSIG team

 * @version $Id$

 */

public interface AnnotationCreationService extends MonitorableTask {

	/**

	 * @return

	 * the store that is used like input.

	 */

	public FeatureStore getFeatureStore();

	/**

	 * This method creates a {@link FeatureStore} with the annotations. 

	 * @param destinationShapeFile 

	 * path there the shape this the annotation information is created.

	 * @param textValueAttributeIndex

	 * attribute index of the original {@link FeatureStore} that contains the text.

	 * @return

	 * a new store with the annotation information.

	 * @throws AnnotationCreationException

	 * if there is an error creating the annotation store. 

	 */

    public FeatureStore createAnnotationStore(String destinationShapeFile, int textValueAttributeIndex) throws AnnotationCreationException;

    /**

	 * This method creates a {@link FeatureStore} with the annotations. 

	 * @param destinationShapeFile 

	 * path there the shape this the annotation information is created.

	 * @param textValueAttributeName

	 * attribute name of the original {@link FeatureStore} that contains the text.

	 * @return

	 * a new store with the annotation information.

	 * @throws AnnotationCreationException

	 * if there is an error creating the annotation store. 

	 */

    public FeatureStore createAnnotationStore(String destinationShapeFile, String textValueAttributeName) throws AnnotationCreationException;   

    /**

     * Sets the {@link AnnotationCreationFinishAction} that is used at the end

     * of the annotation creation service. 

     * @param annotationCreationFinishAction

     * it contains an action that can be executed at the end of the annotation

     * creation process.

     */

    public void setAnnotationCreationFinishAction(AnnotationCreationFinishAction annotationCreationFinishAction);

    /**

     * @return

     * the {@link AnnotationCreationFinishAction} used at the end of the annotation

     * creation process.

     */

    public AnnotationCreationFinishAction getAnnotationCreationFinishAction();

    /**

     * Sets an {@link AnnotationPositionCalculator} used to calculate the

     * position of the 

     * @param annotationPositionCalculator

     */

    public void setAnnotationPositionCalculator(AnnotationPositionCalculator annotationPositionCalculator);

    public void setFontTypetAttribute(int index) throws DataException;

    public void setFontStyleAttribute(int index) throws DataException;

    public void setFontColorAttribute(int index) throws DataException;

    public void setFontHeigthAttribute(int index) throws DataException;

    public void setFontRotationAttribute(int index) throws DataException;

    public void setFontTypetAttribute(String attributeName) throws DataException;

    public void setFontStyleAttribute(String attributeName) throws DataException;

    public void setFontColorAttribute(String attributeName) throws DataException;

    public void setFontHeigthAttribute(String attributeName) throws DataException;

    public void setFontRotationAttribute(String attributeName) throws DataException;

    /**

     * Returns the {@link AnnotationManager}

     * 

     * @return {@link AnnotationManager}

     * @see {@link AnnotationManager}

     */

    public AnnotationManager 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 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.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.