Class: QgsServerQueryStringParameter¶
- class qgis.server.QgsServerQueryStringParameter¶
Bases:
sip.wrapper
The
QgsServerQueryStringParameter
class holds the information regarding a query string input parameter and its validation.The class is extendable through custom validators (C++ only) and/or by subclassing and overriding the
value()
method.New in version 3.10.
QgsServerQueryStringParameter(name: str, required: bool = False, type: QgsServerQueryStringParameter.Type = QgsServerQueryStringParameter.Type.String, description: str = ‘’, defaultValue: Any = None) Constructs a
QgsServerQueryStringParameter
object.- Parameters
name – parameter name
required –
type – the parameter type
description – parameter description
defaultValue – default value, it is ignored if the parameter is required
QgsServerQueryStringParameter(
QgsServerQueryStringParameter
)Enums
Bases:
enum.IntEnum
Methods
Returns parameter description
Returns the name of the parameter
Sets validator
description
Returns the name of the
type
Extracts the value from the request
context
by validating the parameter value and converting it to its proper Type.Attributes
- class Type(value)¶
Bases:
enum.IntEnum
The Type enum represents the parameter type
String
:Integer
:Double
:Boolean
:List
:
- Boolean = 1¶
- Double = 6¶
- Integer = 4¶
- List = 11¶
- String = 10¶
- baseClass¶
alias of
QgsServerQueryStringParameter
- description(self) str ¶
Returns parameter description
- Return type
str
- name(self) str ¶
Returns the name of the parameter
- Return type
str
- setDescription(self, description: str)¶
Sets validator
description
- Parameters
description (str) –
- staticMetaObject = <PyQt5.QtCore.QMetaObject object>¶
- typeName(type: QgsServerQueryStringParameter.Type) str ¶
Returns the name of the
type
- Parameters
type (QgsServerQueryStringParameter.Type) –
- Return type
str
- value(self, context: QgsServerApiContext) Any ¶
Extracts the value from the request
context
by validating the parameter value and converting it to its proper Type. If the value is not set and a default was not provided an invalid QVariant is returned.Validation steps:
required
can convert to proper Type
custom validator (if set - not available in Python bindings)
See also
setCustomValidator()
- Return type
Any
- Returns
the parameter value or an invalid QVariant if not found (and not required)
- Raises
QgsServerApiBadRequestError – if validation fails
- Parameters
context (QgsServerApiContext) –