/ - Diff - gvSIG educa bugs - gvSIG

     ===============
     gvSIG Educa
     ===============
     ---------------------
     Portable View
     ---------------------
     Description
     ==============
     This folder contains the sources of the Portable View functionality.
     Requirements
     ==============
     * Maven 2.6 or higher
     * Java JDK 1.5 or higher
     For eclipse
     -------------
     See `developer guide at gvSIG.org <http://www.gvsig.org/plone/projects/gvsig-desktop/docs/devel/gvsig-devel-guide/2-1-0/introduccion>`_ and the file ``REAME-ECLIPSE.txt``
     Contents
     ==========
     org.gvsig.educa.portableview.lib
     ---------------------------------
     Functionality sources. This project just contain the main process and the logic without any dependency with User Interface.
     org.gvsig.educa.portableview.swing
     -------------------------------------
     User Interface components to access a manage the application services.
     org.gvsig.educa.portableview.main
     -----------------------------------
     Little test application which allow run the main functionality of application.
     See `Execute little test application`_ to know how run it.
     pom.xml
     ---------
     Maven project definition file
     README.rst
     --------------
     This file (in reStructureText format, for more info this format look at `gvSIG portal <https://gvsig.org/web/projects/gvsig-desktop/docs/devel/guia-para-documentar/el-formato-restructuredtext>`_  or at `docUtils reference <http://docutils.sourceforge.net/rst.html>`_)
     Compilation
     ================
     From shell
     ------------
     Execute this command::
         org.gvsig.educa.portableview$ mvn clean install
     From eclipse
     --------------
     See `work in a proyect of the developer guide at gvSIG.org <https://gvsig.org/web/projects/gvsig-desktop/docs/devel/gvsig-devel-guide/2.0.0/trabajar-con-un-proyecto>`_
     In some project, could be better use ``mvn eclipse:clean eclipse:eclipse``  than import project as a *Maven project*. Maven plugin of eclipse does not set classpath correctly in some project.
     Packing
     ========
     This functionality has no stand-alone packing process.
     Version
     ---------------
     To changes version number just set in in ``project/version`` tag of *pom.xml* in this folder. Sub-projects will inherit it.
     Version polity is the standard in project. Changes in version number:
     * third number: Bug fixes and minors improvements. API must have no changes from previous version.
     * second number: Bug fixes and mayor improvements. API can have minor changes. Previously deprecated classes could be removed. No architectural changes.
     * first number: Mayor changes.
     Create a tag
     ------------------
     TODO: use *maven release* plugin
     Use svn copy command to copy version in server. Process could be like this:
     #. Check that there ins no changes in workspace::
        svn up ; svn status
     #. Check that project compiles and passes all test.
        mvn clean install
     #. Update *pom.xml* to set version of tag (usually removing *-SNAPSHOT*)
     #. create tag folder on server::
        svn mkdir -m "Create {version} tag folder" https://devel.gvsig.org/svn/gvsig-educa/org.gvsig.educa.portablewview/tags/{version}
     #. Copy current workcopy to tag folder::
        svn copy -m "Create {version} tag" * https://devel.gvsig.org/svn/gvsig-educa/org.gvsig.educa.portablewview/tags/{version}
     #. Update *pom.xml* to next version
     #. Commit *pom.xml* changes::
        svn commit -m "Set new version {version}-SNAPSHOT" pom.xml
     i18n
     ======
     The files for internationalization can be found in this folders:
     + *org.gvsig.educa.portablewview.app.viewer/src/main/resources-plugin*
     + *org.gvsig.educa.portablewview.app.editor/src/main/resources-plugin*
     The internationalization of this application is based on standard java resource bundle mechanism. So, to add a new language just add the file with the language code to every related folder.
     Execute little test application
     =================================
     From shell
     ------------
     After compile the application, execute this command::
         org.gvsig.educa.portablewview$ cd org.gvsig.educa.thematicmap.main
         org.gvsig.educa.portablewview/org.gvsig.educa.portablewview.main$ mvn exec:java
     Form eclipse
     ------------------
     Select ``org.gvsig.educa.portableview.main`` project in *Project tree* using *Java perspective*, click with right mouse button and select ``Run as.../Java application``. Select ``Main`` class for 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.educa.portableview.lib.api</artifactId>
     	<packaging>jar</packaging>
     	<name>org.gvsig.educa.portableview.lib.api</name>
     	<parent>
     		<groupId>org.gvsig</groupId>
     		<artifactId>org.gvsig.educa.portableview.lib</artifactId>
     		<version>1.0.45</version>
     	</parent>
     	<build>
     		<plugins>
     			<plugin>
     				<groupId>org.apache.maven.plugins</groupId>
     				<artifactId>maven-jar-plugin</artifactId>
     				<configuration>
     				</configuration>
     				<executions>
     					<!-- Generates a jar file only with the test classes -->
     					<execution>
     						<goals>
     							<goal>test-jar</goal>
     						</goals>
     					</execution>
     				</executions>
     			</plugin>
     		</plugins>
     	</build>
     	<dependencies>
     		<dependency>
     			<groupId>org.gvsig</groupId>
     			<artifactId>org.gvsig.tools.lib</artifactId>
     		</dependency>
     		<dependency>
     			<groupId>org.gvsig</groupId>
     			<artifactId>org.gvsig.fmap.mapcontext.api</artifactId>
     		</dependency>
     	</dependencies>
     </project>

     ====
         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.
     ====
     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-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.construc">
     		<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>

     /* gvSIG. Geographic Information System of the Valencian Government
+     *
      * Copyright (C) 2007-2008 Infrastructures and Transports Department
      * of the Valencian Government (CIT)
+     *
      * This program is free software; you can redistribute it and/or
      * modify it under the terms of the GNU General Public License
      * as published by the Free Software Foundation; either version 2
      * of the License, or (at your option) any later version.
+     *
      * This program is distributed in the hope that it will be useful,
      * but WITHOUT ANY WARRANTY; without even the implied warranty of
      * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      * GNU General Public License for more details.
+     *
      * You should have received a copy of the GNU General Public License
      * along with this program; if not, write to the Free Software
      * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
      * MA  02110-1301, USA.
+     *
      */
     package org.gvsig.educa.portableview;
     import org.gvsig.tools.exception.BaseException;
     /**
      * Generic exception thrown in the PortableView API when the exception or error
      * may be dealt by the program or the user of the program which is a client of
      * the PortableView API.
+     *
      * @see {@link PortableViewService}
      * @see {@link PortableViewManager}
      * @author gvSIG team.
      * @version $Id$
      */
     public class PortableViewException extends BaseException {
         private static final long serialVersionUID = 6756475060924237176L;
         private static final String MESSAGE =
             "An error has been produced in the PortableView library";
         private static final String KEY = "_PortableViewException";
         /**
          * 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 PortableViewException() {
             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 PortableViewException(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 PortableViewException(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 PortableViewException(String message, Throwable cause, String key,
             long code) {
             super(message, cause, key, code);
+        }
+    }

     /* gvSIG. Geographic Information System of the Valencian Government
+     *
      * Copyright (C) 2007-2008 Infrastructures and Transports Department
      * of the Valencian Government (CIT)
+     *
      * This program is free software; you can redistribute it and/or
      * modify it under the terms of the GNU General Public License
      * as published by the Free Software Foundation; either version 2
      * of the License, or (at your option) any later version.
+     *
      * This program is distributed in the hope that it will be useful,
      * but WITHOUT ANY WARRANTY; without even the implied warranty of
      * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      * GNU General Public License for more details.
+     *
      * You should have received a copy of the GNU General Public License
      * along with this program; if not, write to the Free Software
      * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
      * MA  02110-1301, USA.
+     *
      */
     package org.gvsig.educa.portableview;
     import org.gvsig.tools.exception.BaseRuntimeException;
     /**
      * Generic exception thrown in the PortableView API when the exception or error
      * may be dealt by the program or the user of the program which is a client of
      * the PortableView API.
+     *
      * @see {@link PortableViewService}
      * @see {@link PortableViewManager}
      * @author gvSIG team.
      * @version $Id$
      */
     public class PortableViewRuntimeException extends BaseRuntimeException {
         /**
+         *
          */
         private static final long serialVersionUID = -4039843730204021312L;
         private static final String MESSAGE =
             "An error has been produced in the PortableView library";
         private static final String KEY = "_PortableViewRuntimeException";
         public PortableViewRuntimeException(String message) {
             super(message, KEY, serialVersionUID);
+        }
         /**
+         *
          * @param cause
          *            the original cause of the exception
          */
         public PortableViewRuntimeException(String message, Exception cause) {
             super(message, cause, KEY, serialVersionUID);
+        }
         /**
+         *
          * @param cause
          *            the original cause of the exception
          */
         public PortableViewRuntimeException(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 PortableViewRuntimeException(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 PortableViewRuntimeException(String message, Throwable cause, String key,
             long code) {
             super(message, cause, key, code);
+        }
+    }

     /* gvSIG. Geographic Information System of the Valencian Government
+     *
      * Copyright (C) 2007-2008 Infrastructures and Transports Department
      * of the Valencian Government (CIT)
+     *
      * This program is free software; you can redistribute it and/or
      * modify it under the terms of the GNU General Public License
      * as published by the Free Software Foundation; either version 2
      * of the License, or (at your option) any later version.
+     *
      * This program is distributed in the hope that it will be useful,
      * but WITHOUT ANY WARRANTY; without even the implied warranty of
      * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      * GNU General Public License for more details.
+     *
      * You should have received a copy of the GNU General Public License
      * along with this program; if not, write to the Free Software
      * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
      * MA  02110-1301, USA.
+     *
      */
     package org.gvsig.educa.portableview;
     import java.io.File;
     import java.io.IOException;
     import java.util.zip.ZipException;
     import org.gvsig.fmap.mapcontext.MapContext;
     import org.gvsig.tools.persistence.exception.PersistenceException;
     /**
      * Portable View Utilities related to files
+     *
      * @author gvSIG Team
      * @version $Id$
+     *
      */
     /**
      * @author gvSIG Team
      * @version $Id$
+     *
      */
     public interface PortableViewFileServices {
         /**
          * <p>
          * Unzip a file into a folder
          * </p>
+         *
          * @param zipFile
          * @param outputFloder
          *            must exists. WARNING: <b>Contents will be removed before
          *            unzip</b>
          * @throws IOException
          * @throws ZipException
          * @throws IllegalArgumentException
          *             if zipFile is not a file or outputFloder doesn't exists or is
          *             read-only
          */
         void unzipFile(File zipFile, File outputFloder) throws ZipException,
             IOException;
         /**
          * <p>
          * Create a zip file which will contains all contents of a folder
          * </p>
          * <p>
          * Files will be use relative path to <code>rootFolder</code>
          * </p>
+         *
          * @param rootFolder
          *            rootFolder (must be an existing folder)
          * @param targetFile
          *            final file (must not exists)
          * @throws IOException
          * @throws IllegalArgumentException
          *             if there are any problem in parameters
          */
         void zipFolder(File rootFolder, File targetFile) throws IOException;
         /**
          * Informs if <code>folder</code> is a writable folder( exists & isDir &
          * canWrite)
+         *
          * @param folder
          * @return
          */
         boolean isWritableFolder(File folder);
         /**
          * Informs if <code>folder</code> is a readable folder( exists & isDir &
          * canRead)
+         *
          * @param folder
          * @return
          */
         boolean isReadableFolder(File folder);
         /**
          * Informs if <code>file</code> is a readable file ( exists & isFile &
          * canRead)
+         *
          * @param file
          * @return
          */
         boolean isReadableFile(File file);
         /**
          * <p>
          * Look for a folder on a <code>baseFolder</code> starts with
          * <code>baseName</code> which is writable.
          * </p>
          * <p>
          * The pattern is: <code>baseFolder/baseName.0000</code> where
          * <code>000</code> it's a counter.
          * </p>
+         *
          * @param baseFolder
          *            existing and writable folder
          * @param baseName
          *            start of new folder
          * @return new folder
          * @throws IllegalArgumentException
          *             if base folder is not a writable folder
          * @throws IllegalStateException
          *             if can't found a suitable folder
          */
         File getWritableFolder(File baseFolder, String baseName);
         /**
          * <p>
          * Create a new folder on a <code>baseFolder</code> starts with
          * <code>baseName</code> which is new and writable.
          * </p>
          * <p>
          * The pattern is: <code>baseFolder/baseName.0000</code> where
          * <code>000</code> it's a counter.
          * </p>
+         *
          * @param baseFolder
          *            existing and writable folder
          * @param baseName
          *            start of new folder
          * @return new folder
          * @throws IllegalArgumentException
          *             if base folder is not a writable folder
          * @throws IllegalStateException
          *             if can't found a suitable folder
          */
         File getNewWritableFolder(File baseFolder, String baseName);
         /**
          * <p>
          * Create {@link File} instance for a new file on a <code>baseFolder</code>
          * starts with <code>baseName</code>.
          * </p>
          * <p>
          * The pattern is: <code>baseFolder/baseName.0000.ext</code> where
          * <code>000</code> it's a counter.
          * </p>
          * <p>
          * This <b>no create</b> the file into the file system.
          * </p>
+         *
          * @param baseFolder
          *            existing and writable folder
          * @param name
          *            start of new file
          * @return new folder
          * @throws IllegalArgumentException
          *             if base folder is not a writable folder
          * @throws IllegalStateException
          *             if can't found a suitable folder
          */
         File getNewFileName(File baseFolder, String name);
         /**
          * <p>
          * Return <code>path</code> as relative from <code>basePath</code> only if
          * <code>basePath</code> is an ancestor of <code>path</code>:
          * </p>
+         *
          * @param path
          * @param basePath
          * @return
          * @see FilenameUtils#getRelativeTo(String, String)
          */
         File getRelativeTo(File path, File basePath);
         /**
          * <p>
          * Load a mapContext from a file adjusting file paths which are supposed
          * relatives to a folder
          * </p>
+         *
          * @param mapContext
          *            persistence file
          * @param relativaPathFolder
          *            for files refered in mapContext
          * @return
          * @throws IOException
          * @throws PersistenceException
          */
         MapContext loadMapContext(File mapContext, File relativaPathFolder)
             throws IOException, PersistenceException;
+    }

     /* gvSIG. Geographic Information System of the Valencian Government
+     *
      * Copyright (C) 2007-2008 Infrastructures and Transports Department
      * of the Valencian Government (CIT)
+     *
      * This program is free software; you can redistribute it and/or
      * modify it under the terms of the GNU General Public License
      * as published by the Free Software Foundation; either version 2
      * of the License, or (at your option) any later version.
+     *
      * This program is distributed in the hope that it will be useful,
      * but WITHOUT ANY WARRANTY; without even the implied warranty of
      * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      * GNU General Public License for more details.
+     *
      * You should have received a copy of the GNU General Public License
      * along with this program; if not, write to the Free Software
      * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
      * MA  02110-1301, USA.
+     *
      */
     package org.gvsig.educa.portableview;
     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 PortableView library, providing
      * access to all PortableView services through the {@link PortableViewManager} .
+     *
      * @author gvSIG team
      * @version $Id$
      */
     public class PortableViewLocator extends BaseLocator {
         /**
          * PortableView manager name.
          */
         public static final String MANAGER_NAME = "PortableView.manager";
         /**
          * PortableView manager description.
          */
         public static final String MANAGER_DESCRIPTION = "PortableView Manager";
         /**
          * PortableView file services name.
          */
         public static final String FILESERVICES_NAME = "PortableView.fileservices";
         /**
          * PortableView file services manager description.
          */
         public static final String FILESERVICES_DESCRIPTION =
             "PortableView File Servides";
         private static final String LOCATOR_NAME = "PortableView.locator";
         /**
          * Unique instance.
          */
         private static final PortableViewLocator INSTANCE = new PortableViewLocator();
         /**
          * Return the singleton instance.
+         *
          * @return the singleton instance
          */
         public static PortableViewLocator getInstance() {
             return INSTANCE;
+        }
         /**
          * Return the Locator's name.
+         *
          * @return a String with the Locator's name
          */
         @Override
         public final String getLocatorName() {
             return LOCATOR_NAME;
+        }
         /**
          * Return a reference to the PortableViewManager.
+         *
          * @return a reference to the PortableViewManager
          * @throws LocatorException
          *             if there is no access to the class or the class cannot be
          *             instantiated
          * @see Locator#get(String)
          */
         public static PortableViewManager getManager() throws LocatorException {
             return (PortableViewManager) getInstance().get(MANAGER_NAME);
+        }
         /**
          * Registers the Class implementing the PortableViewManager interface.
+         *
          * @param clazz
          *            implementing the PortableViewManager interface
          */
         public static void registerManager(Class<? extends PortableViewManager> clazz) {
             getInstance().register(MANAGER_NAME, MANAGER_DESCRIPTION, clazz);
+        }
         /**
          * Return a reference to the PortableViewFileServices.
+         *
          * @return a reference to the PortableViewFileServices
          * @throws LocatorException
          *             if there is no access to the class or the class cannot be
          *             instantiated
          * @see Locator#get(String)
          */
         public static PortableViewFileServices getFileServices()
             throws LocatorException {
             return (PortableViewFileServices) getInstance().get(FILESERVICES_NAME);
+        }
         /**
          * Registers the Class implementing the PortableViewFileServices interface.
+         *
          * @param clazz
          *            implementing the PortableViewFileServices interface
          */
         public static void registerFileServices(
             Class<? extends PortableViewFileServices> clazz) {
             getInstance().register(FILESERVICES_NAME, FILESERVICES_DESCRIPTION,
                 clazz);
+        }
+    }

     /* gvSIG. Geographic Information System of the Valencian Government
+     *
      * Copyright (C) 2007-2008 Infrastructures and Transports Department
      * of the Valencian Government (CIT)
+     *
      * This program is free software; you can redistribute it and/or
      * modify it under the terms of the GNU General Public License
      * as published by the Free Software Foundation; either version 2
      * of the License, or (at your option) any later version.
+     *
      * This program is distributed in the hope that it will be useful,
      * but WITHOUT ANY WARRANTY; without even the implied warranty of
      * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      * GNU General Public License for more details.
+     *
      * You should have received a copy of the GNU General Public License
      * along with this program; if not, write to the Free Software
      * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
      * MA  02110-1301, USA.
+     *
      */
     package org.gvsig.educa.portableview;
     import org.gvsig.fmap.dal.DALLibrary;
     import org.gvsig.fmap.mapcontext.MapContextLibrary;
     import org.gvsig.tools.library.AbstractLibrary;
     import org.gvsig.tools.library.LibraryException;
     import org.gvsig.tools.locator.ReferenceNotRegisteredException;
     /**
      * Library for API initialization and configuration.
+     *
      * @author gvSIG team
      * @version $Id$
      */
     public class PortableViewLibrary extends AbstractLibrary {
         @Override
         public void doRegistration() {
             registerAsAPI(PortableViewLibrary.class);
             require(DALLibrary.class);
             require(MapContextLibrary.class);
+        }
         @Override
         protected void doInitialize() throws LibraryException {
             // Do nothing
+        }
         @Override
         protected void doPostInitialize() throws LibraryException {
             // Validate there is any implementation registered.
             PortableViewManager manager = PortableViewLocator.getManager();
             if (manager == null) {
                 throw new ReferenceNotRegisteredException(
                     PortableViewLocator.MANAGER_NAME,
                     PortableViewLocator.getInstance());
+            }
+        }
+    }

     /* gvSIG. Geographic Information System of the Valencian Government
+     *
      * Copyright (C) 2007-2008 Infrastructures and Transports Department
      * of the Valencian Government (CIT)
+     *
      * This program is free software; you can redistribute it and/or
      * modify it under the terms of the GNU General Public License
      * as published by the Free Software Foundation; either version 2
      * of the License, or (at your option) any later version.
+     *
      * This program is distributed in the hope that it will be useful,
      * but WITHOUT ANY WARRANTY; without even the implied warranty of
      * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      * GNU General Public License for more details.
+     *
      * You should have received a copy of the GNU General Public License
      * along with this program; if not, write to the Free Software
      * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
      * MA  02110-1301, USA.
+     *
      */
     package org.gvsig.educa.portableview.map;
     import java.io.File;
     import org.gvsig.educa.portableview.PortableViewException;
     /**
      * Exception Throws when try to open a PortableView file with invalid format
+     *
      * @author gvSIG Team
      * @version $Id$
+     *
      */
     public class InvalidPortableViewFormatException extends PortableViewException {
         /**
+         *
          */
         private static final long serialVersionUID = 8895685032043751029L;
         private static final String MESSAGE =
             "Invalid format of a PortableView file [%(filePath)]: %(info)";
         private static final String KEY = "_InvalidPortableViewFormatException";
         /**
          * Invalid format of a portable view file by unspecified problem
+         *
          * @param mapFile
          */
         public InvalidPortableViewFormatException(File mapFile) {
             this(mapFile, "unspecified problem");
+        }
         /**
          * Invalid format of a portable view file
+         *
          * @param mapFile
          * @param message
          *            problem description
          */
         public InvalidPortableViewFormatException(File mapFile, String message) {
             super(MESSAGE, KEY, serialVersionUID);
             setValue("info", message);
             setValue("filePath", mapFile.getAbsolutePath());
+        }
         /**
          * Invalid format of a portable view file
+         *
          * @param mapFile
          * @param message
          *            problem description
          * @param cause
          */
         public InvalidPortableViewFormatException(File mapFile, String message,
             Throwable cause) {
             super(MESSAGE, cause, KEY, serialVersionUID);
             setValue("info", message);
             setValue("filePath", mapFile.getAbsolutePath());
+        }
         /**
          * Invalid format of a portable view file
+         *
          * @param mapFile
          */
         public InvalidPortableViewFormatException(File mapFile, Throwable cause) {
             this(mapFile, "initializing problem", cause);
+        }
+    }

     /* gvSIG. Geographic Information System of the Valencian Government
+     *
      * Copyright (C) 2007-2008 Infrastructures and Transports Department
      * of the Valencian Government (CIT)
+     *
      * This program is free software; you can redistribute it and/or
      * modify it under the terms of the GNU General Public License
      * as published by the Free Software Foundation; either version 2
      * of the License, or (at your option) any later version.
+     *
      * This program is distributed in the hope that it will be useful,
      * but WITHOUT ANY WARRANTY; without even the implied warranty of
      * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      * GNU General Public License for more details.
+     *
      * You should have received a copy of the GNU General Public License
      * along with this program; if not, write to the Free Software
      * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
      * MA  02110-1301, USA.
+     *
      */
     package org.gvsig.educa.portableview.map;
     import java.io.IOException;
     import org.gvsig.educa.portableview.PortableViewManager;
     import org.gvsig.fmap.mapcontext.MapContext;
     import org.gvsig.tools.dispose.Disposable;
     /**
      * <i>Portable View</i> instance.
      * </p>
      * This class' instances contains information about a installed <i>Portable
      * View</i>
+     *
      * @author <a href="http://www.disid.com">DiSiD Technologies S.L.</a>
      * @version $Rev$
      * @since {version}
      */
     public interface PortableView extends Disposable {
         /**
          * Gets information about this <i>Portable View</i>
+         *
          * @return
          */
         PortableViewInformation getInformation();
         /**
          * Opens this <i>Portable View</i>
          * </p>
          * This unzip <i>Portable View</i> contents into temporal folder (if it isn't
          * created yet)
          * and prepares data
          * </p>
          * unzip folder is defined in {@link PortableViewManager#getTemporalFolder()}
          * </p>
+         *
          * @throws InvalidPortableViewFormatException
          * @throws CantLoadContextException
          * @throws IOException
          */
         void open() throws InvalidPortableViewFormatException,
             CantLoadContextException, IOException;
         /**
          * Informs if <i>Portable View</i> it's already opened or not
+         *
          * @return if it's opened
          */
         boolean isOpen();
         /**
          * Unloads all data loaded in memory and cleans its temporal folder
+         *
          * @throws IOException
          *             if any problem is found cleaning temporal folder
+         *
          */
         void close() throws IOException;
         /**
          * Gets MapContext with <i>Portable View</i> representation
+         *
          * @return MapContext instance
          * @throws IllegalStateException
          *             if {@link #isOpen()} == false
          */
         MapContext getMapContext();
         /**
          * Gets the file which PortableView data
+         *
          * @return
          */
         String getSourceFilePath();
+    }

     /* gvSIG. Geographic Information System of the Valencian Government
+     *
      * Copyright (C) 2007-2008 Infrastructures and Transports Department
      * of the Valencian Government (CIT)
+     *
      * This program is free software; you can redistribute it and/or
      * modify it under the terms of the GNU General Public License
      * as published by the Free Software Foundation; either version 2
      * of the License, or (at your option) any later version.
+     *
      * This program is distributed in the hope that it will be useful,
      * but WITHOUT ANY WARRANTY; without even the implied warranty of
      * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      * GNU General Public License for more details.
+     *
      * You should have received a copy of the GNU General Public License
      * along with this program; if not, write to the Free Software
      * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
      * MA  02110-1301, USA.
+     *
      */
     package org.gvsig.educa.portableview.map;
     import java.io.File;
     import org.gvsig.educa.portableview.PortableViewException;
     /**
      * Exception Throws when try to load the MapContext of a PortableView file
+     *
      * @author gvSIG Team
      * @version $Id$
+     *
      */
     public class CantLoadContextException extends PortableViewException {
         /**
+         *
          */
         private static final long serialVersionUID = -6565034273641780414L;
         private static final String MESSAGE =
             "Problem loading MapContext file [%(mapContextPath)] of a PortableView file [%(mapPath)]: %(info)";
         private static final String KEY = "_CantLoadContextException";
         /**
          * Cannot load mapContext from a Portable view file
+         *
          * @param mapFile
          * @param mapContextFile
          * @param message
          *            problem description
          * @param cause
          */
         public CantLoadContextException(File mapFile, File mapContextFile,
             String message, Throwable cause) {
             super(MESSAGE, cause, KEY, serialVersionUID);
             setValue("info", message);
             setValue("mapPath", mapFile.getAbsolutePath());
             setValue("mapContextPath", mapContextFile.getAbsolutePath());
+        }
         /**
          * Cannot load mapContext from a Portable view file
+         *
          * @param mapFile
          * @param mapContextFile
          * @param cause
          */
         public CantLoadContextException(File mapFile, File mapContextFile,
             Throwable cause) {
             this(mapFile, mapContextFile, "loading problem", cause);
+        }
+    }

     /* gvSIG. Geographic Information System of the Valencian Government
+     *
      * Copyright (C) 2007-2008 Infrastructures and Transports Department
      * of the Valencian Government (CIT)
+     *
      * This program is free software; you can redistribute it and/or
      * modify it under the terms of the GNU General Public License
      * as published by the Free Software Foundation; either version 2
      * of the License, or (at your option) any later version.
+     *
      * This program is distributed in the hope that it will be useful,
      * but WITHOUT ANY WARRANTY; without even the implied warranty of
      * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      * GNU General Public License for more details.
+     *
      * You should have received a copy of the GNU General Public License
      * along with this program; if not, write to the Free Software
      * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
      * MA  02110-1301, USA.
+     *
      */
     package org.gvsig.educa.portableview.map;
     import java.io.File;
     import org.gvsig.educa.portableview.PortableViewException;
     /**
      * Exception Throws when try to open an installed PortableView folder with
      * invalid format (missing package.info file or no match data)
+     *
      * @author gvSIG Team
      * @version $Id$
+     *
      */
     public class InvalidInstalledPortableViewException extends PortableViewException {
         /**
+         *
          */
         private static final long serialVersionUID = 1L;
         private static final String MESSAGE =
             "Invalid format of an installed PortableView [%(folderPath)]: %(info)";
         private static final String KEY = "_InvalidInstalledPortableViewException";
         /**
          * Invalid format of an installed portable view folder by unspecified problem
+         *
          * @param mapFile
          */
         public InvalidInstalledPortableViewException(File mapFolder) {
             this(mapFolder, "unspecified problem");
+        }
         /**
          * Invalid format of a portable view file
+         *
          * @param mapFile
          * @param message
          *            problem description
          */
         public InvalidInstalledPortableViewException(File mapFolder, String message) {
             super(MESSAGE, KEY, serialVersionUID);
             setValue("info", message);
             setValue("folderPath", mapFolder.getAbsolutePath());
+        }
         /**
          * Invalid format of a portable view file
+         *
          * @param mapFile
          * @param message
          *            problem description
          * @param cause
          */
         public InvalidInstalledPortableViewException(File mapFolder, String message,
             Throwable cause) {
             super(MESSAGE, cause, KEY, serialVersionUID);
             setValue("info", message);
             setValue("folderPath", mapFolder.getAbsolutePath());
+        }
         /**
          * Invalid format of a portable view file
+         *
          * @param mapFile
          */
         public InvalidInstalledPortableViewException(File mapFile, Throwable cause) {
             this(mapFile, "initializing problem", cause);
+        }
+    }

     /* gvSIG. Geographic Information System of the Valencian Government
+     *
      * Copyright (C) 2007-2008 Infrastructures and Transports Department
      * of the Valencian Government (CIT)
+     *
      * This program is free software; you can redistribute it and/or
      * modify it under the terms of the GNU General Public License
      * as published by the Free Software Foundation; either version 2
      * of the License, or (at your option) any later version.
+     *
      * This program is distributed in the hope that it will be useful,
      * but WITHOUT ANY WARRANTY; without even the implied warranty of
      * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      * GNU General Public License for more details.
+     *
      * You should have received a copy of the GNU General Public License
      * along with this program; if not, write to the Free Software
      * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
      * MA  02110-1301, USA.
+     *
      */
     package org.gvsig.educa.portableview.map;
     import java.util.Date;
     import org.cresques.cts.IProjection;
     import org.omg.CORBA.DynValue;
     import org.gvsig.fmap.geom.primitive.Envelope;
     import org.gvsig.tools.dynobject.DynObject;
     import org.gvsig.tools.dynobject.DynStruct;
     /**
      * Information about a <i>Portable View</i>:
      * <ul>
      * <li>Name and description</li>
      * <li>Author</li>
      * <li>License</li>
      * </ul>
+     *
      * TODO Add more data
+     *
      * @author <a href="http://www.disid.com">DiSiD Technologies S.L.</a>
      * @version $Rev$
      * @since {version}
      */
     public interface PortableViewInformation {
         public static final String DYN_DEFINITION_NAME = "PortableViewInformation";
         /**
          * Gets <i>Portable View</i> identifier
+         *
          * @return
          */
         String getId();
         /**
          * Gets <i>Portable View</i> name
+         *
          * @return
          */
         String getName();
         /**
          * Gets <i>Portable View</i> description
+         *
          * @return
          */
         String getDescription();
         /**
          * Gets <i>Portable View</i> version
+         *
          * @return
          */
         int getVersion();
         /**
          * Gets <i>Portable View</i> build number
+         *
          * @return
          */
         int getBuildNumber();
         /**
          * Gets <i>Portable View</i> creation timestamp
+         *
          * @return
          */
         Date getCreationTimestamp();
         /**
          * Gets full envelope
+         *
          * @return
          */
         Envelope getFullEnvelope();
         /**
          * Returns CRS
+         *
          * @return
          */
         IProjection getCRS();
         /**
          * Returns {@link DynValue} definition
+         *
          * @return
          */
         DynStruct getDynDefinition();
         /**
          * Returns {@link DynObject} description
+         *
          * @return
          */
         DynObject getDynObject();
+    }

     /* gvSIG. Geographic Information System of the Valencian Government
+     *
      * Copyright (C) 2007-2008 Infrastructures and Transports Department
      * of the Valencian Government (CIT)
+     *
      * This program is free software; you can redistribute it and/or
      * modify it under the terms of the GNU General Public License
      * as published by the Free Software Foundation; either version 2
      * of the License, or (at your option) any later version.
+     *
      * This program is distributed in the hope that it will be useful,
      * but WITHOUT ANY WARRANTY; without even the implied warranty of
      * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      * GNU General Public License for more details.
+     *
      * You should have received a copy of the GNU General Public License
      * along with this program; if not, write to the Free Software
      * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
      * MA  02110-1301, USA.
+     *
      */
     package org.gvsig.educa.portableview;
     import java.io.File;
     import java.io.IOException;
     import java.util.List;
     import org.gvsig.educa.portableview.compilation.PortableViewCompilation;
     import org.gvsig.educa.portableview.compilation.PortableViewCompiler;
     import org.gvsig.educa.portableview.map.CantLoadContextException;
     import org.gvsig.educa.portableview.map.InvalidPortableViewFormatException;
     import org.gvsig.educa.portableview.map.PortableView;
     import org.gvsig.educa.portableview.map.PortableViewInformation;
     import org.gvsig.tools.dispose.Disposable;
     /**
      * Library Manager.
      * </p>
      * Expose main library's functionalities:
      * <ul>
      * <li>Set default folders configuration</li>
      * <li>Get installed <i>Portable View</i></li>
      * <li>Identify and get a <i>Portable View</i> from a file</li>
      * <li>Create a new {@link PortableViewCompilation} instance</li>
      * <li>Create a new {@link PortableViewCompiler} instance</li>
      * </ul>
+     *
      * @author gvSIG team
      * @version $Id$
      */
     public interface PortableViewManager extends Disposable {
         public static final String  INSTALLER_PROVIDER_NAME = "PortableView";
         /**
          * Gets default folder to locate installed <i>Portable View</i>
+         *
          * @return default installation folder
          */
         String getInstallationMapFolder();
         /**
          * Sets default folder to locate installed <i>Portable View</i>

Aplicación gvSIG con fines educativos » gvSIG educa bugs

Revision 510