AttributeValue::fromXML() - Code Metrics - Inspection of "Feature/xsd types" - simplesamlphp/saml11 - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Pull Request — master (#6)

by Tim

created 2025-01-31 20:43 UTC

AttributeValue::fromXML() B

↳ Parent: AttributeValue

Complexity

Conditions	11
Paths	7

Size

Total Lines	43
Code Lines	28

Duplication

Lines	0
Ratio	0 %

Importance

Changes	1
Bugs	0	Features	0

Metric	Value
eloc	28
c	1
b	0
f	0
dl	0
loc	43
rs	7.3166
cc	11
nc	7
nop	1

How to fix Complexity

<?php

declare(strict_types=1);

namespace SimpleSAML\SAML11\XML\saml;

use DOMElement;
use SimpleSAML\SAML11\Assert\Assert;
use SimpleSAML\SAML11\Constants as C;
use SimpleSAML\SAML11\Type\{DateTimeValue, StringValue};
use SimpleSAML\XML\AbstractElement;
use SimpleSAML\XML\Chunk;
use SimpleSAML\XML\Exception\InvalidDOMElementException;
use SimpleSAML\XML\{SchemaValidatableElementInterface, SchemaValidatableElementTrait};
use SimpleSAML\XML\Type\{IntegerValue, ValueTypeInterface};

use function class_exists;
use function explode;
use function gettype;
use function str_contains;
use function strval;

/**
 * Serializable class representing an AttributeValue.
 *
 * @package simplesamlphp/saml11
 */
class AttributeValue extends AbstractSamlElement implements SchemaValidatableElementInterface
{
    use SchemaValidatableElementTrait;

    /**
     * Create an AttributeValue.
     *
     * @param \SimpleSAML\XML\Type\ValueTypeInterface|\SimpleSAML\XML\AbstractElement $value
     * @throws \SimpleSAML\Assert\AssertionFailedException if the supplied value is neither a string or a DOMElement
     */
    final public function __construct(
        protected StringValue|IntegerValue|DateTimeValue|AbstractElement $value,
    ) {
    }


    /**
     * Get the XSI type of this attribute value.
     *
     * @return string
     */
    public function getXsiType(): string
    {
        $value = $this->getValue();

        if ($value === null) {
            return 'xs:nil';
        } elseif ($value instanceof ValueTypeInterface) {
            return $value::SCHEMA_TYPE;
        } else {
            return sprintf(
                '%s:%s',
                $value::getNamespacePrefix(),
                $value::getLocalName(),
            );
        }
    }


    /**
     * Get this attribute value.
     *
     * @return (

     *   \SimpleSAML\XML\Type\IntegerValue|
     *   \SimpleSAML\SAML11\Type\StringValue|
     *   \SimpleSAML\SAML11\Type\DateTimeValue|
     *   \SimpleSAML\XML\AbstractElement|
     *   null
     * )
     */
    public function getValue()
    {
        return $this->value;
    }


    /**
     * Convert XML into a AttributeValue
     *
     * @param \DOMElement $xml The XML element we should load
     * @return static
     *
     * @throws \SimpleSAML\XML\Exception\InvalidDOMElementException
     *   if the qualified name of the supplied element is wrong
     */
    public static function fromXML(DOMElement $xml): static
    {
        Assert::same($xml->localName, static::getLocalName(), InvalidDOMElementException::class);
        Assert::same($xml->namespaceURI, static::NS, InvalidDOMElementException::class);

        if ($xml->childElementCount > 0) {
            $node = $xml->firstElementChild;

            if (str_contains($node->tagName, ':')) {
                list($prefix, $eltName) = explode(':', $node->tagName);
                $className = sprintf('\SimpleSAML\SAML11\XML\%s\%s', $prefix, $eltName);

                if (class_exists($className)) {
                    $value = $className::fromXML($node);
                } else {
                    $value = Chunk::fromXML($node);
                }
            } else {
                $value = Chunk::fromXML($node);
            }
        } elseif (
            $xml->hasAttributeNS(C::NS_XSI, "type") &&
            $xml->getAttributeNS(C::NS_XSI, "type") === "xs:integer"
        ) {
            // we have an integer as value
            $value = IntegerValue::fromString($xml->textContent);
        } elseif (
            $xml->hasAttributeNS(C::NS_XSI, "nil") &&
            ($xml->getAttributeNS(C::NS_XSI, "nil") === "1" || $xml->getAttributeNS(C::NS_XSI, "nil") === "true")
        ) {
            // we have a nill value
            $value = null;
        } elseif (
            $xml->hasAttributeNS(C::NS_XSI, "type") &&
            $xml->getAttributeNS(C::NS_XSI, "type") === "xs:dateTime"
        ) {
            // we have a dateTime as value
            $value = DateTimeValue::fromString($xml->textContent);
        } else {
            $value = StringValue::fromString($xml->textContent);
        }

        return new static($value);
    }


    /**
     * Append this attribute value to an element.
     *
     * @param \DOMElement|null $parent The element we should append this attribute value to.
     *
     * @return \DOMElement The generated AttributeValue element.
     */
    public function toXML(?DOMElement $parent = null): DOMElement
    {
        $e = parent::instantiateParentElement($parent);

        $value = $this->getValue();
        $type = gettype($value);

        switch ($type) {
            case IntegerValue::class:
                // make sure that the xs namespace is available in the AttributeValue
                $e->setAttributeNS('http://www.w3.org/2000/xmlns/', 'xmlns:xsi', C::NS_XSI);
                $e->setAttributeNS('http://www.w3.org/2000/xmlns/', 'xmlns:xs', C::NS_XS);
                $e->setAttributeNS(C::NS_XSI, 'xsi:type', 'xs:integer');
                $e->textContent = strval($value);
                break;
            case "object":
                if ($value instanceof DateTimeValue) {
                    $e->setAttributeNS('http://www.w3.org/2000/xmlns/', 'xmlns:xsi', C::NS_XSI);
                    $e->setAttributeNS('http://www.w3.org/2000/xmlns/', 'xmlns:xs', C::NS_XS);
                    $e->setAttributeNS(C::NS_XSI, 'xsi:type', 'xs:dateTime');
                    $e->textContent = strval($value);
                } elseif ($value instanceof ValueTypeInterface) {
                    if ($value instanceof IntegerValue) {
                        $e->setAttributeNS('http://www.w3.org/2000/xmlns/', 'xmlns:xsi', C::NS_XSI);
                        $e->setAttributeNS('http://www.w3.org/2000/xmlns/', 'xmlns:xs', C::NS_XS);
                        $e->setAttributeNS(C::NS_XSI, 'xsi:type', 'xs:integer');
                    }
                    $e->textContent = strval($value);
                } else {
                    $value->toXML($e);
                }
                break;
            default: // string
                $e->textContent = strval($value);
                break;
        }

        return $e;
    }
}


1			<?php
2
3			declare(strict_types=1);
4
5			namespace SimpleSAML\SAML11\XML\saml;
6
7			use DOMElement;
8			use SimpleSAML\SAML11\Assert\Assert;
9			use SimpleSAML\SAML11\Constants as C;
10			use SimpleSAML\SAML11\Type\{DateTimeValue, StringValue};
11			use SimpleSAML\XML\AbstractElement;
12			use SimpleSAML\XML\Chunk;
13			use SimpleSAML\XML\Exception\InvalidDOMElementException;
14			use SimpleSAML\XML\{SchemaValidatableElementInterface, SchemaValidatableElementTrait};
15			use SimpleSAML\XML\Type\{IntegerValue, ValueTypeInterface};
16
17			use function class_exists;
18			use function explode;
19			use function gettype;
20			use function str_contains;
21			use function strval;
22
23			/**
24			* Serializable class representing an AttributeValue.
25			*
26			* @package simplesamlphp/saml11
27			*/
28			class AttributeValue extends AbstractSamlElement implements SchemaValidatableElementInterface
29			{
30			use SchemaValidatableElementTrait;
31
32			/**
33			* Create an AttributeValue.
34			*
35			* @param \SimpleSAML\XML\Type\ValueTypeInterface\|\SimpleSAML\XML\AbstractElement $value
36			* @throws \SimpleSAML\Assert\AssertionFailedException if the supplied value is neither a string or a DOMElement
37			*/
38			final public function __construct(
39			protected StringValue\|IntegerValue\|DateTimeValue\|AbstractElement $value,
40			) {
41			}
42
43
44			/**
45			* Get the XSI type of this attribute value.
46			*
47			* @return string
48			*/
49			public function getXsiType(): string
50			{
51			$value = $this->getValue();
52
53			if ($value === null) {
54			return 'xs:nil';
55			} elseif ($value instanceof ValueTypeInterface) {
56			return $value::SCHEMA_TYPE;
57			} else {
58			return sprintf(
59			'%s:%s',
60			$value::getNamespacePrefix(),
61			$value::getLocalName(),
62			);
63			}
64			}
65
66
67			/**
68			* Get this attribute value.
69			*
70			* @return (
			1 ignored issue – show Documentation Bug introduced 2025-01-30 16:21 UTC by Report Bug Copy Issue Report The doc comment `(` at position `1` could not be parsed: the token is null at position 1. Loading history...
71			* \SimpleSAML\XML\Type\IntegerValue\|
72			* \SimpleSAML\SAML11\Type\StringValue\|
73			* \SimpleSAML\SAML11\Type\DateTimeValue\|
74			* \SimpleSAML\XML\AbstractElement\|
75			* null
76			* )
77			*/
78			public function getValue()
79			{
80			return $this->value;
81			}
82
83
84			/**
85			* Convert XML into a AttributeValue
86			*
87			* @param \DOMElement $xml The XML element we should load
88			* @return static
89			*
90			* @throws \SimpleSAML\XML\Exception\InvalidDOMElementException
91			* if the qualified name of the supplied element is wrong
92			*/
93			public static function fromXML(DOMElement $xml): static
94			{
95			Assert::same($xml->localName, static::getLocalName(), InvalidDOMElementException::class);
96			Assert::same($xml->namespaceURI, static::NS, InvalidDOMElementException::class);
97
98			if ($xml->childElementCount > 0) {
99			$node = $xml->firstElementChild;
100
101			if (str_contains($node->tagName, ':')) {
102			list($prefix, $eltName) = explode(':', $node->tagName);
103			$className = sprintf('\SimpleSAML\SAML11\XML\%s\%s', $prefix, $eltName);
104
105			if (class_exists($className)) {
106			$value = $className::fromXML($node);
107			} else {
108			$value = Chunk::fromXML($node);
109			}
110			} else {
111			$value = Chunk::fromXML($node);
112			}
113			} elseif (
114			$xml->hasAttributeNS(C::NS_XSI, "type") &&
115			$xml->getAttributeNS(C::NS_XSI, "type") === "xs:integer"
116			) {
117			// we have an integer as value
118			$value = IntegerValue::fromString($xml->textContent);
119			} elseif (
120			$xml->hasAttributeNS(C::NS_XSI, "nil") &&
121			($xml->getAttributeNS(C::NS_XSI, "nil") === "1" \|\| $xml->getAttributeNS(C::NS_XSI, "nil") === "true")
122			) {
123			// we have a nill value
124			$value = null;
125			} elseif (
126			$xml->hasAttributeNS(C::NS_XSI, "type") &&
127			$xml->getAttributeNS(C::NS_XSI, "type") === "xs:dateTime"
128			) {
129			// we have a dateTime as value
130			$value = DateTimeValue::fromString($xml->textContent);
131			} else {
132			$value = StringValue::fromString($xml->textContent);
133			}
134
135			return new static($value);
136			}
137
138
139			/**
140			* Append this attribute value to an element.
141			*
142			* @param \DOMElement\|null $parent The element we should append this attribute value to.
143			*
144			* @return \DOMElement The generated AttributeValue element.
145			*/
146			public function toXML(?DOMElement $parent = null): DOMElement
147			{
148			$e = parent::instantiateParentElement($parent);
149
150			$value = $this->getValue();
151			$type = gettype($value);
152
153			switch ($type) {
154			case IntegerValue::class:
155			// make sure that the xs namespace is available in the AttributeValue
156			$e->setAttributeNS('http://www.w3.org/2000/xmlns/', 'xmlns:xsi', C::NS_XSI);
157			$e->setAttributeNS('http://www.w3.org/2000/xmlns/', 'xmlns:xs', C::NS_XS);
158			$e->setAttributeNS(C::NS_XSI, 'xsi:type', 'xs:integer');
159			$e->textContent = strval($value);
160			break;
161			case "object":
162			if ($value instanceof DateTimeValue) {
163			$e->setAttributeNS('http://www.w3.org/2000/xmlns/', 'xmlns:xsi', C::NS_XSI);
164			$e->setAttributeNS('http://www.w3.org/2000/xmlns/', 'xmlns:xs', C::NS_XS);
165			$e->setAttributeNS(C::NS_XSI, 'xsi:type', 'xs:dateTime');
166			$e->textContent = strval($value);
167			} elseif ($value instanceof ValueTypeInterface) {
168			if ($value instanceof IntegerValue) {
169			$e->setAttributeNS('http://www.w3.org/2000/xmlns/', 'xmlns:xsi', C::NS_XSI);
170			$e->setAttributeNS('http://www.w3.org/2000/xmlns/', 'xmlns:xs', C::NS_XS);
171			$e->setAttributeNS(C::NS_XSI, 'xsi:type', 'xs:integer');
172			}
173			$e->textContent = strval($value);
174			} else {
175			$value->toXML($e);
176			}
177			break;
178			default: // string
179			$e->textContent = strval($value);
180			break;
181			}
182
183			return $e;
184			}
185			}
186

simplesamlphp / saml11

Pull Request — master (#6)

AttributeValue::fromXML() B

Complexity

Size

Duplication

Importance

How to fix Complexity

Long Method

Duplication Side-by-Side

Filter issues like