| gvSIG desktop 1

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

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

    }

}

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

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

	 */

	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.DataStore;

import org.gvsig.tools.dataTypes.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;

}

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

/**

 * Generic exception thrown in the Annotation API when the exception or error

 * may be dealt by the program or the user of the program which is a client of

 * the Annotation API.

 * 

 * @see {@link AnnotationCreationService}

 * @see {@link AnnotationManager}

 * @author gvSIG team.

 * @version $Id$

 */

public class AnnotationException extends BaseException {

    private static final long serialVersionUID = 6756475060924237176L;

    private static final String MESSAGE =

        "An error has been produced in the Annotation library";

    private static final String KEY = "_AnnotationException";

    /**

     * Constructor to be used in rare cases, usually you must create a new child

     * exception class for each case.

     * <strong>Don't use this constructor in child classes.</strong>

     */

    public AnnotationException() {

        super(MESSAGE, KEY, serialVersionUID);

    }

    /**

     * Constructor to be used in rare cases, usually you must create a new child

     * exception class for each case.

     * <p>

     * <strong>Don't use this constructor in child classes.</strong>

     * </p>

     * 

     * @param cause

     *            the original cause of the exception

     */

    public AnnotationException(Exception cause) {

        super(MESSAGE, cause, KEY, serialVersionUID);

    }

    /**

     * @see BaseException#BaseException(String, String, long).

     * @param message

     *            the default messageFormat to describe the exception

     * @param key

     *            the key to use to search a localized messageFormnata

     * @param code

     *            the unique code to identify the exception

     */

    protected AnnotationException(String message, String key, long code) {

        super(message, key, code);

    }

    /**

     * @see BaseException#BaseException(String, Throwable, String, long).

     * @param message

     *            the default messageFormat to describe the exception

     * @param cause

     *            the original cause of the exception

     * @param key

     *            the key to use to search a localized messageFormnata

     * @param code

     *            the unique code to identify the exception

     */

    protected AnnotationException(String message, Throwable cause,

        String key, long code) {

        super(message, cause, key, code);

    }

}

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

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

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

/**

 * This class calculates the position of an annotation layer. It has a 

 * method that calculates the {@link Point} where the annotation has to

 * be displayed.

 * 

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

 */

public interface AnnotationPositionCalculator {

	/**

	 * This method returns the position where the annotation has to be displayed.

	 * @param feature 

	 * the feature that is used like input. 

	 * @return

	 * the point where the annotation is displayed.

	 * @throws AnnotationPositionCalculationException

	 * if there is an exception calculating the point

	 */

	public Point getAnnotationPosition(Feature feature) throws AnnotationPositionCalculationException;	

}

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

import org.gvsig.annotation.AnnotationException;

/**

 * This exception is thrown if there is a problem calculating the

 * point where the annotation has to be displayed.

 * 

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

 */

public class AnnotationPositionCalculationException extends AnnotationException {

	private static final long serialVersionUID = -2759803769427383259L;

	private static final String MESSAGE =

        "An error has been produced calculating the annotation position";

    private static final String KEY = "_AnnotationPositionCalculationException";

    /**

     * Creates a new {@link AnnotationPositionCalculationException}.

     * 

     * @param cause

     *            the original cause

     */

    public AnnotationPositionCalculationException(Throwable cause) {

        super(MESSAGE, cause, 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.calculator;

import org.gvsig.annotation.AnnotationException;

/**

 * This exception is thrown if it is not possible to create an

 * {@link AnnotationPositionCalculator} object.

 * 

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

 */

public class AnnotationPositionCalculatorCreationException extends AnnotationException {

	private static final long serialVersionUID = 8725010909175451070L;

	private String name = null;

	private static final String MESSAGE =

        "An error has been produced creating the %(name) AnnotationPositionCalculator";

    private static final String KEY = "_CreationAnnotationPositionCalculatoException";

    /**

     * Creates a new {@link AnnotationPositionCalculatorCreationException}.

     * 

     * @param cause

     *            the original cause

     */

    public AnnotationPositionCalculatorCreationException(String name, Throwable cause) {

        super(MESSAGE, cause, KEY, serialVersionUID);

        setValue("name", name);

    }      

}

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