Application: gvSIG desktop

gvSIG. Desktop Geographic Information System.

Copyright (C) 2007-2013 gvSIG Association.

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 3

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.

For any additional information, do not hesitate to contact us 

at info AT gvsig.com, or visit our website www.gvsig.com.

<?xml version="1.0"?>

<!--

    gvSIG. Desktop Geographic Information System.

    Copyright (C) 2007-2013 gvSIG Association.

    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 3

    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.

    For any additional information, do not hesitate to contact us

    at info AT gvsig.com, or visit our website www.gvsig.com.

-->

<!DOCTYPE module PUBLIC

    "-//Puppy Crawl//DTD Check Configuration 1.2//EN"

    "http://www.puppycrawl.com/dtds/configuration_1_2.dtd">

<!--

  Checkstyle configuration that checks the sun coding conventions from:

    - the Java Language Specification at

      http://java.sun.com/docs/books/jls/second_edition/html/index.html

    - the Sun Code Conventions at http://java.sun.com/docs/codeconv/

    - the Javadoc guidelines at

      http://java.sun.com/j2se/javadoc/writingdoccomments/index.html

    - the JDK Api documentation http://java.sun.com/j2se/docs/api/index.html

    - some best practices

  Checkstyle is very configurable. Be sure to read the documentation at

  http://checkstyle.sf.net (or in your downloaded distribution).

  Most Checks are configurable, be sure to consult the documentation.

  To completely disable a check, just comment it out or delete it from the file.

  Finally, it is worth reading the documentation.

-->

<module name="Checker">

    <!--

        If you set the basedir property below, then all reported file

        names will be relative to the specified directory. See

        http://checkstyle.sourceforge.net/5.x/config.html#Checker

        <property name="basedir" value="${basedir}"/>

    -->

    <!-- gvSIG: All project files have the ISO-8859-1 charset -->

	<property name="charset" value="ISO-8859-1" />

    <!-- Checks that a package-info.java file exists for each package.     -->

    <!-- See http://checkstyle.sf.net/config_javadoc.html#JavadocPackage -->

	<module name="JavadocPackage">

		<property name="allowLegacy" value="true" />

	</module>

    <!-- Checks whether files end with a new line.                        -->

    <!-- See http://checkstyle.sf.net/config_misc.html#NewlineAtEndOfFile -->

    <module name="NewlineAtEndOfFile"/>

    <!-- Checks that property files contain the same keys.         -->

    <!-- See http://checkstyle.sf.net/config_misc.html#Translation -->

    <module name="Translation"/>

    <!-- Checks for Size Violations.                    -->

    <!-- See http://checkstyle.sf.net/config_sizes.html -->

    <module name="FileLength"/>

    <!-- Checks for whitespace                               -->

    <!-- See http://checkstyle.sf.net/config_whitespace.html -->

    <module name="FileTabCharacter"/>

    <module name="TreeWalker">

	    <!-- Miscellaneous other checks.                   -->

	    <!-- See http://checkstyle.sf.net/config_misc.html -->

	    <!-- gvSIG: apply only to java files -->

	    <module name="RegexpSinglelineJava">

	       <property name="format" value="\s+$"/>

	       <property name="minimum" value="0"/>

	       <property name="maximum" value="0"/>

	       <property name="message" value="Line has trailing spaces."/>

	       <property name="ignoreComments" value="true"/>

	    </module>

        <!-- Checks for Javadoc comments.                     -->

        <!-- See http://checkstyle.sf.net/config_javadoc.html -->

		<!--

			gvSIG rule 3: All protected or public classes must have a Javadoc comments,

			except getters and setters

		-->

		<module name="JavadocMethod">

			<property name="scope" value="protected" />

			<property name="allowMissingPropertyJavadoc" value="true" />

		</module>

		<!--

			gvSIG rule 9: All classes must have a Javadoc comment

			with the "@author tag" and the "@version $Id$" tag included 

		-->

		<module name="JavadocType">

			<property name="scope" value="private" />

			<property name="authorFormat" value="\S" />

			<property name="versionFormat" value="\$Id.*\$"/>

		</module>

        <module name="JavadocVariable">

			<property name="scope" value="protected" />

		</module>

		<!-- gvSIG rule 3: Check correctly formatted Javadoc -->

		<module name="JavadocStyle">

			<property name="scope" value="protected" />

		</module>

        <!-- Checks for Naming Conventions.                  -->

        <!-- See http://checkstyle.sf.net/config_naming.html -->

        <module name="ConstantName"/>

        <module name="LocalFinalVariableName"/>

        <module name="LocalVariableName"/>

        <module name="MemberName"/>

        <module name="MethodName"/>

		<!-- gvSIG rule 15: All packages must begin with org.gvsig.  -->

		<module name="PackageName">

			<property name="format" value="^org\.gvsig(\.[a-z][a-z0-9]*)+$" />

		</module>

		<!-- gvSIG advised rule 1: Abstract class names must begin with Abstract. -->

		<!-- module name="AbstractClassName" /-->

        <module name="ParameterName"/>

        <module name="StaticVariableName"/>

        <module name="TypeName"/>

        <!-- Checks for imports                              -->

        <!-- See http://checkstyle.sf.net/config_import.html -->

        <module name="AvoidStarImport"/>

        <module name="IllegalImport"/> <!-- defaults to sun.* packages -->

        <module name="RedundantImport"/>

        <module name="UnusedImports"/>

        <!-- Checks for Size Violations.                    -->

        <!-- See http://checkstyle.sf.net/config_sizes.html -->

        <module name="LineLength"/>

        <module name="MethodLength"/>

        <module name="ParameterNumber"/>

        <!-- Checks for whitespace                               -->

        <!-- See http://checkstyle.sf.net/config_whitespace.html -->

        <module name="EmptyForIteratorPad"/>

        <module name="GenericWhitespace"/>

        <module name="MethodParamPad"/>

        <module name="NoWhitespaceAfter"/>

        <module name="NoWhitespaceBefore"/>

        <module name="OperatorWrap"/>

        <module name="ParenPad"/>

        <module name="TypecastParenPad"/>

        <module name="WhitespaceAfter"/>

        <module name="WhitespaceAround"/>

        <!-- Modifier Checks                                    -->

        <!-- See http://checkstyle.sf.net/config_modifiers.html -->

        <module name="ModifierOrder"/>

        <module name="RedundantModifier"/>

        <!-- Checks for blocks. You know, those {}'s         -->

        <!-- See http://checkstyle.sf.net/config_blocks.html -->

        <module name="AvoidNestedBlocks"/>

        <module name="EmptyBlock"/>

        <module name="LeftCurly"/>

        <module name="NeedBraces"/>

        <module name="RightCurly"/>

        <!-- Checks for common coding problems               -->

        <!-- See http://checkstyle.sf.net/config_coding.html -->

        <module name="AvoidInlineConditionals"/>

        <module name="DoubleCheckedLocking"/>    <!-- MY FAVOURITE -->

        <module name="EmptyStatement"/>

        <module name="EqualsHashCode"/>

        <module name="HiddenField"/>

        <module name="IllegalInstantiation"/>

        <module name="InnerAssignment"/>

        <module name="MagicNumber"/>

        <module name="MissingSwitchDefault"/>

        <module name="RedundantThrows"/>

        <module name="SimplifyBooleanExpression"/>

        <module name="SimplifyBooleanReturn"/>

		<!-- gvSIG: Check for some common programming errors -->

		<module name="CovariantEquals" />

		<module name="StringLiteralEquality" />

        <!-- Checks for class design                         -->

        <!-- See http://checkstyle.sf.net/config_design.html -->

        <module name="DesignForExtension"/>

        <module name="FinalClass"/>

        <module name="HideUtilityClassConstructor"/>

        <module name="InterfaceIsType"/>

        <module name="VisibilityModifier"/>

        <!-- Miscellaneous other checks.                   -->

        <!-- See http://checkstyle.sf.net/config_misc.html -->

        <module name="ArrayTypeStyle"/>

        <!-- gvSIG: removed -->

        <!-- module name="FinalParameters"/-->

        <module name="TodoComment"/>

        <module name="UpperEll"/>

	    <!-- gvSIG rule 2: Sun style with 4 spaces -->

	    <module name="Indentation">

	    	<property name="basicOffset" value="4"/>

		    <property name="caseIndent" value="0"/>

		</module>

        <!-- gvSIG rule 10: Do not use System.out/err to log -->

		<module name="Regexp">

		    <!-- . matches any character, so we need to escape it and use \. 

		    to match dots.-->

		    <property name="format" value="System\.[out|err]\.println"/>

		    <property name="illegalPattern" value="true"/>

		</module>

		<!-- gvSIG rule 11: Try to avoid catching Throwable or 

		Exception and catch specific exceptions instead. -->

		<module name="IllegalCatch"/>

		<!-- gvSIG rule 13: Use interfaces in the declaration of 

		methods and variables.

        By default only avoids usage of Classes:

			"java.util.GregorianCalendar, java.util.Hashtable, 

		  	java.util.HashSet, java.util.HashMap, java.util.ArrayList, 

		  	java.util.LinkedList, java.util.LinkedHashMap, 

		  	java.util.LinkedHashSet, java.util.TreeSet, 

		  	java.util.TreeMap, java.util.Vector" -->

		<module name="IllegalType">

		    <property name="ignoredMethodNames" value="getInstance"/>

		</module>

    </module>

	<!--  gvSIG rule 1: check for the gvSIG header -->

    <!-- Uneeded, use the maven-license-plugin instead

	<module name="RegexpHeader"> -->

		<!-- The follow property value demonstrates the ability     -->

		<!-- to have access to ANT properties. In this case it uses -->

		<!-- the ${basedir} property to allow Checkstyle to be run  -->

		<!-- from any directory within a project. See property      -->

		<!-- expansion,                                             -->

		<!-- http://checkstyle.sf.net/config.html#properties        -->

    <!--

		<property name="headerFile" value="${checkstyle.header.file}" />

	</module>

    -->

</module>

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

<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.desktop.buildtools</artifactId>

  <version>1.0.0</version>

  <packaging>jar</packaging>

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

  <description>Resources used for build gvsig desktop</description>

<!-- No puede ser hijo de org.gvsig.desktop para evitar referencas circulares -->

<!--

  <parent>

    <groupId>org.gvsig</groupId>

    <artifactId>org.gvsig.desktop</artifactId>

    <version>2.0.327-SNAPSHOT</version>

   </parent>  

-->

    <licenses>

        <license>

            <name>GPLv3</name>

            <url>http://www.gnu.org/licenses/gpl.html</url>

            <distribution>repo</distribution>

            <comments>

			"GPL" stands for "General Public License". The most widespread such

			license is the GNU General Public License, or GNU GPL for short.

			This can be further shortened to "GPL", when it is understood that

			the GNU GPL is the one intended.

	      	</comments>

        </license>

    </licenses>

    <organization>

        <name>gvSIG Association</name>

        <url>http://www.gvsig.com/</url>

    </organization>

    <scm>

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

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

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

    </scm>

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

    <distributionManagement>

      <site>

        <id>gvsig-repository</id>

        <url>dav:https://devel.gvsig.org/sites/${project.artifactId}/${project.version}</url>

      </site>

      <repository>

          <id>gvsig-repository</id>

          <name>gvSIG maven repository</name>

          <url>dav:https://devel.gvsig.org/m2repo/j2se</url>

          <uniqueVersion>false</uniqueVersion>

      </repository>

      <snapshotRepository>

          <id>gvsig-repository</id>

          <name>gvSIG maven repository</name>

          <url>dav:https://devel.gvsig.org/m2repo/j2se</url>

          <uniqueVersion>false</uniqueVersion>

      </snapshotRepository>

    </distributionManagement>

    <issueManagement>

      <system>redmine</system>

      <url>https://devel.gvsig.org/redmine/projects/gvsig-desktop</url>

    </issueManagement>

    <mailingLists>

      <mailingList>

        <name>User List</name>

        <subscribe>http://listserv.gva.es/cgi-bin/mailman/listinfo/gvsig_usuarios</subscribe>

        <unsubscribe>http://listserv.gva.es/cgi-bin/mailman/listinfo/gvsig_usuarios</unsubscribe>

        <post>gvsig_usuarios@listserv.gva.es</post>

        <archive>http://www.gvsig.org/web/community/mailing-lists/gvsig-nabble</archive>

        <otherArchives>

          <otherArchive>http://www.mail-archive.com/gvsig_usuarios@runas.cap.gva.es</otherArchive>

          <otherArchive>http://dir.gmane.org/index.php?prefix=gmane.comp.gis.gvsig</otherArchive>

        </otherArchives>

      </mailingList>

      <mailingList>

        <name>Developer List</name>

        <subscribe>http://listserv.gva.es/cgi-bin/mailman/listinfo/gvsig_desarrolladores</subscribe>

        <unsubscribe>http://listserv.gva.es/cgi-bin/mailman/listinfo/gvsig_desarrolladores</unsubscribe>

        <post>gvsig_desarrolladores@listserv.gva.es</post>

        <archive>http://www.gvsig.org/web/community/mailing-lists/gvsig-nabble</archive>

        <otherArchives>

          <otherArchive>http://www.mail-archive.com/gvsig_desarrolladores@runas.cap.gva.es</otherArchive>

          <otherArchive>http://dir.gmane.org/index.php?prefix=gmane.comp.gis.gvsig</otherArchive>

        </otherArchives>

      </mailingList>

      <mailingList>

        <name>International List</name>

        <subscribe>http://listserv.gva.es/cgi-bin/mailman/listinfo/gvsig_internacional</subscribe>

        <unsubscribe>http://listserv.gva.es/cgi-bin/mailman/listinfo/gvsig_internacional</unsubscribe>

        <post>gvsig_internacional@listserv.gva.es</post>

        <archive>http://www.gvsig.org/web/community/mailing-lists/gvsig-nabble</archive>

        <otherArchives>

          <otherArchive>http://www.mail-archive.com/gvsig_internacional@runas.cap.gva.es</otherArchive>

          <otherArchive>http://dir.gmane.org/index.php?prefix=gmane.comp.gis.gvsig</otherArchive>

        </otherArchives>

      </mailingList>

    </mailingLists>

    <build>

        <extensions>

            <extension>

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

                <artifactId>wagon-webdav-jackrabbit</artifactId>

                <version>1.0-beta-7</version>

            </extension>

        </extensions>

    </build>

</project>

gvSIG. Desktop Geographic Information System.

Copyright (C) 2007-2023 gvSIG Association.

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 3

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, see <https://www.gnu.org/licenses/>. 

For any additional information, do not hesitate to contact us

at info AT gvsig.com, or visit our website www.gvsig.com.

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

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

  <description>Annotation</description>

  <parent>

      <groupId>org.gvsig</groupId>

      <artifactId>org.gvsig.desktop.library</artifactId>

      <version>2.0.440</version>

  </parent>

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

      <scope>test</scope>

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

<?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>${project.artifactId}</name>

  <parent>

    <groupId>org.gvsig</groupId>

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

    <version>2.0.440</version>

  </parent>

  <dependencies>

    <dependency>

      <groupId>org.gvsig</groupId>

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

      <scope>compile</scope>

    </dependency>

    <dependency>

      <groupId>org.gvsig</groupId>

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

      <scope>compile</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.fmap.dal.api</artifactId>

        <scope>compile</scope>

    </dependency>

    <dependency>

        <groupId>org.gvsig</groupId>

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

        <scope>compile</scope>

    </dependency>

    <dependency>

        <groupId>org.gvsig</groupId>

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

        <scope>compile</scope>

    </dependency>

  </dependencies>

</project>

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

<!--

    gvSIG. Desktop Geographic Information System.

    Copyright (C) 2007-2013 gvSIG Association.

    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 3

    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.

    For any additional information, do not hesitate to contact us

    at info AT gvsig.com, or visit our website www.gvsig.com.

-->

<!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="UTF-8" ?>

<!--

    gvSIG. Desktop Geographic Information System.

    Copyright (C) 2007-2013 gvSIG Association.

    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 3

    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.

    For any additional information, do not hesitate to contact us

    at info AT gvsig.com, or visit our website www.gvsig.com.

-->

<!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. Desktop Geographic Information System.

 *

 * Copyright (C) 2007-2013 gvSIG Association.

 *

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

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

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 */

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. Desktop Geographic Information System.

 *

 * Copyright (C) 2007-2013 gvSIG Association.

 *

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

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

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 */

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 test classes.

This folder is added to the Tests 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 tests classes.

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

<!--

    gvSIG. Desktop Geographic Information System.

    Copyright (C) 2007-2013 gvSIG Association.

    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 3

    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.

    For any additional information, do not hesitate to contact us

    at info AT gvsig.com, or visit our website www.gvsig.com.

-->

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

# Resource bundle texts for the English language locale (en)

centroid=Centroid

# Resource bundle texts for the Spanish language locale (es)

centroid=Centroide

org.gvsig.annotation.impl.AnnotationDefaultImplLibrary

/**

 * gvSIG. Desktop Geographic Information System.

 *

 * Copyright (C) 2007-2013 gvSIG Association.

 *

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

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

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 */

package org.gvsig.annotation.impl;

import java.io.File;

import java.io.FileOutputStream;

import java.io.IOException;

import java.io.InputStream;

import java.io.OutputStream;

import org.gvsig.annotation.AnnotationCreationException;

import org.gvsig.annotation.AnnotationCreationFinishAction;

import org.gvsig.annotation.AnnotationCreationService;

import org.gvsig.annotation.AnnotationDataTypes;

import org.gvsig.annotation.AnnotationManager;

import org.gvsig.annotation.calculator.AnnotationPositionCalculationException;

import org.gvsig.annotation.calculator.AnnotationPositionCalculator;

import org.gvsig.annotation.calculator.AnnotationPositionCalculatorCreationException;

import org.gvsig.fmap.dal.DALLocator;

import org.gvsig.fmap.dal.DataManager;

import org.gvsig.fmap.dal.DataTypes;

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

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

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

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

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

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

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

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

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

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

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

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

import org.gvsig.fmap.dal.serverexplorer.filesystem.FilesystemServerExplorer;

import org.gvsig.fmap.geom.Geometry;

import org.gvsig.tools.ToolsLocator;

import org.gvsig.tools.dispose.DisposableIterator;

import org.gvsig.tools.dynobject.exception.DynFieldNotFoundException;

import org.gvsig.tools.task.AbstractMonitorableTask;

import org.gvsig.tools.task.SimpleTaskStatus;

import org.gvsig.tools.task.TaskStatusManager;

import org.apache.commons.lang3.StringUtils;

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

/**

 * Default {@link AnnotationCreationService} implementation.

 * 

 * @author gvSIG Team

 * @version $Id$

 */

public class DefaultAnnotationCreationService extends AbstractMonitorableTask implements AnnotationCreationService {

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

	private static final String TEMPLATE_NAME = "template.gvslab";

	private static DataManager dataManager = DALLocator.getDataManager();

	private AnnotationManager manager;

	private FeatureStore sourceStore;

	private int sourceFontTypeAttribute = -1;

	private int sourceFontStyleAttribute = -1;

	private int sourceFontColorAttribute = -1;

	private int sourceRotationAttribute = -1;

	private int sourceHeigthAttribute = -1;

	private AnnotationPositionCalculator annotationPositionCalculator = null;

	private String destinationGeometryAttributeName = null;

	private AnnotationCreationFinishAction annotationCreationFinishAction = null; 

	/**

	 * {@link DefaultAnnotationCreationService} constructor with a

	 * {@link AnnotationManager}.

	 * 

	 * @param manager

	 *            to use in the service

	 * @throws DataException 

	 */

	public DefaultAnnotationCreationService(FeatureStore featureStore, AnnotationManager manager) throws DataException {

		super("annotation");

	    this.sourceStore = featureStore; 

		this.manager = manager;

		destinationGeometryAttributeName = featureStore.getDefaultFeatureType().getDefaultGeometryAttributeName();

	}

	public AnnotationManager getManager() {

		return this.manager;

	}

	public FeatureStore createAnnotationStore(String destinationShapeFile, int textValueAttribute)

	throws AnnotationCreationException {		

		try {

			if (destinationShapeFile == null){

				throw new AnnotationCreationException("File can not be null");

			}	

			String destinationShapeFileWithoutExtension = destinationShapeFile.toLowerCase().replaceAll("\\.shp", "");

			if (destinationShapeFileWithoutExtension.length() == destinationShapeFile.length()-4){

				destinationShapeFileWithoutExtension =  destinationShapeFile.substring(0, destinationShapeFile.length()-4);

			}else{

				destinationShapeFileWithoutExtension = destinationShapeFile;

			}			

			NewFeatureStoreParameters newFeatureStoreParameters = (NewFeatureStoreParameters)dataManager.createNewStoreParameters("FilesystemExplorer", "Shape");

			newFeatureStoreParameters.setDynValue("shpfile", destinationShapeFileWithoutExtension + ".shp");

			newFeatureStoreParameters.setDynValue("dbffile", destinationShapeFileWithoutExtension + ".dbf");

			newFeatureStoreParameters.setDynValue("shxfile", destinationShapeFileWithoutExtension + ".shx");

			newFeatureStoreParameters.setDynValue("crs", sourceStore.getDefaultFeatureType().getDefaultSRS());

			EditableFeatureType editableFeatureType = sourceStore.getDefaultFeatureType().getEditable();//newFeatureStoreParameters.getDefaultFeatureType().getEditable();

			FeatureAttributeDescriptor[] featureAttributeDescriptors = editableFeatureType.getAttributeDescriptors();

			for (int i=featureAttributeDescriptors.length-1  ; i>=0 ; i--){

				editableFeatureType.remove(i);

			}

			initializeFeatureType(editableFeatureType);

			newFeatureStoreParameters.setDefaultFeatureType(editableFeatureType);

			dataManager.newStore("FilesystemExplorer", "Shape", newFeatureStoreParameters, true);

			//If there is not an annotationPositionCalculator it gets the default 

			if (annotationPositionCalculator == null){

				annotationPositionCalculator = manager.getDefaultAnnotationPositionCalculator();

			}	

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

			copyFeatureStore(sourceStore, 

					destinationStore,

					textValueAttribute);	

			try {

				copyLegend(destinationStore);

			} catch (IOException e) {

				LOG.error("Error copying the legend");

			}

			if (annotationCreationFinishAction != null){

				annotationCreationFinishAction.finished(destinationStore);

			}

			return destinationStore;

		} catch (InitializeException e) {

			throw new AnnotationCreationException(e);

		} catch (ProviderNotRegisteredException e) {

			throw new AnnotationCreationException(e);

		} catch (ValidateDataParametersException e) {

			throw new AnnotationCreationException(e);

		} catch (DynFieldNotFoundException e) {

			throw new AnnotationCreationException(e);

		} catch (DataException e) {

			throw new AnnotationCreationException(e);

		} catch (AnnotationPositionCalculatorCreationException e) {

			throw new AnnotationCreationException(e);

		} 			

	}	

	public FeatureStore createAnnotationStore(String destinationShapeFile,

			String textValueAttributeName) throws AnnotationCreationException {

		try {

			return createAnnotationStore(destinationShapeFile, getIndex(textValueAttributeName));

		} catch (DataException e) {

			throw new AnnotationCreationException(e);

		}			

	}

	private void initializeFeatureType(EditableFeatureType editableFeatureType) throws DataException

	{		

		EditableFeatureAttributeDescriptor geometryType = editableFeatureType.add(destinationGeometryAttributeName, DataTypes.GEOMETRY);

		geometryType.setAllowNull(false);		

		geometryType.setGeometryType(Geometry.TYPES.POINT).setGeometrySubType(Geometry.SUBTYPES.GEOM2D);

		geometryType.setSRS(sourceStore.getDefaultFeatureType().getDefaultSRS());

		geometryType.setObjectClass(Geometry.class);

		editableFeatureType.setDefaultGeometryAttributeName(destinationGeometryAttributeName);

		editableFeatureType.add(AnnotationManager.TEXTVALUE_ATTRIBUTE_NAME, AnnotationDataTypes.TEXT, 256).setAllowNull(true);

		editableFeatureType.add(AnnotationManager.FONTTYPE_ATTRIBUTE_NAME, AnnotationDataTypes.FONTTYPE, 30).setAllowNull(true);

		editableFeatureType.add(AnnotationManager.FONTSTYLE_ATTRIBUTE_NAME, AnnotationDataTypes.FONTSTYLE, 30).setAllowNull(true);

		editableFeatureType.add(AnnotationManager.FONTCOLOR_ATTRIBUTE_NAME, AnnotationDataTypes.FONTCOLOR, 20).setAllowNull(true);

		editableFeatureType.add(AnnotationManager.FONTROTATION_ATTRIBUTE_NAME, AnnotationDataTypes.FONTROTATION, 5).setAllowNull(true);

		editableFeatureType.add(AnnotationManager.FONTHEGTH_ATTRIBUTE_NAME, AnnotationDataTypes.FONTHEIGHT, 5).setAllowNull(true);

	}

	private AttributeInserter createInserter(int attributePosition, Object defaultValue)

	{

		if (attributePosition > -1){

			return new StoreAttributeInserter(attributePosition);

		}else{

			return new DefaultAttributeInserter(defaultValue);

		}

	}

	private void copyFeatureStore(FeatureStore sourceStore,

			FeatureStore destinationStore, int textAttribute)

	throws AnnotationCreationException, DataException {		

		FeatureSet featureSet = null;

		DisposableIterator iterator = null;

		try{

			//Start the edition

			destinationStore.edit();

			//Copy data

			featureSet = sourceStore.getFeatureSet();

			iterator = featureSet.fastIterator();

			taskStatus.setRangeOfValues(0, featureSet.getSize());

			//Create the attribute inserter's

			AttributeInserter fontTypeAttributeInserter = createInserter(sourceFontTypeAttribute, manager.getDefaultFontType());		

			AttributeInserter fontStyleAttributeInserter = createInserter(sourceFontStyleAttribute, manager.getDefaultFontStyle());		

			AttributeInserter fontColorAttributeInserter = createInserter(sourceFontColorAttribute, manager.getDefaultFontColor());		

			AttributeInserter fontRotationAttributeInserter = createInserter(sourceRotationAttribute, manager.getDefaultFontRotation());		

			AttributeInserter fontHeigthAttributeInserter = createInserter(sourceHeigthAttribute, manager.getDefaultFontHeight());		

			Feature sourceFeature;

			long featureCount = 0;

			while (iterator.hasNext()) {			

				sourceFeature = (Feature) iterator.next();

				EditableFeature destinationFeature = destinationStore.createNewFeature().getEditable();

				try {

					destinationFeature.set(destinationGeometryAttributeName, annotationPositionCalculator.getAnnotationPosition(sourceFeature));

				} catch (AnnotationPositionCalculationException e) {

					LOG.error("Not possible to get the point for the geometry", e);				

				}

		        String s = (String) sourceFeature.get(textAttribute);

                if (StringUtils.isEmpty(s)) {

                    s = this.getManager().getDefaultTextValue();

                }

				destinationFeature.set(AnnotationManager.TEXTVALUE_ATTRIBUTE_NAME, s);

				destinationFeature.set(AnnotationManager.FONTTYPE_ATTRIBUTE_NAME, fontTypeAttributeInserter.getValue(sourceFeature));

				destinationFeature.set(AnnotationManager.FONTSTYLE_ATTRIBUTE_NAME, fontStyleAttributeInserter.getValue(sourceFeature));

				destinationFeature.set(AnnotationManager.FONTCOLOR_ATTRIBUTE_NAME, fontColorAttributeInserter.getValue(sourceFeature));

				destinationFeature.set(AnnotationManager.FONTROTATION_ATTRIBUTE_NAME, fontRotationAttributeInserter.getValue(sourceFeature));

				destinationFeature.set(AnnotationManager.FONTHEGTH_ATTRIBUTE_NAME, fontHeigthAttributeInserter.getValue(sourceFeature));

				destinationStore.insert(destinationFeature);

	    		featureCount++;  

	    		this.taskStatus.setCurValue(featureCount);

	            if (this.taskStatus.isCancellationRequested()) {

	            	destinationStore.cancelEditing();

	            	this.taskStatus.cancel();

	                return;

	            }

			}

		}finally{

			//Finish the edition

			if(destinationStore.isEditing()){

				destinationStore.finishEditing();

			}

			//Dispose resources

			if(iterator != null){

				iterator.dispose();	

			}

			if(featureSet != null){

				featureSet.dispose();

			}

			if(this.taskStatus.isRunning()){

				this.taskStatus.terminate();

			}

	        //this.taskStatus.remove();

		}

	}

	private void copyLegend(FeatureStore destinationStore) throws ValidateDataParametersException, DataException, IOException {

		FilesystemServerExplorer filesystemServerExplorer = (FilesystemServerExplorer)destinationStore.getExplorer();

		File target = filesystemServerExplorer.getResourcePath(destinationStore, "gvslab");

		//Copy the template

		InputStream in = getClass().getClassLoader().getResourceAsStream(TEMPLATE_NAME);

		OutputStream out = null;

		out = new FileOutputStream(target);

		byte[] buf = new byte[1024];

		int len;

		while ((len = in.read(buf)) > 0) { 

			out.write(buf, 0, len); 

		} 

		in.close();

		out.close(); 		

	}

	private void checkAttribute(int index, int[] type) throws DataException{

		if (index >= sourceStore.getDefaultFeatureType().size()){

			throw new IllegalArgumentException("Attribute not found");

		}

		int datatype = sourceStore.getDefaultFeatureType().getAttributeDescriptor(index).getDataType().getType();

		boolean validType = false;

		if(type != null) {

			for (int i = 0; i < type.length; i++) {

				if(datatype == type[i]) {

					validType = true;

				}

			}

		}

		if (!validType) {

			throw new IllegalArgumentException("The Attribute has not have the fine type");

		}

	}

	public void setFontTypeAttribute(int index) throws DataException {

		checkAttribute(index, new int[]{AnnotationDataTypes.FONTTYPE});

		this.sourceFontTypeAttribute = index;		

	}

	public void setFontStyleAttribute(int index) throws DataException {

		checkAttribute(index, new int[]{AnnotationDataTypes.FONTSTYLE});

		this.sourceFontStyleAttribute = index;		

	}

	public void setFontColorAttribute(int index) throws DataException {

		checkAttribute(index, new int[]{AnnotationDataTypes.FONTCOLOR});

		this.sourceFontColorAttribute = index;