Add XML-representation for ds:SignatureMethod element (#10)

Author: tvdijen

src/XML/ds/SignatureMethod.php

@@ -0,0 +1,114 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SimpleSAML\XMLSecurity\XML\ds;
+
+use DOMElement;
+use SimpleSAML\Assert\Assert;
+use SimpleSAML\XML\Exception\InvalidDOMElementException;
+use SimpleSAML\XMLSecurity\Constants;
+use SimpleSAML\XMLSecurity\Exception\InvalidArgumentException;
+
+/**
+ * Class representing a ds:SignatureMethod element.
+ *
+ * @package simplesamlphp/xml-security
+ */
+final class SignatureMethod extends AbstractDsElement
+{
+    /**
+     * The algorithm.
+     *
+     * @var string
+     */
+    protected string $Algorithm;
+
+
+    /**
+     * Initialize a SignatureMethod element.
+     *
+     * @param string $algorithm
+     */
+    public function __construct(string $algorithm)
+    {
+        $this->setAlgorithm($algorithm);
+    }
+
+
+    /**
+     * Collect the value of the Algorithm-property
+     *
+     * @return string
+     */
+    public function getAlgorithm(): string
+    {
+        return $this->Algorithm;
+    }
+
+
+    /**
+     * Set the value of the Algorithm-property
+     *
+     * @param string $algorithm
+     */
+    private function setAlgorithm(string $algorithm): void
+    {
+        Assert::oneOf(
+            $algorithm,
+            [
+                Constants::SIG_RSA_SHA1,
+                Constants::SIG_RSA_SHA224,
+                Constants::SIG_RSA_SHA256,
+                Constants::SIG_RSA_SHA384,
+                Constants::SIG_RSA_SHA512,
+                Constants::SIG_RSA_RIPEMD160,
+                Constants::SIG_HMAC_SHA1,
+                Constants::SIG_HMAC_SHA224,
+                Constants::SIG_HMAC_SHA256,
+                Constants::SIG_HMAC_SHA384,
+                Constants::SIG_HMAC_SHA512,
+                Constants::SIG_HMAC_RIPEMD160,
+            ],
+            'Invalid canonicalization method',
+            InvalidArgumentException::class
+        );
+
+        $this->Algorithm = $algorithm;
+    }
+
+
+    /**
+     * Convert XML into a SignatureMethod
+     *
+     * @param \DOMElement $xml The XML element we should load
+     * @return self
+     *
+     * @throws \SimpleSAML\XML\Exception\InvalidDOMElementException
+     *   If the qualified name of the supplied element is wrong
+     */
+    public static function fromXML(DOMElement $xml): object
+    {
+        Assert::same($xml->localName, 'SignatureMethod', InvalidDOMElementException::class);
+        Assert::same($xml->namespaceURI, SignatureMethod::NS, InvalidDOMElementException::class);
+
+        $Algorithm = SignatureMethod::getAttribute($xml, 'Algorithm');
+
+        return new self($Algorithm);
+    }
+
+
+    /**
+     * Convert this SignatureMethod element to XML.
+     *
+     * @param \DOMElement|null $parent The element we should append this KeyName element to.
+     * @return \DOMElement
+     */
+    public function toXML(DOMElement $parent = null): DOMElement
+    {
+        $e = $this->instantiateParentElement($parent);
+        $e->setAttribute('Algorithm', $this->Algorithm);
+
+        return $e;
+    }
+}

tests/XML/ds/SignatureMethodTest.php

@@ -0,0 +1,68 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SimpleSAML\XMLSecurity\Test\XML\ds;
+
+use DOMDocument;
+use PHPUnit\Framework\TestCase;
+use SimpleSAML\XML\DOMDocumentFactory;
+use SimpleSAML\XMLSecurity\Constants;
+use SimpleSAML\XMLSecurity\XML\ds\SignatureMethod;
+
+/**
+ * Class \SimpleSAML\XMLSecurity\XML\ds\SignatureMethodTest
+ *
+ * @covers \SimpleSAML\XMLSecurity\XML\ds\AbstractDsElement
+ * @covers \SimpleSAML\XMLSecurity\XML\ds\SignatureMethod
+ *
+ * @package simplesamlphp/xml-security
+ */
+final class SignatureMethodTest extends TestCase
+{
+    /** @var \DOMDocument */
+    private DOMDocument $document;
+
+    /**
+     */
+    protected function setUp(): void
+    {
+        $this->document = DOMDocumentFactory::fromFile(
+            dirname(dirname(dirname(dirname(__FILE__)))) . '/tests/resources/xml/ds_SignatureMethod.xml'
+        );
+    }
+
+
+    /**
+     */
+    public function testMarshalling(): void
+    {
+        $SignatureMethod = new SignatureMethod(Constants::SIG_RSA_SHA256);
+
+        $this->assertEquals(Constants::SIG_RSA_SHA256, $SignatureMethod->getAlgorithm());
+
+        $this->assertEquals($this->document->saveXML($this->document->documentElement), strval($SignatureMethod));
+    }
+
+
+    /**
+     */
+    public function testUnmarshalling(): void
+    {
+        $SignatureMethod = SignatureMethod::fromXML($this->document->documentElement);
+
+        $this->assertEquals(Constants::SIG_RSA_SHA256, $SignatureMethod->getAlgorithm());
+    }
+
+
+    /**
+     * Test serialization / unserialization
+     */
+    public function testSerialization(): void
+    {
+        $this->assertEquals(
+            $this->document->saveXML($this->document->documentElement),
+            strval(unserialize(serialize(SignatureMethod::fromXML($this->document->documentElement))))
+        );
+    }
+}

tests/resources/xml/ds_SignatureMethod.xml

@@ -0,0 +1 @@
+<ds:SignatureMethod xmlns:ds="http://www.w3.org/2000/09/xmldsig#" Algorithm="http://www.w3.org/2001/04/xmldsig-more#rsa-sha256" />