diff options
| author | Chris McDonough <chrism@agendaless.com> | 2009-05-22 15:27:54 +0000 |
|---|---|---|
| committer | Chris McDonough <chrism@agendaless.com> | 2009-05-22 15:27:54 +0000 |
| commit | 6bcd8f69d18c3a4c331f88094dd46540114422af (patch) | |
| tree | 58c687953e14c37b92657fcdd4eb06109fec0362 /docs | |
| parent | 21a4807c8352358b446fd12186402ea4b1815763 (diff) | |
| download | pyramid-6bcd8f69d18c3a4c331f88094dd46540114422af.tar.gz pyramid-6bcd8f69d18c3a4c331f88094dd46540114422af.tar.bz2 pyramid-6bcd8f69d18c3a4c331f88094dd46540114422af.zip | |
Tweak.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/narr/traversal.rst | 23 |
1 files changed, 15 insertions, 8 deletions
diff --git a/docs/narr/traversal.rst b/docs/narr/traversal.rst index 5b81a0af3..467916779 100644 --- a/docs/narr/traversal.rst +++ b/docs/narr/traversal.rst @@ -3,13 +3,14 @@ Traversal ========= -The :mod:`repoze.bfg` *Router* parses the URL associated with the -request and traverses the graph based on path segments in the URL. -Based on these path segments, :mod:`repoze.bfg` traverses the *model -graph* in order to find a :term:`context`. It then attempts to find a -:term:`view` based on the *type* of the context (specified by an -:term:`interface`). If :mod:`repoze.bfg` finds a :term:`view` for the -context, it calls it and returns a response to the user. +When :term:`traversal` is used, the :mod:`repoze.bfg` *Router* parses +the URL associated with the request and splits the URL into path +segments. Based on these path segments, :mod:`repoze.bfg` traverses +a *model graph* in order to find a :term:`context`. It then +attempts to find a :term:`view` based on the *type* of the context +(specified by an :term:`interface`). If :mod:`repoze.bfg` finds a +:term:`view` for the context, it calls it and returns a response to +the user. The Model Graph --------------- @@ -30,7 +31,13 @@ dictionary). .. note:: If a :term:`root factory` is passed to the :mod:`repoze.bfg` "make_app" function as the value ``None``, no traversal is performed. Instead, it's assumed that all URLs will be mapped to - code via :term:`URL dispatch`. No root factory, no traversal. + code via :term:`URL dispatch`. No root factory, no traversal. It + is also possible to mix-and-match traversal with URL dispatch. + When both a root factory (and therefore traversal) *and* "routes" + declarations (and therefore url dispatch) are used, the url + dispatch routes are checked first, and if none match, + :mod:`repoze.bfg` will fall back to using traversal to attempt to + map the request to a view. Items contained within the object graph are analogous to the concept of :term:`model` objects used by many other frameworks (and |