org.deegree.ogcwebservices.csw.discovery
Class Discovery

java.lang.Object
  org.deegree.ogcwebservices.csw.discovery.Discovery

Direct Known Subclasses:

Discovery_2_0_2_blob

public class Discovery
extends Object

The Discovery class allows clients to discover resources registered in a catalogue, by providing four operations named query,present, describeRecordType, and getDomain. This class has a required association from the Catalogue Service class, and is thus always implemented by all Catalogue Service implementations. The Session class can be included with the Discovery class, in associations with the Catalogue Service class. The "e;query"e; and "e;present"e; operations may be executed in a session or stateful context. If a session context exists, the dynamic model uses internal states of the session and the allowed transitions between states. When the "e;query"e; and "e;present"e; state does not include a session between a server and a client, any memory or shared information between the client and the server may be based on private understandings or features available in the protocol binding. The describeRecordType and getDomain operations do not require a session context.

Version:

$Revision: 31089 $, $Date: 2011-06-22 10:30:37 +0200 (Mi, 22 Jun 2011) $

Author:

Andreas Poth , Torsten Friebe , last edited by: $Author: lbuesching $

Field Summary

protected CatalogueConfiguration	cswConfiguration
protected static String	DEFAULT_SCHEMA
protected static Map<String,XSLTDocument>	IN_XSL
protected static String	OGC_CORE_SCHEMA
protected static Map<String,XSLTDocument>	OUT_XSL
protected static Map<String,XSDocument>	SCHEMA_DOCS
protected static Map<String,URL>	SCHEMA_URLS
protected WFService	wfsResource The complete data access of a catalog service is managed by one instances of WFService.

Constructor Summary

Discovery()
to be used with reflections

Discovery(WFService wfsService, CatalogueConfiguration cswConfiguration)

Method Summary

DescribeRecordResult	describeRecordType(DescribeRecord request) Performs the submitted DescribeRecord -request.
protected int	determineRecordsMatched(GetRecords getRecords) Returns the number of records matching a GetRecords request.
DomainValues	getDomain(GetDomain request)
GetRepositoryItemResponse	guery(GetRepositoryItem request) Contacts the wfsResource to find a rim:ExtrinsicObject which contains the GetRepositoryItem.getRepositoryItemID() and retrieves it's app:RegistryObject/app:extrinsicObject/app:ExtrinsicObject/app:object.
void	init(WFService wfsService, CatalogueConfiguration serviceConfiguration)
GetRecordByIdResult	query(GetRecordById getRecordById) Performs a GetRecordById request.
GetRecordsResult	query(GetRecords getRecords) Performs a GetRecords request.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

IN_XSL

protected static final Map<String,XSLTDocument> IN_XSL

OUT_XSL

protected static final Map<String,XSLTDocument> OUT_XSL

SCHEMA_URLS

protected static final Map<String,URL> SCHEMA_URLS

SCHEMA_DOCS

protected static final Map<String,XSDocument> SCHEMA_DOCS

DEFAULT_SCHEMA

protected static final String DEFAULT_SCHEMA

See Also:

Constant Field Values

OGC_CORE_SCHEMA

protected static final String OGC_CORE_SCHEMA

See Also:

Constant Field Values

cswConfiguration

protected CatalogueConfiguration cswConfiguration

wfsResource

protected WFService wfsResource

The complete data access of a catalog service is managed by one instances of WFService.

Constructor Detail

Discovery

public Discovery()

to be used with reflections

Discovery

public Discovery(WFService wfsService,
                 CatalogueConfiguration cswConfiguration)

Parameters:

wfsService - to contact

cswConfiguration - of this service

Method Detail

init

public void init(WFService wfsService,
                 CatalogueConfiguration serviceConfiguration)

Parameters:

wfsService -

serviceConfiguration -

describeRecordType

public DescribeRecordResult describeRecordType(DescribeRecord request)
                                        throws OGCWebServiceException

Performs the submitted DescribeRecord -request. TODO: Check output schema & Co.

Parameters:

request -

Returns:

The DescribeRecordResult created from the given request

Throws:

OGCWebServiceException

getDomain

public DomainValues getDomain(GetDomain request)

Parameters:

request - which is not handled

Returns:

just a new empty DomainValues instance.

query

public GetRecordsResult query(GetRecords getRecords)
                       throws OGCWebServiceException

Performs a GetRecords request.

This involves the following steps:

• GetRecords->GetRecordsDocument
• GetRecordsDocument->GetFeatureDocument using XSLT
• GetFeatureDocument->GetFeature
• GetFeature request is performed against the underlying WFS
• WFS answers with a FeatureResult object (which contains a FeatureCollection)
• FeatureCollection-> GMLFeatureCollectionDocument (as a String)
• GMLFeatureCollectionDocument->GetRecordsResultDocument using XSLT
• GetRecordsResultDocument->GetRecordsResult

Parameters:

getRecords -

Returns:

GetRecordsResult

Throws:

OGCWebServiceException

determineRecordsMatched

protected int determineRecordsMatched(GetRecords getRecords)
                               throws OGCWebServiceException

Returns the number of records matching a GetRecords request.

Parameters:

getRecords -

Returns:

the number of records matching a GetRecords request

Throws:

OGCWebServiceException

query

public GetRecordByIdResult query(GetRecordById getRecordById)
                          throws OGCWebServiceException

Performs a GetRecordById request.

This involves the following steps:

• GetRecordById->GetRecordByIdDocument
• GetRecordByIdDocument->GetFeatureDocument using XSLT
• GetFeatureDocument->GetFeature
• GetFeature request is performed against the underlying WFS
• WFS answers with a FeatureResult object (which contains a FeatureCollection)
• FeatureCollection-> GMLFeatureCollectionDocument (as a String)
• GMLFeatureCollectionDocument->GetRecordsResultDocument using XSLT
• GetRecordsResultDocument->GetRecordsResult

Parameters:

getRecordById -

Returns:

The GetRecordByIdResult created from teh given GetRecordById

Throws:

OGCWebServiceException

guery

public GetRepositoryItemResponse guery(GetRepositoryItem request)
                                throws OGCWebServiceException

Contacts the wfsResource to find a rim:ExtrinsicObject which contains the GetRepositoryItem.getRepositoryItemID() and retrieves it's app:RegistryObject/app:extrinsicObject/app:ExtrinsicObject/app:object. The value in this property will then be written to the response stream (e.g. sent to the requester).

Parameters:

request - the created OGCRequest

Returns:

the repository item response

Throws:

OGCWebServiceException