mirror of
https://github.com/DesignPatternsPHP/DesignPatternsPHP.git
synced 2025-07-31 20:20:15 +02:00
Change index.rst to README.rst
remove all pattern's README.md
This commit is contained in:
77
Behavioral/Command/README.rst
Normal file
77
Behavioral/Command/README.rst
Normal file
@@ -0,0 +1,77 @@
|
||||
`Command`_
|
||||
==========
|
||||
|
||||
Purpose
|
||||
-------
|
||||
|
||||
To encapsulate invocation and decoupling.
|
||||
|
||||
We have an Invoker and a Receiver. This pattern uses a "Command" to
|
||||
delegate the method call against the Receiver and presents the same
|
||||
method "execute". Therefore, the Invoker just knows to call "execute" to
|
||||
process the Command of the client. The Receiver is decoupled from the
|
||||
Invoker.
|
||||
|
||||
The second aspect of this pattern is the undo(), which undoes the method
|
||||
execute(). Command can also be aggregated to combine more complex
|
||||
commands with minimum copy-paste and relying on composition over
|
||||
inheritance.
|
||||
|
||||
Examples
|
||||
--------
|
||||
|
||||
- A text editor : all events are Command which can be undone, stacked
|
||||
and saved.
|
||||
- Symfony2: SF2 Commands that can be run from the CLI are built with
|
||||
just the Command pattern in mind
|
||||
- big CLI tools use subcommands to distribute various tasks and pack
|
||||
them in "modules", each of these can be implemented with the Command
|
||||
pattern (e.g. vagrant)
|
||||
|
||||
UML Diagram
|
||||
-----------
|
||||
|
||||
.. image:: uml/uml.png
|
||||
:alt: Alt Command UML Diagram
|
||||
:align: center
|
||||
|
||||
Code
|
||||
----
|
||||
|
||||
You can also find these code on `GitHub`_
|
||||
|
||||
HelloCommand.php
|
||||
|
||||
.. literalinclude:: HelloCommand.php
|
||||
:language: php
|
||||
:linenos:
|
||||
|
||||
Receiver.php
|
||||
|
||||
.. literalinclude:: Receiver.php
|
||||
:language: php
|
||||
:linenos:
|
||||
|
||||
CommandInterface.php
|
||||
|
||||
.. literalinclude:: CommandInterface.php
|
||||
:language: php
|
||||
:linenos:
|
||||
|
||||
Invoker.php
|
||||
|
||||
.. literalinclude:: Invoker.php
|
||||
:language: php
|
||||
:linenos:
|
||||
|
||||
Test
|
||||
----
|
||||
|
||||
Tests/CommandTest.php
|
||||
|
||||
.. literalinclude:: Tests/CommandTest.php
|
||||
:language: php
|
||||
:linenos:
|
||||
|
||||
.. _`GitHub`: https://github.com/domnikl/DesignPatternsPHP/tree/master/Behavioral/Command
|
||||
.. _`Command`: http://en.wikipedia.org/wiki/Command_pattern
|
Reference in New Issue
Block a user