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

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

    <packaging>pom</packaging>

    <name>org.gvsig.personaldb</name>

    <description>PersonalDB project</description>

    <parent>

        <groupId>org.gvsig</groupId>

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

        <version>2.0.111</version>

    </parent>

    <dependencies>

        <dependency>

            <groupId>org.gvsig</groupId>

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

            <scope>compile</scope>

        </dependency>

        <dependency>

            <groupId>org.gvsig</groupId>

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

            <type>test-jar</type>

            <scope>test</scope>

        </dependency>

    </dependencies>

  <build>

    <plugins>

      <plugin>

        <groupId>org.codehaus.mojo</groupId>

        <artifactId>animal-sniffer-maven-plugin</artifactId>

        <configuration>

          <skip>true</skip>

        </configuration>

      </plugin>

    </plugins>

  </build>

  <modules>

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

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

  </modules>

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

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

</head>

<body>

	<p>PersonalDB 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.personaldb.main;

import java.sql.Connection;

import java.sql.DatabaseMetaData;

import java.sql.SQLException;

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

import org.gvsig.personaldb.PersonalDBException;

import org.gvsig.personaldb.PersonalDBLocator;

import org.gvsig.personaldb.PersonalDBManager;

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

/**

 * Main executable class for testing the PersonalDB library.

 * 

 * @author gvSIG Team

 * @version $Id$

 */

public class Main {

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

    public static void main(String args[]) {

        Main main = new Main();

        try {

            main.show();

        } catch (Throwable e) {

            e.printStackTrace();

            System.exit(-1);

        }

        System.exit(0);

    }

    public void show() throws PersonalDBException, SQLException {

        new DefaultLibrariesInitializer().fullInitialize();

        PersonalDBManager manager = PersonalDBLocator.getManager();

        Connection connection = manager.getConnection();

        DatabaseMetaData metadata = connection.getMetaData();

        LOG.info("DatabaseMetadata: {}", metadata);

    }

}

<?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.personaldb.main</artifactId>

    <packaging>jar</packaging>

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

    <parent>

        <groupId>org.gvsig</groupId>

        <artifactId>org.gvsig.personaldb</artifactId>

        <version>2.0.111</version>

    </parent>

    <dependencies>

        <dependency>

            <groupId>org.gvsig</groupId>

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

            <scope>compile</scope>

        </dependency>

        <dependency>

            <groupId>org.gvsig</groupId>

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

            <scope>runtime</scope>

        </dependency>

        <dependency>

            <groupId>org.gvsig</groupId>

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

            <scope>compile</scope>

        </dependency>        

        <dependency>

            <groupId>org.slf4j</groupId>

            <artifactId>slf4j-api</artifactId>

            <scope>compile</scope>

        </dependency>

    </dependencies>

    <build>

        <plugins>

            <plugin>

                <groupId>org.codehaus.mojo</groupId>

                <artifactId>exec-maven-plugin</artifactId>

                <executions>

                    <execution>

                        <goals>

                            <goal>exec</goal>

                        </goals>

                    </execution>

                </executions>

                <configuration>

                    <executable>java</executable>

                    <arguments>

                        <argument>-classpath</argument>

                        <!-- automatically creates the classpath using all project 

                            dependencies, also adding the project build directory -->

                        <classpath />

                        <argument>org.gvsig.personaldb.main.Main</argument>

                    </arguments>

                    <environmentVariables>

                    </environmentVariables>

                </configuration>

            </plugin>

        </plugins>

    </build>

</project>

/**

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

/**

 * Exception thrown when there is an error creating a connection to the

 * personal database.

 * 

 * @author gvSIG Team

 * @version $Id$

 */

public class DataServerExplorerParametersException extends PersonalDBException {

    private static final long serialVersionUID = 8918999379397938916L;

    private final static String MESSAGE_FORMAT =

        "Error creating a DataServerExplorerParameters for the personal "

            + "database of the type: %(name)";

    private final static String MESSAGE_KEY =

        "_DataServerExplorerParametersException";

    /**

     * Constructor with a message and a cause

     */

    public DataServerExplorerParametersException(String name,

        Throwable cause) {

        super(MESSAGE_FORMAT, cause, MESSAGE_KEY, serialVersionUID);

        setValue("name", name);

    }

}

/**

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

import java.sql.Connection;

import org.gvsig.fmap.dal.DataParameters;

import org.gvsig.fmap.dal.DataServerExplorerParameters;

import org.gvsig.fmap.dal.DataStoreParameters;

/**

 * 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 Connection}s and {@link DataParameters} to connect to the personal

 * database.

 * 

 * @see PersonalDBService

 * @author gvSIG team

 * @version $Id$

 */

public interface PersonalDBManager {

    /**

     * Returns a {@link Connection} the personal database.

     * 

     * @return a connection to the personal database

     * @throws PersonalDBException

     *             if there is an error getting the connection

     */

    public Connection getConnection() throws PersonalDBException;

    /**

     * Returns a {@link DataStoreParameters} to connect to the personal database

     * through the DAL library.

     * 

     * @return the DAL data store parameters to connect to connect to the

     *         database

     * @throws PersonalDBException

     *             if there is an error creating the parameters

     */

    public DataStoreParameters getDataStoreParameters()

        throws PersonalDBException;

    /**

     * Returns a {@link DataStoreParameters} to connect to the personal database

     * through the DAL library.

     * 

     * @param schema

     *            the schema of the table to load data from

     * @param table

     *            the name of the table to load data from

     * @return the DAL data store parameters to connect to connect to the

     *         database

     * @throws PersonalDBException

     *             if there is an error creating the parameters

     */

    public DataStoreParameters getDataStoreParameters(String schema,

        String table) throws PersonalDBException;

    /**

     * Returns a {@link DataServerExplorerParameters} to connect to the personal

     * database

     * through the DAL library.

     * 

     * @return the DAL data server explorer parameters to connect to connect to

     *         the

     *         database

     * @throws PersonalDBException

     *             if there is an error creating the parameters

     */

    public DataServerExplorerParameters getDataServerExplorerParameters()

        throws PersonalDBException;

    /**

     * Returns a {@link DataServerExplorerParameters} to connect to the personal

     * database

     * through the DAL library.

     * 

     * @param schema

     *            the schema of the database to connect to

     * @return the DAL data server explorer parameters to connect to connect to

     *         the

     *         database

     * @throws PersonalDBException

     *             if there is an error creating the parameters

     */

    public DataServerExplorerParameters getDataServerExplorerParameters(

        String schema) throws PersonalDBException;

}

/**

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

import org.gvsig.fmap.dal.DataParameters;

/**

 * Exception thrown when there is an error creating a connection to the

 * personal database.

 * 

 * @author gvSIG Team

 * @version $Id$

 */

public class DBAccessException extends PersonalDBException {

    private static final long serialVersionUID = 8918999379397938916L;

    private final static String MESSAGE_FORMAT =

        "Access error to a database whose parameters are: %(parameters)";

    private final static String MESSAGE_KEY = "_DBAccessException";

    /**

     * Constructor with a message and a cause

     */

    public DBAccessException(DataParameters parameters, Throwable cause) {

        super(MESSAGE_FORMAT, cause, MESSAGE_KEY, serialVersionUID);

        setValue("parameters", parameters.toString());

    }

}

/**

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

import org.gvsig.tools.exception.BaseException;

/**

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

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

 * the PersonalDB API.

 * 

 * @see {@link PersonalDBManager}

 * @author gvSIG team.

 * @version $Id$

 */

public class PersonalDBException extends BaseException {

    private static final long serialVersionUID = 6756475060924237176L;

    private static final String MESSAGE =

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

    private static final String KEY = "_PersonalDBException";

    /**

     * 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 PersonalDBException() {

        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 PersonalDBException(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 PersonalDBException(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 PersonalDBException(String message, Throwable cause,

        String key, long code) {

        super(message, cause, key, code);

    }

}

/**

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

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 PersonalDB library, providing

 * access to all PersonalDB services through the {@link PersonalDBManager}

 * .

 * 

 * @author gvSIG team

 * @version $Id$

 */

public class PersonalDBLocator extends BaseLocator {

    /**

     * PersonalDB manager name.

     */

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

    /**

     * PersonalDB manager description.

     */

    public static final String MANAGER_DESCRIPTION = "PersonalDB Manager";

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

    /**

     * Unique instance.

     */

    private static final PersonalDBLocator INSTANCE =

        new PersonalDBLocator();

    /**

     * Return the singleton instance.

     * 

     * @return the singleton instance

     */

    public static PersonalDBLocator 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 PersonalDBManager.

     * 

     * @return a reference to the PersonalDBManager

     * @throws LocatorException

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

     *             instantiated

     * @see Locator#get(String)

     */

    public static PersonalDBManager getManager() throws LocatorException {

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

    }

    /**

     * Registers the Class implementing the PersonalDBManager interface.

     * 

     * @param clazz

     *            implementing the PersonalDBManager interface

     */

    public static void registerManager(

        Class<? extends PersonalDBManager> clazz) {

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

    }

}

/**

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

import org.gvsig.tools.library.AbstractLibrary;

import org.gvsig.tools.library.LibraryException;

import org.gvsig.tools.locator.ReferenceNotRegisteredException;

/**

 * Library for PersonalDB API initialization and configuration.

 * 

 * @author gvSIG team

 * @version $Id$

 */

public class PersonalDBLibrary extends AbstractLibrary {

    @Override

    public void doRegistration() {

        registerAsAPI(PersonalDBLibrary.class);

    }

    @Override

    protected void doInitialize() throws LibraryException {

        // Do nothing

    }

    @Override

    protected void doPostInitialize() throws LibraryException {

        // Validate there is any implementation registered.

        PersonalDBManager manager = PersonalDBLocator.getManager();

        if (manager == null) {

            throw new ReferenceNotRegisteredException(

                PersonalDBLocator.MANAGER_NAME, PersonalDBLocator

                    .getInstance());

        }

    }

}

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

</head>

<body>

	<p>PersonalDB library API.</p>

	<p>

	It allows to get new PersonalDB and get their text.

	</p>

</body>

</html>

org.gvsig.personaldb.PersonalDBLibrary

<?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.personaldb.lib.api</artifactId>

    <packaging>jar</packaging>

    <name>org.gvsig.personaldb.lib.api</name>

    <parent>

        <groupId>org.gvsig</groupId>

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

        <version>2.0.111</version>

    </parent>

    <dependencies>

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

    </dependencies>

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

</project>