https://github.com/pmjones/adr

Action-Domain-Responder: a web-specific alternative to Model-View-Controller.
https://github.com/pmjones/adr

Last synced: 30 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/pmjones/adr
• Owner: pmjones
• Created: 2014-05-06T15:01:09.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2022-02-28T16:23:43.000Z (over 2 years ago)
• Last Synced: 2024-10-01T13:42:51.185Z (about 1 month ago)
• Language: HTML
• Homepage: http://pmjones.io/adr
• Size: 641 KB
• Stars: 1,125
• Watchers: 63
• Forks: 64
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Changelog: HISTORY.md

Awesome Lists containing this project

README

        
# 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](adr.png)

## 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 needed to build an HTTP Response.

_Domain_ is an entry point to the domain logic forming the core of the application. It may be a _Transaction Script_, _Service Layer_, _Application Service_, or something similar.

_Responder_ is the presentation logic to build an HTTP Response using 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_.

1. The _Action_ invokes the _Domain_, collecting any required inputs to the _Domain_ from the HTTP Request.

1. 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).

1. The _Responder_ builds an HTTP Response using the data fed to it by the _Action_.

1. The _Action_ returns the HTTP Response to the web handler sends the HTTP Response.

## Reading

- [_Model View Controller_ and "Model 2"](./MVC-MODEL-2.md)

- [Comparing "Model 2" MVC to ADR](./ADR.md)

- [Tradeoffs in ADR](./TRADEOFFS.md)

- [Objections to ADR](./OBJECTIONS.md)

## Resources

- [Refactoring from "Model 2" MVC to ADR](./REFACTORING.md)

- [Implementation notes and advice](./IMPLEMENTATION.md)

- [ADR discussions, mentions, implementations, etc.](./MENTIONS.md)

Example code resides in the [`example`](https://github.com/pmjones/adr-example) repository.

You can also find out about [the history of this pattern](./HISTORY.md), [the research bibliography](./BIBLIO.md), and [the author's acknowledgments](./ACKNOWLEDGEMENTS.md).