/adr

Action-Domain-Responder: a web-specific alternative to Model-View-Controller.

Primary LanguageHTML

Action Domain Responder

Action Domain Responder organizes a single user interface interaction between an HTTP client and a HTTP server-side application into three distinct roles.

ADR

Components

Action is the logic to connect the Domain and Responder. It invokes the Domain with inputs collected from the HTTP request, then invokes the Responder with the data it needs to build an HTTP response.

Domain is an entry point to the domain logic forming the core of the application, modifying state and persistence as needed. This may be a Transaction Script, Service Layer, Application Service, or something similar.

Responder is the presentation logic to build an HTTP response from the data it receives from the Action. It deals with status codes, headers and cookies, content, formatting and transformation, templates and views, and so on.

Collaborations

  1. The web handler receives an HTTP request and dispatches it to an Action.

  2. The Action invokes the Domain, collecting any required inputs to the Domain from the HTTP request.

  3. The Action then invokes the Responder with the data it needs to build an HTTP response (typically the HTTP request and the Domain results, if any).

  4. The Responder builds an HTTP response using the data fed to it by the Action.

  5. The Action returns the HTTP response to the web handler sends the HTTP response.

Reading

Resources

Example code resides in the example repository.


You can read about the history of this pattern here, and you can find the acknowledgments here.