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.ogc.impl.base;

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.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.impl.struct.WMTSLayerImpl;

import org.gvsig.raster.wmts.ogc.impl.struct.WMTSServiceProviderImpl;

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

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

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

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

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

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

/**

 * <p>Represents the class with the necessary logic to connect to a OGCWMTS and interpret the data </p>

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

 */

public class WMTSClientImpl implements WMTSClient {

        protected String                      hostName;

        protected int                         port;

        protected String                      serviceName;

        private String                        type;

        private String                        subtype;

        private WMTSProtocolHandler           handler                      = null;

        private WMTSServerDescription         serverDescription            = null;

        protected boolean                     forceLongitudeFirstAxisOrder = false;

        private Logger                        logger                       = LoggerFactory.getLogger(WMTSClientImpl.class.toString());

        /**

         * Constructor.

         * the parameter host, indicates the WMS host to connect.

         * */

        public WMTSClientImpl(String host) throws ConnectException, IOException {

                setHost(host);

                getHandler();       

        }

        private WMTSProtocolHandler getHandler() throws ConnectException, IOException {

            if (handler == null) {

                        if (getHost().trim().length() > 0) {                                        

                                handler = WMTSProtocolHandlerFactory.negotiate(getHost());

                                handler.setHost(getHost());

                        }          

                }

            return handler;

    }

         /**

         * Sets longitude first in the axis order

         * @param force

         */

        public void setForceLongitudeFirstAxisOrder(boolean force) {

                this.forceLongitudeFirstAxisOrder = force;

                if(handler != null) {

                        handler.setForceLongitudeFirstAxisOrder(force);

                }

        }

    public String getVersion() {

        return handler.getVersion();

    }

    /**

     * <p> Reads from the WMS Capabilities, the layers available in the service</p>

     * @return a TreeMap with the available layers in the WMS 

     */

        public List<WMTSLayer> getLayers() {        

            if(serverDescription != null)

                        return serverDescription.getLayerList();

                return null;

    } 

    /**

     * <p>Reads from the WMS Capabilities the number if layers available in the service</p>

     * @return, number of layers available

     */

    public int getNumberOfLayers() {        

            if(serverDescription != null)

                        return serverDescription.getLayerList().size();

                return 0;

    }

        public void close() {

                serverDescription = null;

                handler = null;

        }

        /**

     * <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 handler.getTile((WMTSStatusImpl)status, cancel, file);

    }

         /**

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

     * @throws ServerErrorException 

     */

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

        return handler.getTile((WMTSStatusImpl)status, cancel);

    }

    /**

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

     * @throws ServerErrorException 

     */

    public synchronized URL getTileURL(WMTSStatus status) throws MalformedURLException {   

        return handler.getTileURL((WMTSStatusImpl)status);

    }

    /**

     * Downloads a file

     * @throws DownloadException 

     * @throws ServerErrorException 

     */

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

        return handler.downloadFile(url, cancel);

    }

        /**

     * <p>One of the three interfaces defined by OGC WMS, it gets the service capabilities</p>

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

     */

    public void getCapabilities(WMTSServerDescription serverDescription, boolean override, ICancellable cancel) {        

        handler.getCapabilities(serverDescription, override, 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) {

            return handler.getFeatureInfo((WMTSStatusImpl)status, x, y, cancel);

    }

    /**

     * Gets the legend graphic of one layer

     */

    public File getLegendGraphic(WMTSLayer layer, WMTSStyle style, ICancellable cancel) throws WMTSException {

            try {

                        return handler.getLegendGraphic(layer, style, cancel);

                } catch (ServerErrorException e) {

                        throw new WMTSException("Error getting the legend", e);

                } catch (DownloadException e) {

                        throw new WMTSException("Error downloading the legend", e);

                }

    }

    public boolean connect(boolean override, ICancellable cancel) {

            try {            

                    if(getHandler() == null)

                            return false;

                           serverDescription = getHandler().getServerDescription();

                    getHandler().setForceLongitudeFirstAxisOrder(forceLongitudeFirstAxisOrder);

                    getCapabilities(serverDescription, override, cancel);

                    return true;

            } catch (Exception e) {

                    logger.debug("Error connecting to the server", e);

                    return false;

            }

    } 

        public boolean connect(ICancellable cancel) {

                return connect(false, cancel);

        }

        /**

         * Gets the list of formats supported by a layer

         * @param layerTitle

         * @return

         */

        public List<String> getFormats(String layerTitle) {

                if(serverDescription != null)

                        return serverDescription.getLayerByTitle(layerTitle).getFormat();

                return null;

    }

        public WMTSServiceIdentification getServiceIdentification() {

                if(serverDescription != null)

                        return serverDescription.getServiceIdentification();

                return null;

        }

        public WMTSServiceProviderImpl getServiceProvider() {

                if(serverDescription != null)

                        return serverDescription.getServiceProvider();

                return null;

        }

        /**

         * Gets the list of themes

         * @return

         */

        public WMTSThemes getThemes() {

                if(serverDescription != null)

                        return serverDescription.getThemes();

                return null;

        }

        public WMTSThemes getLayerListAsThemes() {

                if(serverDescription != null)

                        return serverDescription.getLayerListAsThemes();

                return null;

        }

    public List<WMTSTileMatrixSet> getTileMatrixSet() {

            if(serverDescription != null)

                    return serverDescription.getTileMatrixSet();

            return null;

    }

    public WMTSLayer getLayer(String layerName) {

            if(serverDescription != null) {

                        List<WMTSLayer> list = serverDescription.getLayerList();

                        for (int i = 0; i < list.size(); i++) {

                                WMTSLayerImpl layer = (WMTSLayerImpl)list.get(i);

                                if(layer.getTitle().compareTo(layerName) == 0) {

                                        return layer;

                                }

                        }

            }

                return null;

    }

    public String getHost() {

        return hostName;

    }

    public void setHost(String _hostName) {

        hostName = _hostName;

    }

    public int getPort() {

        return port;

    }

    public void setPort(int _port) {

        port = _port;

    }

    public String getServiceName() {

        return serviceName;

    }

    public void setServiceName(String _serviceName) {

        serviceName = _serviceName;

    }

    public String getType() {

        return type;

    }

    public void setType(String _type) {

        type = _type;

    }

    public String getSubtype() {

        return subtype;

    }

    public void setSubtype(String _subtype) {

        subtype = _subtype;

    }

        public WMTSStatus createStatus() {

                return new WMTSStatusImpl();

        }

}