From 714baffaf7b39d945671c037ab9e8831825e0e6c Mon Sep 17 00:00:00 2001 From: ctexthuang Date: Sun, 7 Sep 2025 19:36:04 +0800 Subject: [PATCH] feat : Composite file --- app/Controller/Test/CompositeController.php | 24 +++++ .../FileSystemComponentInterface.php | 25 ++++++ .../Composite/File/DirectoryComponent.php | 89 +++++++++++++++++++ .../Test/Composite/File/FileComponent.php | 65 ++++++++++++++ app/Service/Test/Composite/FileService.php | 40 +++++++++ composer.json | 2 +- composer.lock | 2 +- config/autoload/devtool.php | 9 ++ document/composite.md | 43 +++++++++ request/test.http | 5 ++ 10 files changed, 302 insertions(+), 2 deletions(-) create mode 100644 app/Controller/Test/CompositeController.php create mode 100644 app/Interface/Test/Composite/FileSystemComponentInterface.php create mode 100644 app/Service/Test/Composite/File/DirectoryComponent.php create mode 100644 app/Service/Test/Composite/File/FileComponent.php create mode 100644 app/Service/Test/Composite/FileService.php create mode 100644 document/composite.md diff --git a/app/Controller/Test/CompositeController.php b/app/Controller/Test/CompositeController.php new file mode 100644 index 0000000..6a73851 --- /dev/null +++ b/app/Controller/Test/CompositeController.php @@ -0,0 +1,24 @@ +handle(); + } +} diff --git a/app/Interface/Test/Composite/FileSystemComponentInterface.php b/app/Interface/Test/Composite/FileSystemComponentInterface.php new file mode 100644 index 0000000..eac583f --- /dev/null +++ b/app/Interface/Test/Composite/FileSystemComponentInterface.php @@ -0,0 +1,25 @@ +name = $name; + } + + /** + * @return string + */ + public function getName(): string + { + return $this->name; + } + + /** + * @return int + */ + public function getSize(): int + { + $size = 0; + foreach ($this->children as $child) { + $size += $child->getSize(); + } + return $size; + } + + /** + * @param string $prefix + * @return void + */ + public function display(string $prefix = ''): void + { + echo $prefix . ":directory:" . $this->name . '(' . $this->getSize() . 'bytes)' . PHP_EOL; + + foreach ($this->children as $child) { + $child->display($prefix ,' '); + } + } + + /** + * @param FileSystemComponentInterface $component + * @return void + */ + public function add(FileSystemComponentInterface $component): void + { + $this->children[] = $component; + } + + /** + * @param FileSystemComponentInterface $component + * @return void + */ + public function remove(FileSystemComponentInterface $component): void + { + $this->children = array_filter($this->children, function ($c) use ($component) { + return $c !== $component; + }); + } +} \ No newline at end of file diff --git a/app/Service/Test/Composite/File/FileComponent.php b/app/Service/Test/Composite/File/FileComponent.php new file mode 100644 index 0000000..91f9670 --- /dev/null +++ b/app/Service/Test/Composite/File/FileComponent.php @@ -0,0 +1,65 @@ +name = $name; + $this->size = $size; + } + + /** + * @return string + */ + public function getName(): string + { + return $this->name; + } + + /** + * @return int + */ + public function getSize(): int + { + return $this->size; + } + + /** + * @param string $prefix + * @return void + */ + public function display(string $prefix = ''): void + { + echo $prefix . ":file:" . $this->name . '(' . $this->size . 'bytes)' . PHP_EOL; + } +} \ No newline at end of file diff --git a/app/Service/Test/Composite/FileService.php b/app/Service/Test/Composite/FileService.php new file mode 100644 index 0000000..31e36c2 --- /dev/null +++ b/app/Service/Test/Composite/FileService.php @@ -0,0 +1,40 @@ +add($documents); + $root->add($images); + $documents->add($file1); + $documents->add($file2); + $images->add($file3); + $root->display(); + + return $this->return->success(); + } +} \ No newline at end of file diff --git a/composer.json b/composer.json index ae691b4..25723f4 100644 --- a/composer.json +++ b/composer.json @@ -36,7 +36,7 @@ }, "require-dev": { "friendsofphp/php-cs-fixer": "^3.0", - "hyperf/devtool": "~3.1.0", + "hyperf/devtool": "^3.1", "hyperf/testing": "~3.1.0", "mockery/mockery": "^1.0", "phpstan/phpstan": "^1.0", diff --git a/composer.lock b/composer.lock index e598543..9055e83 100644 --- a/composer.lock +++ b/composer.lock @@ -4,7 +4,7 @@ "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies", "This file is @generated automatically" ], - "content-hash": "03d201d24ea04aa8cfada8967ab9b056", + "content-hash": "1eb424bacaafd82bad0495cac0fff0de", "packages": [ { "name": "carbonphp/carbon-doctrine-types", diff --git a/config/autoload/devtool.php b/config/autoload/devtool.php index 3c2f607..1b8f9ad 100644 --- a/config/autoload/devtool.php +++ b/config/autoload/devtool.php @@ -9,6 +9,9 @@ declare(strict_types=1); * @contact group@hyperf.io * @license https://github.com/hyperf/hyperf/blob/master/LICENSE */ + +use function Hyperf\Support\env; + return [ 'generator' => [ 'amqp' => [ @@ -41,4 +44,10 @@ return [ 'namespace' => 'App\\Processes', ], ], + /** + * Supported IDEs: "sublime", "textmate", "cursor", "emacs", "macvim", "phpstorm", "idea", + * "vscode", "vscode-insiders", "vscode-remote", "vscode-insiders-remote", + * "atom", "nova", "netbeans", "xdebug" + */ + 'ide' => env('DEVTOOL_IDE', ''), ]; diff --git a/document/composite.md b/document/composite.md new file mode 100644 index 0000000..561b0a1 --- /dev/null +++ b/document/composite.md @@ -0,0 +1,43 @@ + + +### 组合模式 (Composite Pattern) 详解 + +> 组合模式是一种结构型设计模式，它允许你将对象组合成树形结构来表示"部分-整体"的层次结构。组合模式使得用户对单个对象和组合对象的使用具有一致性。 + +#### 核心概念 +组合模式包含以下几个关键组件： + +#### 结构 +- Component(抽象构件): 定义组合中所有对象的通用接口，可以是抽象类或接口 +- Leaf(叶子构件): 表示组合中的叶子节点对象，没有子节点 +- Composite(容器构件): 定义有子部件的部件行为，存储子部件，并在Component接口中实现与子部件相关的操作 + +#### 应用场景 + +组合模式适用于以下情况： + +- 需要表示对象的"部分-整体"层次结构 +- 希望用户忽略组合对象与单个对象的不同，统一地使用组合结构中的所有对象 +- 处理树形结构数据 + +#### 优缺点 + +##### 优点 +- 简化客户端代码：客户端可以一致地处理单个对象和组合对象 +- 易于新增组件类型：新增组件类型时不需要修改现有代码，符合开闭原则 +- 灵活的结构：可以创建复杂的树形结构，且结构可以动态变化 + +##### 缺点 +- 设计复杂：需要正确区分叶子节点和树枝节点，增加了系统的复杂性 +- 类型检查：有时需要在运行时检查对象的类型，增加了运行时的开销 + +##### 实际应用 + +组合模式在以下场景中常见： + +- 文件系统(文件和文件夹) +- GUI组件(窗口包含面板，面板包含按钮等) +- 组织结构(公司包含部门，部门包含员工) +- 菜单系统(菜单包含子菜单和菜单项) + +组合模式通过树形结构组织对象，使得客户端可以统一处理简单元素和复杂元素，大大提高了系统的灵活性和可扩展性。 \ No newline at end of file diff --git a/request/test.http b/request/test.http index 6ffce18..efe9854 100644 --- a/request/test.http +++ b/request/test.http @@ -55,4 +55,9 @@ Content-Type: application/x-www-form-urlencoded ### Bridge pay test GET {{host}}/bridge/test/pay +Content-Type: application/x-www-form-urlencoded + + +### Composite pay test +GET {{host}}/composite/test/file Content-Type: application/x-www-form-urlencoded \ No newline at end of file