Availability:
:- use_module(library(http/http_dispatch)).
- 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)
constructlocation_by_id(ID)
or its abbreviation#(ID)