Learn R Programming

sos4R (version 0.2-11)

OWS: Classes and Construction Functions for Elements of the OWS Namespace

Description

These classes represent elements from the OGC Web Services Common Specification and the OGC Web Services Common Standard.

Usage

OwsCapabilities(version, updateSequence = NA, owsVersion = sosDefaultGetCapOwsVersion, identification = NULL, provider = NULL, operations = NULL, contents = NULL, languages = NULL) OwsException(exceptionCode, exceptionText = c(), locator = as.character(NA)) OwsExceptionReport(version, lang = as.character(NA), exceptions = list(NA)) OwsGetCapabilities(service, acceptVersions, sections = sosDefaultGetCapSections, acceptFormats = sosDefaultGetCapAcceptFormats, updateSequence = c(as.character(NA)), owsVersion = sosDefaultGetCapOwsVersion, acceptLanguages = c(NA)) OwsOperation(name, DCPs, parameters = list(NA), constraints = list(NA), metadata = list(NA)) OwsOperationsMetadata(operations, parameters = list(NA), constraints = list(NA), extendedCapabilities = xmlNode(NA)) OwsRange(minimumValue = as.character(NA), maximumValue = as.character(NA), rangeClosure = as.character(NA), spacing = as.character(NA)) OwsServiceProvider(providerName, providerSite = as.character(NA), serviceContact = xmlNode(NA)) OwsServiceIdentification(serviceType, serviceTypeVersion, profile = c(NA), title, abstract = c(NA), keywords = c(NA), fees = as.character(NA), accessConstraints = c(NA))

Arguments

abstract
Brief narrative description of this server, normally available for display to a human.
acceptFormats
Unordered character vector of zero or more response formats desired by client, with preferred formats listed first.
acceptLanguages
Unordered character vector of zero or more languages desired by client, with preferred formats listed first. Only OWS 2.0.0!
acceptVersions
Comma-separated prioritized sequence of one or more specification versions accepted by client, with preferred versions listed first.
accessConstraints
Access constraints that should be observed to assure the protection of privacy or intellectual property, and any other restrictions on retrieving or using data from or otherwise using a server.
constraints
Constraint on valid domain of a non-parameter quantity that applies to an operation which a server implements.
contents
The provider section of a capabilities document, object of class OwsContentsOrNULL.
DCPs
Information for a Distributed Computing Platform (DCP) supported for an operation.
exceptionCode
The code attribute of an OWS Exception, see OwsExceptionsData.
exceptions
The list of OwsException in a OwsExceptionReport.
exceptionText
The text element of an OWS Exception, see OwsExceptionsData.
extendedCapabilities
The possible contents of the ExtendedCapabilities subsection are not specified by the SOS standard.
fees
Fees and terms for using a server, including the monetary units as specified in ISO 4217.
identification
The identification section of a capabilities document, object of class OwsServiceIdentificationOrNULL.
keywords
Unordered list of one or more commonly used or formalised word(s) or phrase(s) used to describe a server.
lang
The code attribute of an OWS Exception.
languages
The languages section of a capabilities document, currently an object of class XMLAbstractNode.
locator
The locator attribute of an OWS Exception, see OwsExceptionsData.
maximumValue
Maximum value of a range (numeric parameter).
metadata
Metadata about an operation and its implementation.
minimumValue
Minimum value of a range (numeric parameter).
name
Name of an operation (request) (for example, GetCapabilities).
operations
A list of objects of class OwsOperation in a OperationsMetadata object. The provider section of a capabilities document.
owsVersion
The used OWS specification version.
parameters
Parameter valid domain that applies to an operation which a server implements.
profile
Identifier of OGC Web Service (OWS) Application Profile.
providerName
Unique identifier for service provider organization.
providerSite
Reference to the most relevant web site of a service provider.
provider
The provider section of a capabilities document, object of class OwsServiceProviderOrNULL.
rangeClosure
Specifies which of minimum and maximum values are included in this range; include when not default of “closed” range. Possible values are closed, open, open-closed, or closed-open.
sections
Unordered character vector of zero or more names of sections of service metadata document to be returned in service metadata document.
serviceContact
Information for contacting service provider.
service
Service type identifier text.
serviceType
A service type name from registry of services.
serviceTypeVersion
Version of a service type implemented by a server.
spacing
Regular distance or spacing between allowed values in this range; include when range is not continuous.
title
Title of a server, normally used for display to a human.
updateSequence
Service metadata document version, value is "increased" whenever any change is made in complete service metadata document. This can be used to request a certain version of a metadata document. Parameter is found in both request and reponse, but may not be supported by a service.
version
The version of the document.

Objects from the Class

Objects can be created by calling the construction functions, e.g. in the form OwsCapabilities_1.1.0(...), OwsContents(...) or OwsException(...). The following classes are virtual and no objects may be created from it: OwsContentsOrNULL, OwsServiceIdentificationOrNULL, OwsServiceProviderOrNULL, OwsOperationsMetadataOrNULL.

Slots

Capabilities:
contents:
Object of class "OwsContentsOrNULL", the contents section of a capabilities document.
identification:
Object of class "OwsServiceIdentificationOrNULL", the identification section of a capabilities document.
languages:
Object of class "XMLAbstractNode", the languages section of a capabilities document, only OWS 2.0.0!
operations:
Object of class "OwsOperationsMetadataOrNULL", the operations section of capabilities document.
owsVersion:
Object of class "character", the used version of OWS.
provider:
Object of class "OwsServiceProviderOrNULL", the provider section of a capabilities document.
updateSequence:
Object of class "character", the updateSequence attribute of a capabilities document.
version:
Object of class "character", the version of the described service in a capabilities document.
exceptionCode:
Object of class "character", the code attribute of an OWS Exception, see OwsExceptionsData.
exceptionText:
Object of class "vector", the text of an OWS Exception, see OwsExceptionsData.
locator:
Object of class "character", the locator attribute of an OWS Exception, see OwsExceptionsData.
version:
Object of class "character", the version of an OWS Exception, see OwsExceptionsData.
lang:
Object of class "character", the code attribute of an OWS Exception, see OwsExceptionsData.
exceptions:
Object of class "list", the list of OwsException in a OwsExceptionReport.
sections:
Object of class "vector", unordered character vector of zero or more names of sections of service metadata document to be returned in service metadata document.
acceptFormats:
Object of class "vector", unordered character vector of zero or more response formats desired by client, with preferred formats listed first.
updateSequence:
Object of class "vector", service metadata document version.
acceptVersions:
Object of class "character", comma-separated prioritized sequence of one or more specification versions accepted by client, with preferred versions listed first.
service:
Object of class "character", the name of the service.
request:
Object of class "character", the name of the operation/request.
acceptLanguages:
Object of class "vector", an unordered character vector of zero or more languages desired by client, with preferred formats listed first. Only OWS 2.0.0!
name:
Object of class "character", name of an operation (request) (for example, GetCapabilities).
DCPs:
Object of class "list", information for a Distributed Computing Platform (DCP) supported for an operation.
parameters:
Object of class "list", parameter valid domain that applies to an operation which a server implements.
constraints:
Object of class "list", Constraint on valid domain of a non-parameter quantity that applies to an operation which a server implements.
metadata:
Object of class "list", metadata about an operation and its implementation.
operations:
Object of class "list", a list of objects of class OwsOperation in a OperationsMetadata object.
extendedCapabilities:
Object of class "XMLAbstractNode", the possible contents of the ExtendedCapabilities subsection.
minimumValue:
Object of class "character", minimum value of a range (numeric parameter).
maximumValue:
Object of class "character", maximum value of a range (numeric parameter).
rangeClosure:
Object of class "character", specifies which of minimum and maximum values are included in this range.
spacing:
Object of class "character", regular distance or spacing between allowed values in this range; included when range is not continuous.
serviceType:
Object of class "character", the service type name from registry of services.
serviceTypeVersion:
Object of class "vector", version of a service type implemented by the server.
profile:
Object of class "vector", identifier of OGC Web Service (OWS) Application Profile.
title:
Object of class "vector", title of the server, normally used for display to a human.
abstract:
Object of class "vector", brief narrative description of this server, normally available for display to a human.
keywords:
Object of class "vector", unordered list of one or more commonly used or formalised word(s) or phrase(s) used to describe a server.
fees:
Object of class "character", fees and terms for using a server, including the monetary units as specified in ISO 4217.
accessConstraints:
Object of class "vector", access constraints that should be observed to assure the protection of privacy or intellectual property, and any other restrictions on retrieving or using data from or otherwise using a server.
providerName:
Object of class "character", unique identifier for service provider organization.
providerSite:
Object of class "character", reference to the most relevant web site of a service provider.
serviceContact:
Object of class "XMLAbstractNode", information for contacting service provider.

Extends

OwsCapabilities_1.1.0: Class "OwsCapabilities", directly. OwsCapabilities_2.0.0: Class "OwsCapabilities_1.1.0", directly. Class "OwsCapabilities", by class "OwsCapabilities_1.1.0", distance 2. OwsGetCapabilities_1.1.0 Class "OwsGetCapabilities", directly. Class "OwsServiceOperation", by class "OwsGetCapabilities", distance 2. OwsGetCapabilities_2.0.0: Class "OwsGetCapabilities_1.1.0", directly. Class "OwsGetCapabilities", by class "OwsGetCapabilities_1.1.0", distance 2. Class "OwsServiceOperation", by class "OwsGetCapabilities_1.1.0", distance 3. OwsServiceIdentification: Class "OwsServiceIdentificationOrNULL", directly. OwsServiceProvider: Class "OwsServiceProviderOrNULL", directly.

Methods

show
signature(object = ""): Shows a human readable version of the object.
checkRequest
signature(service = "SOS", operation = "OwsGetCapabilities_1.1.0", verbose = "logical") or signature(service = "SOS", operation = "OwsGetCapabilities_2.0.0", verbose = "logical"): Check the given operation for validity and for compliance with the metadata of the given SOS.
encodeRequestKVP
signature(obj = "OwsGetCapabilities"): See link{encodeRequestKVP}.
encodeRequestSOAP
signature(obj = "OwsGetCapabilities"): See link{encodeRequestSOAP}.
encodeRequestXML
signature(obj = "OwsGetCapabilities"): See link{encodeRequestXML}.
encodeRequestKVP
signature(obj = "OwsGetCapabilities_2.0.0"): See link{encodeRequestKVP}.
encodeRequestKVP
signature(obj = "OwsGetCapabilities_1.1.0"): See link{encodeRequestKVP}.
sosRequest
signature(sos = "SOS", request = "OwsServiceOperation", verbose = "logical", inspect = "logical"): Send the given operation as a request to the given SOS.

Details

OwsServiceOperation is the top class which is eventually put into the request method, sosRequest(...).

Classes ending in ...OrNULL are used to model optional slots.

References

Whiteside A. (Ed.), OGC Web Services Common Specification, Open Geospatial Consortium Inc., OGC 06-121r3, Version: 1.1.0 with Corrigendum 1

Whiteside A., Greenwood, J. (Eds.), OGC Web Services Common Standard, Open Geospatial Consortium Inc., OGC 06-121r9, Version: 2.0.0

Examples

Run this code
showClass("OwsCapabilities_1.1.0")
showClass("OwsCapabilities_2.0.0")
showClass("OwsCapabilities")
showClass("OwsContents")
showClass("OwsContentsOrNULL")
showClass("OwsException")
showClass("OwsExceptionReport")
showClass("OwsGetCapabilities_1.1.0")
showClass("OwsGetCapabilities_2.0.0")
showClass("OwsGetCapabilities")
showClass("OwsOperation")
showClass("OwsOperationsMetadata")
showClass("OwsRange")
showClass("OwsServiceIdentification")
showClass("OwsServiceIdentificationOrNULL")
showClass("OwsServiceOperation")
showClass("OwsServiceProvider")
showClass("OwsServiceProviderOrNULL")

# TBD examples for construction functions

Run the code above in your browser using DataLab