001 //$HeadURL: https://svn.wald.intevation.org/svn/deegree/base/branches/2.4_testing/src/org/deegree/ogcwebservices/OWSUtils.java $
002 /*----------------------------------------------------------------------------
003 This file is part of deegree, http://deegree.org/
004 Copyright (C) 2001-2009 by:
005 Department of Geography, University of Bonn
006 and
007 lat/lon GmbH
008
009 This library is free software; you can redistribute it and/or modify it under
010 the terms of the GNU Lesser General Public License as published by the Free
011 Software Foundation; either version 2.1 of the License, or (at your option)
012 any later version.
013 This library is distributed in the hope that it will be useful, but WITHOUT
014 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
015 FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
016 details.
017 You should have received a copy of the GNU Lesser General Public License
018 along with this library; if not, write to the Free Software Foundation, Inc.,
019 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
020
021 Contact information:
022
023 lat/lon GmbH
024 Aennchenstr. 19, 53177 Bonn
025 Germany
026 http://lat-lon.de/
027
028 Department of Geography, University of Bonn
029 Prof. Dr. Klaus Greve
030 Postfach 1147, 53001 Bonn
031 Germany
032 http://www.geographie.uni-bonn.de/deegree/
033
034 e-mail: info@deegree.org
035 ----------------------------------------------------------------------------*/
036 package org.deegree.ogcwebservices;
037
038 import java.net.URL;
039 import java.util.List;
040
041 import org.deegree.datatypes.QualifiedName;
042 import org.deegree.ogcwebservices.getcapabilities.GetCapabilities;
043 import org.deegree.ogcwebservices.getcapabilities.OGCCapabilities;
044 import org.deegree.ogcwebservices.wfs.capabilities.WFSCapabilities;
045 import org.deegree.ogcwebservices.wfs.capabilities.WFSOperationsMetadata;
046 import org.deegree.ogcwebservices.wfs.operation.GetFeature;
047 import org.deegree.ogcwebservices.wfs.operation.GetFeatureWithLock;
048 import org.deegree.ogcwebservices.wfs.operation.Lock;
049 import org.deegree.ogcwebservices.wfs.operation.transaction.Transaction;
050 import org.deegree.ogcwebservices.wms.capabilities.WMSCapabilities;
051 import org.deegree.ogcwebservices.wms.operation.GetFeatureInfo;
052 import org.deegree.ogcwebservices.wms.operation.GetLegendGraphic;
053 import org.deegree.ogcwebservices.wms.operation.GetMap;
054 import org.deegree.owscommon_new.DCP;
055 import org.deegree.owscommon_new.HTTP;
056 import org.deegree.owscommon_new.Operation;
057 import org.deegree.owscommon_new.OperationsMetadata;
058
059 /**
060 *
061 *
062 *
063 * @version $Revision: 26212 $
064 * @author <a href="mailto:poth@lat-lon.de">Andreas Poth</a>
065 * @author last edited by: $Author: apoth $
066 *
067 * @version 1.0. $Revision: 26212 $, $Date: 2010-08-27 14:00:42 +0200 (Fr, 27. Aug 2010) $
068 *
069 * @since 2.0
070 */
071 public class OWSUtils {
072
073 /**
074 * according to OGC WMS 1.3 Testsuite a URL to a service operation via HTTPGet must end with '?'
075 * or '&'
076 *
077 * @param href
078 * @return the parameter, changed to fulfill the spec
079 */
080 public static String validateHTTPGetBaseURL( String href ) {
081 if ( !href.endsWith( "/" ) ) {
082 if ( href.indexOf( '?' ) < 0 ) {
083 href = href + '?';
084 } else if ( !href.endsWith( "&" ) && !href.endsWith( "?" ) ) {
085 href = href + '&';
086 }
087 }
088 return href;
089 }
090
091 /**
092 * the method return the first HTTPGet URL for a Operation within the pass capabilities
093 * document. If No URL can be found (e.g. the service does not support the operation via HTTP
094 * Get) <code>null</code> will be returned
095 *
096 * @param capabilities
097 * @param clss
098 * @return see above
099 */
100 @SuppressWarnings("unchecked")
101 public synchronized static URL getHTTPGetOperationURL( OGCCapabilities capabilities, Class clss ) {
102 URL url = null;
103 if ( capabilities instanceof WMSCapabilities ) {
104 url = getHTTPGetOperationURL( (WMSCapabilities) capabilities, clss );
105 } else if ( capabilities instanceof WFSCapabilities ) {
106 url = getHTTPGetOperationURL( (WFSCapabilities) capabilities, clss );
107 } else {
108 // TODO
109 // support more service types
110 // possibly use generic base capabilities to extract it
111 }
112 return url;
113
114 }
115
116 /**
117 * @see #getHTTPGetOperationURL(OGCCapabilities, Class)
118 * @param capabilities
119 * @param clss
120 * @return the first operation URL
121 */
122 @SuppressWarnings("unchecked")
123 private synchronized static URL getHTTPGetOperationURL( WMSCapabilities capabilities, Class clss ) {
124
125 OperationsMetadata om = capabilities.getOperationMetadata();
126 List<DCP> dcps = null;
127 if ( clss.equals( GetMap.class ) ) {
128 Operation op = om.getOperation( new QualifiedName( "GetMap" ) );
129 if ( op == null ) {
130 op = om.getOperation( new QualifiedName( "map" ) );
131 }
132 dcps = op.getDCP();
133 } else if ( clss.equals( GetCapabilities.class ) ) {
134 Operation op = om.getOperation( new QualifiedName( "GetCapabilities" ) );
135 if ( op == null ) {
136 op = om.getOperation( new QualifiedName( "capabilities" ) );
137 }
138 dcps = op.getDCP();
139 } else if ( clss.equals( GetFeatureInfo.class ) ) {
140 Operation op = om.getOperation( new QualifiedName( "GetFeatureInfo" ) );
141 if ( op == null ) {
142 op = om.getOperation( new QualifiedName( "FeatureInfo" ) );
143 }
144 dcps = op.getDCP();
145 } else if ( clss.equals( GetLegendGraphic.class ) ) {
146 Operation op = om.getOperation( new QualifiedName( "GetLegendGraphic" ) );
147 dcps = op.getDCP();
148 }
149
150 // search for the first HTTP Get link
151 if ( dcps == null ) {
152 return null;
153 }
154 for ( DCP dcp : dcps ) {
155 if ( dcp instanceof HTTP ) {
156 HTTP http = (HTTP) dcp;
157 List<URL> urls = http.getGetOnlineResources();
158 if ( urls.size() > 0 ) {
159 return urls.get( 0 );
160 }
161 }
162 }
163
164 return null;
165
166 }
167
168 /**
169 * @see #getHTTPGetOperationURL(OGCCapabilities, Class)
170 * @param capabilities
171 * @param clss
172 * @return the first operation URL
173 */
174 @SuppressWarnings("unchecked")
175 private synchronized static URL getHTTPGetOperationURL( WFSCapabilities capabilities, Class clss ) {
176
177 URL url = null;
178 WFSOperationsMetadata om = (WFSOperationsMetadata) capabilities.getOperationsMetadata();
179 if ( clss.equals( GetCapabilities.class ) ) {
180 org.deegree.ogcwebservices.getcapabilities.HTTP http = (org.deegree.ogcwebservices.getcapabilities.HTTP) om.getGetCapabilitiesOperation().getDCPs()[0].getProtocol();
181 url = http.getGetOnlineResources()[0];
182 } else if ( clss.equals( GetFeature.class ) ) {
183 org.deegree.ogcwebservices.getcapabilities.HTTP http = (org.deegree.ogcwebservices.getcapabilities.HTTP) om.getGetFeature().getDCPs()[0].getProtocol();
184 url = http.getGetOnlineResources()[0];
185 } else if ( clss.equals( GetFeatureWithLock.class ) ) {
186 org.deegree.ogcwebservices.getcapabilities.HTTP http = (org.deegree.ogcwebservices.getcapabilities.HTTP) om.getGetFeatureWithLock().getDCPs()[0].getProtocol();
187 url = http.getGetOnlineResources()[0];
188 } else if ( clss.equals( Lock.class ) ) {
189 org.deegree.ogcwebservices.getcapabilities.HTTP http = (org.deegree.ogcwebservices.getcapabilities.HTTP) om.getLockFeature().getDCPs()[0].getProtocol();
190 url = http.getGetOnlineResources()[0];
191 } else if ( clss.equals( Transaction.class ) ) {
192 org.deegree.ogcwebservices.getcapabilities.HTTP http = (org.deegree.ogcwebservices.getcapabilities.HTTP) om.getTransaction().getDCPs()[0].getProtocol();
193 url = http.getGetOnlineResources()[0];
194 }
195 return url;
196 }
197
198 /**
199 * the method return the first HTTPPost URL for a Operation within the pass capabilities
200 * document. If No URL can be found (e.g. the service does not support the operation via HTTP
201 * Get) <code>null</code> will be returned
202 *
203 * @param capabilities
204 * @param clss
205 * @return the first HTTPPost URL for a Operation within the pass capabilities document. If No
206 * URL can be found (e.g. the service does not support the operation via HTTP Get)
207 * <code>null</code> will be returned
208 */
209 @SuppressWarnings("unchecked")
210 public synchronized static URL getHTTPPostOperationURL( OGCCapabilities capabilities, Class clss ) {
211 URL url = null;
212 if ( capabilities instanceof WFSCapabilities ) {
213 url = getHTTPPostOperationURL( (WFSCapabilities) capabilities, clss );
214 } else {
215 // TODO
216 // support more service types
217 // possibly use generic base capabilities to extract it
218 }
219 return url;
220 }
221
222 /**
223 * @see #getHTTPPostOperationURL(OGCCapabilities, Class)
224 * @param capabilities
225 * @param clss
226 * @return the first operation URL
227 */
228 @SuppressWarnings("unchecked")
229 private synchronized static URL getHTTPPostOperationURL( WFSCapabilities capabilities, Class clss ) {
230
231 URL url = null;
232 WFSOperationsMetadata om = (WFSOperationsMetadata) capabilities.getOperationsMetadata();
233 if ( clss.equals( GetCapabilities.class ) ) {
234 org.deegree.ogcwebservices.getcapabilities.HTTP http = (org.deegree.ogcwebservices.getcapabilities.HTTP) om.getGetCapabilitiesOperation().getDCPs()[0].getProtocol();
235 url = http.getPostOnlineResources()[0];
236 } else if ( clss.equals( GetFeature.class ) ) {
237 org.deegree.ogcwebservices.getcapabilities.HTTP http = (org.deegree.ogcwebservices.getcapabilities.HTTP) om.getGetFeature().getDCPs()[0].getProtocol();
238 url = http.getPostOnlineResources()[0];
239 } else if ( clss.equals( GetFeatureWithLock.class ) ) {
240 org.deegree.ogcwebservices.getcapabilities.HTTP http = (org.deegree.ogcwebservices.getcapabilities.HTTP) om.getGetFeatureWithLock().getDCPs()[0].getProtocol();
241 url = http.getPostOnlineResources()[0];
242 } else if ( clss.equals( Lock.class ) ) {
243 org.deegree.ogcwebservices.getcapabilities.HTTP http = (org.deegree.ogcwebservices.getcapabilities.HTTP) om.getLockFeature().getDCPs()[0].getProtocol();
244 url = http.getPostOnlineResources()[0];
245 } else if ( clss.equals( Transaction.class ) ) {
246 org.deegree.ogcwebservices.getcapabilities.HTTP http = (org.deegree.ogcwebservices.getcapabilities.HTTP) om.getTransaction().getDCPs()[0].getProtocol();
247 url = http.getPostOnlineResources()[0];
248 }
249 return url;
250 }
251
252 }