Class UrlQueryParameter<T>

An class that defines an optional query parameter in a method.

Query parameters are included in the request URL as such: apix.example.com/entity/method?paramName=paramValue&param2=value2

In this example, there are 2 parameters, paramName and param2, and each has a value of paramValue and value2, respectively.

Example

const queryParameters = [
  // input is paramName, so it's expected to be `/entity/method?paramName=some_value`
  new UrlQueryParameter('paramName', someValidator, someProcessor, true),
  // input is 'ANOTHER_PARAM', so it's expected to be `/entity/method?ANOTHER_PARAM=some_value`
  // use someProcessor to transform the name into something like anotherParam
  new UrlQueryParameter('ANOTHER_PARAM', someValidator, someProcessor)
]

See

ApiXMethod#queryParameters UrlQueryParameterValidator UrlQueryParameterProcessor

Type Parameters

Index

Constructors

constructor

new UrlQueryParameter<T>(
    name: string,
    validator: UrlQueryParameterValidator,
    processor: UrlQueryParameterProcessor<T>,
    isRequired?: boolean,
): UrlQueryParameter<T>
An optional query parameter.
Type Parameters
- T
Parameters
- name: string
  The name of the parameter to define.
- validator: UrlQueryParameterValidator
  The object that validates the value of the parameter, if present.
- processor: UrlQueryParameterProcessor<T>
  The object that processes the parameter and its value, if present.
- isRequired: boolean = false
Returns UrlQueryParameter<T>
- Defined in src/apixlib/common/methods/UrlQueryParameter.ts:61

Accessors

name

get name(): string
The name of URL query parameter.

Returns string
- Defined in src/apixlib/common/methods/UrlQueryParameter.ts:75

processor

get processor(): UrlQueryParameterProcessor<T>
A processor that will transform a parameter into its most optimal form to be used by a method request handler. For example, a parameter param=value1,value2,value3 can be transformed so that the value is converted into a ReadonlyArray<string> or a ReadonlySet<string>.

Returns UrlQueryParameterProcessor<T>
- Defined in src/apixlib/common/methods/UrlQueryParameter.ts:92

validator

get validator(): UrlQueryParameterValidator
The validator that determines whether the value of the parameter is valid.

Returns UrlQueryParameterValidator
- Defined in src/apixlib/common/methods/UrlQueryParameter.ts:82

Methods

get

get(req: Request): undefined | [string, T]
A method that validates and processes a parameter into its final form.
Parameters
- req: Request
  The express request that contains the query parameters.
Returns undefined | [string, T]
The processed key value pair or undefined if missing and not required.

Throws
MissingRequiredParameterError if the parameter is required but missing.

Throws
InvalidParameterError if the parameter validation fails.
- Defined in src/apixlib/common/methods/UrlQueryParameter.ts:103

Class UrlQueryParameter<T>

Example

See

Type Parameters

Index

Constructors

Accessors

Methods

Constructors

constructor

Type Parameters

Parameters

Returns UrlQueryParameter<T>

Accessors

name

Returns string

processor

Returns UrlQueryParameterProcessor<T>

validator

Returns UrlQueryParameterValidator

Methods

get

Parameters

Returns undefined | [string, T]

Throws

Throws

Settings

On This Page