Introduction Capitalization Parameter value lists Numeric and boolean values

84 Copyright © 2010 Open Geospatial Consortium, Inc. POST is used, the operation request message may be encoded as an XML document, formatted as specified by one or more XML Schemas. When POST is used, the operation request message may alternately be KVP encoded.

11.5 KVP encoding

11.5.1 Introduction

This subclause specifies the Keyword Value Pair KVP encoding of the operation request parameters specified in Clauses 7 through 10. KVP encoded values may include XML encoded data, with that data encoded in one XML element.

11.5.2 Capitalization

The capitalization of parameter names when KVP encoded shall be case insensitive, meaning that parameter names may have mixed case or not. EXAMPLES The ―request‖ parameter name could be REQUEST, request, Request, or ReQuEsT. NOTE The XML capitalization is uniformly used in Clauses 7 through 10 plus Annex C of this document. The capitalization of parameter values when encoded using Keyword Value Pairs shall be as used in Clause 7 through 10 of this document. More generally, all value strings shall have the first word and any subsequent words in the name capitalized. All other letters will be lower case. EXAMPLE One possible ―request‖ parameter value is ―GetCapabilities‖.

11.5.3 Parameter value lists

Parameters values containing lists for example, AcceptVersions and AcceptFormats in the GetCapabilities operation request shall use the comma , as the separator between items in the list. Additional white space shall not be used to delimit list items. If a list item value includes a space or comma, it shall be escaped using the URL encoding rules [IETF RFC 2396]. In some lists, individual entries may be empty, and shall be represented by the empty string . Thus, two successive commas indicates an empty item, as does a leading comma or a trailing comma. An empty list can either be interpreted as a list containing no items or as a list containing a single empty item, depending on the context.

11.5.4 Numeric and boolean values

Integer numbers shall be represented in a manner consistent with the specification for integers in Section 3.3.13 of [XML Schema Part 2: Datatypes]. Each Implementation Specification shall explicitly specify where an integer value is mandatory. Copyright © 2010 Open Geospatial Consortium, Inc. 85 Real numbers shall be represented in a manner consistent with the specification for double-precision numbers in Section 3.2.5 of [XML Schema Part 2: Datatypes]. This representation allows for integer, decimal and exponential notations. This representation also allows special values representing infinity and not-a-number, which shall not be used except where specifically allowed by an Implementation Specification. A real value is allowed in all numeric fields unless the value is explicitly restricted to integer. Boolean values shall be represented by the uppercase strings TRUE and FALSE, representing Boolean true and false respectively. Each Implementation Specification shall explicitly specify where a Boolean value is mandatory.

11.5.5 Parameter names