deegree 2.5 (2011/06/29 09:44 build-8-official)

org.deegree.ogcwebservices.csw.capabilities
Class CatalogueOperationsMetadata

java.lang.Object
  extended by org.deegree.ogcwebservices.getcapabilities.OperationsMetadata
      extended by org.deegree.ogcwebservices.csw.capabilities.CatalogueOperationsMetadata
All Implemented Interfaces:
java.io.Serializable

public class CatalogueOperationsMetadata
extends OperationsMetadata

Represents the OperationMetadata part in the capabilities document of an OGC-CSW according to the OpenGIS� Catalogue Services Specification 2.0.

In addition to the GetCapabilities operation that all OWS 0.2 compliant services must implement, it may define some or all of the following operations:

Name Mandatory? Function
DescribeRecord X Allows a client to discover elements of the information model supported by the target catalogue service.
GetDomain - The optional GetDomain operation is used to obtain runtime information about the range of values of a metadata record element or request parameter. The runtime range of values for a property or request parameter is typically much smaller than the value space for that property or parameter based on its static type definition. For example, a property or request parameter defined as a 16bit positive integer in a database may have a value space of 65535 distinct integers but the actual number of distinct values existing in the database may be much smaller. This type of runtime information about the range of values of a property or request parameter is useful for generating user interfaces with meaningful pick lists or for generating query predicates that have a higher chance of actually identifying a result set. It should be noted that the GetDomain operation is a �best-effort� operation. That is to say that a catalogue tries to generate useful information about the specified request parameter or property if it can. It is entirely possible that a catalogue may not be able to determine anything about the values of a property or request parameter in which case an empty response should be generated.
GetRecords X The primary means of resource discovery in the general model are the two operations search and present. In the HTTP protocol binding these are combined in the form of the mandatory GetRecords operation, which does a search and a piggybacked present.
GetRecordById X The mandatory GetRecordById request retrieves the default representation of catalogue records using their identifier. The GetRecordById operation is an implementation of the Present operation from the general model. This operation presumes that a previous query has been performed in order to obtain the identifiers that may be used with this operation. For example, records returned by a GetRecords operation may contain references to other records in the catalogue that may be retrieved using the GetRecordById operation. This operation is also a subset of the GetRecords operation, and is included as a convenient short form for retrieving and linking to records in a catalogue.
Transaction - The optional Transaction operation defines an interface for creating, modifying and deleting catalogue records. The specific payload being manipulated must be defined in a profile.
Harvest - The optional Harvest operation is an operation that "pulls" data into the catalogue. That is, this operation only references the data to be inserted or updated in the catalogue, and it is the job of the catalogue service to resolve the reference, fetch that data, and process it into the catalogue. The Harvest operation has two modes of operation, controlled by a flag in the request. The first mode of operation is a synchronous mode in which the CSW receives a Harvest request from the client, processes it immediately, and sends the results to the client while the client waits. The second mode of operation is asynchronous in that the server receives a Harvest request from the client, and sends the client an immediate acknowledgement that the request has been successfully received. The server can then process the Harvest request whenever it likes, taking as much time as is required and then send the results of the processing to a URI specified in the original Harvest request. This latter mode of operation is included to support Harvest requests that could run for a period of time longer than most HTTP timeout's will allow. Processing a Harvest request means that the CSW resolves the URI pointing to the metadata resource, parses the resource, and then creates or modifies metadata records in the catalogue in order to register the resource. This operation may be performed only once or periodically depending on how the client invokes the operation.

Version:
$Revision: 18195 $, $Date: 2009-06-18 17:55:39 +0200 (Do, 18 Jun 2009) $
Author:
Andreas Poth , last edited by: $Author: mschneider $
See Also:
OperationsMetadata, Serialized Form

Field Summary
static java.lang.String DESCRIBE_RECORD_NAME
           
static java.lang.String GET_DOMAIN_NAME
           
static java.lang.String GET_RECORD_BY_ID_NAME
           
static java.lang.String GET_RECORDS_NAME
           
static java.lang.String GET_REPOSITORY_ITEM
          Identifier for a GetRepositoryItem request.
static java.lang.String HARVEST_NAME
           
static java.lang.String TRANSACTION_NAME
           
 
Fields inherited from class org.deegree.ogcwebservices.getcapabilities.OperationsMetadata
constraints, GET_CAPABILITIES_NAME, getCapabilitiesOperation, parameters
 
Constructor Summary
CatalogueOperationsMetadata(Operation getCapabilities, Operation describeRecord, Operation getDomain, Operation getRecords, Operation getRecordById, Operation transaction, Operation harvest, OWSDomainType[] parameters, OWSDomainType[] constraints)
          Constructs a new CatalogOperationsMetadata from the given parameters.
 
Method Summary
 Operation getDescribeRecord()
           
 Operation getGetDomain()
           
 Operation getGetRecordById()
           
 Operation getGetRecords()
           
 Operation getHarvest()
           
 Operation[] getOperations()
          Returns all Operations.
 Operation getTransaction()
           
 void setDescribeRecord(Operation describeRecord)
           
 void setGetDomain(Operation getDomain)
           
 void setGetRecordById(Operation getRecordById)
           
 void setGetRecords(Operation getRecords)
           
 void setHarvest(Operation harvest)
           
 void setTransaction(Operation transaction)
           
 
Methods inherited from class org.deegree.ogcwebservices.getcapabilities.OperationsMetadata
addConstraint, addParameter, getConstraints, getGetCapabilitiesOperation, getParameter, removeParameter, setConstraints, setGetCapabilitiesOperation, setOperationParameter
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

DESCRIBE_RECORD_NAME

public static final java.lang.String DESCRIBE_RECORD_NAME
See Also:
Constant Field Values

GET_DOMAIN_NAME

public static final java.lang.String GET_DOMAIN_NAME
See Also:
Constant Field Values

GET_RECORDS_NAME

public static final java.lang.String GET_RECORDS_NAME
See Also:
Constant Field Values

GET_RECORD_BY_ID_NAME

public static final java.lang.String GET_RECORD_BY_ID_NAME
See Also:
Constant Field Values

GET_REPOSITORY_ITEM

public static final java.lang.String GET_REPOSITORY_ITEM
Identifier for a GetRepositoryItem request.

See Also:
Constant Field Values

TRANSACTION_NAME

public static final java.lang.String TRANSACTION_NAME
See Also:
Constant Field Values

HARVEST_NAME

public static final java.lang.String HARVEST_NAME
See Also:
Constant Field Values
Constructor Detail

CatalogueOperationsMetadata

public CatalogueOperationsMetadata(Operation getCapabilities,
                                   Operation describeRecord,
                                   Operation getDomain,
                                   Operation getRecords,
                                   Operation getRecordById,
                                   Operation transaction,
                                   Operation harvest,
                                   OWSDomainType[] parameters,
                                   OWSDomainType[] constraints)
Constructs a new CatalogOperationsMetadata from the given parameters.

Parameters:
getCapabilities -
describeRecord -
getDomain -
getRecords -
getRecordById -
transaction -
harvest -
parameters -
constraints -
Method Detail

getOperations

public Operation[] getOperations()
Returns all Operations.

Overrides:
getOperations in class OperationsMetadata
Returns:
all Operations.

getDescribeRecord

public Operation getDescribeRecord()
Returns:
the describeRecord.

setDescribeRecord

public void setDescribeRecord(Operation describeRecord)
Parameters:
describeRecord - The describeRecord to set.

getGetDomain

public Operation getGetDomain()
Returns:
the getDomain.

setGetDomain

public void setGetDomain(Operation getDomain)
Parameters:
getDomain - The getDomain to set.

getGetRecordById

public Operation getGetRecordById()
Returns:
the getRecordById.

setGetRecordById

public void setGetRecordById(Operation getRecordById)
Parameters:
getRecordById - The getRecordId to set.

getGetRecords

public Operation getGetRecords()
Returns:
the getRecords.

setGetRecords

public void setGetRecords(Operation getRecords)
Parameters:
getRecords - The getRecords to set.

getHarvest

public Operation getHarvest()
Returns:
the harvest.

setHarvest

public void setHarvest(Operation harvest)
Parameters:
harvest - The harvest to set.

getTransaction

public Operation getTransaction()
Returns:
the transaction.

setTransaction

public void setTransaction(Operation transaction)
Parameters:
transaction - The transaction to set.

deegree 2.5 (2011/06/29 09:44 build-8-official)

an open source project founded by lat/lon, Bonn, Germany.
For more information visit: http://www.deegree.org