org.gcube.opensearch.opensearchoperator.resource
Class ISOpenSearchResource

java.lang.Object
  org.gcube.opensearch.opensearchoperator.resource.ISOpenSearchResource

All Implemented Interfaces:

OpenSearchResource

public class ISOpenSearchResource
extends Object
implements OpenSearchResource

Class implementing the OpenSearchResource interface that processes OpenSearch resources when an InformationSystem is available

Author:

gerasimos.farantatos

Constructor Summary

ISOpenSearchResource(String xml, gr.uoa.di.madgik.environment.hint.EnvHintCollection envHints)
Creates a new ISOpenSearchResource that will not use a cache

ISOpenSearchResource(String xml, Map<String,String> cachedDescriptionDocs, Map<String,String> cachedResourcesXML, Map<String,String> cachedXSLTs, gr.uoa.di.madgik.environment.hint.EnvHintCollection envHints)
Creates a new ISOpenSearchResource with a cache that will be used and further populated

Method Summary

Document	getDescriptionDocument() Retrieves the description document of the OpenSearch provider described by this resource
String	getDescriptionDocURL() Retrieves the URL of the description document of the OpenSearch provider described by this resource
String	getName() Returns the name of the OpenSearch provider
String	getParameterQName(String fieldName) Retrieves the fully qualified name of an OpenSearch parameter which corresponds to a field
Map<String,String>	getParameters() Retrieved the full mapping from field names to fully ns-qualified OpenSearch parameters as contained in the OpenSearch Resource
Map<String,String>	getPresentationInformation(String MIMEType) Retrieves the presentation information, that is, a mapping from field names to XPath expressions
XPathExpression	getRecordIdXPath(String MIMEType) Retrieves an XPathExpression that can be used to extract a record id a from a search result record
XPathExpression	getRecordSplitXPath(String MIMEType) Retrieves an XPathExpression that can be used to split a search result page of a given MIME type to individual records
String	getSecuritySpecs() Retrieves the security specifications of this OpenSearch provider
List<String>	getTransformationTypes() Retrieves a list of all MIME types for which there exists a transformation specification
Transformer	getTransformer() Retrieves a transformer that can be used to transform the results of the first MIME type appearing in this OpenSearch resource that are returned by the provider described by this resource
Transformer	getTransformer(String MIMEType) Retrieves a transformer that can be used to transform the results of a given MIME type that are returned by the provider described by this resource
boolean	isBrokered() Determines whether the provider described by this resource returns brokered results, i.e the results it returns describe other OpenSearch providers
boolean	isSecure() Determines if the provider described by this resource uses a security scheme

Methods inherited from class java.lang.Object

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

Constructor Detail

ISOpenSearchResource

public ISOpenSearchResource(String xml,
                            Map<String,String> cachedDescriptionDocs,
                            Map<String,String> cachedResourcesXML,
                            Map<String,String> cachedXSLTs,
                            gr.uoa.di.madgik.environment.hint.EnvHintCollection envHints)
                     throws Exception

Creates a new ISOpenSearchResource with a cache that will be used and further populated

Parameters:

xml - The XML representation of the OpenSearch resource

cachedDescriptionDocs - A cache containing description documents in XML form, identified by their URLs

cachedResourcesXML - A cache containing OpenSearch resources in XML form, identified by their description document URLs

cachedXSLTs - A cache containing XSLTs in XML form, identified by the names of the generic resources associated with them

envHints - The environment hints that to be passed to the InformationSystem

Throws:

Exception - If the resource is malformed or in case of other error

ISOpenSearchResource

public ISOpenSearchResource(String xml,
                            gr.uoa.di.madgik.environment.hint.EnvHintCollection envHints)
                     throws Exception

Creates a new ISOpenSearchResource that will not use a cache

Parameters:

xml - The XML representation of the OpenSearch resource

envHints - The environment hints that to be passed to the InformationSystem

Throws:

Exception - If the resource is malformed or in case of other error

Method Detail

getName

public String getName()

Returns the name of the OpenSearch provider

Specified by:

getName in interface OpenSearchResource

Returns:

The name of the OpenSearch provider

See Also:

OpenSearchResource.getName()

isBrokered

public boolean isBrokered()

Determines whether the provider described by this resource returns brokered results, i.e the results it returns describe other OpenSearch providers

Specified by:

isBrokered in interface OpenSearchResource

Returns:

true if the provider returns brokered results, false otherwise

See Also:

OpenSearchResource.isBrokered()

isSecure

public boolean isSecure()

Determines if the provider described by this resource uses a security scheme

Specified by:

isSecure in interface OpenSearchResource

Returns:

true if the provider uses a security scheme, false otherwise

See Also:

OpenSearchResource.isSecure()

getSecuritySpecs

public String getSecuritySpecs()

Retrieves the security specifications of this OpenSearch provider

Specified by:

getSecuritySpecs in interface OpenSearchResource

Returns:

The security specifications of the provider

See Also:

OpenSearchResource.getSecuritySpecs()

getDescriptionDocument

public Document getDescriptionDocument()

Retrieves the description document of the OpenSearch provider described by this resource

Specified by:

getDescriptionDocument in interface OpenSearchResource

Returns:

A Document representing the description document of the provider

See Also:

OpenSearchResource.getDescriptionDocument()

getDescriptionDocURL

public String getDescriptionDocURL()

Retrieves the URL of the description document of the OpenSearch provider described by this resource

Specified by:

getDescriptionDocURL in interface OpenSearchResource

Returns:

A String containing the URL of the description document of the provider

See Also:

OpenSearchResource.getDescriptionDocURL()

getTransformer

public Transformer getTransformer(String MIMEType)
                           throws Exception

Retrieves a transformer that can be used to transform the results of a given MIME type that are returned by the provider described by this resource

Specified by:

getTransformer in interface OpenSearchResource

Parameters:

MIMEType - The MIME type of the results that will be transformed

Returns:

The transformer that can be used to transform the results of the given MIME type

Throws:

Exception - In case of error

See Also:

OpenSearchResource.getTransformer(String)

getRecordSplitXPath

public XPathExpression getRecordSplitXPath(String MIMEType)
                                    throws Exception

Retrieves an XPathExpression that can be used to split a search result page of a given MIME type to individual records

Specified by:

getRecordSplitXPath in interface OpenSearchResource

Parameters:

MIMEType - The MIME type of the results returned by the provider described by this resource

Returns:

The Xpath expression that can be used to split search result pages to individual records

Throws:

Exception - In case of error

See Also:

OpenSearchResource.getRecordSplitXPath(String)

getRecordIdXPath

public XPathExpression getRecordIdXPath(String MIMEType)
                                 throws Exception

Retrieves an XPathExpression that can be used to extract a record id a from a search result record

Specified by:

getRecordIdXPath in interface OpenSearchResource

Parameters:

MIMEType - The MIME type of the results returned by the provider described by this resource

Returns:

The Xpath expression that can be used extract a record id from a search result record

Throws:

Exception - In case of error

See Also:

OpenSearchResource.getRecordIdXPath(String)

getTransformer

public Transformer getTransformer()
                           throws Exception

Retrieves a transformer that can be used to transform the results of the first MIME type appearing in this OpenSearch resource that are returned by the provider described by this resource

Specified by:

getTransformer in interface OpenSearchResource

Returns:

The transformer that can be used to transform the results of the first MIME type appearing in this OpenSearch resource

Throws:

Exception - In case of error

See Also:

OpenSearchResource.getTransformer()

getPresentationInformation

public Map<String,String> getPresentationInformation(String MIMEType)

Retrieves the presentation information, that is, a mapping from field names to XPath expressions

Specified by:

getPresentationInformation in interface OpenSearchResource

Returns:

See Also:

OpenSearchResource.getPresentationInformation(String)

getTransformationTypes

public List<String> getTransformationTypes()

Retrieves a list of all MIME types for which there exists a transformation specification

Specified by:

getTransformationTypes in interface OpenSearchResource

Returns:

All MIME types for which there exists a transformation specification

See Also:

OpenSearchResource.getTransformationTypes()

getParameterQName

public String getParameterQName(String fieldName)

Description copied from interface: OpenSearchResource

Retrieves the fully qualified name of an OpenSearch parameter which corresponds to a field

Specified by:

getParameterQName in interface OpenSearchResource

Parameters:

fieldName - The name of the field corresponding to the requested OpenSearch parameter

Returns:

The fully qualified name of the OpenSearch parameter

getParameters

public Map<String,String> getParameters()

Description copied from interface: OpenSearchResource

Retrieved the full mapping from field names to fully ns-qualified OpenSearch parameters as contained in the OpenSearch Resource

Specified by:

getParameters in interface OpenSearchResource

Returns:

All field name to fully ns-qualified mappings