Tebru\Gson\Internal\Excluder

Complexity

Total Complexity

70

Size/Duplication

Total Lines	462
Duplicated Lines	0 %

Importance

Changes

0

25 Methods

Rating	Name	Duplication	Size	Complexity
A	excludePropertySerialize()	0	14	5
A	addExclusionStrategy()	0	16	5
A	excludeClassByDeserializationStrategy()	0	9	3
B	excludeByAnnotation()	0	22	7
A	setExcludedModifiers()	0	5	1
A	hasClassSerializationStrategies()	0	3	1
A	setRequireExpose()	0	5	1
A	setVersion()	0	5	1
A	shouldSkipUntil()	0	8	3
A	applyClassDeserializationExclusionData()	0	5	3
A	hasClassDeserializationStrategies()	0	3	1
A	hasPropertyDeserializationStrategies()	0	3	1
A	excludeClassSerialize()	0	9	4
A	excludeClassDeserialize()	0	9	4
A	hasPropertySerializationStrategies()	0	3	1
A	addCachedExclusionStrategy()	0	3	1
A	applyClassSerializationExclusionData()	0	5	3
A	applyPropertySerializationExclusionData()	0	5	3
A	validVersion()	0	3	2
A	applyPropertyDeserializationExclusionData()	0	5	3
A	excludePropertyByDeserializationStrategy()	0	9	3
A	excludeClassBySerializationStrategy()	0	9	3
A	excludePropertyBySerializationStrategy()	0	9	3
A	shouldSkipSince()	0	8	3
A	excludePropertyDeserialize()	0	14	5

<?php
/*
 * Copyright (c) Nate Brunette.
 * Distributed under the MIT License (http://opensource.org/licenses/MIT)
 */

declare(strict_types=1);

namespace Tebru\Gson\Internal;

use ReflectionProperty;
use Tebru\AnnotationReader\AnnotationCollection;
use Tebru\Gson\Annotation\Exclude;
use Tebru\Gson\Annotation\Expose;
use Tebru\Gson\Annotation\Since;
use Tebru\Gson\Annotation\Until;
use Tebru\Gson\ClassMetadata;
use Tebru\Gson\Exclusion\ClassDeserializationExclusionStrategy;
use Tebru\Gson\Exclusion\ClassSerializationExclusionStrategy;
use Tebru\Gson\Exclusion\DeserializationExclusionData;
use Tebru\Gson\Exclusion\DeserializationExclusionDataAware;
use Tebru\Gson\Exclusion\ExclusionStrategy;
use Tebru\Gson\Exclusion\PropertyDeserializationExclusionStrategy;
use Tebru\Gson\Exclusion\PropertySerializationExclusionStrategy;
use Tebru\Gson\Exclusion\SerializationExclusionData;
use Tebru\Gson\Exclusion\SerializationExclusionDataAware;
use Tebru\Gson\PropertyMetadata;

/**
 * Class Excluder
 *
 * @author Nate Brunette <n@tebru.net>
 */
final class Excluder
{
    /**
     * Version, if set, will be used with [@see Since] and [@see Until] annotations
     *
     * @var string
     */
    private $version;

    /**
     * Which modifiers are excluded
     *
     * By default only static properties are excluded
     *
     * @var int
     */
    private $excludedModifiers = ReflectionProperty::IS_STATIC;

    /**
     * If this is true, properties will need to explicitly have an [@see Expose] annotation
     * to be serialized or deserialized
     *
     * @var bool
     */
    private $requireExpose = false;

    /**
     * Class Exclusion strategies during serialization
     *
     * @var ClassSerializationExclusionStrategy[]
     */
    private $classSerializationStrategies = [];

    /**
     * Property Exclusion strategies during serialization
     *
     * @var PropertySerializationExclusionStrategy[]
     */
    private $propertySerializationStrategies = [];

    /**
     * Class Exclusion strategies during deserialization
     *
     * @var ClassDeserializationExclusionStrategy[]
     */
    private $classDeserializationStrategies = [];

    /**
     * Property Exclusion strategies during deserialization
     *
     * @var PropertyDeserializationExclusionStrategy[]
     */
    private $propertyDeserializationStrategies = [];

    /**
     * Exclusion strategies that can be cached
     *
     * @var ExclusionStrategy[]
     */
    private $cachedStrategies = [];


    /**
     * Set the version to test against
     *
     * @param string $version
     * @return Excluder
     */
    public function setVersion(?string $version): Excluder
    {
        $this->version = $version;

        return $this;
    }

    /**
     * Set an integer representing the property modifiers that should be excluded
     *
     * @param int $modifiers
     * @return Excluder
     */
    public function setExcludedModifiers(int $modifiers): Excluder
    {
        $this->excludedModifiers = $modifiers;

        return $this;
    }

    /**
     * Require the [@see Expose] annotation to serialize properties
     *
     * @param bool $requireExpose
     * @return Excluder
     */
    public function setRequireExpose(bool $requireExpose): Excluder
    {
        $this->requireExpose = $requireExpose;

        return $this;
    }

    /**
     * Add an exclusion strategy
     *
     * @param ExclusionStrategy $strategy
     * @return void
     */
    public function addExclusionStrategy(ExclusionStrategy $strategy): void
    {
        if ($strategy instanceof ClassSerializationExclusionStrategy) {
            $this->classSerializationStrategies[] = $strategy;
        }

        if ($strategy instanceof PropertySerializationExclusionStrategy) {
            $this->propertySerializationStrategies[] = $strategy;
        }

        if ($strategy instanceof ClassDeserializationExclusionStrategy) {
            $this->classDeserializationStrategies[] = $strategy;
        }

        if ($strategy instanceof PropertyDeserializationExclusionStrategy) {
            $this->propertyDeserializationStrategies[] = $strategy;
        }
    }

    /**
     * Add an exclusion strategy that can be cached
     *
     * @param ExclusionStrategy $strategy
     */
    public function addCachedExclusionStrategy(ExclusionStrategy $strategy): void
    {
        $this->cachedStrategies[] = $strategy;
    }

    /**
     * Compile time exclusion checking of classes to determine if we should exclude during serialization
     *
     * @param ClassMetadata $classMetadata
     * @return bool
     */
    public function excludeClassSerialize(ClassMetadata $classMetadata): bool
    {
        foreach ($this->cachedStrategies as $strategy) {
            if ($strategy instanceof ClassSerializationExclusionStrategy && $strategy->skipSerializingClass($classMetadata)) {
                return true;
            }
        }

        return $this->excludeByAnnotation($classMetadata->getAnnotations(), true);
    }

    /**
     * Compile time exclusion checking of classes to determine if we should exclude during deserialization
     *
     * @param ClassMetadata $classMetadata
     * @return bool
     */
    public function excludeClassDeserialize(ClassMetadata $classMetadata): bool
    {
        foreach ($this->cachedStrategies as $strategy) {
            if ($strategy instanceof ClassDeserializationExclusionStrategy && $strategy->skipDeserializingClass($classMetadata)) {
                return true;
            }
        }

        return $this->excludeByAnnotation($classMetadata->getAnnotations(), false);
    }

    /**
     * Add [@see SerializationExclusionData] to class exclusion strategies
     *
     * @param SerializationExclusionData $exclusionData
     */
    public function applyClassSerializationExclusionData(SerializationExclusionData $exclusionData): void
    {
        foreach ($this->classSerializationStrategies as $exclusionStrategy) {
            if ($exclusionStrategy instanceof SerializationExclusionDataAware) {
                $exclusionStrategy->setSerializationExclusionData($exclusionData);
            }
        }
    }

    /**
     * Add [@see SerializationExclusionData] to property exclusion strategies
     *
     * @param SerializationExclusionData $exclusionData
     */
    public function applyPropertySerializationExclusionData(SerializationExclusionData $exclusionData): void
    {
        foreach ($this->propertySerializationStrategies as $exclusionStrategy) {
            if ($exclusionStrategy instanceof SerializationExclusionDataAware) {
                $exclusionStrategy->setSerializationExclusionData($exclusionData);
            }
        }
    }

    /**
     * Add [@see SerializationExclusionData] to class deserialization strategies
     *
     * @param DeserializationExclusionData $exclusionData
     */
    public function applyClassDeserializationExclusionData(DeserializationExclusionData $exclusionData): void
    {
        foreach ($this->classDeserializationStrategies as $exclusionStrategy) {
            if ($exclusionStrategy instanceof DeserializationExclusionDataAware) {
                $exclusionStrategy->setDeserializationExclusionData($exclusionData);
            }
        }
    }

    /**
     * Add [@see SerializationExclusionData] to property deserialization strategies
     *
     * @param DeserializationExclusionData $exclusionData
     */
    public function applyPropertyDeserializationExclusionData(DeserializationExclusionData $exclusionData): void
    {
        foreach ($this->propertyDeserializationStrategies as $exclusionStrategy) {
            if ($exclusionStrategy instanceof DeserializationExclusionDataAware) {
                $exclusionStrategy->setDeserializationExclusionData($exclusionData);
            }
        }
    }

    /**
     * Runtime exclusion checking of classes by strategy during serialization
     *
     * Uses user-defined strategies
     *
     * @param ClassMetadata $classMetadata
     * @return bool
     */
    public function excludeClassBySerializationStrategy(ClassMetadata $classMetadata): bool
    {
        foreach ($this->classSerializationStrategies as $exclusionStrategy) {
            if ($exclusionStrategy->skipSerializingClass($classMetadata)) {
                return true;
            }
        }

        return false;
    }

    /**
     * Runtime exclusion checking of classes by strategy during deserialization
     *
     * Uses user-defined strategies
     *
     * @param ClassMetadata $classMetadata
     * @return bool
     */
    public function excludeClassByDeserializationStrategy(ClassMetadata $classMetadata): bool
    {
        foreach ($this->classDeserializationStrategies as $exclusionStrategy) {
            if ($exclusionStrategy->skipDeserializingClass($classMetadata)) {
                return true;
            }
        }

        return false;
    }

    /**
     * Compile time exclusion checking of properties
     *
     * @param PropertyMetadata $propertyMetadata
     * @return bool
     */
    public function excludePropertySerialize(PropertyMetadata $propertyMetadata): bool
    {
        // exclude the property if the property modifiers are found in the excluded modifiers
        if (0 !== ($this->excludedModifiers & $propertyMetadata->getModifiers())) {
            return true;
        }

        foreach ($this->cachedStrategies as $strategy) {
            if ($strategy instanceof PropertySerializationExclusionStrategy && $strategy->skipSerializingProperty($propertyMetadata)) {
                return true;
            }
        }

        return $this->excludeByAnnotation($propertyMetadata->getAnnotations(), true);
    }

    /**
     * Compile time exclusion checking of properties
     *
     * @param PropertyMetadata $propertyMetadata
     * @return bool
     */
    public function excludePropertyDeserialize(PropertyMetadata $propertyMetadata): bool
    {
        // exclude the property if the property modifiers are found in the excluded modifiers
        if (0 !== ($this->excludedModifiers & $propertyMetadata->getModifiers())) {
            return true;
        }

        foreach ($this->cachedStrategies as $strategy) {
            if ($strategy instanceof PropertyDeserializationExclusionStrategy && $strategy->skipDeserializingProperty($propertyMetadata)) {
                return true;
            }
        }

        return $this->excludeByAnnotation($propertyMetadata->getAnnotations(), false);
    }

    /**
     * Runtime exclusion checking of properties by strategy during serialization
     *
     * Uses user-defined strategies
     *
     * @param PropertyMetadata $property
     * @return bool
     */
    public function excludePropertyBySerializationStrategy(PropertyMetadata $property): bool
    {
        foreach ($this->propertySerializationStrategies as $exclusionStrategy) {
            if ($exclusionStrategy->skipSerializingProperty($property)) {
                return true;
            }
        }

        return false;
    }

    /**
     * Runtime exclusion checking of properties by strategy during deserialization
     *
     * Uses user-defined strategies
     *
     * @param PropertyMetadata $property
     * @return bool
     */
    public function excludePropertyByDeserializationStrategy(PropertyMetadata $property): bool
    {
        foreach ($this->propertyDeserializationStrategies as $exclusionStrategy) {
            if ($exclusionStrategy->skipDeserializingProperty($property)) {
                return true;
            }
        }

        return false;
    }

    /**
     * Returns true if class serialization strategies exist
     *
     * @return bool
     */
    public function hasClassSerializationStrategies(): bool
    {
        return $this->classSerializationStrategies !== [];
    }

    /**
     * Returns true if property serialization strategies exist
     *
     * @return bool
     */
    public function hasPropertySerializationStrategies(): bool
    {
        return $this->propertySerializationStrategies !== [];
    }

    /**
     * Returns true if class deserialization strategies exist
     *
     * @return bool
     */
    public function hasClassDeserializationStrategies(): bool
    {
        return $this->classDeserializationStrategies !== [];
    }

    /**
     * Returns true if property deserialization strategies exist
     *
     * @return bool
     */
    public function hasPropertyDeserializationStrategies(): bool
    {
        return $this->propertyDeserializationStrategies !== [];
    }

    /**
     * Checks various annotations to see if the property should be excluded
     *
     * - [@see Since] / [@see Until]
     * - [@see Exclude]
     * - [@see Expose] (if requireExpose is set)
     *
     * @param AnnotationCollection $annotations
     * @param bool $serialize
     * @return bool
     */
    private function excludeByAnnotation(AnnotationCollection $annotations, bool $serialize): bool
    {
        if (!$this->validVersion($annotations)) {
            return true;
        }

        /** @var Exclude $exclude */
        $exclude = $annotations->get(Exclude::class);
        if (null !== $exclude && $exclude->shouldExclude($serialize)) {
            return true;
        }

        // if we need an expose annotation
        if ($this->requireExpose) {
            /** @var Expose $expose */
            $expose = $annotations->get(Expose::class);
            if (null === $expose || !$expose->shouldExpose($serialize)) {
                return true;
            }
        }

        return false;
    }

    /**
     * Returns true if the set version is valid for [@see Since] and [@see Until] annotations
     *
     * @param AnnotationCollection $annotations
     * @return bool
     */
    private function validVersion(AnnotationCollection $annotations): bool
    {
        return !$this->shouldSkipSince($annotations) && !$this->shouldSkipUntil($annotations);
    }

    /**
     * Returns true if we should skip based on the [@see Since] annotation
     *
     * @param AnnotationCollection $annotations
     * @return bool
     */
    private function shouldSkipSince(AnnotationCollection $annotations): bool
    {
        $sinceAnnotation = $annotations->get(Since::class);

        return
            null !== $sinceAnnotation
            && null !== $this->version
            && \version_compare($this->version, $sinceAnnotation->getValue(), '<');
    }

    /**
     * Returns true if we should skip based on the [@see Until] annotation
     *
     * @param AnnotationCollection $annotations
     * @return bool
     */
    private function shouldSkipUntil(AnnotationCollection $annotations): bool
    {
        $untilAnnotation = $annotations->get(Until::class);

        return
            null !== $untilAnnotation
            && null !== $this->version
            && \version_compare($this->version, $untilAnnotation->getValue(), '>=');
    }
}