Application: gvSIG desktop » gvSIG raster

/* 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.raster.wmts.io;

import java.io.File;

import java.io.IOException;

import java.net.ConnectException;

import java.net.MalformedURLException;

import java.net.URL;

import java.util.List;

import org.gvsig.compat.net.ICancellable;

import org.gvsig.raster.wmts.ogc.WMTSClient;

import org.gvsig.raster.wmts.ogc.WMTSOGCLocator;

import org.gvsig.raster.wmts.ogc.WMTSStatus;

import org.gvsig.raster.wmts.ogc.exception.DownloadException;

import org.gvsig.raster.wmts.ogc.exception.ServerErrorException;

import org.gvsig.raster.wmts.ogc.exception.WMTSException;

import org.gvsig.raster.wmts.ogc.struct.WMTSLayer;

import org.gvsig.raster.wmts.ogc.struct.WMTSServiceIdentification;

import org.gvsig.raster.wmts.ogc.struct.WMTSServiceProvider;

import org.gvsig.raster.wmts.ogc.struct.WMTSThemes;

import org.gvsig.raster.wmts.ogc.struct.WMTSTileMatrixSet;

/**

 * This class offers an interface of services for a WMTS  

 *

 * @author Nacho Brodin (nachobrodin@gmail.com)

 */

public class WMTSConnector  {

        private WMTSClient                     client        = null;

    public WMTSConnector(URL url) throws ConnectException, IOException {

            client = WMTSOGCLocator.getManager().createWMTSClient(url.toString());

    }

        /**

         * Creates a <code>WMTSStatus</code> structure to make a request 

         * @return

         */

        public WMTSStatus createStatus() {

                return client.createStatus();

        }

    /**

         * Sets longitude first in the axis order

         * @param force

         */

        public void setForceLongitudeFirstAxisOrder(boolean force) {

                if(client != null) {

                        client.setForceLongitudeFirstAxisOrder(force);

                }

        }

    /**

     * Establishes the connection.

     * @param override, if true the previous downloaded data will be overridden

     * @return <b>true</b> if the connection was successful, or <b>false</b> if it was no possible

     * to establish the connection for any reason such as version negotiation.

     */

    public boolean connect(boolean override, ICancellable cancel) {

            return client.connect(override, cancel);

    }

    public boolean connect(ICancellable cancel) {

            return client.connect(false, cancel);

    }

        /**

         * Gets the list of themes

         * @return

         */

        public WMTSThemes getThemes() {

                return client.getThemes();

        }

    /**

     * Gets a layer 

     * @param layerName

     * @return

     */

    public WMTSLayer getLayer(String layerName) {

            return client.getLayer(layerName);

    }

    /**

     * Gets the set of tiles definition

     * @return

     */

        public List<WMTSTileMatrixSet> getTileMatrixSet() {

            return client.getTileMatrixSet();

    }

    /*

         * (non-Javadoc)

         * @see org.gvsig.fmap.dal.coverage.explorer.WMTSServerExplorer#getServiceIdentification()

         */

        public WMTSServiceIdentification getServiceIdentification() {

                return client.getServiceIdentification();

        }

        public WMTSServiceProvider getServiceProvider() {

                return client.getServiceProvider();

        }

    /**

     * Gets the host

     * @return

     */

    public String getHost(){

            return client.getHost();

    }

    /**

     * <p>Gets a tile downloading using a specific path and file.</p> 

     * @throws ServerErrorException 

     */

    public synchronized File getTile(WMTSStatus status, ICancellable cancel, File file) throws WMTSException, ServerErrorException {   

        return client.getTile(status, cancel, file);

    }

    /**

     * <p>One of the three interfaces that OGC WMTS defines. Request a map.</p> 

     * @throws ServerErrorException 

     */

    public synchronized File getTile(WMTSStatus status, ICancellable cancel) throws WMTSException, ServerErrorException {   

        return client.getTile(status, cancel);

    }

    /**

     * Builds the URL to get a tile using a WMTSStatus object 

     * @throws ServerErrorException 

     */

    public synchronized URL getTileURL(WMTSStatus status) throws MalformedURLException {   

        return client.getTileURL(status);

    }

    /**

     * Downloads a file

     * @throws DownloadException 

     * @throws ServerErrorException 

     */

    public synchronized File downloadFile(URL url, ICancellable cancel) throws DownloadException {   

        return client.downloadFile(url, cancel);

    }

    /**

     * <p>It will send a GetFeatureInfo request to the WMTS

     * Parsing the response and redirecting the info to the WMTS client</p>

     */

    public String getFeatureInfo(WMTSStatus status, int x, int y, ICancellable cancel) throws WMTSException, ServerErrorException {   

        return client.getFeatureInfo(status, x, y, cancel);

    }

}