001    // $HeadURL: /cvsroot/deegree/src/org/deegree/ogcwebservices/wms/WMService.java,v
002    // 1.3 2004/07/12 06:12:11 ap Exp $
003    /*----------------------------------------------------------------------------
004     This file is part of deegree, http://deegree.org/
005     Copyright (C) 2001-2009 by:
006       Department of Geography, University of Bonn
007     and
008       lat/lon GmbH
009    
010     This library is free software; you can redistribute it and/or modify it under
011     the terms of the GNU Lesser General Public License as published by the Free
012     Software Foundation; either version 2.1 of the License, or (at your option)
013     any later version.
014     This library is distributed in the hope that it will be useful, but WITHOUT
015     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
016     FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
017     details.
018     You should have received a copy of the GNU Lesser General Public License
019     along with this library; if not, write to the Free Software Foundation, Inc.,
020     59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
021    
022     Contact information:
023    
024     lat/lon GmbH
025     Aennchenstr. 19, 53177 Bonn
026     Germany
027     http://lat-lon.de/
028    
029     Department of Geography, University of Bonn
030     Prof. Dr. Klaus Greve
031     Postfach 1147, 53001 Bonn
032     Germany
033     http://www.geographie.uni-bonn.de/deegree/
034    
035     e-mail: info@deegree.org
036    ----------------------------------------------------------------------------*/
037    package org.deegree.ogcwebservices.wms;
038    
039    import java.lang.reflect.Constructor;
040    import java.lang.reflect.InvocationTargetException;
041    
042    import org.deegree.enterprise.Proxy;
043    import org.deegree.framework.log.ILogger;
044    import org.deegree.framework.log.LoggerFactory;
045    import org.deegree.framework.trigger.TriggerProvider;
046    import org.deegree.ogcwebservices.CurrentUpdateSequenceException;
047    import org.deegree.ogcwebservices.InvalidUpdateSequenceException;
048    import org.deegree.ogcwebservices.OGCWebService;
049    import org.deegree.ogcwebservices.OGCWebServiceException;
050    import org.deegree.ogcwebservices.OGCWebServiceRequest;
051    import org.deegree.ogcwebservices.OGCWebServiceResponse;
052    import org.deegree.ogcwebservices.getcapabilities.OGCCapabilities;
053    import org.deegree.ogcwebservices.wms.configuration.WMSConfigurationType;
054    import org.deegree.ogcwebservices.wms.operation.DescribeLayer;
055    import org.deegree.ogcwebservices.wms.operation.GetFeatureInfo;
056    import org.deegree.ogcwebservices.wms.operation.GetLegendGraphic;
057    import org.deegree.ogcwebservices.wms.operation.GetLegendGraphicResult;
058    import org.deegree.ogcwebservices.wms.operation.GetMap;
059    import org.deegree.ogcwebservices.wms.operation.GetStyles;
060    import org.deegree.ogcwebservices.wms.operation.GetStylesResult;
061    import org.deegree.ogcwebservices.wms.operation.PutStyles;
062    import org.deegree.ogcwebservices.wms.operation.WMSGetCapabilities;
063    import org.deegree.ogcwebservices.wms.operation.WMSGetCapabilitiesResult;
064    import org.deegree.ogcwebservices.wms.operation.WMSProtocolFactory;
065    
066    /**
067     * @author <a href="mailto:poth@lat-lon.de">Andreas Poth</a>
068     * @author last edited by: $Author: mschneider $
069     *
070     * @version 1.0. $Revision: 18195 $, $Date: 2009-06-18 17:55:39 +0200 (Do, 18 Jun 2009) $
071     *
072     * @since 1.1
073     *
074     */
075    
076    public class WMService implements OGCWebService {
077    
078        private static final ILogger LOG = LoggerFactory.getLogger( WMService.class );
079    
080        private static final TriggerProvider TP = TriggerProvider.create( WMService.class );
081    
082        private WMSConfigurationType configuration = null;
083    
084        /**
085         * Creates a new WMService object.
086         *
087         * @param configuration
088         */
089        public WMService( WMSConfigurationType configuration ) {
090            this.configuration = configuration;
091            Proxy proxy = configuration.getDeegreeParams().getProxy();
092            if ( proxy != null ) {
093                proxy.setProxy( true );
094            }
095        }
096    
097        /**
098         *
099         */
100        public OGCCapabilities getCapabilities() {
101            // should a class implement the WMSConfigurationType and not be an instance
102            // of OGCCapabilities, here's where it'll fail ;-)
103            return (OGCCapabilities) configuration;
104        }
105    
106        /**
107         * the method performs the handling of the passed OGCWebServiceEvent directly and returns the result to the calling
108         * class/method
109         *
110         * @param request
111         *            request to perform
112         *
113         * @throws OGCWebServiceException
114         */
115        public Object doService( OGCWebServiceRequest request )
116                                throws OGCWebServiceException {
117    
118            request = (OGCWebServiceRequest) TP.doPreTrigger( this, request )[0];
119    
120            LOG.logDebug( "Handling WMS request with ID ", request.getId() );
121    
122            Object result = null;
123            if ( request instanceof GetMap ) {
124                GetMapHandler gmh = (GetMapHandler) createHandler( request, GetMap.class,
125                                                                   HandlerMapping.getString( "WMService.GETMAP" ) );
126                result = gmh.performGetMap();
127            } else if ( request instanceof GetFeatureInfo ) {
128                GetFeatureInfoHandler gmh = (GetFeatureInfoHandler) createHandler(
129                                                                                   request,
130                                                                                   GetFeatureInfo.class,
131                                                                                   HandlerMapping.getString( "WMService.GETFEATUREINFO" ) );
132                result = gmh.performGetFeatureInfo();
133            } else if ( request instanceof WMSGetCapabilities ) {
134                result = handleGetCapabilities( (WMSGetCapabilities) request );
135            } else if ( request instanceof GetStyles ) {
136                handleGetStyles( (GetStyles) request );
137            } else if ( request instanceof PutStyles ) {
138                handlePutStyles( (PutStyles) request );
139            } else if ( request instanceof DescribeLayer ) {
140                result = new DescribeLayerHandler().perform( (DescribeLayer) request, configuration );
141            } else if ( request instanceof GetLegendGraphic ) {
142                result = handleGetLegendGraphic( (GetLegendGraphic) request );
143            }
144    
145            LOG.logDebug( "Handled WMS request with ID ", request.getId() );
146    
147            return TP.doPostTrigger( this, result )[0];
148        }
149    
150        /**
151         * creates a handler class for performing the incomming request. The instance that will be created depends on the
152         * responsible class the for the submitted request in the WMS capabilities/configuration.
153         *
154         * @param request
155         *            request to be performed
156         * @param requestClass
157         *            of the request (GetStyles, WMSFeatureInfoRequest etc.)
158         */
159        private Object createHandler( OGCWebServiceRequest request, Class<?> requestClass, String className )
160                                throws OGCWebServiceException {
161            // describes the signature of the required constructor
162            Class<?>[] cl = new Class[2];
163            cl[0] = WMSConfigurationType.class;
164            cl[1] = requestClass;
165    
166            // set parameter to submitt to the constructor
167            Object[] o = new Object[2];
168            o[0] = configuration;
169            o[1] = request;
170    
171            Object handler = null;
172    
173            try {
174                // get constructor
175                Class<?> creator = Class.forName( className );
176                Constructor<?> con = creator.getConstructor( cl );
177    
178                // call constructor and instantiate a new DataStore
179                handler = con.newInstance( o );
180            } catch ( ClassNotFoundException cce ) {
181                throw new OGCWebServiceException( "Couldn't instantiate " + className + "! \n" + cce.toString() );
182            } catch ( NoSuchMethodException nsme ) {
183                throw new OGCWebServiceException( "Couldn't instantiate " + className + "! \n" + nsme.toString() );
184            } catch ( InstantiationException ie ) {
185                throw new OGCWebServiceException( "Couldn't instantiate " + className + "! \n" + ie.toString() );
186            } catch ( IllegalAccessException iae ) {
187                throw new OGCWebServiceException( "Couldn't instantiate " + className + "! \n" + iae.toString() );
188            } catch ( InvocationTargetException ite ) {
189                // causes need not be OGCWebService exceptions
190                Throwable cause = ite.getCause();
191                if ( cause instanceof OGCWebServiceException ) {
192                    throw (OGCWebServiceException) cause;
193                }
194                LOG.logError( "Unknown error", cause );
195                throw new OGCWebServiceException( getClass().getName(), cause.getMessage() );
196            } catch ( Exception e ) {
197                throw new OGCWebServiceException( "Couldn't instantiate " + className + "! \n" + e.toString() );
198            }
199    
200            return handler;
201        }
202    
203        /**
204         * reads/creates the capabilities of the WMS.
205         *
206         * @param request
207         *            capabilities request
208         */
209        private WMSGetCapabilitiesResult handleGetCapabilities( WMSGetCapabilities request )
210                                throws OGCWebServiceException {
211    
212            String rUp = request.getUpdateSequence();
213            String cUp = configuration.getUpdateSequence();
214    
215            if ( ( rUp != null ) && ( cUp != null ) && ( rUp.compareTo( cUp ) == 0 ) ) {
216                throw new CurrentUpdateSequenceException( "request update sequence (" + rUp + ") is equal to capabilities"
217                                                          + " update sequence " + cUp );
218            }
219    
220            if ( ( rUp != null ) && ( cUp != null ) && ( rUp.compareTo( cUp ) > 0 ) ) {
221                throw new InvalidUpdateSequenceException( "request update sequence: " + rUp + " is higher than the "
222                                                          + "capabilities update sequence " + cUp );
223            }
224    
225            WMSGetCapabilitiesResult res = null;
226            res = WMSProtocolFactory.createGetCapabilitiesResponse( request, null, configuration );
227    
228            return res;
229        }
230    
231        /**
232         * @param request
233         *            get styles request (WMS 1.1.1 - SLD)
234         */
235        private GetStylesResult handleGetStyles( GetStyles request ) {
236            throw new UnsupportedOperationException( "handleGetStyles(" + request.getClass().getSimpleName()
237                                                     + ") not implemented" );
238        }
239    
240        /**
241         * @param request
242         *            put styles request (WMS 1.1.1 - SLD)
243         */
244        private void handlePutStyles( PutStyles request ) {
245            throw new UnsupportedOperationException( "handlePutStyles(" + request.getClass().getSimpleName()
246                                                     + ") not implemented" );
247        }
248    
249        /**
250         * @param request
251         *
252         * @return the response
253         * @throws OGCWebServiceException
254         */
255        private OGCWebServiceResponse handleGetLegendGraphic( GetLegendGraphic request )
256                                throws OGCWebServiceException {
257            OGCWebServiceResponse result;
258    
259            Object o = createHandler( request, GetLegendGraphic.class,
260                                      HandlerMapping.getString( "WMService.GETLEGENDGRAPHIC" ) );
261    
262            GetLegendGraphicHandler glgh = (GetLegendGraphicHandler) o;
263            result = glgh.performGetLegendGraphic();
264            if ( ( (GetLegendGraphicResult) result ).getLegendGraphic() != null ) {
265                // cache.push(request, ((GetLegendGraphicResult) result).getLegendGraphic());
266            }
267    
268            return result;
269        }
270    
271    }