Error.php

<?php

declare(strict_types=1);

// SPDX-FileCopyrightText: 2015-2023 Artur Weigandt https://wlabs.de/kontakt
//
// SPDX-License-Identifier: GPL-3.0-or-later

namespace Art4\JsonApiClient\V1;

use Art4\JsonApiClient\Exception\AccessException;
use Art4\JsonApiClient\Exception\ValidationException;
use Art4\JsonApiClient\Helper\AbstractElement;
use Art4\JsonApiClient\Helper\AccessKey;

/**
 * Error Object
 *
 * @see http://jsonapi.org/format/#error-objects
 */
final class Error extends AbstractElement
{
    /**
     * Parses the data for this element
     *
     * @throws ValidationException
     */
    protected function parse(mixed $object): void
    {
        if (!is_object($object)) {
            throw new ValidationException(
                'Error has to be an object, "' . gettype($object) . '" given.'
            );
        }

        foreach (get_object_vars($object) as $key => $value) {
            if ($key === 'id') {
                if (!is_string($value)) {
                    throw new ValidationException(
                        'property "id" has to be a string, "' .
                        gettype($value) . '" given.'
                    );
                }

                $this->set('id', strval($value));
            } elseif ($key === 'links') {
                $this->set('links', $this->create('ErrorLink', $value));
            } elseif ($key === 'status') {
                if (!is_string($value)) {
                    throw new ValidationException(
                        'property "status" has to be a string, "' .
                        gettype($value) . '" given.'
                    );
                }

                $this->set('status', strval($value));
            } elseif ($key === 'code') {
                if (!is_string($value)) {
                    throw new ValidationException(
                        'property "code" has to be a string, "' .
                        gettype($value) . '" given.'
                    );
                }

                $this->set('code', strval($value));
            } elseif ($key === 'title') {
                if (!is_string($value)) {
                    throw new ValidationException(
                        'property "title" has to be a string, "' .
                        gettype($value) . '" given.'
                    );
                }

                $this->set('title', strval($value));
            } elseif ($key === 'detail') {
                if (!is_string($value)) {
                    throw new ValidationException(
                        'property "detail" has to be a string, "' .
                        gettype($value) . '" given.'
                    );
                }

                $this->set('detail', strval($value));
            } elseif ($key === 'source') {
                $this->set('source', $this->create('ErrorSource', $value));
            } elseif ($key === 'meta') {
                $this->set('meta', $this->create('Meta', $value));
            } else {
                $this->set($key, $value);
            }
        }
    }

    /**
     * Get a value by the key of this object
     *
     * @param int|string|AccessKey<string> $key The key of the value
     */
    public function get($key): mixed
    {
        try {
            return parent::get($key);
        } catch (AccessException $e) {
            throw new AccessException(
                '"' . $key . '" doesn\'t exist in this error object.'
            );
        }
    }
}