Application: gvSIG desktop » gvSIG projections

/**

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

 */

package org.gvsig.proj;

import org.gvsig.proj.catalogue.CRSDefinition;

import org.gvsig.proj.catalogue.CoordinateOperationDefinition;

import org.gvsig.tools.dynobject.DynObject;

/**

 * This class is responsible of the management of the CoordinateReferenceSystem

 * library's business logic.

 * It is the library's main entry point, and provides all the services to manage

 * {@link CoordinateReferenceSystem}s.

 * 

 * @author gvSIG team

 * @version $Id$

 */

public interface CoordinateReferenceSystemManager {

        /**

         * Returns a Coordinate Reference System.

         * @param wkt

         *            a WKT definition or a CRS code using the 

         *            AUTHORITY:CODE format.

         */

        CoordinateReferenceSystem getCoordinateReferenceSystem(

                        String wkt)

                                        throws CoordinateReferenceSystemNotFoundException;

        /**

         * Returns a Coordinate Reference System.

         * 

         * @param authorityName

         *            name of the Authority who defines de Coordinate Reference

         *            System

         * @param code

         *            the code used by the Authority to identify the Coordinate

         *            Reference System

         * @return the projection

         * @throws CoordinateReferenceSystemNotFoundException

         *             if there is not any Coordinate Reference System available in

         *             the library with the given reference

         */

        CoordinateReferenceSystem getCoordinateReferenceSystem(

                        String authorityName, String code)

                                        throws CoordinateReferenceSystemNotFoundException;

        /**

         * Returns a Coordinate Reference System.

         * 

         * @param definition

         */

        CoordinateReferenceSystem getCoordinateReferenceSystem(

                CRSDefinition definition)

                        throws CoordinateReferenceSystemNotFoundException;

        /**

         * Returns a Coordinate Operation 

         * @param authorityName

         * @param code

         * @return

         * @throws CoordinateReferenceSystemNotFoundException

         */

        CoordinateOperation getCoordinateOperation(

                        String authorityName, String code)

                                        throws CoordinateOperationNotFoundException;

        /**

         * Returns a Coordinate Operation

         * 

         * @param definition

         */

        CoordinateOperation getCoordinateOperation(

                        CoordinateOperationDefinition definition)

                                        throws CoordinateOperationNotFoundException;

        /**

         * Creates the parameters needed to initialize the manager.

         * 

         * @return the initialization parameters

         */

        DynObject createParameters();

        /**

         * Initializes the manager with the given parameters.

         * 

         * @param parameters

         *            to initialize the manager

         */

        void initialize(DynObject parameters);

}