Application: gvSIG desktop » gvSIG tools: Vector editing

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

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

	<modelVersion>4.0.0</modelVersion>

	<groupId>org.gvsig</groupId>

	<artifactId>org.gvsig.vectorediting.app</artifactId>

	<packaging>pom</packaging>

	<version>1.0.0-SNAPSHOT</version>

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

	<description>This plugin add to gvSIG a tool to show Vectorediting messages</description>

	<parent>

		<groupId>org.gvsig</groupId>

		<artifactId>org.gvsig.vectorediting</artifactId>

		<version>1.0.0-SNAPSHOT</version>

	</parent>

	<dependencyManagement>

		<dependencies>

		</dependencies>

	</dependencyManagement>

	<modules>

		<module>org.gvsig.vectorediting.app.mainplugin</module>

	</modules>

</project>

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

Usefull maven "howtos" and FAQs

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

.. contents::

How to reduce the process of "install" to run as fast as possible.

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

Can reduce install execution skiping test execution and compilation,

javadoc generation, test signature checking, license checking, and 

attach sources in jar.

  mvn  -Danimal.sniffer.skip=true -Dmaven.test.skip=true -Dsource.skip=true -DskipTests -Dmaven.javadoc.skip=true install

How to increment the build number of gvSIG plugins

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

To increase the build number of gvSIG plugins, yo can do:

  mvn -Dincrease-build-number process-sources

How to deploy a package of a gvSIG plugin

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

Yo can deploy the package of a gvSIG plugin with:

  mvn -Ddeploy-package -Duser=USER -Dpassword=PASSWORD install

Notes:

- Require that the gvsig.package.info.poolURL property that this set to the correct value.

- The process uses WEBDAV to upload the packages, gvspkg and gvspki, and require 

  access to write in the location specified by gvsig.package.info.poolURL

- If "user" or "password" is not present, the process ask its each time it need.

- If folder specified in  gvsig.package.info.poolURL does not exist, the process try to create it.

- The process create a file "addon-request.txt" in the target with the information to 

  add to the ticket to request the update of the package in the main repository of

  packages of gvSIG.

How to skip attach sources in jar from command line

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

If in the project is enabled by default the generation of jar whith 

the sources of the project, you can disable this setting the property

"source.skip" to true in the command line::

    mvn -Dsource.skip=true  install

How to skip test compile from command line

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

You can skip the compilation of test setting the propety "maven.test.skip" 

to true in the command line::

    mvn -Dmaven.test.skip=true  install

How to skip test execution from command line

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

You can skip the tests execution setting the propety "skipTests" to true

in the command line::

    mvn -DskipTests install

How to skip javadoc generation from command line

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

You can skip the javadoc generation setting the property

"maven.javadoc.skip" to true in the command line::

    mvn -Dmaven.javadoc.skip=true  install

How to skip test signature cheks from command line

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

You can skip the signature check setting the property

"animal.sniffer.skip" to true in the command line::

    mvn -Danimal.sniffer.skip=true install

How to install a project without install submodules

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

To install a project with submodules and only install the

parent project without submodules use the option "--non-recursive" ::

    mvn --non-recursive install

How to skip test compilation

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

To configure a project to don't run the compilation

of test you can add to this pom the next configuration of

the plugin "maven-compiler-plugin"::

  <build>

    <plugins>

      ...

      <plugin>

        <!-- Skip compilation tests -->

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

        <artifactId>maven-compiler-plugin</artifactId>

        <executions>

          <execution>

            <id>default-testCompile</id>

            <phase>process-test-sources</phase>

            <goals>

              <goal>testCompile</goal>

            </goals>

            <configuration>

              <skip>true</skip>

            </configuration>

          </execution>

        </executions>

      </plugin>

      ...

    </plugins>

  </build>

Skip test execution

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

To configure a project to don't run the execution

of test you can add to this pom the next configuration of

the plugin "maven-surefire-plugin"::

  <build>

    <plugins>

      ...

      <plugin>

        <!-- Skip test execution -->

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

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

        <configuration>

          <skipTests>true</skipTests>

        </configuration>

      </plugin>

      ...

    </plugins>

  </build>

Continue on test failure

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

You can configure a project to continue on test execution 

failure. To do this add to the pom of the project the next 

configuration of plugin "maven-surefire-plugin" ::

  <build>

    <plugins>

      ...

      <plugin>

        <!-- Continue on test failure -->

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

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

        <configuration>

          <testFailureIgnore>true</testFailureIgnore>

        </configuration>

      </plugin>

      ...

    </plugins>

  </build>

Set java compatibility

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

To set the compatibility with a java version  add to the 

pom of the project the next configuration of plugin 

"maven-compiler-plugin" ::

  <build>

    <plugins>

      ...

      <plugin>

          <!-- Set java compatibility -->

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

          <artifactId>maven-compiler-plugin</artifactId>

          <configuration>

              <source>1.5</source>

              <target>1.5</target>

              <encoding>ISO-8859-1</encoding>

          </configuration>

      </plugin>

      ...

    </plugins>

  </build>

Packaging tests in jar

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

Test classes do not packaging in jar by default.

To packing add to pom::

  <build>

    <plugins>

      ...

      <plugin>

        <!-- Packaging tests in jar -->

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

        <artifactId>maven-jar-plugin</artifactId>

        <executions>

          <!-- Generates a jar file only with the test classes -->

          <execution>

            <goals>

              <goal>test-jar</goal>

            </goals>

            <configuration>

              <includes>

                <include>**/**</include>

              </includes>

            </configuration>

          </execution>

        </executions>

      </plugin> 

      ...

    </plugins>

  </build>

How to set a dependency with tests jar

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

You can set a dependency with a test jar adding to

the declaration of the dependency the scope of

test and the type of "test-jar"::

  <dependency>

      <groupId>...</groupId>

      <artifactId>...</artifactId>

      <type>test-jar</type>

      <scope>test</scope>

  </dependency>

How use ant in maven

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

You can use ant embed in the pom of you project.

To do this use::

  <plugin>

    <artifactId>maven-antrun-plugin</artifactId>

    <version>1.7</version>

    <executions>

      <execution>

        <phase>generate-sources</phase>

        <configuration>

          <target>

            <echo>Hello world!</echo>

          </target>

        </configuration>

        <goals>

          <goal>run</goal>

        </goals>

      </execution>

    </executions>

  </plugin>

Fail when execute "mvn deploy" with "No connector available"

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

When execute a "mvn deploy" fail with the error::

  [INFO] ------------------------------------------------------------------------

  [ERROR] Failed to execute goal org.apache.maven.plugins:maven-deploy-plugin:2.7:deploy 

    (default-deploy) on project org.gvsig.desktop: Failed to deploy artifacts/metadata: 

    No connector available to access repository gvsig-repository (dav:https://devel.gvsig.org/m2repo/j2se) 

    of type default using the available factories WagonRepositoryConnectorFactory -> [Help 1]

  [ERROR] 

This happens to be configured the webdav wagon as an extension in the section "build"::

  ...

  <build>

    <extensions>

        <extension>

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

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

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

        </extension>

    </extensions>

  ...

Fail when execute "mvn release: prepare" with "svn command failed... Could not authenticate"

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

When running "mvn release: prepare" updates poms, compiles, and then

fails with the following error ::

  [INFO] ------------------------------------------------------------------------

  [ERROR] Failed to execute goal org.apache.maven.plugins:maven-release-plugin:2.1:prepare 

    (default-cli) on project org.gvsig.desktop: Unable to commit files

  [ERROR] Provider message:

  [ERROR] The svn command failed.

  [ERROR] Command output:

  [ERROR] svn: Commit failed (details follow):

  [ERROR] svn: MKACTIVITY of '/svn/gvsig-desktop/!svn/act/931a27bc-57e8-45d9-adcd-5a2cf54a7045': 

    authorization failed: Could not authenticate to server: rejected Basic challenge (https://devel.gvsig.org)

  [ERROR] -> [Help 1]

  [ERROR] 

  [ERROR]

Apparently maven in linux system use the svn of system and if you're not

authenticated when trying to access to the repository, svn fails.

This is solved by executing a commit from the command line on

some file of the project (only if you have not enabled the option 

"store-passwords = no" in $ HOME / .subversion / config). For example, you 

can add or remove at the end of "pom.xml" a blank line and then run 

from the command line ::

  svn ci -m "" pom.xml

Another option that works on Windows in declaring the user and password in the command:

mvn release:prepare -Dusername=[username] -Dpassword=[password]

<?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.vectorediting.app.mainplugin</artifactId>

	<packaging>jar</packaging>

	<name>Vectorediting messages</name>

	<description>This plugin add to gvSIG a tool that show Vectorediting messages</description>

	<parent>

		<groupId>org.gvsig</groupId>

		<artifactId>org.gvsig.vectorediting.app</artifactId>

		<version>1.0.0-SNAPSHOT</version>

	</parent>

	<properties>

        <!-- Package info property values -->

        <!-- Default values in org.gvsig.desktop -->

        <gvsig.package.info.state>devel</gvsig.package.info.state>

        <gvsig.package.info.dependencies>required: org.gvsig.app.mainplugin -ge 2.1.0-A</gvsig.package.info.dependencies>

        <gvsig.package.info.categories></gvsig.package.info.categories>

        <gvsig.package.info.poolURL>http://devel.gvsig.org/download/projects/gvsig-templates/pool/</gvsig.package.info.poolURL>

    </properties>

	<dependencies>

		<dependency>

			<groupId>org.gvsig</groupId>

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

		</dependency>

		<dependency>

			<groupId>org.gvsig</groupId>

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

		</dependency>

	</dependencies>

</project>

#maven.buildNumber.plugin properties file

#Thu May 05 17:08:17 CEST 2011

buildNumber=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.

====

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

    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.vectorediting">

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

/*

 * Copyright 2014 DiSiD Technologies S.L.L. All rights reserved.

 * 

 * Project  : DiSiD org.gvsig.vectorediting.app.mainplugin 

 * SVN Id   : $Id$

 */

package org.gvsig.vectorediting.app.mainplugin;

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

import org.gvsig.fmap.mapcontrol.tools.Listeners.ToolListener;

public class EditingBehavior extends Behavior{

  @Override

  public ToolListener getListener() {

    // TODO Auto-generated method stub

    return null;

  }

}

/*

 * Copyright 2014 DiSiD Technologies S.L.L. All rights reserved.

 * 

 * Project  : DiSiD org.gvsig.vectorediting.app.mainplugin 

 * SVN Id   : $Id$

 */

package org.gvsig.vectorediting.app.mainplugin;

public class BaseEditingServiceExtension {

}

/*

 * Copyright 2014 DiSiD Technologies S.L.L. All rights reserved.

 * 

 * Project  : DiSiD org.gvsig.vectorediting.app.mainplugin 

 * SVN Id   : $Id$

 */

package org.gvsig.vectorediting.app.mainplugin.extensions;

import org.gvsig.andami.plugins.Extension;

public class InsertPointExtension extends Extension {

  public void execute(String arg0) {

    // TODO Auto-generated method stub

  }

  public void initialize() {

    // TODO Auto-generated method stub

  }

  public boolean isEnabled() {

    // TODO Auto-generated method stub

    return false;

  }

  public boolean isVisible() {

    // TODO Auto-generated method stub

    return false;

  }

}

/*

 * Copyright 2014 DiSiD Technologies S.L.L. All rights reserved.

 * 

 * Project  : DiSiD org.gvsig.vectorediting.app.mainplugin 

 * SVN Id   : $Id$

 */

package org.gvsig.vectorediting.app.mainplugin.extensions;

public class EditingExtension {

  /**

   * 

   */

  private void activateConsole() {

    // TODO Activate console

  }

  /**

   * 

   */

  private void initFocus(){

    //TODO add console listener and register behavior

  }

  /**

   * 

   */

  public void initialize() {

    // TODO Register EditingBehaivor, as well as the actions to

    // activate/deactivate editing. Also activate console, put select store in

    // editing mode and notifies about the begin and end of editing mode.

  }

  /**

   * 

   */

  private void refreshMenusAndToolBars() {

    //TODO Refresh menus and toolbars

  }

  /**

   * 

   */

  private void registerEditingBehaivor() {

    // TODO Register EditingBehaivor in MapContext

  }

  /**

   * 

   */

  private void setStoreInEditingMode() {

    // TODO Set the store in edition mode

  }

}

# Traducciones de este plugin

_Fortune_cookies=Galletas de la fortuna

_Show_fortune_cookie_messaje=Mostrar un mensaje de Galleta de la Fortuna

# Traducciones de librerias que aporta este plugin

# Las traducciones especificadas en el plugin tienen prioridad sobre

# las que incluye la propia libreria.

_Close=Cerrar

_Fortune_cookie_message=Mensage de la galleta de la fortuna

_Cant_get_fortune_cookie_message=No puedo obtener el mensaje de la galleta de la fortuna

_Fortune_cookie=Galleta de la fortuna

# Translations to this plugin

_Fortune_cookies=Vectorediting

# Translations from librerias of this plugin_

Close=Close

_Fortune_cookie_message=Vectorediting message

_Cant_get_fortune_cookie_message=Can't get fortume cookie message

_Fortune_cookie=Vectorediting

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

-->

<plugin-config>

	<depends plugin-name="org.gvsig.app.mainplugin" />

	<resourceBundle name="text"/>

	<libraries library-dir="lib"/>

	<extensions>

		<extension class-name="org.gvsig.vectorediting.app.mainplugin.VectoreditingExtension"

			description=""

			active="true"

			priority="1">

		    <action 

		        name= "tools-show-fortune-cookie"

		        label="_Show_fortune_cookie_messaje"

		        tooltip="_Show_fortune_cookie_messaje"

		        action-command="tools-show-fortune-cookie" 

		        icon="tools-show-fortune-cookie"

		        position="001009000000"

		        accelerator=""

		    />

			<menu 

				text="tools/_Fortune_cookies/_Show_fortune_cookie_messaje"

				name="tools-show-fortune-cookie"

			/>

			<tool-bar name="fortune-cookies" position="1">

		        <action-tool name="tools-show-fortune-cookie"/>

      		</tool-bar>

		</extension>

	</extensions>

</plugin-config>

====

    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.

====

Put into this folder the resources to be included in the plugin jar.

<!--

    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.

-->

<assembly>

  <id>gvsig-plugin-package</id>

  <formats>

    <format>zip</format>

  </formats>

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

  <includeBaseDirectory>true</includeBaseDirectory>

  <files>

    <file>

      <source>target/${project.artifactId}-${project.version}.jar</source>

      <outputDirectory>lib</outputDirectory>

    </file>

    <file>

      <source>target/package.info</source>

    </file>

  </files>

  <fileSets>

    <fileSet>

      <directory>src/main/resources-plugin</directory>

      <outputDirectory>.</outputDirectory>

    </fileSet>

  </fileSets>

  <dependencySets>

    <dependencySet>

      <useProjectArtifact>false</useProjectArtifact>

      <useTransitiveDependencies>false</useTransitiveDependencies>

      <outputDirectory>lib</outputDirectory>

      <includes>

		<include>org.gvsig:org.gvsig.vectorediting.lib.api</include>

		<include>org.gvsig:org.gvsig.vectorediting.swing.api</include>

		<include>org.gvsig:org.gvsig.vectorediting.lib.impl</include>

		<include>org.gvsig:org.gvsig.vectorediting.swing.impl</include>

		<include>org.gvsig:org.gvsig.vectorediting.lib.prov</include>

		<include>org.gvsig:org.gvsig.vectorediting.lib.spi</include>        

      </includes>

    </dependencySet>

  </dependencySets>

</assembly>

		<module>org.gvsig.vectorediting.app</module>