001: //$HeadURL: https://svn.wald.intevation.org/svn/deegree/base/trunk/src/org/deegree/ogcwebservices/csw/discovery/GetDomain.java $
002: /*---------------- FILE HEADER ------------------------------------------
003:
004: This file is part of deegree.
005: Copyright (C) 2001-2008 by:
006: EXSE, Department of Geography, University of Bonn
007: http://www.giub.uni-bonn.de/deegree/
008: lat/lon GmbH
009: http://www.lat-lon.de
010:
011: This library is free software; you can redistribute it and/or
012: modify it under the terms of the GNU Lesser General Public
013: License as published by the Free Software Foundation; either
014: version 2.1 of the License, or (at your option) any later version.
015:
016: This library is distributed in the hope that it will be useful,
017: but WITHOUT ANY WARRANTY; without even the implied warranty of
018: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
019: Lesser General Public License for more details.
020:
021: You should have received a copy of the GNU Lesser General Public
022: License along with this library; if not, write to the Free Software
023: Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
024:
025: Contact:
026:
027: Andreas Poth
028: lat/lon GmbH
029: Aennchenstr. 19
030: 53177 Bonn
031: Germany
032: E-Mail: poth@lat-lon.de
033:
034: Prof. Dr. Klaus Greve
035: Department of Geography
036: University of Bonn
037: Meckenheimer Allee 166
038: 53115 Bonn
039: Germany
040: E-Mail: greve@giub.uni-bonn.de
041:
042:
043: ---------------------------------------------------------------------------*/
044:
045: package org.deegree.ogcwebservices.csw.discovery;
046:
047: import java.util.HashMap;
048: import java.util.Map;
049:
050: import org.deegree.ogcwebservices.csw.AbstractCSWRequest;
051:
052: /**
053: * The optional GetDomain operation is used to obtain runtime information about
054: * the range of values of a metadata record element or request parameter. The
055: * runtime range of values for a property or request parameter is typically much
056: * smaller than the value space for that property or parameter based on its
057: * static type definition. For example, a property or request parameter defined
058: * as a 16bit positive integer in a database may have a value space of 65535
059: * distinct integers but the actual number of distinct values existing in the
060: * database may be much smaller.
061: * <p>
062: * This type of runtime information about the range of values of a property or
063: * request parameter is useful for generating user interfaces with meaningful
064: * pick lists or for generating query predicates that have a higher chance of
065: * actually identifying a result set.
066: * <p>
067: * It should be noted that the GetDomain operation is a "best-effort" operation.
068: * That is to say that a catalogue tries to generate useful information about
069: * the specified request parameter or property if it can. It is entirely
070: * possible that a catalogue may not be able to determine anything about the
071: * values of a property or request parameter in which case an empty response
072: * should be generated.
073: *
074: * @author <a href="mailto:poth@lat-lon.de">Andreas Poth </a>
075: * @author <a href="mailto:tfr@users.sourceforge.net">Torsten Friebe </a>
076: * @author <a href="mailto:mschneider@lat-lon.de">Markus Schneider </a>
077: *
078: * @author last edited by: $Author: apoth $
079: *
080: * @version 2.0, $Revision: 9345 $, $Date: 2007-12-27 08:22:25 -0800 (Thu, 27 Dec 2007) $
081: */
082: public class GetDomain extends AbstractCSWRequest {
083:
084: /**
085: *
086: * @param map
087: * @return
088: */
089: public static GetDomain create(Map<String, String> map) {
090: return new GetDomain(map.get("ID"), map.get("VERSION"), null);
091: }
092:
093: /**
094: * @param version
095: * @param id
096: * @param vendorSpecificParameter
097: */
098: GetDomain(String id, String version,
099: HashMap<String, String> vendorSpecificParameter) {
100: super (version, id, vendorSpecificParameter);
101: }
102:
103: /**
104: * Unordered list of names of requested properties, from the information
105: * model that the catalogue is using
106: * <p>
107: * Zero or one; (Conditional)Include when ParameterName not included
108: */
109: public String[] getPropertyNames() {
110: return null;
111: }
112:
113: /**
114: * Unordered list of names of requested parameters, of the form
115: * OperationName. ParameterName
116: * <p>
117: * Zero or one; (Conditional)Include when PropertyName not included
118: */
119: public String[] ParameterNames() {
120: return null;
121: }
122:
123: }
|