Add functions to get the elements by index of value

Move readers to traits to increase code readability

src/Mods/Reader/AbstractReader.php

@@ -0,0 +1,43 @@
+<?php
+
+/**
+ * Copyright (C) 2024 Saxon State and University Library Dresden
+ *
+ * This file is part of the php-mods-reader.
+ *
+ * @license GNU General Public License version 3 or later.
+ * For the full copyright and license information, please read the
+ * LICENSE.txt file that was distributed with this source code.
+ */
+
+namespace Slub\Mods\Reader;
+
+use Slub\Mods\Element\AbstractElement;
+use Slub\Mods\Element\Xml\Element;
+
+/**
+ * Trait for reading Abstract element
+ */
+trait AbstractReader
+{
+
+    /**
+     * Get the value of the <abstract> element.
+     * @see https://www.loc.gov/standards/mods/userguide/abstract.html
+     *
+     * @access public
+     *
+     * @param string $query for metadata search
+     *
+     * @return ?AbstractElement
+     */
+    public function getAbstract(string $query = ''): ?AbstractElement
+    {
+        $xpath = './mods:abstract' . $query;
+        $element = new Element($this->xml, $xpath);
+        if ($element->exists()) {
+            return new AbstractElement($element->getFirstValue());
+        }
+        return null;
+    }
+}

src/Mods/Reader/AccessConditionReader.php

@@ -0,0 +1,97 @@
+<?php
+
+/**
+ * Copyright (C) 2024 Saxon State and University Library Dresden
+ *
+ * This file is part of the php-mods-reader.
+ *
+ * @license GNU General Public License version 3 or later.
+ * For the full copyright and license information, please read the
+ * LICENSE.txt file that was distributed with this source code.
+ */
+
+namespace Slub\Mods\Reader;
+
+use Slub\Mods\Element\AccessCondition;
+
+/**
+ * Trait for reading AccessCondition element
+ */
+trait AccessConditionReader
+{
+
+    /**
+     * Get the the array of the <accessCondition> elements.
+     * @see https://www.loc.gov/standards/mods/userguide/accesscondition.html
+     *
+     * @access public
+     *
+     * @param string $query for metadata search
+     *
+     * @return AccessCondition[]
+     */
+    public function getAccessConditions(string $query = ''): array
+    {
+        $accessConditions = [];
+        $values = $this->getValues('./mods:accessCondition' . $query);
+        foreach ($values as $value) {
+            $accessConditions[] = new AccessCondition($value);
+        }
+        return $accessConditions;
+    }
+
+    /**
+     * Get the matching <accessCondition> element.
+     * @see https://www.loc.gov/standards/mods/userguide/accesscondition.html
+     *
+     * @access public
+     *
+     * @param int $index of the searched element
+     * @param string $query for metadata search
+     *
+     * @return ?AccessCondition
+     */
+    public function getAccessCondition(int $index, string $query = ''): ?AccessCondition
+    {
+        $values = $this->getValues('./mods:accessCondition' . $query);
+        if (array_key_exists($index, $values)) {
+            return new AccessCondition($values[$index]);
+        }
+        return null;
+    }
+
+    /**
+     * Get the the first matching <accessCondition> element.
+     * @see https://www.loc.gov/standards/mods/userguide/accesscondition.html
+     *
+     * @access public
+     *
+     * @param string $query for metadata search
+     *
+     * @return ?AccessCondition
+     */
+    public function getFirstAccessCondition(string $query = ''): ?AccessCondition
+    {
+        return $this->getAccessCondition(0, $query);
+    }
+
+    /**
+     * Get the the last matching <accessCondition> element.
+     * @see https://www.loc.gov/standards/mods/userguide/accesscondition.html
+     *
+     * @access public
+     *
+     * @param string $query for metadata search
+     *
+     * @return ?AccessCondition
+     */
+    public function getLastAccessCondition(string $query = ''): ?AccessCondition
+    {
+        $elements = $this->getAccessConditions($query);
+        $count = count($elements);
+        if ($count > 0) {
+            return $elements[$count - 1];
+        }
+        return null;
+    }
+}

src/Mods/Reader/ClassificationReader.php

@@ -0,0 +1,96 @@
+<?php
+
+/**
+ * Copyright (C) 2024 Saxon State and University Library Dresden
+ *
+ * This file is part of the php-mods-reader.
+ *
+ * @license GNU General Public License version 3 or later.
+ * For the full copyright and license information, please read the
+ * LICENSE.txt file that was distributed with this source code.
+ */
+
+namespace Slub\Mods\Reader;
+
+use Slub\Mods\Element\Classification;
+
+/**
+ * Trait for reading Classification element
+ */
+trait ClassificationReader
+{
+    /**
+     * Get the the array of the <classification> elements.
+     * @see https://www.loc.gov/standards/mods/userguide/classification.html
+     *
+     * @access public
+     *
+     * @param string $query for metadata search
+     *
+     * @return Classification[]
+     */
+    public function getClassifications(string $query = ''): array
+    {
+        $classifications = [];
+        $values = $this->getValues('./mods:classification' . $query);
+        foreach ($values as $value) {
+            $classifications[] = new Classification($value);
+        }
+        return $classifications;
+    }
+
+    /**
+     * Get the matching <classification> element.
+     * @see https://www.loc.gov/standards/mods/userguide/classification.html
+     *
+     * @access public
+     *
+     * @param int $index of the searched element
+     * @param string $query for metadata search
+     *
+     * @return ?Classification
+     */
+    public function getClassification(int $index, string $query = ''): ?Classification
+    {
+        $values = $this->getValues('./mods:classification' . $query);
+        if (array_key_exists($index, $values)) {
+            return new Classification($values[$index]);
+        }
+        return null;
+    }
+
+    /**
+     * Get the the first matching <classification> element.
+     * @see https://www.loc.gov/standards/mods/userguide/classification.html
+     *
+     * @access public
+     *
+     * @param string $query for metadata search
+     *
+     * @return ?Classification
+     */
+    public function getFirstClassification(string $query = ''): ?Classification
+    {
+        return $this->getClassification(0, $query);
+    }
+
+    /**
+     * Get the the last matching <classification> element.
+     * @see https://www.loc.gov/standards/mods/userguide/classification.html
+     *
+     * @access public
+     *
+     * @param string $query for metadata search
+     *
+     * @return ?Classification
+     */
+    public function getLastClassification(string $query = ''): ?Classification
+    {
+        $elements = $this->getClassifications($query);
+        $count = count($elements);
+        if ($count > 0) {
+            return $elements[$count - 1];
+        }
+        return null;
+    }
+}

src/Mods/Reader/ExtensionReader.php

@@ -0,0 +1,98 @@
+<?php
+
+/**
+ * Copyright (C) 2024 Saxon State and University Library Dresden
+ *
+ * This file is part of the php-mods-reader.
+ *
+ * @license GNU General Public License version 3 or later.
+ * For the full copyright and license information, please read the
+ * LICENSE.txt file that was distributed with this source code.
+ */
+
+namespace Slub\Mods\Reader;
+
+use Slub\Mods\Element\Extension;
+use Slub\Mods\Element\Xml\Element;
+
+/**
+ * Trait for reading Extension element
+ */
+trait ExtensionReader
+{
+
+    /**
+     * Get the the array of the <extension> elements.
+     * @see https://www.loc.gov/standards/mods/userguide/extension.html
+     *
+     * @access public
+     *
+     * @param string $query for metadata search
+     *
+     * @return Extension[]
+     */
+    public function getExtensions(string $query = ''): array
+    {
+        $extensions = [];
+        $values = $this->getValues('./mods:extension' . $query);
+        foreach ($values as $value) {
+            $extensions[] = new Extension($value);
+        }
+        return $extensions;
+    }
+
+    /**
+     * Get the matching <extension> element.
+     * @see https://www.loc.gov/standards/mods/userguide/extension.html
+     *
+     * @access public
+     *
+     * @param int $index of the searched element
+     * @param string $query for metadata search
+     *
+     * @return ?Extension
+     */
+    public function getExtension(int $index, string $query = ''): ?Extension
+    {
+        $values = $this->getValues('./mods:extension' . $query);
+        if (array_key_exists($index, $values)) {
+            return new Extension($values[$index]);
+        }
+        return null;
+    }
+
+    /**
+     * Get the the first matching <extension> element.
+     * @see https://www.loc.gov/standards/mods/userguide/extension.html
+     *
+     * @access public
+     *
+     * @param string $query for metadata search
+     *
+     * @return ?Extension
+     */
+    public function getFirstExtension(string $query = ''): ?Extension
+    {
+        return $this->getExtension(0, $query);
+    }
+
+    /**
+     * Get the the last matching <extension> element.
+     * @see https://www.loc.gov/standards/mods/userguide/extension.html
+     *
+     * @access public
+     *
+     * @param string $query for metadata search
+     *
+     * @return ?Extension
+     */
+    public function getLastExtension(string $query = ''): ?Extension
+    {
+        $elements = $this->getExtensions($query);
+        $count = count($elements);
+        if ($count > 0) {
+            return $elements[$count - 1];
+        }
+        return null;
+    }
+}