doc/book/en/devweb/controllers.rst
branchstable
changeset 6347 ef47a2100c66
parent 5459 6e561796804c
child 7529 2fdc310be7cd
equal deleted inserted replaced
6346:1a968e545e4e 6347:ef47a2100c66
    13 list them by category. They are all defined in
    13 list them by category. They are all defined in
    14 (:mod:`cubicweb.web.views.basecontrollers`).
    14 (:mod:`cubicweb.web.views.basecontrollers`).
    15 
    15 
    16 `Browsing`:
    16 `Browsing`:
    17 
    17 
    18 * the View controlleris associated with most browsing actions within a
    18 * the View controller is associated with most browsing actions within a
    19   CubicWeb application: it always instantiates a
    19   CubicWeb application: it always instantiates a :ref:`the_main_template` and
    20   :ref:`the_main_template` and lets the ResultSet/Views dispatch
    20   lets the ResultSet/Views dispatch system build up the whole content; it
    21   system build up the whole content; it handles ObjectNotFound and
    21   handles :exc:`ObjectNotFound` and :exc:`NoSelectableObject` errors that may
    22   NoSelectableObject errors that may bubble up to its entry point, in
    22   bubble up to its entry point, in an end-user-friendly way (but other
    23   an end-user-friendly way (but other programming errors will slip
    23   programming errors will slip through)
    24   through)
       
    25 
    24 
    26 * the JSon controller (same module) provides services for Ajax calls,
    25 * the JSon controller (same module) provides services for Ajax calls,
    27   typically using JSON as a serialization format for input, and
    26   typically using JSON as a serialization format for input, and
    28   sometimes using either JSON or XML for output;
    27   sometimes using either JSON or XML for output;
    29 
    28 
    47 
    46 
    48 * the ``SendMail controller`` (web/views/basecontrollers.py) is reponsible
    47 * the ``SendMail controller`` (web/views/basecontrollers.py) is reponsible
    49   for outgoing email notifications
    48   for outgoing email notifications
    50 
    49 
    51 * the MailBugReport controller (web/views/basecontrollers.py) allows
    50 * the MailBugReport controller (web/views/basecontrollers.py) allows
    52   to quickly have a `repotbug` feature in one's application
    51   to quickly have a `reportbug` feature in one's application
    53 
    52 
    54 Registration
    53 Registration
    55 ++++++++++++
    54 ++++++++++++
    56 
    55 
    57 All controllers (should) live in the 'controllers' namespace within
    56 All controllers (should) live in the 'controllers' namespace within