AbstractElement::getChildrenOfClass() - Code Metrics - Inspection of "Merge pull request #18 from simplesamlphp/renameEl..." - simplesamlphp/xml-common - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( 3444f2...316fc7 )

by Tim

created 2022-09-05 22:03 UTC

AbstractElement::getChildrenOfClass() A

↳ Parent: AbstractElement

Complexity

Conditions	4
Paths	3

Size

Total Lines	13
Code Lines	7

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
cc	4
eloc	7
nc	3
nop	1
dl	0
loc	13
rs	10
c	0
b	0
f	0

<?php

declare(strict_types=1);

namespace SimpleSAML\XML;

use DOMElement;
use RuntimeException;
use SimpleSAML\XML\DOMDocumentFactory;
use SimpleSAML\XML\Exception\MissingAttributeException;
use SimpleSAML\XML\Exception\SchemaViolationException;
use SimpleSAML\Assert\Assert;

use function array_slice;
use function defined;
use function explode;
use function in_array;
use function intval;
use function join;

/**
 * Abstract class to be implemented by all classes
 *
 * @package simplesamlphp/xml-common
 */
abstract class AbstractElement extends AbstractSerializableElement
{
    /**
     * Create a document structure for this element
     *
     * @param \DOMElement|null $parent The element we should append to.
     * @return \DOMElement
     */
    public function instantiateParentElement(DOMElement $parent = null): DOMElement
    {
        $qualifiedName = $this->getQualifiedName();
        $namespace = static::getNamespaceURI();

        if ($parent === null) {
            $doc = DOMDocumentFactory::create();
            $e = $doc->createElementNS($namespace, $qualifiedName);
            $doc->appendChild($e);
        } else {
            $doc = $parent->ownerDocument;
            Assert::notNull($doc);

            /** @psalm-var \DOMDocument $doc */
            $e = $doc->createElementNS($namespace, $qualifiedName);
            $parent->appendChild($e);
        }

        return $e;
    }


    /**
     * Get the value of an attribute from a given element.
     *
     * @param \DOMElement $xml The element where we should search for the attribute.
     * @param string      $name The name of the attribute.
     * @param string|null $default The default to return in case the attribute does not exist and it is optional.
     * @return string|null
     * @throws \SimpleSAML\Assert\AssertionFailedException if the attribute is missing from the element
     */
    public static function getAttribute(DOMElement $xml, string $name, ?string $default = ''): ?string
    {
        if (!$xml->hasAttribute($name)) {
            Assert::nullOrStringNotEmpty(
                $default,
                'Missing \'' . $name . '\' attribute on ' . static::getNamespacePrefix() . ':'
                    . self::getLocalName() . '.',
                MissingAttributeException::class,
            );

            return $default;
        }

        return $xml->getAttribute($name);
    }


    /**
     * @param \DOMElement $xml The element where we should search for the attribute.
     * @param string      $name The name of the attribute.
     * @param string|null $default The default to return in case the attribute does not exist and it is optional.
     * @return bool|null
     * @throws \SimpleSAML\Assert\AssertionFailedException if the attribute is not a boolean
     */
    public static function getBooleanAttribute(DOMElement $xml, string $name, ?string $default = ''): ?bool
    {
        $value = self::getAttribute($xml, $name, $default);
        if ($value === null) {
            return null;
        }

        Assert::oneOf(
            $value,
            ['0', '1', 'false', 'true'],
            'The \'' . $name . '\' attribute of ' . static::getNamespacePrefix() . ':' . self::getLocalName() .
            ' must be boolean.',
        );

        return in_array($value, ['1', 'true'], true);
    }


    /**
     * Get the integer value of an attribute from a given element.
     *
     * @param \DOMElement $xml The element where we should search for the attribute.
     * @param string      $name The name of the attribute.
     * @param string|null $default The default to return in case the attribute does not exist and it is optional.
     *
     * @return int|null
     * @throws \SimpleSAML\Assert\AssertionFailedException if the attribute is not an integer
     */
    public static function getIntegerAttribute(DOMElement $xml, string $name, ?string $default = ''): ?int
    {
        $value = self::getAttribute($xml, $name, $default);
        if ($value === null) {
            return null;
        }

        Assert::numeric(
            $value,
            'The \'' . $name . '\' attribute of ' . static::getNamespacePrefix() . ':' . self::getLocalName()
                . ' must be numerical.',
        );

        return intval($value);
    }


    /**
     * Static method that processes a fully namespaced class name and returns the name of the class from it.
     *
     * @param string $class
     * @return string
     */
    public static function getClassName(string $class): string
    {
        $ncName = join('', array_slice(explode('\\', $class), -1));
        Assert::validNCName($ncName, SchemaViolationException::class);
        return $ncName;
    }


    /**
     * Get the XML qualified name (prefix:name) of the element represented by this class.
     *
     * @return string
     */
    public function getQualifiedName(): string
    {
        $qName = static::getNamespacePrefix() . ':' . static::getLocalName();
        Assert::validQName($qName, SchemaViolationException::class);
        return $qName;
    }


    /**
     * Extract localized names from the children of a given element.
     *
     * @param \DOMElement $parent The element we want to search.
     * @return static[] An array of objects of this class.
     */
    public static function getChildrenOfClass(DOMElement $parent): array
    {
        $ret = [];
        foreach ($parent->childNodes as $node) {
            if (
                $node->namespaceURI === static::getNamespaceURI()
                && $node->localName === static::getLocalName()
            ) {
                /** @psalm-var \DOMElement $node */
                $ret[] = static::fromXML($node);
            }
        }
        return $ret;
    }


    /**
     * Get the namespace for the element.
     *
     * @return string
     */
    public static function getNamespaceURI(): string
    {
        Assert::true(
            defined('static::NS'),
            self::getClassName(static::class)
            . '::NS constant must be defined and set to the namespace for the XML-class it represents.',
            RuntimeException::class,
        );
        Assert::validURI(static::NS, SchemaViolationException::class);

        return static::NS;
    }


    /**
     * Get the namespace-prefix for the element.
     *
     * @return string
     */
    public static function getNamespacePrefix(): string
    {
        Assert::true(
            defined('static::NS_PREFIX'),
            self::getClassName(static::class)
            . '::NS_PREFIX constant must be defined and set to the namespace prefix for the XML-class it represents.',
            RuntimeException::class,
        );
        return static::NS_PREFIX;

    }


    /**
     * Get the local name for the element.
     *
     * @return string
     */
    public static function getLocalName(): string
    {
        if (defined('static::LOCALNAME')) {
            $ncName = static::LOCALNAME;

        } else {
            $ncName = self::getClassName(static::class);
        }

        Assert::validNCName($ncName, SchemaViolationException::class);
        return $ncName;
    }


    /**
     * Test if an object, at the state it's in, would produce an empty XML-element
     *
     * @return bool
     */
    public function isEmptyElement(): bool
    {
        return false;
    }


    /**
     * Create a class from an array
     *
     * @param array $data
     * @return self
     */
    public static function fromArray(/** @scrutinizer ignore-unused */array $data): object
    {
        throw new RuntimeException('Not implemented.');
    }


    /**
     * Create an array from this class
     *
     * @return array
     */
    public function toArray(): array
    {
        throw new RuntimeException('Not implemented');
    }
}


1			<?php
2
3			declare(strict_types=1);
4
5			namespace SimpleSAML\XML;
6
7			use DOMElement;
8			use RuntimeException;
9			use SimpleSAML\XML\DOMDocumentFactory;
10			use SimpleSAML\XML\Exception\MissingAttributeException;
11			use SimpleSAML\XML\Exception\SchemaViolationException;
12			use SimpleSAML\Assert\Assert;
13
14			use function array_slice;
15			use function defined;
16			use function explode;
17			use function in_array;
18			use function intval;
19			use function join;
20
21			/**
22			* Abstract class to be implemented by all classes
23			*
24			* @package simplesamlphp/xml-common
25			*/
26			abstract class AbstractElement extends AbstractSerializableElement
27			{
28			/**
29			* Create a document structure for this element
30			*
31			* @param \DOMElement\|null $parent The element we should append to.
32			* @return \DOMElement
33			*/
34			public function instantiateParentElement(DOMElement $parent = null): DOMElement
35			{
36			$qualifiedName = $this->getQualifiedName();
37			$namespace = static::getNamespaceURI();
38
39			if ($parent === null) {
40			$doc = DOMDocumentFactory::create();
41			$e = $doc->createElementNS($namespace, $qualifiedName);
42			$doc->appendChild($e);
43			} else {
44			$doc = $parent->ownerDocument;
45			Assert::notNull($doc);
46
47			/** @psalm-var \DOMDocument $doc */
48			$e = $doc->createElementNS($namespace, $qualifiedName);
49			$parent->appendChild($e);
50			}
51
52			return $e;
53			}
54
55
56			/**
57			* Get the value of an attribute from a given element.
58			*
59			* @param \DOMElement $xml The element where we should search for the attribute.
60			* @param string $name The name of the attribute.
61			* @param string\|null $default The default to return in case the attribute does not exist and it is optional.
62			* @return string\|null
63			* @throws \SimpleSAML\Assert\AssertionFailedException if the attribute is missing from the element
64			*/
65			public static function getAttribute(DOMElement $xml, string $name, ?string $default = ''): ?string
66			{
67			if (!$xml->hasAttribute($name)) {
68			Assert::nullOrStringNotEmpty(
69			$default,
70			'Missing \'' . $name . '\' attribute on ' . static::getNamespacePrefix() . ':'
71			. self::getLocalName() . '.',
72			MissingAttributeException::class,
73			);
74
75			return $default;
76			}
77
78			return $xml->getAttribute($name);
79			}
80
81
82			/**
83			* @param \DOMElement $xml The element where we should search for the attribute.
84			* @param string $name The name of the attribute.
85			* @param string\|null $default The default to return in case the attribute does not exist and it is optional.
86			* @return bool\|null
87			* @throws \SimpleSAML\Assert\AssertionFailedException if the attribute is not a boolean
88			*/
89			public static function getBooleanAttribute(DOMElement $xml, string $name, ?string $default = ''): ?bool
90			{
91			$value = self::getAttribute($xml, $name, $default);
92			if ($value === null) {
93			return null;
94			}
95
96			Assert::oneOf(
97			$value,
98			['0', '1', 'false', 'true'],
99			'The \'' . $name . '\' attribute of ' . static::getNamespacePrefix() . ':' . self::getLocalName() .
100			' must be boolean.',
101			);
102
103			return in_array($value, ['1', 'true'], true);
104			}
105
106
107			/**
108			* Get the integer value of an attribute from a given element.
109			*
110			* @param \DOMElement $xml The element where we should search for the attribute.
111			* @param string $name The name of the attribute.
112			* @param string\|null $default The default to return in case the attribute does not exist and it is optional.
113			*
114			* @return int\|null
115			* @throws \SimpleSAML\Assert\AssertionFailedException if the attribute is not an integer
116			*/
117			public static function getIntegerAttribute(DOMElement $xml, string $name, ?string $default = ''): ?int
118			{
119			$value = self::getAttribute($xml, $name, $default);
120			if ($value === null) {
121			return null;
122			}
123
124			Assert::numeric(
125			$value,
126			'The \'' . $name . '\' attribute of ' . static::getNamespacePrefix() . ':' . self::getLocalName()
127			. ' must be numerical.',
128			);
129
130			return intval($value);
131			}
132
133
134			/**
135			* Static method that processes a fully namespaced class name and returns the name of the class from it.
136			*
137			* @param string $class
138			* @return string
139			*/
140			public static function getClassName(string $class): string
141			{
142			$ncName = join('', array_slice(explode('\\', $class), -1));
143			Assert::validNCName($ncName, SchemaViolationException::class);
144			return $ncName;
145			}
146
147
148			/**
149			* Get the XML qualified name (prefix:name) of the element represented by this class.
150			*
151			* @return string
152			*/
153			public function getQualifiedName(): string
154			{
155			$qName = static::getNamespacePrefix() . ':' . static::getLocalName();
156			Assert::validQName($qName, SchemaViolationException::class);
157			return $qName;
158			}
159
160
161			/**
162			* Extract localized names from the children of a given element.
163			*
164			* @param \DOMElement $parent The element we want to search.
165			* @return static[] An array of objects of this class.
166			*/
167			public static function getChildrenOfClass(DOMElement $parent): array
168			{
169			$ret = [];
170			foreach ($parent->childNodes as $node) {
171			if (
172			$node->namespaceURI === static::getNamespaceURI()
173			&& $node->localName === static::getLocalName()
174			) {
175			/** @psalm-var \DOMElement $node */
176			$ret[] = static::fromXML($node);
177			}
178			}
179			return $ret;
180			}
181
182
183			/**
184			* Get the namespace for the element.
185			*
186			* @return string
187			*/
188			public static function getNamespaceURI(): string
189			{
190			Assert::true(
191			defined('static::NS'),
192			self::getClassName(static::class)
193			. '::NS constant must be defined and set to the namespace for the XML-class it represents.',
194			RuntimeException::class,
195			);
196			Assert::validURI(static::NS, SchemaViolationException::class);
			1 ignored issue – show Bug introduced 2022-09-05 19:34 UTC by Report Bug Copy Issue Report The constant `SimpleSAML\XML\AbstractElement::NS` was not found. Maybe you did not declare it correctly or list all dependencies? Loading history...
197			return static::NS;
198			}
199
200
201			/**
202			* Get the namespace-prefix for the element.
203			*
204			* @return string
205			*/
206			public static function getNamespacePrefix(): string
207			{
208			Assert::true(
209			defined('static::NS_PREFIX'),
210			self::getClassName(static::class)
211			. '::NS_PREFIX constant must be defined and set to the namespace prefix for the XML-class it represents.',
212			RuntimeException::class,
213			);
214			return static::NS_PREFIX;
			1 ignored issue – show Bug introduced 2022-09-05 19:34 UTC by Report Bug Copy Issue Report The constant `SimpleSAML\XML\AbstractElement::NS_PREFIX` was not found. Maybe you did not declare it correctly or list all dependencies? Loading history...
215			}
216
217
218			/**
219			* Get the local name for the element.
220			*
221			* @return string
222			*/
223			public static function getLocalName(): string
224			{
225			if (defined('static::LOCALNAME')) {
226			$ncName = static::LOCALNAME;
			1 ignored issue – show Bug introduced 2022-09-05 19:34 UTC by Report Bug Copy Issue Report The constant `SimpleSAML\XML\AbstractElement::LOCALNAME` was not found. Maybe you did not declare it correctly or list all dependencies? Loading history...
227			} else {
228			$ncName = self::getClassName(static::class);
229			}
230
231			Assert::validNCName($ncName, SchemaViolationException::class);
232			return $ncName;
233			}
234
235
236			/**
237			* Test if an object, at the state it's in, would produce an empty XML-element
238			*
239			* @return bool
240			*/
241			public function isEmptyElement(): bool
242			{
243			return false;
244			}
245
246
247			/**
248			* Create a class from an array
249			*
250			* @param array $data
251			* @return self
252			*/
253			public static function fromArray(/** @scrutinizer ignore-unused */array $data): object
254			{
255			throw new RuntimeException('Not implemented.');
256			}
257
258
259			/**
260			* Create an array from this class
261			*
262			* @return array
263			*/
264			public function toArray(): array
265			{
266			throw new RuntimeException('Not implemented');
267			}
268			}
269

simplesamlphp / xml-common

Push — master ( 3444f2...316fc7 )

AbstractElement::getChildrenOfClass() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like