PHP 设计模式系列之 specification规格模式

《PHP 设计模式系列之 Specification 规格模式》是一种常用的设计模式，可以帮助我们更好地组织代码和实现业务逻辑。接下来将详细讲解 Specification 规格模式的完整攻略，包括定义、特征、实现、优缺点等方面。

定义

规格模式是一种软件设计模式，它可以用来描述一个对象是否符合某种特定的规格。规格通常由一组条件或操作符组成，被用于查询、过滤或验证一个目标对象。

特征

定义一组规格，表示对象的属性或行为；
将规格组合起来，形成更复杂的规格；
利用规格来对数据进行验证、过滤或查询。

实现

实现规格模式需要定义两个类：

Specification 规格接口

定义规格的接口，通常包括一个 isSatisfiedBy 方法，用于判断一个指定对象是否符合规格。

interface Specification
{
    public function isSatisfiedBy($object): bool;
}

CompositeSpecification 合成规格类

实现 Specification 接口，用于提供规格组合的方法，如 AND、OR 和 NOT 等。其中，andSpecification 和 orSpecification 方法可以用于实现规格与和规格或的组合，notSpecification 方法可以用于对规格的求反。

abstract class CompositeSpecification implements Specification
{
    public function andSpecification(Specification $specification): Specification
    {
        return new AndSpecification($this, $specification);
    }

    public function orSpecification(Specification $specification): Specification
    {
        return new OrSpecification($this, $specification);
    }

    public function notSpecification(): Specification
    {
        return new NotSpecification($this);
    }
}

具体规格类

实现 Specification 接口，用于对对象的属性或行为进行判断，返回true或false。

示例1：判断一个字符串是否包含指定的关键字。

class KeywordSpecification extends CompositeSpecification
{
    private $keyword;

    public function __construct(string $keyword)
    {
        $this->keyword = $keyword;
    }

    public function isSatisfiedBy($object): bool
    {
        if (!$object instanceof String) {
            throw new InvalidArgumentException('Invalid argument type');
        }

        return strpos($object, $this->keyword) !== false;
    }
}

示例2：判断一个数值是否在指定的范围内。

class RangeSpecification extends CompositeSpecification
{
    private $min;
    private $max;

    public function __construct(int $min, int $max)
    {
        $this->min = $min;
        $this->max = $max;
    }

    public function isSatisfiedBy($object): bool
    {
        if (!is_numeric($object)) {
            throw new InvalidArgumentException('Invalid argument type');
        }

        return $object >= $this->min && $object <= $this->max;
    }
}

实际使用

$user = new User('John', 25);

// 判断用户是否符合规格
$specification = new AndSpecification(new KeywordSpecification('Jo'), new RangeSpecification(18, 30));
if ($specification->isSatisfiedBy($user)) {
    echo 'User is satisfied by specification';
} else {
    echo 'User is not satisfied by specification';
}