PHRUTS_ActionService represents the "controller" in the Model-View-Controller (MVC) design pattern for web applications that is commonly known as "Model 2".

Generally, a "Model 2" application is architected as follows:

• The user interface will generally be created with PHP pages, which will not themselves contain any business logic. These pages represent the "view" component of an MVC architecture.
• Forms and hyperlinks in the user interface that require business logic to be executed will be submitted to a request URI that is mapped to the controller service.
• There will be one instance of this service class, which receives and processes all requests that change the state of a user's interaction with the application. This component represents the "controller" component of an MVC architecture.
• The controller service will select and invoke an action class to perform the requested business logic.
• The action classes will manipulate the state of the application's interaction with the user, typically by creating or modifying PHPBeans that are stored as request or session attributes (depending on how long they need to be available). Such PHPBeans represent the "model" component of an MVC architecture.
• Instead of producing the next page of the user interface directly, action classes will generally use the PHRUTS_RequestDispatcher->forward facility of the service API to pass control to an appropriate PHP page to produce the next page of the user interface.

<p>The standard version of PHRUTS_ActionService implements the following logic for each incoming HTTP request. You can override some or all of this functionality by subclassing this service and implementing your own version of the processing.</p>

• Identify, from the incoming request URI, the substring that will be used to select an action procedure.
• Use this substring to map to the PHP class name of the corresponding action class (an implementation of the PHRUTS_Action interface).
• If this is the first request for a particular action class, instantiate an instance of that class and cache it for future use.
• Optionally populate the properties of a PHRUTS_ActionForm bean associated with this mapping.
• Call the execute method of this action class, passing on a reference to the mapping that was used (thereby providing access to the underlying PHRUTS_ActionService and PHRUTS_ServiceContext, as well as any specialized properties of the mapping itself), and the request and response that were passed to the controller.

• author: John WILDENAUER <jwilde@users.sourceforge.net> (PHP4 port of Struts)
• author: Olivier HENRY <oliv.henry@gmail.com> (PHP5 port of Struts)
• version: $Id: PHRUTS_ActionService.php,v 1.5 2008/05/28 15:52:26 ohenry Exp $
• copyright: Copyright PHruts 2008
• todo: Add information in the class comment about the web deployment descriptor "/WEB-INF/web.xml".
• todo: Manage the possibility of subclassing the service controller.

Located in /action/PHRUTS_ActionService.php (line 103)