Explicit id

If a term id(ID) appears in the option list of the handler, ID it is used and takes preference over using the predicate.

Using the handler predicate

ID matches a handler if the predicate name matches ID. The ID may have a module qualification, e.g., Module:Pred

If the handler is declared with a pattern, e.g., root(user/User), the location to access a particular user may be accessed using e.g., user('Bob'). The number of arguments to the compound term must match the number of variables in the path pattern.

A plain atom ID can be used to find a handler with a pattern. The returned location is the path up to the first variable, e.g., /user/ in the example above.

User code is adviced to use http_link_to_id/3 which can also add query parameters to the URL. This predicate is a helper for http_link_to_id/3.

Errors

- existence_error(http_handler_id, Id).

See also

- http_link_to_id/3 and the library(http/html_write) construct location_by_id(ID) or its abbreviation #(ID)