The \u201cwidget problem\u201d is when you have several panels or content areas on an HTML page that have different data sources. You might have a main content area, then a calendar off to the side, with perhaps a list of recent news items or blog posts, a todo or reminder widget, and maybe other information panels. The problem is that they each have different data sources, and may not always be displayed in every circumstance -- perhaps they are only shown to some users based on their preferences, or under certain conditions.
\nSo how, in Action-Domain-Responder, do we get the \u201cright\u201d data for the set of widgets that are actually going to be displayed? (We\u2019ll presume here that the entire page is being rendered server-side, for delivery as a whole to the client.)
\nThe answer is \u201cthe same as with anything else\u201d \u2013 we just have more kinds of data to get from the domain. The domain has all the data needed, and the knowledge necessary to figure out which data elements to return.
\nLet\u2019s start with the Action, which is intentionally very spare: it only collects input, calls the Domain with that input, then invokes the Responder:
\n<?php\nclass PageAction\n{\n public function __construct(\n PageService $domain,\n PageResponder $responder\n ) {\n $this->domain = $domain;\n $this->responder = $responder;\n }\n\n public function __invoke(HttpRequest $request)\n {\n $payload = $this->domain->fetchPageData(\n $request->getAttribute('sessionId'),\n $request->getAttribute('pageName')\n );\n return $this->responder->respond($request, $payload);\n }\n}\nThe domain work is where the heavy lifting happens. The example below returns the domain objects and data wrapped in a Domain Payload object.
\n<?php\nclass PageService\n{\n // presume $userService, $sessionService, and $database\n // dependencies are injected via constructor\n\n public function fetchPageData($sessionId, $pageName)\n {\n $session = $this->sessionService->resume($sessionId);\n $user = $this->userService->fetch($session->userId);\n\n // the main page data\n $mainData = $this->fetchMainData($pageName);\n if (! $mainData) {\n return new Payload('NOT_FOUND');\n }\n\n // an array of widgets to show\n $widgets = [];\n\n // different users might prefer to see different widgets\n foreach ($user->getWidgetsToShow() as $widgetName) {\n $method = \"fetch{$widgetName}Data\";\n $widgets[$widgetName] = $this->$method();\n }\n\n $this->sessionService->commit($session);\n\n return new Payload('FOUND', [\n 'user' => $user,\n 'page_name' => $pageName,\n 'main_data' => $mainData,\n 'widgets' => $widgets\n ]);\n }\n\n protected function fetchMainData($page_name)\n {\n return $this->database->fetchRow(\n \"SELECT * FROM pages WHERE page_name = ? LIMIT 1\",\n $page_name\n );\n }\n\n protected function fetchTodoData() { ... }\n\n protected function fetchRemindersData() { ... }\n\n protected function fetchUpcomingEventsData() { ... }\n\n protected function fetchCalendarData() { ... }\n\n}\nFinally, the Responder work becomes as straightforward as: \u201cIs there Todo data to present? Then render the Todo widget via a Todo helper using the Todo data.\u201d It could be as simple as this:
\n<?php\nclass PageResponder\n{\n // ...\n\n public function respond(Request $request, Payload $payload)\n {\n if ($payload->getStatus() == 'NOT_FOUND') {\n return new Response(404);\n }\n\n $output = $payload->getOutput();\n\n $html = '';\n $html .= $this->renderHeader($output['page_name'];\n $html .= $this->renderNav();\n $html .= $this->renderMain($output['main_data']);\n\n foreach ($output['widgets'] as $widgetName => $widgetData) {\n $method = \"render{$widgetName}Html\";\n $html .= $this->$method($widgetData);\n }\n\n return new Response(200, $html);\n }\n\n protected function renderHeader($request, $pageName) { ... }\n\n protected function renderNav($request) { ... }\n\n protected function renderMain($request, $mainData) { ... }\n\n protected function renderTodoHtml($request, $widgetData) { ... }\n\n protected function renderRemindersHtml($request, $widgetData) { ... }\n\n protected function renderUpcomingEventsHtml($request, $widgetData) { ... }\n\n protected function renderCalendarHtml($request, $widgetData) { ... }\n?>\nOne alternative here is for some client-side Javascript to make one additional call per widget or panel to retrieve widget-specific data, then render that data on the client. The server-side work becomes less complex (one action per widget, and transform the data to JSON instead of HTML) \u2013 but the client-side work becomes more complex, and you have more HTTP calls back-and-forth to build the page.
\n" }