Application: gvSIG desktop » gvSIG data provider for GPE

org.gvsig.gpe.lib.api.GPELibrary

/* gvSIG. Geographic Information System of the Valencian Government

*

* Copyright (C) 2007-2008 Infrastructures and Transports Department

* of the Valencian Government (CIT)

* 

* This program is free software; you can redistribute it and/or

* modify it under the terms of the GNU General Public License

* as published by the Free Software Foundation; either version 2

* of the License, or (at your option) any later version.

* 

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

* GNU General Public License for more details.

* 

* You should have received a copy of the GNU General Public License

* along with this program; if not, write to the Free Software

* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, 

* MA  02110-1301, USA.

* 

*/

/*

* AUTHORS (In addition to CIT):

* 2009 {Iver T.I.}   {Task}

*/

package org.gvsig.gpe.lib.api;

import org.gvsig.tools.locator.AbstractLocator;

import org.gvsig.tools.locator.Locator;

import org.gvsig.tools.locator.LocatorException;

/**

 * This Locator provides the entry point for the gvSIG 

 * {@link GPEManager}

 * @see Locator

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

 */

public class GPELocator extends AbstractLocator {

	private static final String LOCATOR_NAME = "GPELocator";

	/**

	 * GPEManager name used by the locator to access the instance

	 */

	public static final String GPE_MANAGER_NAME = "GPEManager";

	private static final String GPE_MANAGER_DESCRIPTION = "GPEManager of gvSIG";

	/**

	 * GPEDatatTypesManager name used by the locator to access the instance

	 */

	public static final String GPE_DATATYPES_MANAGER_NAME = "GPEDatatypesManager";

	private static final String GPE_DATATYPES_MANAGER_DESCRIPTION = "GPEDatattypeManager of gvSIG";

	/**

	 * Unique instance.

	 */

	private static final GPELocator instance = new GPELocator();

	/* (non-Javadoc)

	 * @see org.gvsig.tools.locator.Locator#getLocatorName()

	 */

	public String getLocatorName() {

		return LOCATOR_NAME;

	}

	/**

	 * Return a reference to {@link GPEManager}.

	 *

	 * @return a reference to GPEManager

	 * @throws LocatorException

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

	 *             instantiated

	 * @see Locator#get(String)

	 */

	public static GPEManager getGPEManager() throws LocatorException {

		return (GPEManager) getInstance().get(GPE_MANAGER_NAME);

	}

	/**

	 * Return the singleton instance.

	 *

	 * @return the singleton instance

	 */

	public static GPELocator getInstance() {

		return instance;

	}

	/**

	 * Registers the Class implementing the {@link GPEManager} interface.

	 *

	 * @param clazz

	 *            implementing the GeometryManager interface

	 */

	public static void registerGPEManager(Class clazz) {

		getInstance().register(GPE_MANAGER_NAME, 

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

* 

*/

/*

* AUTHORS (In addition to CIT):

* 2009 {Iver T.I.}   {Task}

*/

package org.gvsig.gpe.lib.api;

import org.gvsig.tools.library.AbstractLibrary;

import org.gvsig.tools.library.LibraryException;

/**

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

 */

public class GPELibrary extends AbstractLibrary  {

	public void doRegistration() {

		registerAsAPI(GPELibrary.class);

	}

	protected void doInitialize() throws LibraryException {

		// Nothing to do

	}

	protected void doPostInitialize() throws LibraryException {

		// Nothing to do		

	}

}

/* gvSIG. Geographic Information System of the Valencian Government

*

* Copyright (C) 2007-2008 Infrastructures and Transports Department

* of the Valencian Government (CIT)

* 

* This program is free software; you can redistribute it and/or

* modify it under the terms of the GNU General Public License

* as published by the Free Software Foundation; either version 2

* of the License, or (at your option) any later version.

* 

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

* GNU General Public License for more details.

* 

* You should have received a copy of the GNU General Public License

* along with this program; if not, write to the Free Software

* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, 

* MA  02110-1301, USA.

* 

*/

/*

* AUTHORS (In addition to CIT):

* 2008 Iver T.I.  {{Task}}

*/

package org.gvsig.gpe.lib.api.exceptions;

import java.util.Hashtable;

import java.util.Map;

public class WriterHandlerNotRegisteredException  extends WriterHandlerCreationException {

	/**

	 * 

	 */

	private static final long serialVersionUID = 3901631250887201546L;

	private String className = null;

	public WriterHandlerNotRegisteredException(String className) {

		this.className = className;

		initialize();		

	}

	/**

	 * Initialize the properties

	 */

	private void initialize() {

		messageKey = "gpe_writer_handler_creation_class_not_registered";

		formatString = "The writer with class name %(className) " +

			"has not been registered yet";

	}

	/*

	 *  (non-Javadoc)

	 * @see org.gvsig.tools.exception.BaseException#values()

	 */

	protected Map values() {

		Hashtable params = new Hashtable();

		params.put("className",className);			

		return params;	

	}

}

/* gvSIG. Geographic Information System of the Valencian Government

*

* Copyright (C) 2007-2008 Infrastructures and Transports Department

* of the Valencian Government (CIT)

* 

* This program is free software; you can redistribute it and/or

* modify it under the terms of the GNU General Public License

* as published by the Free Software Foundation; either version 2

* of the License, or (at your option) any later version.

* 

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

* GNU General Public License for more details.

* 

* You should have received a copy of the GNU General Public License

* along with this program; if not, write to the Free Software

* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, 

* MA  02110-1301, USA.

* 

*/

/*

* AUTHORS (In addition to CIT):

* 2008 Iver T.I.  {{Task}}

*/

package org.gvsig.gpe.lib.api.exceptions;

import java.util.Hashtable;

import java.util.Map;

public class ParserNameNotFoundException extends ParserCreationException {

	/**

	 * 

	 */

	private static final long serialVersionUID = -6315192736102348696L;

	private String name = null;

	public ParserNameNotFoundException(String name) {

		this.name = name;

		initialize();		

	}

	/**

	 * Initialize the properties

	 */

	private void initialize() {

		messageKey = "gpe_parser_creation_name_not_found";

		formatString = "The parser with name %(name) has not been found ";

	}

	/*

	 *  (non-Javadoc)

	 * @see org.gvsig.tools.exception.BaseException#values()

	 */

	protected Map values() {

		Hashtable params = new Hashtable();

		params.put("name",name);			

		return params;	

	}

}

/* gvSIG. Geographic Information System of the Valencian Government

*

* Copyright (C) 2007-2008 Infrastructures and Transports Department

* of the Valencian Government (CIT)

* 

* This program is free software; you can redistribute it and/or

* modify it under the terms of the GNU General Public License

* as published by the Free Software Foundation; either version 2

* of the License, or (at your option) any later version.

* 

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

* GNU General Public License for more details.

* 

* You should have received a copy of the GNU General Public License

* along with this program; if not, write to the Free Software

* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, 

* MA  02110-1301, USA.

* 

*/

/*

* AUTHORS (In addition to CIT):

* 2008 Iver T.I.  {{Task}}

*/

package org.gvsig.gpe.lib.api.exceptions;

import java.util.Hashtable;

import java.util.Map;

public class ParserNotRegisteredException extends ParserCreationException {

	/**

	 * 

	 */

	private static final long serialVersionUID = 526423919232532055L;

	private String className = null;

	public ParserNotRegisteredException(String className) {

		this.className = className;

		initialize();		

	}

	/**

	 * Initialize the properties

	 */

	private void initialize() {

		messageKey = "gpe_parser_creation_class_not_registered";

		formatString = "The parser with class name %(className) " +

			"has not been registered yet";

	}

	/*

	 *  (non-Javadoc)

	 * @see org.gvsig.tools.exception.BaseException#values()

	 */

	protected Map values() {

		Hashtable params = new Hashtable();

		params.put("className",className);			

		return params;	

	}

}

/* gvSIG. Geographic Information System of the Valencian Government

*

* Copyright (C) 2007-2008 Infrastructures and Transports Department

* of the Valencian Government (CIT)

* 

* This program is free software; you can redistribute it and/or

* modify it under the terms of the GNU General Public License

* as published by the Free Software Foundation; either version 2

* of the License, or (at your option) any later version.

* 

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

* GNU General Public License for more details.

* 

* You should have received a copy of the GNU General Public License

* along with this program; if not, write to the Free Software

* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, 

* MA  02110-1301, USA.

* 

*/

/*

* AUTHORS (In addition to CIT):

* 2008 Iver T.I.  {{Task}}

*/

package org.gvsig.gpe.lib.api.exceptions;

import java.util.Hashtable;

import java.util.Map;

public class WriterHandlerMimeTypeNotSupportedException extends WriterHandlerCreationException {

	/**

	 * 

	 */

	private static final long serialVersionUID = -8043491289837882507L;

	private String mimeType = null;

	public WriterHandlerMimeTypeNotSupportedException(String mimeType) {

		this.mimeType = mimeType;

		initialize();		

	}

	/**

	 * Initialize the properties

	 */

	private void initialize() {

		messageKey = "gpe_writer_handler_creation_mimetype_not_found";

		formatString = "There is not a writer to write the mimetype %(mimetype)";

	}

	/*

	 *  (non-Javadoc)

	 * @see org.gvsig.tools.exception.BaseException#values()

	 */

	protected Map values() {

		Hashtable params = new Hashtable();

		params.put("mimetype",mimeType);			

		return params;	

	}

}

/* gvSIG. Geographic Information System of the Valencian Government

*

* Copyright (C) 2007-2008 Infrastructures and Transports Department

* of the Valencian Government (CIT)

* 

* This program is free software; you can redistribute it and/or

* modify it under the terms of the GNU General Public License

* as published by the Free Software Foundation; either version 2

* of the License, or (at your option) any later version.

* 

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

* GNU General Public License for more details.

* 

* You should have received a copy of the GNU General Public License

* along with this program; if not, write to the Free Software

* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, 

* MA  02110-1301, USA.

* 

*/

/*

* AUTHORS (In addition to CIT):

* 2008 Iver T.I.  {{Task}}

*/

package org.gvsig.gpe.lib.api.exceptions;

import java.util.Hashtable;

import java.util.Map;

public class ParserMimetypeNotSupportedException extends ParserCreationException {

	/**

	 * 

	 */

	private static final long serialVersionUID = 9064233953718286477L;

	private String mimeType = null;

	public ParserMimetypeNotSupportedException(String mimeType) {

		this.mimeType = mimeType;

		initialize();		

	}

	/**

	 * Initialize the properties

	 */

	private void initialize() {

		messageKey = "gpe_parser_creation_mimetype_not_found";

		formatString = "There is not a parser to parse the mimetype %(mimetype)";

	}

	/*

	 *  (non-Javadoc)

	 * @see org.gvsig.tools.exception.BaseException#values()

	 */

	protected Map values() {

		Hashtable params = new Hashtable();

		params.put("mimetype",mimeType);			

		return params;	

	}

}

/* gvSIG. Geographic Information System of the Valencian Government

*

* Copyright (C) 2007-2008 Infrastructures and Transports Department

* of the Valencian Government (CIT)

* 

* This program is free software; you can redistribute it and/or

* modify it under the terms of the GNU General Public License

* as published by the Free Software Foundation; either version 2

* of the License, or (at your option) any later version.

* 

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

* GNU General Public License for more details.

* 

* You should have received a copy of the GNU General Public License

* along with this program; if not, write to the Free Software

* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, 

* MA  02110-1301, USA.

* 

*/

/*

* AUTHORS (In addition to CIT):

* 2008 Iver T.I.  {{Task}}

*/

package org.gvsig.gpe.lib.api.exceptions;

import java.util.HashMap;

import java.util.Map;

import org.gvsig.tools.exception.BaseException;

/**

 * This exception is thrown it has been an error in the

 * writer creation. The reason for this error can be other

 * exception or a detailed error.  

 */

public class WriterHandlerCreationException extends BaseException {

	/**

	 * 

	 */

	private static final long serialVersionUID = 3512666764912250722L;

	public WriterHandlerCreationException() {

		super();

		initialize();	

	}

	public WriterHandlerCreationException(Throwable e) {

		super();

		initCause(e);

		initialize();	

	}

	/**

	 * Initialize the properties

	 */

	private void initialize() {

		messageKey = "gpe_writer_handler_creation_exception";

		formatString = "Impossible to create a writer";

	}

	/*

	 * (non-Javadoc)

	 * @see org.gvsig.tools.exception.BaseException#values()

	 */

	protected Map values() {

		return new HashMap();

	}

}

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 * 

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 * 

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 * 

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, 

 * MA  02110-1301, USA.

 * 

 */

/*

 * AUTHORS (In addition to CIT):

 * 2008 Iver T.I.  {{Task}}

 */

package org.gvsig.gpe.lib.api.exceptions;

import java.util.HashMap;

import java.util.Map;

import org.gvsig.tools.exception.BaseException;

/**

 * This exception is thrown it has been an error in the

 * parser creation. The reason for this error can be other

 * exception or a detailed error.  

 */

public class ParserCreationException extends BaseException {

	private static final long serialVersionUID = 5482517192827506712L;

	public ParserCreationException() {

		super();

		initialize();	

	}

	public ParserCreationException(Throwable e) {

		super();

		initCause(e);

		initialize();	

	}

	/**

	 * Initialize the properties

	 */

	private void initialize() {

		messageKey = "gpe_parser_creation_exception";

		formatString = "Impossible to create a parser";

	}

	/*

	 * (non-Javadoc)

	 * @see org.gvsig.tools.exception.BaseException#values()

	 */

	protected Map values() {

		return new HashMap();

	}

}

/* gvSIG. Geographic Information System of the Valencian Government

*

* Copyright (C) 2007-2008 Infrastructures and Transports Department

* of the Valencian Government (CIT)

* 

* This program is free software; you can redistribute it and/or

* modify it under the terms of the GNU General Public License

* as published by the Free Software Foundation; either version 2

* of the License, or (at your option) any later version.

* 

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

* GNU General Public License for more details.

* 

* You should have received a copy of the GNU General Public License

* along with this program; if not, write to the Free Software

* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, 

* MA  02110-1301, USA.

* 

*/

/*

* AUTHORS (In addition to CIT):

* 2008 Iver T.I.  {{Task}}

*/

package org.gvsig.gpe.lib.api.exceptions;

import java.io.File;

import java.net.URI;

import java.util.Hashtable;

import java.util.Map;

public class ParserFileNotSupportedException extends ParserCreationException {

	/**

	 * 

	 */

	private static final long serialVersionUID = 576971727796678053L;

	private String uri = null;

	public ParserFileNotSupportedException(URI uri) {

		this.uri = uri.toString();

		initialize();		

	}

	public ParserFileNotSupportedException(File file) {

		this.uri = file.getAbsolutePath();

		initialize();		

	}

	/**

	 * Initialize the properties

	 */

	private void initialize() {

		messageKey = "gpe_parser_creation_uri_not_found";

		formatString = "There is not a parser to parse the resource %(uri)";

	}

	/*

	 *  (non-Javadoc)

	 * @see org.gvsig.tools.exception.BaseException#values()

	 */

	protected Map values() {

		Hashtable params = new Hashtable();

		params.put("uri",uri);			

		return params;	

	}

}

/* gvSIG. Geographic Information System of the Valencian Government

*

* Copyright (C) 2007-2008 Infrastructures and Transports Department

* of the Valencian Government (CIT)

*

* This program is free software; you can redistribute it and/or

* modify it under the terms of the GNU General Public License

* as published by the Free Software Foundation; either version 2

* of the License, or (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program; if not, write to the Free Software

* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

* MA  02110-1301, USA.

*

*/

/*

* AUTHORS (In addition to CIT):

* 2009 {Iver T.I.}   {Task}

*/

package org.gvsig.gpe.lib.api;

import java.io.File;

import java.net.URI;

import java.util.Iterator;

import org.gvsig.gpe.lib.api.exceptions.ParserCreationException;

import org.gvsig.gpe.lib.api.exceptions.WriterHandlerCreationException;

import org.gvsig.gpe.lib.api.parser.IGPEContentHandler;

import org.gvsig.gpe.lib.api.parser.IGPEContentHandlerInmGeom;

import org.gvsig.gpe.lib.api.parser.IGPEErrorHandler;

import org.gvsig.gpe.lib.api.writer.IGPEWriterHandler;

/**

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

 */

public interface GPEManager {

    /**

     * Return true if exists a driver that can open the file

     * @param uri

     * File to open

     * @return

     * true if the driver exists

     */

    public boolean accept(URI uri);

    /**

	 * Method to parse a file. It cannot to throw

	 * any exception and it cannot to return any value.

	 * In a future it could be implemented like a independent

	 * thread

	 * @param contents

	 * Application ContentHandler

	 * @param errors

	 * Application ErrorsHandler

	 * @param uri

	 * File to open

	 * @throws ParserCreationException

	 * @throws Exception

	 */

	public void parse(IGPEContentHandler contents, IGPEErrorHandler errors, URI uri) throws ParserCreationException;

	/**

	 * Method to parse a file. It cannot to throw

	 * any exception and it cannot to return any value.

	 * In a future it could be implemented like a independent

	 * thread

	 * @param contents

	 * Application ContentHandler

	 * @param errors

	 * Application ErrorsHandler

	 * @param file

	 * File to open

	 * @throws ParserCreationException

	 * @throws Exception

	 */

	public void parse(IGPEContentHandler contents, IGPEErrorHandler errors, File file) throws ParserCreationException;

	 /**

	 * Method to parse a file. It cannot to throw

	 * any exception and it cannot to return any value.

	 * In a future it could be implemented like a independent

	 * thread

	 * @param contents

	 * Application ContentHandler

	 * @param errors

	 * Application ErrorsHandler

	 * @param uri

	 * File to open

	 * @throws ParserCreationException

	 * @throws Exception

	 */

	public void parse(IGPEContentHandlerInmGeom contents, IGPEErrorHandler errors, URI uri) throws ParserCreationException;

	/**

	 * Method to parse a file. It cannot to throw

	 * any exception and it cannot to return any value.

	 * In a future it could be implemented like a independent

	 * thread

	 * @param contents

	 * Application ContentHandler

	 * @param errors

	 * Application ErrorsHandler

	 * @param file

	 * File to open

	 * @throws ParserCreationException

	 * @throws Exception

	 */

	public void parse(IGPEContentHandlerInmGeom contents, IGPEErrorHandler errors, File file) throws ParserCreationException;

	/**

	 * Create a new content writer from a name

	 * @param name

	 * GPEWriterHandler name

	 * GPEParser name

	 * @param contenHandler

	 * Application contenHandler usett to throw the parsing events

	 * @param errorHandler

	 * Application errror handler used to put errors and warnings

	 * @throws GPEWriterHandlerCreationException

	 */

	public IGPEWriterHandler createWriter(String name) throws WriterHandlerCreationException;

	/**

	 * Create a new writer from a class name. This method can be used

	 * if the class name is known but, the common method to get a writer

	 * is using the mime type.     *

	 * @param prefferredImplClassName

	 * The name of the class that implements {@link GPEWriterHandler}

	 * @return

	 * A writer for a concrete format.

	 * @throws WriterHandlerCreationException

	 * If it is not possible to create a writer

	 */

	public IGPEWriterHandler createWriterByClass(String prefferredImplClassName) throws WriterHandlerCreationException;

	/**

	 * Create a new writer from a mime type. Each writer has a method

	 * named {@link GPEWriterHandler#getFormat()} that returns the mimetype

	 * that the writer can write. One writer only supports one mimetype.

	 * <p>

	 * This method retrieve all the writers and returns the first

	 * one that is able to write the mimetype. If there are more

	 * writer that can write the format will not be used.

	 * </p>

	 * @param mimeType

	 * The mimetype of the file to write

	 * @return

	 * A writer that can write the mimetype.

	 * @throws WriterHandlerCreationException

	 * If it is not possible to create a writer

	 * @see

	 * <a href="http://www.iana.org/assignments/media-types/">http://www.iana.org/assignments/media-types/</a>

	 */

	public IGPEWriterHandler createWriterByMimeType(String mimeType) throws WriterHandlerCreationException;

	/**

	 * Returns an iterator with the name of all the properties that

	 * has been established.

	 */

	public Iterator getKeys();

	/**

	 * Gets a String property

	 * @param key

	 * Property name

	 * @return

	 */

	public String getStringProperty(String key);

	/**

	 * Gets a int property

	 * @param key

	 * Property name

	 * @return

	 * The int property or -1

	 */

	public int getIntPropertyProperty(String key);

	/**

	 * Gets a boolean property. If the property doesn't exist

	 * it returns false.

	 * @param key

	 * Property name

	 * @return

	 * The boolean property or false

	 */

	public boolean getBooleanProperty(String key);

	/**

	 * Gets a property

	 * @param key

	 * Property name

	 * @return

	 */

	public Object getProperty(String key);

	/**

	 * Sets a property

	 * @param key

	 * @param value

	 */

	public void setProperty(String key, Object value);

	public String getDefaultProjection(File file) throws ParserCreationException;

}

/* gvSIG. Geographic Information System of the Valencian Government

*

* Copyright (C) 2007-2008 Infrastructures and Transports Department

* of the Valencian Government (CIT)

* 

* This program is free software; you can redistribute it and/or

* modify it under the terms of the GNU General Public License

* as published by the Free Software Foundation; either version 2

* of the License, or (at your option) any later version.

* 

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

* GNU General Public License for more details.

* 

* You should have received a copy of the GNU General Public License

* along with this program; if not, write to the Free Software

* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, 

* MA  02110-1301, USA.

* 

*/

/*

* AUTHORS (In addition to CIT):

* 2008 Iver T.I.  {{Task}}

*/

package org.gvsig.gpe.lib.api;

/**

 * This class contains the generic properties for all the 

 * GPE parsers and writers. 

 */

public class GPEProperties {

	public static final String DECIMAL_DIGITS = "decimalDigits";

}

package org.gvsig.gpe.lib.api.parser;

/* gvSIG. Sistema de Informaci?n Geogr?fica de la Generalitat Valenciana

 *

 * Copyright (C) 2004 IVER T.I. and Generalitat Valenciana.

 *

 * 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., 59 Temple Place - Suite 330, Boston, MA  02111-1307,USA.

 *

 * For more information, contact:

 *

 *  Generalitat Valenciana

 *   Conselleria d'Infraestructures i Transport

 *   Av. Blasco Ib??ez, 50

 *   46010 VALENCIA

 *   SPAIN

 *

 *      +34 963862235

 *   gvsig@gva.es

 *      www.gvsig.gva.es

 *

 *    or

 *

 *   IVER T.I. S.A

 *   Salamanca 50

 *   46005 Valencia

 *   Spain

 *

 *   +34 963163400

 *   dac@iver.es

 */

/* CVS MESSAGES:

 *

 * $Id: IGPEErrorHandler.java 153 2007-06-20 09:35:37Z jorpiell $

 * $Log$

 * Revision 1.4  2007/06/20 09:35:37  jorpiell

 * Add the javadoc comments

 *

 * Revision 1.3  2007/04/19 07:23:20  jorpiell

 * Add the add methods to teh contenhandler and change the register mode

 *

 * Revision 1.2  2007/04/12 17:06:42  jorpiell

 * First GML writing tests

 *

 * Revision 1.1  2007/04/11 08:46:21  csanchez

 * Actualizacion protoripo libGPE

 *

 *

 */

/**

 * This interface defines the GPE error handler. It has methods

 * to register the errors and the warnings that can happen

 * wherear a parser is reading or writing a file. 

 * @author Jorge Piera Llodr? (jorge.piera@iver.es)

 * @author Carlos S?nchez Peri??n (sanchez_carper@gva.es)

 */

public interface IGPEErrorHandler {

	/**

	 * This method is invoked when a parser has found

	 * an error that has to stop the reading or the writing 

	 * process

	 * @param e

	 * The detected exception

	 */

	public void addError(Throwable e);

	public int getErrorsSize();

	public Throwable getErrorAt(int i);

	/**

	 * This method is invoke when a parser has detected a

	 * error, but it is able to manage it by itself

	 * @param e

	 * The detected exception

	 */

	public void addWarning(Throwable e);

	public int getWarningsSize();

	public Throwable getWarningAt(int i);

}

package org.gvsig.gpe.lib.api.parser;

/* gvSIG. Sistema de Informaci?n Geogr?fica de la Generalitat Valenciana

*

* Copyright (C) 2004 IVER T.I. and Generalitat Valenciana.

*

* 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., 59 Temple Place - Suite 330, Boston, MA  02111-1307,USA.

*

* For more information, contact:

*

*  Generalitat Valenciana

*   Conselleria d'Infraestructures i Transport

*   Av. Blasco Ib??ez, 50

*   46010 VALENCIA

*   SPAIN

*

*      +34 963862235

*   gvsig@gva.es

*      www.gvsig.gva.es

*

*    or

*

*   IVER T.I. S.A

*   Salamanca 50

*   46005 Valencia

*   Spain

*

*   +34 963163400

*   dac@iver.es

*/

/* CVS MESSAGES:

*

* $Id: IGPEContentHandler.java 202 2007-11-27 12:00:11Z jpiera $

* $Log$

* Revision 1.18  2007/06/20 09:35:37  jorpiell

* Add the javadoc comments

*

* Revision 1.17  2007/06/19 10:34:51  jorpiell

* Add some comments and creates a warning when an operation is not supported

*

*

*/

/**

 * This interface defines the "contract" between the consumer

 * application and libGPE. It has methods that will be invoke

 * by the parser every time that an event happens

 * @author Jorge Piera Llodr? (jorge.piera@iver.es)

 * @author Carlos S?nchez Peri??n (sanchez_carper@gva.es)

 */

public interface IGPEContentHandler extends IGPEContentHandlerSFP0{

	/**

	 * This method is thrown when the parser find a new

	 * bounding box.

	 * @param id

	 * Bounding box identifier

	 * @param coords

	 * A coordinates iterator

	 * @param srs

	 * Spatial reference system

	 * @return

	 * The consumer application object that represents

	 *  a bounding box

	 */

	public Object startBbox(String id, ICoordinateIterator coords, String srs);

	/**

	 * This method indicates that the parser thas finished to

	 * parse the bounding box.

	 * @param bbox

	 * The consumer application object that represents a

	 * bounding box

	 */

	public void endBbox(Object bbox);

	/**

	 * It is thrown every time that a new layer is detected.

	 * @param id

	 * Layer identifier

	 * @param namespace

	 * XML namespace

	 * @param name

	 * Layer name

	 * @param description

	 * Layer description

	 * @param srs

	 * Layer spatial reference system

	 * @param attributes

	 * Layer attributes

	 * @param parentLayer

	 * Layer that contains it

	 * @param bBox

	 * Layer bounding box

	 * @return

	 * The consumer application object that represents a layer

	 */

	public Object startLayer(String id,  String namespace, String name, String description,

			String srs, IAttributesIterator attributes, Object parentLayer, Object bBox);

	/**

	 * It is thrown when a layer has been finished to parse.

	 * @param layer

	 * The consumer application object that represents a layer

	 */

	public void endLayer(Object layer);

	/**

	 * It adds a name to one layer that has been previously

	 * created using the startLayer method.

	 * @param name

	 * Layer name

	 * @param layer

	 * The consumer application object that represents a layer

	 */

	public void addNameToLayer(String name, Object layer);

	/**

	 * It adds the description to one layer that has been previously

	 * created using the startLayer method.

	 * @param description

	 * Layer description

	 * @param layer

	 * The consumer application object that represents a layer

	 */

	public void addDescriptionToLayer(String description, Object layer);

	/**

	 * It adds a spatial reference system to one layer that

	 * has been previously created using the startLayer method.

	 * @param srs

	 * Spatial reference system

	 * @param layer

	 * The consumer application object that represents a layer

	 */

	public void addSrsToLayer(String srs, Object Layer);

	/**

	 * It establish the relationship parent-child between two layers

	 * that have been previously created using the startLayer method.

	 * @param parent

	 * The consumer application object that represents the parent layer

	 * @param layer

	 * The consumer application object that represents the child layer

	 */

	public void addParentLayerToLayer(Object parent, Object layer);

	/**

	 * It adds a bounding box to one layer that  has been previously

	 * created using the startLayer method.

	 * @param bbox

	 * Layer bounding box

	 * @param layer

	 * The consumer application object that represents a layer

	 */

	public void addBboxToLayer(Object bbox, Object layer);

	/**

	 * It is thrown when the parser has found a new feature.

	 * @param id

	 * Feature identifier

	 * @param name

	 * Feature name

	 * @param namespace

	 * XML namespace

	 * @param attributes

	 * Feature attributes

	 * @param layer

	 * Consumer application object that represents a layer

	 * @return

	 * Consumer application object that represents a feature

	 */

	public Object startFeature(String id, String namespace, String name, IAttributesIterator attributes, Object layer);

	/**

	 * This method is thrown when the parser has finished to

	 * parse a feature.

	 * @param feature

	 * Consumer application object that represents a feature

	 */

	public void endFeature(Object feature);

	/**

	 * This method adds a name to one layer that has been

	 * previously created using the startFeature method.

	 * @param name

	 * Feature name

	 * @param feature

     * Consumer application object that represents a feature

	 */

	public void addNameToFeature(String name, Object feature);

	/**

	 * This method adds a feature to one layer that has been

	 * previously created using the startLayer method.

	 * @param feature

	 * Consumer application object that represents a feature

	 * @param layer

	 * Consumer application object that represents a layer

	 */

	public void addFeatureToLayer(Object feature, Object layer);

	/**

	 * It is thrown when the parser has found a new element

	 * @param namespace

	 * XML namespace

	 * @param name

	 * Element name

	 * @param value

	 * Element value

	 * @param attributes

	 * Element attributes

	 * @param parentElement

	 * The parent of this element (if exists)

	 * @return

	 * Consumer application object that represents an element

	 */

	public Object startElement(String namespace, String name, Object value,

			IAttributesIterator attributes, Object parentElement);

	/**

	 * This method is thrown when the parser find the end

	 * of an element.

	 * @param element

	 * Consumer application object that represents an element

	 */

	public void endElement(Object element);

	/**

	 * It is thrown to establish a relationship parent-child

	 * between two elements.

	 * @param parent

	 * Consumer application object that represents the parent element

	 * @param element

	 * Consumer application object that represents the child element

	 */

	public void addParentElementToElement(Object parent, Object element);

	/**

	 * This method adds an element to one feature that has been

	 * previously created using the startFeature method

	 * @param element

	 * Consumer application object that represents an element

	 * @param feature

	 * Consumer application object that represents the feature

	 */

	public void addElementToFeature(Object element, Object feature);

	/**

	 * This method indicates that the parser has found a point.

	 * @param id

	 * Point identifier

	 * @param coords

	 * A coordinates iterator

	 * @param srs

	 * Spatial reference system

	 * @return

	 * Consumer application object that represents a point

	 */

	public Object startPoint(String id, ICoordinateIterator coords, String srs);

	/**

	 * It is thrown when the point has been completely parsed.

	 * @param point

	 * Consumer application object that represents a point

	 */

	public void endPoint(Object point);

	/**

	 * This method indicates that the parser has found a lineString.

	 * @param id

	 * LineString identifier

	 * @param coords

	 * A coordinates iterator