Add RootControllerDelegate

diff --git a/http/root_controller.php b/http/root_controller.php
index ca09e42905fb94058ebb75dea4cbd7fa24733232..43d16dad24b80ade384bc9e4b291ca6efa6a886a 100644 (file)
--- a/http/root_controller.php
+++ b/http/root_controller.php
@@ -16,6 +16,7 @@
 
 namespace hoplite\http;
 
+require_once HOPLITE_ROOT . '/base/weak_interface.php';
 require_once HOPLITE_ROOT . '/http/request.php';
 require_once HOPLITE_ROOT . '/http/response.php';
 require_once HOPLITE_ROOT . '/http/response_code.php';
@@ -38,6 +39,9 @@ class RootController
   /*! @var OutputFilter */
   private $output_filter = NULL;
 
+  /*! @var WeakInterface<RootControllerDelegate> */
+  private $delegate = NULL;
+
   /*!
     Creates the controller with the request context information, typicallhy
     from the global scope ($GLOBALS), but can be injected for testing.
@@ -55,6 +59,7 @@ class RootController
       '_COOKIE' => &$globals['_COOKIE'],
       '_SERVER' => &$globals['_SERVER']
     );
+    $this->delegate = new \hoplite\base\WeakInterface('hoplite\http\RootControllerDelegate');
   }
 
   /*! Accessors */
@@ -70,6 +75,12 @@ class RootController
     $this->output_filter = $output_filter;
   }
 
+  /*! Sets the delegate. */
+  public function set_delegate($delegate)
+  {
+    $this->delegate->Bind($delegate);
+  }
+
   /*!
     Createst the Request and Response that are used throughout the duration of
     the execution.
@@ -89,6 +100,8 @@ class RootController
     $this->request->url = $url;
     $this->request->http_method = $this->request->data['_SERVER']['REQUEST_METHOD'];
 
+    $this->delegate->OnInitialRequest($this->request);
+
     // Dispatch the request to an Action.
     $this->RouteRequest($this->request);
 
@@ -103,6 +116,7 @@ class RootController
   */
   public function Stop()
   {
+    $this->delegate->WillStop($this->request, $this->response);
     $this->output_filter->FilterOutput($this->request, $this->response);
     $this->_Exit();
   }
@@ -122,6 +136,8 @@ class RootController
   */
   public function RouteRequest(Request $request)
   {
+    $this->delegate->WillRouteRequest($request, $this->response);
+
     $url_map_value = $this->url_map->Evaluate($request);
 
     $action = NULL;
@@ -143,9 +159,13 @@ class RootController
   */
   public function InvokeAction(Action $action)
   {
+    $this->delegate->WillInvokeAction($action, $this->request, $this->response);
+
     $action->FilterRequest($this->request, $this->response);
     $action->Invoke($this->request, $this->response);
     $action->FilterResponse($this->request, $this->response);
+
+    $this->delegate->DidInvokeAction($action, $this->request, $this->response);
   }
 
   /*!
@@ -162,3 +182,20 @@ class RootController
     }
   }
 }
+
+/*!
+  Delegate for the root controller. The controller uses WeakInterface to call
+  these methods, so they're all optional.
+*/
+interface RootControllerDelegate
+{
+  public function OnInitialRequest(Request $request);
+
+  public function WillRouteRequest(Request $request, Response $response);
+
+  public function WillInvokeAction(Action $action, Request $request, Response $response);
+
+  public function DidInvokeAction(Action $action, Request $request, Response $response);
+
+  public function WillStop(Request $request, Response $response);
+}