OpenStack\Common\Api\AbstractParams

Complexity

Total Complexity

8

Size/Duplication

Total Lines	96
Duplicated Lines	0 %

Coupling/Cohesion

Components	0
Dependencies	0

Importance

Changes	4
Bugs	0	Features	2

8 Methods

Rating	Name	Duplication	Size	Complexity
A	isSupportedLocation()	0	4	1
A	idPath()	0	8	1
A	sortDir()	0	9	1
A	sortKey()	0	8	1
A	limit()	0	11	1
A	marker()	0	12	1
A	id()	0	8	1
A	name()	0	8	1

<?php declare (strict_types=1);

namespace OpenStack\Common\Api;

abstract class AbstractParams
{
    // locations
    const QUERY = 'query';
    const HEADER = 'header';
    const URL = 'url';
    const JSON = 'json';
    const RAW = 'raw';

    // types
    const STRING_TYPE = "string";
    const BOOL_TYPE = "boolean";
    const BOOLEAN_TYPE = self::BOOL_TYPE;
    const OBJECT_TYPE = "object";
    const ARRAY_TYPE = "array";
    const NULL_TYPE = "NULL";
    const INT_TYPE = 'integer';
    const INTEGER_TYPE = self::INT_TYPE;

    public static function isSupportedLocation(string $val): bool
    {
        return in_array($val, [self::QUERY, self::HEADER, self::URL, self::JSON, self::RAW]);
    }

    public function limit(): array
    {
        return [
            'type'        => self::INT_TYPE,
            'location'    => 'query',
            'description' => <<<DESC
This will limit the total amount of elements returned in a list up to the number specified. For example, specifying a
limit of 10 will return 10 elements, regardless of the actual count.
DESC
        ];
    }

    public function marker(): array
    {
        return [
            'type'        => 'string',
            'location'    => 'query',
            'description' => <<<DESC
Specifying a marker will begin the list from the value specified. Elements will have a particular attribute that
identifies them, such as a name or ID. The marker value will search for an element whose identifying attribute matches
the marker value, and begin the list from there.
DESC
        ];
    }

    public function id(string $type): array
    {
        return [
            'description' => sprintf("The unique ID, or identifier, for the %s", $type),
            'type'        => self::STRING_TYPE,
            'location'    => self::JSON,
        ];
    }

    public function idPath(): array
    {
        return [
            'type'        => self::STRING_TYPE,
            'location'    => self::URL,
            'description' => 'The unique ID of the resource',
        ];
    }

    public function name(string $resource): array
    {
        return [
            'description' => sprintf("The name of the %s", $resource),
            'type'        => self::STRING_TYPE,
            'location'    => self::JSON,
        ];
    }


    public function sortDir(): array
    {
        return [
            'type'        => self::STRING_TYPE,
            'location'    => self::QUERY,
            'description' => "Sorts by one or more sets of attribute and sort direction combinations.",
            'enum'        => ['asc', 'desc']
        ];
    }

    public function sortKey(): array
    {
        return [
            'type'     => self::STRING_TYPE,
            'location' => self::QUERY,
            'description' => "Sorts by one or more sets of attribute and sort direction combinations.",
        ];
    }
}