Parameters & Query
Ambiorix allows using parameters in the URL and also parses the query string for convenience.
- Parameters are accessible at
req$params$param_name - Query are accessible at
req$query$query_nameorreq$query[[index]]if unnamed.
Parameters
Use :<param> to indicate a parameter which can then be accessed with req$params$<name>.
library(ambiorix)
app <- Ambiorix$new()
app$get("/books/:category", \(req, res){
res$send(htmltools::h3("Books of", req$params$category))
})
app$start()
Run the app and visit these routes:
/books/fiction/books/math/books/philosophy
What do you notice?
Query
The parsed query string can also be accessed from the req object. Note that you may include named URL query arguments in the path for clarity these are not taken into account when matching path to requests.
library(ambiorix)
app <- Ambiorix$new()
app$get("/hello?firstname&lastname", \(req, res){
res$send(htmltools::h3("Hi", req$query$firstname, req$query$lastname))
})
app$start()
Run the app and visit these routes:
/hello?firstname=John&lastname=Coene/hello?firstname=John&lastname=Doe/hello?firstname=Marie&lastname=Curie