AnnotationReader::readPropertyAnnotations() - Code Metrics - Inspection of "More tests on component annotations." - jaxon-php/jaxon-mono - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — main ( 7f530d...7aae9b )

by Thierry

created 2025-10-28 05:08 UTC

AnnotationReader::readPropertyAnnotations() A

↳ Parent: AnnotationReader

Complexity

Conditions	4
Paths	3

Size

Total Lines	25
Code Lines	11

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
cc	4
eloc	11
c	0
b	0
f	0
nc	3
nop	2
dl	0
loc	25
rs	9.9

<?php

/**
 * AnnotationReader.php
 *
 * Jaxon annotation reader.
 *
 * @package jaxon-annotations
 * @author Thierry Feuzeu <[email protected]>
 * @copyright 2022 Thierry Feuzeu <[email protected]>
 * @license https://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
 * @link https://github.com/jaxon-php/jaxon-annotations
 */

namespace Jaxon\Annotations;

use Jaxon\App\Metadata\InputData;
use Jaxon\App\Metadata\Metadata;
use Jaxon\App\Metadata\MetadataReaderInterface;
use Jaxon\Annotations\Annotation\AbstractAnnotation;
use Jaxon\Annotations\Annotation\AfterAnnotation;
use Jaxon\Annotations\Annotation\BeforeAnnotation;
use Jaxon\Annotations\Annotation\CallbackAnnotation;
use Jaxon\Annotations\Annotation\DatabagAnnotation;
use Jaxon\Annotations\Annotation\ExcludeAnnotation;
use Jaxon\Annotations\Annotation\ExportAnnotation;
use Jaxon\Annotations\Annotation\UploadAnnotation;
use Jaxon\Annotations\Annotation\ContainerAnnotation;
use Jaxon\Exception\SetupException;
use mindplay\annotations\AnnotationException;
use mindplay\annotations\AnnotationManager;
use mindplay\annotations\standard\VarAnnotation;

use function array_filter;
use function count;
use function is_a;

class AnnotationReader implements MetadataReaderInterface
{
    /**
     * @var AnnotationManager
     */
    protected $xManager;

    /**
     * @var Metadata
     */
    protected $xMetadata;

    /**
     * Properties types, read from the "var" annotations.
     *
     * @var array
     */
    protected $aPropTypes;

    /**
     * The type of the class member being currently processed.
     *
     * @var string
     */
    protected $sCurrMemberType;

    /**
     * The constructor
     *
     * @param AnnotationManager $xManager
     */
    public function __construct(AnnotationManager $xManager)
    {
        $this->xManager = $xManager;
        $this->xManager->registry['upload'] = UploadAnnotation::class;
        $this->xManager->registry['databag'] = DatabagAnnotation::class;
        $this->xManager->registry['exclude'] = ExcludeAnnotation::class;
        $this->xManager->registry['export'] = ExportAnnotation::class;
        $this->xManager->registry['before'] = BeforeAnnotation::class;
        $this->xManager->registry['after'] = AfterAnnotation::class;
        $this->xManager->registry['di'] = ContainerAnnotation::class;
        $this->xManager->registry['callback'] = CallbackAnnotation::class;
        // Missing standard annotations.
        // We need to define this, otherwise they throw an exception, and make the whole processing fail.
        $this->xManager->registry['const'] = false;
        $this->xManager->registry['inheritDoc'] = false;
        $this->xManager->registry['template'] = false;
        $this->xManager->registry['param-closure-this'] = false;
    }

    /**
     * @return array
     */
    public function getPropTypes(): array
    {
        return $this->aPropTypes;
    }

    /**
     * @return bool
     */
    public function annotationIsOnProperty(): bool
    {
        return $this->sCurrMemberType === AnnotationManager::MEMBER_PROPERTY;
    }

    /**
     * @param string $sClass
     *
     * @return void
     * @throws AnnotationException
     */
    private function readClassAnnotations(string $sClass): void
    {
        // Only keep the annotations declared in this package.
        /** @var array<AbstractAnnotation> */
        $aAnnotations = array_filter(
            $this->xManager->getClassAnnotations($sClass),
            fn($xAnnotation) => is_a($xAnnotation, AbstractAnnotation::class)
        );
        // First check if the class is excluded.
        foreach($aAnnotations as $xAnnotation)
        {
            if(is_a($xAnnotation, ExcludeAnnotation::class))
            {
                $xAnnotation->saveValue($this->xMetadata);
            }
        }
        if($this->xMetadata->isExcluded())
        {
            return;
        }

        foreach($aAnnotations as $xAnnotation)
        {
            if(!is_a($xAnnotation, ExcludeAnnotation::class))
            {
                $xAnnotation->saveValue($this->xMetadata);
            }
        }
    }

    /**
     * @param string $sClass
     * @param string $sProperty
     *
     * @return void
     * @throws AnnotationException
     */
    private function readPropertyAnnotations(string $sClass, string $sProperty): void
    {
        /** @var array<ContainerAnnotation> */
        // Only keep the annotations declared in this package.
        $aAnnotations = array_filter(
            $this->xManager->getPropertyAnnotations($sClass, $sProperty),
            function($xAnnotation) use($sProperty) {
                // Save the property type
                if(is_a($xAnnotation, VarAnnotation::class))
                {
                    $this->aPropTypes[$sProperty] = $xAnnotation->type;
                }
                // Only container annotations are allowed on properties
                return is_a($xAnnotation, ContainerAnnotation::class);
            }
        );
        if(count($aAnnotations) > 1)
        {
            throw new AnnotationException('Only one @di annotation is allowed on a property');
        }

        foreach($aAnnotations as $xAnnotation)
        {
            $xAnnotation->setAttr($sProperty);
            $xAnnotation->saveValue($this->xMetadata);
        }
    }

    /**
     * @param string $sClass
     * @param string $sMethod
     *
     * @return void
     * @throws AnnotationException
     */
    private function readMethodAnnotations(string $sClass, string $sMethod): void
    {
        // Only keep the annotations declared in this package.
        /** @var array<AbstractAnnotation> */
        $aAnnotations = array_filter(
            $this->xManager->getMethodAnnotations($sClass, $sMethod),
            fn($xAnnotation) => is_a($xAnnotation, AbstractAnnotation::class)
        );
        foreach($aAnnotations as $xAnnotation)
        {
            $xAnnotation->saveValue($this->xMetadata, $sMethod);
        }
    }

    /**
     * @throws SetupException
     */
    public function getAttributes(InputData $xInput): Metadata
    {
        ContainerAnnotation::$xReader = $this;
        $this->aPropTypes = [];
        $this->xMetadata = new Metadata();
        $sClass = $xInput->getReflectionClass()->getName();

        try
        {
            // Processing class annotations
            $this->sCurrMemberType = AnnotationManager::MEMBER_CLASS;

            $this->readClassAnnotations($sClass);

            // Processing properties annotations
            $this->sCurrMemberType = AnnotationManager::MEMBER_PROPERTY;

            // Properties annotations
            foreach($xInput->getProperties() as $sProperty)
            {
                $this->readPropertyAnnotations($sClass, $sProperty);
            }

            // The methods annotations are not taken for excluded classes.
            if($this->xMetadata->isExcluded())
            {
                return $this->xMetadata;
            }

            // Processing methods annotations
            $this->sCurrMemberType = AnnotationManager::MEMBER_METHOD;

            foreach($xInput->getMethods() as $sMethod)
            {
                $this->readMethodAnnotations($sClass, $sMethod);
            }

            return $this->xMetadata;
        }
        catch(AnnotationException $e)
        {
            throw new SetupException($e->getMessage());
        }
    }
}


1			<?php
2
3			/**
4			* AnnotationReader.php
5			*
6			* Jaxon annotation reader.
7			*
8			* @package jaxon-annotations
9			* @author Thierry Feuzeu <[email protected]>
10			* @copyright 2022 Thierry Feuzeu <[email protected]>
11			* @license https://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
12			* @link https://github.com/jaxon-php/jaxon-annotations
13			*/
14
15			namespace Jaxon\Annotations;
16
17			use Jaxon\App\Metadata\InputData;
18			use Jaxon\App\Metadata\Metadata;
19			use Jaxon\App\Metadata\MetadataReaderInterface;
20			use Jaxon\Annotations\Annotation\AbstractAnnotation;
21			use Jaxon\Annotations\Annotation\AfterAnnotation;
22			use Jaxon\Annotations\Annotation\BeforeAnnotation;
23			use Jaxon\Annotations\Annotation\CallbackAnnotation;
24			use Jaxon\Annotations\Annotation\DatabagAnnotation;
25			use Jaxon\Annotations\Annotation\ExcludeAnnotation;
26			use Jaxon\Annotations\Annotation\ExportAnnotation;
27			use Jaxon\Annotations\Annotation\UploadAnnotation;
28			use Jaxon\Annotations\Annotation\ContainerAnnotation;
29			use Jaxon\Exception\SetupException;
30			use mindplay\annotations\AnnotationException;
31			use mindplay\annotations\AnnotationManager;
32			use mindplay\annotations\standard\VarAnnotation;
33
34			use function array_filter;
35			use function count;
36			use function is_a;
37
38			class AnnotationReader implements MetadataReaderInterface
39			{
40			/**
41			* @var AnnotationManager
42			*/
43			protected $xManager;
44
45			/**
46			* @var Metadata
47			*/
48			protected $xMetadata;
49
50			/**
51			* Properties types, read from the "var" annotations.
52			*
53			* @var array
54			*/
55			protected $aPropTypes;
56
57			/**
58			* The type of the class member being currently processed.
59			*
60			* @var string
61			*/
62			protected $sCurrMemberType;
63
64			/**
65			* The constructor
66			*
67			* @param AnnotationManager $xManager
68			*/
69			public function __construct(AnnotationManager $xManager)
70			{
71			$this->xManager = $xManager;
72			$this->xManager->registry['upload'] = UploadAnnotation::class;
73			$this->xManager->registry['databag'] = DatabagAnnotation::class;
74			$this->xManager->registry['exclude'] = ExcludeAnnotation::class;
75			$this->xManager->registry['export'] = ExportAnnotation::class;
76			$this->xManager->registry['before'] = BeforeAnnotation::class;
77			$this->xManager->registry['after'] = AfterAnnotation::class;
78			$this->xManager->registry['di'] = ContainerAnnotation::class;
79			$this->xManager->registry['callback'] = CallbackAnnotation::class;
80			// Missing standard annotations.
81			// We need to define this, otherwise they throw an exception, and make the whole processing fail.
82			$this->xManager->registry['const'] = false;
83			$this->xManager->registry['inheritDoc'] = false;
84			$this->xManager->registry['template'] = false;
85			$this->xManager->registry['param-closure-this'] = false;
86			}
87
88			/**
89			* @return array
90			*/
91			public function getPropTypes(): array
92			{
93			return $this->aPropTypes;
94			}
95
96			/**
97			* @return bool
98			*/
99			public function annotationIsOnProperty(): bool
100			{
101			return $this->sCurrMemberType === AnnotationManager::MEMBER_PROPERTY;
102			}
103
104			/**
105			* @param string $sClass
106			*
107			* @return void
108			* @throws AnnotationException
109			*/
110			private function readClassAnnotations(string $sClass): void
111			{
112			// Only keep the annotations declared in this package.
113			/** @var array<AbstractAnnotation> */
114			$aAnnotations = array_filter(
115			$this->xManager->getClassAnnotations($sClass),
116			fn($xAnnotation) => is_a($xAnnotation, AbstractAnnotation::class)
117			);
118			// First check if the class is excluded.
119			foreach($aAnnotations as $xAnnotation)
120			{
121			if(is_a($xAnnotation, ExcludeAnnotation::class))
122			{
123			$xAnnotation->saveValue($this->xMetadata);
124			}
125			}
126			if($this->xMetadata->isExcluded())
127			{
128			return;
129			}
130
131			foreach($aAnnotations as $xAnnotation)
132			{
133			if(!is_a($xAnnotation, ExcludeAnnotation::class))
134			{
135			$xAnnotation->saveValue($this->xMetadata);
136			}
137			}
138			}
139
140			/**
141			* @param string $sClass
142			* @param string $sProperty
143			*
144			* @return void
145			* @throws AnnotationException
146			*/
147			private function readPropertyAnnotations(string $sClass, string $sProperty): void
148			{
149			/** @var array<ContainerAnnotation> */
150			// Only keep the annotations declared in this package.
151			$aAnnotations = array_filter(
152			$this->xManager->getPropertyAnnotations($sClass, $sProperty),
153			function($xAnnotation) use($sProperty) {
154			// Save the property type
155			if(is_a($xAnnotation, VarAnnotation::class))
156			{
157			$this->aPropTypes[$sProperty] = $xAnnotation->type;
158			}
159			// Only container annotations are allowed on properties
160			return is_a($xAnnotation, ContainerAnnotation::class);
161			}
162			);
163			if(count($aAnnotations) > 1)
164			{
165			throw new AnnotationException('Only one @di annotation is allowed on a property');
166			}
167
168			foreach($aAnnotations as $xAnnotation)
169			{
170			$xAnnotation->setAttr($sProperty);
171			$xAnnotation->saveValue($this->xMetadata);
172			}
173			}
174
175			/**
176			* @param string $sClass
177			* @param string $sMethod
178			*
179			* @return void
180			* @throws AnnotationException
181			*/
182			private function readMethodAnnotations(string $sClass, string $sMethod): void
183			{
184			// Only keep the annotations declared in this package.
185			/** @var array<AbstractAnnotation> */
186			$aAnnotations = array_filter(
187			$this->xManager->getMethodAnnotations($sClass, $sMethod),
188			fn($xAnnotation) => is_a($xAnnotation, AbstractAnnotation::class)
189			);
190			foreach($aAnnotations as $xAnnotation)
191			{
192			$xAnnotation->saveValue($this->xMetadata, $sMethod);
193			}
194			}
195
196			/**
197			* @throws SetupException
198			*/
199			public function getAttributes(InputData $xInput): Metadata
200			{
201			ContainerAnnotation::$xReader = $this;
202			$this->aPropTypes = [];
203			$this->xMetadata = new Metadata();
204			$sClass = $xInput->getReflectionClass()->getName();
205
206			try
207			{
208			// Processing class annotations
209			$this->sCurrMemberType = AnnotationManager::MEMBER_CLASS;
210
211			$this->readClassAnnotations($sClass);
212
213			// Processing properties annotations
214			$this->sCurrMemberType = AnnotationManager::MEMBER_PROPERTY;
215
216			// Properties annotations
217			foreach($xInput->getProperties() as $sProperty)
218			{
219			$this->readPropertyAnnotations($sClass, $sProperty);
220			}
221
222			// The methods annotations are not taken for excluded classes.
223			if($this->xMetadata->isExcluded())
224			{
225			return $this->xMetadata;
226			}
227
228			// Processing methods annotations
229			$this->sCurrMemberType = AnnotationManager::MEMBER_METHOD;
230
231			foreach($xInput->getMethods() as $sMethod)
232			{
233			$this->readMethodAnnotations($sClass, $sMethod);
234			}
235
236			return $this->xMetadata;
237			}
238			catch(AnnotationException $e)
239			{
240			throw new SetupException($e->getMessage());
241			}
242			}
243			}
244

jaxon-php / jaxon-mono

Push — main ( 7f530d...7aae9b )

AnnotationReader::readPropertyAnnotations() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like