feat(Chain Of Responsibilities): code & test & readme

Author: roiwk

Behavioral/ChainOfResponsibilities/Handler.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Behavioral\ChainOfResponsibilities;
+
+use Psr\Http\Message\RequestInterface;
+
+abstract class Handler
+{
+    /**
+     * @var Handler
+     */
+    private $successor = null;
+
+    public function __construct(Handler $handler = null)
+    {
+        $this->successor = $handler;
+    }
+
+    /**
+     * 确保了每个子类都不会忘记调用后续处理
+     */
+    final public function handle(RequestInterface $request): ?string
+    {
+        $processed = $this->processing($request);
+
+        if ($processed === null && $this->successor !== null) {
+            $processed = $this->successor->handle($request);
+        }
+
+        return $processed;
+    }
+
+    abstract protected function processing(RequestInterface $request): ?string;
+}

Behavioral/ChainOfResponsibilities/HttpInMemoryCacheHandler.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace Behavioral\ChainOfResponsibilities;
+
+use Psr\Http\Message\RequestInterface;
+
+class HttpInMemoryCacheHandler extends Handler
+{
+    /**
+     * @var array
+     */
+    private $data;
+
+    public function __construct(array $data, ?Handler $successor = null)
+    {
+        parent::__construct($successor);
+
+        $this->data = $data;
+    }
+
+    protected function processing(RequestInterface $request): ?string
+    {
+        $key = sprintf(
+            '%s?%s',
+            $request->getUri()->getPath(),
+            $request->getUri()->getQuery()
+        );
+
+        if ($request->getMethod() == 'GET' && isset($this->data[$key])) {
+            return $this->data[$key];
+        }
+
+        return null;
+    }
+}

Behavioral/ChainOfResponsibilities/SlowDatabaseHandler.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace Behavioral\ChainOfResponsibilities;
+
+use Psr\Http\Message\RequestInterface;
+
+class SlowDatabaseHandler extends Handler
+{
+    protected function processing(RequestInterface $request): ?string
+    {
+        // 模拟数据返回, 生产状态下是查询数据库的结果.
+        return 'Hello World!';
+    }
+}

Behavioral/ChainOfResponsibilities/Tests/ChainTest.php

@@ -0,0 +1,54 @@
+<?php
+
+namespace Behavioral\ChainOfResponsibilities\Tests;
+
+use PHPUnit\Framework\TestCase;
+use Psr\Http\Message\RequestInterface;
+use Psr\Http\Message\UriInterface;
+use Behavioral\ChainOfResponsibilities\Handler;
+use Behavioral\ChainOfResponsibilities\HttpInMemoryCacheHandler;
+use Behavioral\ChainOfResponsibilities\SlowDatabaseHandler;
+
+class ChainTest extends TestCase
+{
+    /**
+     * @var Handler
+     */
+    private $chain;
+
+    protected function setUp(): void
+    {
+        $this->chain = new HttpInMemoryCacheHandler(
+            ['/test?a=1' => 'Hello In Memory!'],
+            new SlowDatabaseHandler()
+        );
+    }
+
+    public function testCanRequestKeyInFastStorage()
+    {
+        $uri = $this->createMock(UriInterface::class);
+        $uri->method('getPath')->willReturn('/test');
+        $uri->method('getQuery')->willReturn('a=1');
+
+        $request = $this->createMock(RequestInterface::class);
+        $request->method('getMethod')
+            ->willReturn('GET');
+        $request->method('getUri')->willReturn($uri);
+
+        $this->assertSame('Hello In Memory!', $this->chain->handle($request));
+    }
+
+    public function testCanRequestKeyInSlowStorage()
+    {
+        $uri = $this->createMock(UriInterface::class);
+        $uri->method('getPath')->willReturn('/foo');
+        $uri->method('getQuery')->willReturn('');
+
+        $request = $this->createMock(RequestInterface::class);
+        $request->method('getMethod')
+            ->willReturn('GET');
+        $request->method('getUri')->willReturn($uri);
+
+        $this->assertSame('Hello World!', $this->chain->handle($request));
+    }
+}

Behavioral/README.md

@@ -0,0 +1,31 @@
+# 行为型模式
+
+这些设计模式特别关注**对象之间的通信**。
+增加了执行通信的灵活性。
+
+## 责任链模式
+
+* 简介
+
+为请求创建了一个接收者对象的链。
+通常每个接收者都包含对另一个接收者的引用。如果一个对象不能处理该请求，那么它会把相同的请求传给下一个接收者，依此类推。
+
+* 优点：
+    1. 降低耦合度。它将请求的发送者和接收者解耦。
+    2. 简化了对象。使得对象不需要知道链的结构。
+    3. 增强给对象指派职责的灵活性。通过改变链内的成员或者调动它们的次序，允许动态地新增或者删除责任。
+    4. 增加新的请求处理类很方便。
+
+* 缺点：
+    1. 不能保证请求一定被接收。
+    2. 系统性能将受到一定影响，而且在进行代码调试时不太方便，可能会造成循环调用。
+    3. 可能不容易观察运行时的特征，有碍于除错。
+
+* 使用场景：
+    1. 有多个对象可以处理同一个请求，具体哪个对象处理该请求由运行时刻自动确定。
+    2. 在不明确指定接收者的情况下，向多个对象中的一个提交一个请求。
+    3. 可动态指定一组对象处理请求。
+
+* 示例
+
+> 场景：请求接口数据, 缓存上未找到, 委托给数据库查询接口。

README.md

@@ -26,9 +26,9 @@
 - [x] 数据映射
 - [x] 依赖注入
 
-## 行为型
+## 行为型(./Behavioral/README.md)
 
-- [ ] 责任链模式
+- [x] 责任链模式
 - [ ] 命令模式
 - [ ] 解释器模式
 - [ ] 迭代器模式

composer.json

@@ -10,7 +10,8 @@
     ],
     "minimum-stability": "stable",
     "require": {
-        "php": ">=7"
+        "php": ">=7.2",
+        "psr/http-message": "^1.0"
     },
     "require-dev": {
         "phpunit/phpunit": "^8"