<?php
require_once __DIR__ . '/vendor/autoload.php';

use SimpleFactory\Test as SimpleFactoryTest;
use FactoryMethod\Test as FactoryMethodTest;
use AbstractFactory\Test as AbstractFactoryTest;
use Builder\Test as BuilderTest;
use Prototype\Test as PrototypeTest;
use Singleton\Test as SingletonTest;
use Adapter\Test as AdapterTest;
use Bridge\Test as BridgeTest;
use Composite\Test as CompositeTest;
use Decorator\Test as DecoratorTest;
use Facade\Test as FacadeTest;
use Flyweight\Test as FlyweightTest;
use Proxy\Test as ProxyTest;
use ChainOfResponsibilities\Test as ChainOfResponsibilitiesTest;
use Command\Test as CommandTest;
use Interpreter\Test as InterpreterTest;
use Iterator\Test as IteratorTest;
use Mediator\Test as MediatorTest;
use Memento\Test as MementoTest;
use Observer\Test as ObserverTest;
use Visitor\Test as VisitorTest;
use Strategy\Test as StrategyTest;
use State\Test as StateTest;
use TemplateMethod\Test as TemplateMethodTest;

//-------------创建型设计模式-------------


/*
 * @title 简单工厂模式（Simple Factory）
 * @description 当创建一个对象不仅仅是一些分配而且涉及一些逻辑时，将它放在专用工厂中而不是在任何地方重复相同的代码是有意义的。
 */
(new SimpleFactoryTest())->test();


/*
 * @title 工厂方法模式（Factory Method）
 * @description 定义一个用于创建对象的接口，让子类决定实例化哪一个类。Factory Method 使一个类的实例化延迟到其子类。
 * @content 适用性：
 *      当一个类不知道它所必须创建的对象的类的时候。√
 *      当一个类希望由它的子类来指定它所创建的对象的时候。
 *      当类将创建对象的职责委托给多个帮助子类中的某一个，并且你希望将哪一个帮助子类是代理者这一信息局部化的时候。
 */
(new FactoryMethodTest())->test();


/*
 * @title 抽象工厂模式（Abstract Factory）
 * @description 当存在相互关联的依赖关系时，涉及非简单的创建逻辑
 *              提供一个创建一系列相关或相互依赖对象的接口，而无需指定它们具体的类。
 * @content 适用性：
 *      一个系统要独立于它的产品的创建、组合和表示时。
 *      一个系统要由多个产品系列中的一个来配置时。
 *      当你要强调一系列相关的产品对象的设计以便进行联合使用时。√
 *      当你提供一个产品类库，而只想显示它们的接口而不是实现时。
 */
(new AbstractFactoryTest())->test();


/*
 * @title 构建器模式（Builder）
 * @description 当可能存在几种类型的对象并避免构造函数伸缩时。与工厂模式的主要区别在于：当创建是一步过程时，将使用工厂模式，而当创建是多步骤过程时，将使用构建器模式。
 * @content 适用性：
 *      当创建复杂对象的算法应该独立于该对象的组成部分以及它们的装配方式时。
 *      当构造过程必须允许被构造的对象有不同的表示时。
 */
(new BuilderTest())->test();


/*
 * @title 原型模式（Prototype）
 * @description 当需要一个与现有对象类似的对象时，或者与克隆相比，创建的成本会很高。
 * @content 适用性：
 *      当要实例化的类是在运行时刻指定时，例如:
 *          通过动态装载；
 *          或者为了避免创建一个与产品类层次平行的工厂类层次时；
 *          或者当一个类的实例只能有几个不同状态组合中的一种时。
 *      建立相应数目的原型并克隆它们可能比每次用合适的状态手工实例化该类更方便一些。 √
 */
(new PrototypeTest())->test();


/*
 * @title 单例模式（Singleton）
 * @description 确保只创建特定类的一个对象。单例模式实际上被认为是反模式，应该避免过度使用它。它不一定是坏的，可能有一些有效的用例，但应谨慎使用，因为它在您的应用程序中引入了一个全局状态，并且在一个地方更改它可能会影响其他区域，并且它可能变得非常难以调试。关于它们的另一个坏处是它使你的代码紧密耦合加上嘲弄单例可能很困难。
 * @content 适用性：
 *      当类只能有一个实例而且客户可以从一个众所周知的访问点访问它时。√
 *      当这个唯一实例应该是通过子类化可扩展的，并且客户应该无需更改代码就能使用一个扩展的实例时。
 */
(new SingletonTest())->test();


//-------------结构型设计模式-------------


/*
 * @title 适配器模式（Adapter）
 * @description 适配器模式允许您在适配器中包装其他不兼容的对象，以使其与另一个类兼容。
 * @content 适用性：
 *      你想使用一个已经存在的类，而它的接口不符合你的需求。
 *      你想创建一个可以复用的类，该类可以与其他不相关的类或不可预见的类（即那些接口可能不一定兼容的类）协同工作。
 *      （仅适用于对象Adapter ）你想使用一些已经存在的子类，但是不可能对每一个都进行子类化以匹配它们的接口。对象适配器可以适配它的父类接口。√
 */
(new AdapterTest())->test();


/*
 * @title 桥梁模式（Bridge）
 * @description 桥接模式是软件工程中使用的设计模式，旨在“将抽象与其实现分离，以便两者可以独立变化”
 * @content 适用性：
 *      你不希望在抽象和它的实现部分之间有一个固定的绑定关系。例如这种情况可能是因为，在程序运行时刻实现部分应可以被选择或者切换。√
 *      类的抽象以及它的实现都应该可以通过生成子类的方法加以扩充。这时Bridge模式使你可以对不同的抽象接口和实现部分进行组合，并分别对它们进行扩充。√
 *      对一个抽象的实现部分的修改应对客户不产生影响，即客户的代码不必重新编译。
 *      你想对客户完全隐藏抽象的实现部分。类的表示在类接口中是可见的。
 *      有许多类要生成。这样一种类层次结构说明你必须将一个对象分解成两个部分。Rumbaugh称这种类层次结构为“嵌套的普化”（nested generalizations）。
 *      你想在多个对象间共享实现（可能使用引用计数），但同时要求客户并不知道这一点。
 */
(new BridgeTest())->test();


/*
 * @title 组合模式（Composite）
 * @description 复合模式允许客户以统一的方式处理单个对象。
 * @content 适用性：
 *      你想表示对象的部分-整体层次结构。
 *      你希望用户忽略组合对象与单个对象的不同，用户将统一地使用组合结构中的所有对象。√
 */
(new CompositeTest())->test();


/*
 * @title 装饰模式（Decorator）
 * @description 装饰模式允许您通过将对象包装在装饰器类的对象中来动态更改对象在运行时的行为。
 * @content 适用性：
 *      在不影响其他对象的情况下，以动态、透明的方式给单个对象添加职责。√
 *      处理那些可以撤消的职责。
 *      当不能采用生成子类的方法进行扩充时。一种情况是，可能有大量独立的扩展，为支持每一种组合将产生大量的子类，使得子类数目呈爆炸性增长。另一种情况可能是因为类定义被隐藏，或类定义不能用于生成子类。
 */
(new DecoratorTest())->test();


/*
 * @title 门面模式（Facade）
 * @description 门面模式为复杂的子系统提供了简化的界面。
 * @content 适用性：
 *      当你要为一个复杂子系统提供一个简单接口时。子系统往往因为不断演化而变得越来越复杂。大多数模式使用时都会产生更多更小的类。这使得子系统更具可重用性，也更容易对子系统进行定制，但这也给那些不需要定制子系统的用户带来一些使用上的困难。Facade可以提供一个简单的缺省视图，这一视图对大多数用户来说已经足够，而那些需要更多的可定制性的用户可以越过facade层。√
 *      客户程序与抽象类的实现部分之间存在着很大的依赖性。引入facade将这个子系统与客户以及其他的子系统分离，可以提高子系统的独立性和可移植性。
 *      当你需要构建一个层次结构的子系统时，使用facade模式定义子系统中每层的入口点。如果子系统之间是相互依赖的，你可以让它们仅通过facade进行通讯，从而简化了它们之间的依赖关系。
 */
(new FacadeTest())->test();


/*
 * @title 享元模式（Flyweight）
 * @description 享元模式是一个通过与其他类似对象共享尽可能多的数据来最小化内存使用的对象; 当简单的重复表示将使用不可接受的内存量时，它是一种大量使用对象的方法。
 * @content 适用性：
 *      一个应用程序使用了大量的对象。√
 *      完全由于使用大量的对象，造成很大的存储开销。√
 *      对象的大多数状态都可变为外部状态。
 *      如果删除对象的外部状态，那么可以用相对较少的共享对象取代很多组对象。√
 *      应用程序不依赖于对象标识。由于Flyweight对象可以被共享，对于概念上明显有别的对象，标识测试将返回真值。
 */
(new FlyweightTest())->test();


/*
 * @title 代理模式（Proxy）
 * @description 代理以其最一般的形式，是一个充当其他东西的接口的类。代理是一个包装器或代理对象，客户端正在调用它来访问幕后的真实服务对象。使用代理可以简单地转发到真实对象，或者可以提供额外的逻辑。在代理中，可以提供额外的功能，例如当对真实对象的操作是资源密集时的高速缓存，或者在调用对象的操作之前检查先决条件。
 * @content 适用性：
 *          在需要用比较通用和复杂的对象指针代替简单的指针的时候，使用Proxy模式。下面是一些可以使用Proxy模式常见情况：
 *          1) 远程代理（Remote Proxy）为一个对象在不同的地址空间提供局部代表。
 *          2) 虚代理（Virtual Proxy）根据需要创建开销很大的对象。
 *          3) 保护代理（Protection Proxy）控制对原始对象的访问。保护代理用于对象应该有不同的访问权限的时候。√
 *          4) 智能指引（Smart Reference）取代了简单的指针，它在访问对象时执行一些附加操作。 它的典型用途包括：
 *                  对指向实际对象的引用计数，这样当该对象没有引用时，可以自动释放它。
 *                  当第一次引用一个持久对象时，将它装入内存。
 *                  在访问一个实际对象前，检查是否已经锁定了它，以确保其他对象不能改变它。
 */
(new ProxyTest())->test();


//-------------行为型设计模式-------------


/*
 * @title 责任链模式（Chain Of Responsibilities）
 * @description 有助于构建一系列对象。请求从一端进入并继续从一个对象到另一个对象，直到找到合适的处理程序。
 *              使多个对象都有机会处理请求，从而避免请求的发送者和接收者之间的耦合关系。将这些对象连成一条链，并沿着这条链传递该请求，直到有一个对象处理它为止。
 * @content 适用性：
 *      有多个的对象可以处理一个请求，哪个对象处理该请求运行时刻自动确定。√
 *      你想在不明确指定接收者的情况下，向多个对象中的一个提交一个请求。
 *      可处理一个请求的对象集合应被动态指定。√
 */
(new ChainOfResponsibilitiesTest())->test();


/*
 * @title 命令行模式（Command）
 * @description 允许您将操作封装在对象中。这种模式背后的关键思想是提供将客户端与接收器分离的方法。
 * @content 适用性：
 *      抽象出待执行的动作以参数化某对象，你可用过程语言中的回调（callback）函数表达这种参数化机制。所谓回调函数是指函数先在某处注册，而它将在稍后某个需要的时候被调用。Command模式是回调机制的一个面向对象的替代品。√访问一个聚合对象的内容而无需暴露它的内部表示。 √
 *      在不同的时刻指定、排列和执行请求。一个Command对象可以有一个与初始请求无关的生存期。如果一个请求的接收者可用一种与地址空间无关的方式表达，那么就可将负责该请求的命令对象传送给另一个不同的进程并在那儿实现该请求。支持对聚合对象的多种遍历。√
 *      支持取消操作。Command的Excute操作可在实施操作前将状态存储起来，在取消操作时这个状态用来消除该操作的影响。Command接口必须添加一个Unexecute操作，该操作取消上一次Execute调用的效果。执行的命令被存储在一个历史列表中。可通过向后和向前遍历这一列表并分别调用Unexecute和Execute来实现重数不限的“取消”和“重做”。√为遍历不同的聚合结构提供一个统一的接口(即, 支持多态迭代)。√
 *      支持修改日志，这样当系统崩溃时，这些修改可以被重做一遍。在Command接口中添加装载操作和存储操作，可以用来保持变动的一个一致的修改日志。从崩溃中恢复的过程包括从磁盘中重新读入记录下来的命令并用Execute操作重新执行它们。
 *      用构建在原语操作上的高层操作构造一个系统。这样一种结构在支持事务(transaction)的信息系统中很常见。一个事务封装了对数据的一组变动。Command模式提供了对事务进行建模的方法。Command有一个公共的接口，使得你可以用同一种方式调用所有的事务。同时使用该模式也易于添加新事务以扩展系统。√
 */
(new CommandTest())->test();


/*
 * @title 解释器模式（Interpreter）
 * @description 给定一个语言, 定义它的文法的一种表示，并定义一个解释器，该解释器使用该表示来解释语言中的句子。
 * @content 适用性：
 *      当有一个语言需要解释执行, 并且你可将该语言中的句子表示为一个抽象语法树时，可使用解释器模式。而当存在以下情况时该模式效果最好：
 *      该文法简单对于复杂的文法, 文法的类层次变得庞大而无法管理。此时语法分析程序生成器这样的工具是更好的选择。它们无需构建抽象语法树即可解释表达式, 这样可以节省空间而且还可能节省时间。
 *      效率不是一个关键问题最高效的解释器通常不是通过直接解释语法分析树实现的, 而是首先将它们转换成另一种形式。例如，正则表达式通常被转换成状态机。但即使在这种情况下, 转换器仍可用解释器模式实现, 该模式仍是有用的。
 */
(new InterpreterTest())->test();


/*
 * @title 迭代器模式（Iteratobr）
 * @description 在面向对象的编程中，迭代器模式是一种设计模式，其中迭代器用于遍历容器并访问容器的元素。迭代器模式将算法与容器分离; 在某些情况下，算法必然是特定于容器的，因此不能解耦。
 * @content 适用性：
 *      访问一个聚合对象的内容而无需暴露它的内部表示。 √
 *      支持对聚合对象的多种遍历。√
 *      为遍历不同的聚合结构提供一个统一的接口(即, 支持多态迭代)。√
 */
(new IteratorTest())->test();


/*
 * @title 中介者模式（Mediator）
 * @description Mediator 模式添加第三方对象（称为 mediator）来控制两个对象（称为同事）之间的交互。它有助于减少彼此通信的类之间的耦合。因为现在他们不需要了解彼此的实施。
 * @content 适用性：
 *      一组对象以定义良好但是复杂的方式进行通信。产生的相互依赖关系结构混乱且难以理解。√
 *      一个对象引用其他很多对象并且直接与这些对象通信,导致难以复用该对象。
 *      想定制一个分布在多个类中的行为，而又不想生成太多的子类。
 */
(new MediatorTest())->test();


/*
 * @title 备忘录模式（Memento）
 * @description 在不破坏封装性的前提下，捕获一个对象的内部状态，并在该对象之外保存这个状态。这样以后就可将该对象恢复到原先保存的状态。
 * @content 适用性：
 *      必须保存一个对象在某一个时刻的(部分)状态, 这样以后需要时它才能恢复到先前的状态。√
 *      如果一个用接口来让其它对象直接得到这些状态，将会暴露对象的实现细节并破坏对象的封装性。√
 */
(new MementoTest())->test();


/*
 * @title 观察者模式（Observer）
 * @description 观察者模式是一种软件设计模式，其中一个称为主体的对象维护其依赖者列表，称为观察者，并通常通过调用其中一种方法自动通知它们任何状态变化。
 *              定义对象间的一种一对多的依赖关系,当一个对象的状态发生改变时, 所有依赖于它的对象都得到通知并被自动更新。
 * @content 适用性：
 *      当一个抽象模型有两个方面, 其中一个方面依赖于另一方面。将这二者封装在独立的对象中以使它们可以各自独立地改变和复用。
 *      当对一个对象的改变需要同时改变其它对象, 而不知道具体有多少对象有待改变。√
 *      当一个对象必须通知其它对象，而它又不能假定其它对象是谁。换言之, 你不希望这些对象是紧密耦合的。√
 */
(new ObserverTest())->test();


/*
 * @title 访问者模式（Visitor）
 * @description 访客模式允许您向对象添加更多操作，而无需修改它们。
 *              表示一个作用于某对象结构中的各元素的操作。它使你可以在不改变各元素的类的前提下定义作用于这些元素的新操作。
 * @content 适用性：
 *      一个对象结构包含很多类对象，它们有不同的接口，而你想对这些对象实施一些依赖于其具体类的操作。
 *      需要对一个对象结构中的对象进行很多不同的并且不相关的操作，而你想避免让这些操作“污染”这些对象的类。Vi s i t o r 使得你可以将相关的操作集中起来定义在一个类中。当该对象结构被很多应用共享时，用Vi s i t o r 模式让每个应用仅包含需要用到的操作。
 *      定义对象结构的类很少改变，但经常需要在此结构上定义新的操作。改变对象结构类需要重定义对所有访问者的接口，这可能需要很大的代价。如果对象结构类经常改变，那么可能还是在这些类中定义这些操作较好。
 */
(new VisitorTest())->test();


/*
 * @title 策略模式（Strategy）
 * @description 策略模式允许您根据情况切换算法或策略。
 * @content 适用性：
 *      许多相关的类仅仅是行为有异。“策略”提供了一种用多个行为中的一个行为来配置一个类的方法。
 *      需要使用一个算法的不同变体。例如，你可能会定义一些反映不同的空间/时间权衡的算法。当这些变体实现为一个算法的类层次时,可以使用策略模式。√
 *      算法使用客户不应该知道的数据。可使用策略模式以避免暴露复杂的、与算法相关的数据结构。
 *      一个类定义了多种行为, 并且这些行为在这个类的操作中以多个条件语句的形式出现。将相关的条件分支移入它们各自的Strategy类中以代替这些条件语句。√
 */
(new StrategyTest())->test();


/*
 * @title 状态模式（State）
 * @description 状态模式是一种行为软件设计模式，它以面向对象的方式实现状态机。使用状态模式，通过将每个单独的状态实现为状态模式接口的派生类来实现状态机，并通过调用由模式的超类定义的方法来实现状态转换。状态模式可以解释为一种策略模式，它能够通过调用模式接口中定义的方法来切换当前策略。
 * @content 适用性：
 *      一个对象的行为取决于它的状态, 并且它必须在运行时刻根据状态改变它的行为。√
 *      一个操作中含有庞大的多分支的条件语句，且这些分支依赖于该对象的状态。这个状态通常用一个或多个枚举常量表示。通常, 有多个操作包含这一相同的条件结构。State模式将每一个条件分支放入一个独立的类中。这使得你可以根据对象自身的情况将对象的状态作为一个对象，这一对象可以不依赖于其他对象而独立变化。√
 */
(new StateTest())->test();


/*
 * @title 模板方法模式（Template Method）
 * @description 在软件工程中，模板方法模式是一种行为设计模式，它定义了操作中算法的程序框架，将一些步骤推迟到子类。它允许重新定义算法的某些步骤而不改变算法的结构。
 * @content 适用性：
 *      一次性实现一个算法的不变的部分，并将可变的行为留给子类来实现。√
 *      各子类中公共的行为应被提取出来并集中到一个公共父类中以避免代码重复。首先识别现有代码中的不同之处，并且将不同之处分离为新的操作。最后，用一个调用这些新的操作的模板方法来替换这些不同的代码。√
 *      控制子类扩展。模板方法只在特定点调用“hook”操作，这样就只允许在这些点进行扩展。
 */
(new TemplateMethodTest())->test();