Query parameters

Introduction

Query parameters are name-value pairs sent as part of the request URL following ? character.

Example:

POST example.com/todo/1234?name=jaguar&message=hello&at=5

Query parameters are often used to send post/put data of the request. For example, HTML forms with simple inputs are usually encoded as query parameters.

Query parameters are also used to send extra parameters for the request.

Accessing Query parameters

queryParams method on Context object shall be used to obtain value of the query parameter by name.

Example:

  @Get(path: '/books')
  Future<Response<String>> getBooks(Context ctx) async {
    // get the queryParams from
    String from = ctx.queryParams.get('from');
  }

DynamicDottableMap

queryParams is of type QueryParams, which is extended from DynamicDottableMap. This offers some nice features like:

1. Type conversion
2. Query parameters as properties

Type conversion

DynamicDottableMap provides convenience methods to convert query parameter value to built-in type.

• get
  Returns query parameter as String
• getInt Converts and returns query parameter as int
• getDouble Converts and returns query parameter as double
• getNum Converts and returns query parameter as num
• getBool Converts and returns query parameter as bool

All these methods take an optional defaultValue argument, which is returned if the conversion of the query parameter fails.

Example:

  @Get(path: '/books')
  Future<Response<String>> getBooks(Context ctx) async {
    // get the queryParams from
    int from = ctx.queryParams.getInt('from', 0);
  }

Query parameters as properties

DynamicDottableMap allows accessing query parameter values like they are properties on the queryParams object.

Example:

  @Put(path: '/book/:id')
  Future<Response<String>> updateBook(Context ctx) async {
    // get the query parameter as property
    String from = ctx.queryParams.from;
  }