ArangoClient\Schema\ManagesViews

Complexity

Total Complexity

14

Size/Duplication

Total Lines	163
Duplicated Lines	0 %

Test Coverage

Coverage

95.56%

Importance

Changes	1
Bugs	0	Features	0

9 Methods

Rating	Name	Duplication	Size	Complexity
A	getViewProperties()	0	7	1
A	deleteView()	0	5	1
A	createView()	0	10	2
A	getView()	0	5	1
A	renameView()	0	10	1
A	getViews()	0	5	1
A	hasView()	0	5	1
A	updateView()	0	19	4
A	replaceView()	0	11	2

<?php

declare(strict_types=1);

namespace ArangoClient\Schema;

use ArangoClient\ArangoClient;
use ArangoClient\Exceptions\ArangoException;

/*
 * @see https://www.arangodb.com/docs/stable/http/views.html
 */
trait ManagesViews
{
    protected ArangoClient $arangoClient;

    /**
     * @see https://www.arangodb.com/docs/stable/http/views-arangosearch.html#create-an-arangosearch-view
     *
     * @param  array<mixed>  $view
     * @return array<mixed>
     * @throws ArangoException
     */
    public function createView(array $view): array
    {
        $view['type'] = isset($view['type']) ? (string) $view['type'] : 'arangosearch';

        $uri = '/_api/view#' . $view['type'];
        $body = json_encode((object) $view);

        $results =  $this->arangoClient->request('post', $uri, ['body' => $body]);

        return $this->sanitizeRequestMetadata($results);

It seems like sanitizeRequestMetadata() must be provided by classes using this trait. How about adding it as abstract method to this trait?

    }

    /**
     * @see https://www.arangodb.com/docs/stable/http/views-arangosearch.html#drops-a-view
     *
     * @param  string  $name
     * @return bool
     * @throws ArangoException
     */
    public function deleteView(string $name): bool
    {
        $uri = '/_api/view/' . $name;

        return (bool) $this->arangoClient->request('delete', $uri);
    }

    /**
     * @see https://www.arangodb.com/docs/stable/http/views-arangosearch.html#list-all-views
     *
     * @return array<mixed>
     * @throws ArangoException
     */
    public function getViews(): array
    {
        $results = $this->arangoClient->request('get', '/_api/view');

        return (array) $results['result'];
    }

    /**
     * Check for view existence
     *
     * @param  string  $name
     * @return bool
     * @throws ArangoException
     */
    public function hasView(string $name): bool
    {
        $views = $this->getViews();

        return array_search($name, array_column($views, 'name'), true) !== false;
    }

    /**
     * @see https://www.arangodb.com/docs/stable/http/views-arangosearch.html#return-information-about-a-view
     *
     * @param  string  $name
     * @return array<mixed>
     * @throws ArangoException
     */
    public function getView(string $name): array
    {
        $result =  $this->getViewProperties($name);

        return $this->sanitizeRequestMetadata($result);
    }

    /**
     * @see https://www.arangodb.com/docs/stable/http/views-arangosearch.html#read-properties-of-a-view
     *
     * @param  string  $name
     * @return array<mixed>
     * @throws ArangoException
     */
    public function getViewProperties(string $name): array
    {
        $uri = '/_api/view/' . $name . '/properties';

        $result =  $this->arangoClient->request('get', $uri);

        return $this->sanitizeRequestMetadata($result);
    }

    /**
     * @param  string  $old
     * @param  string  $new
     * @return array<mixed>
     * @throws ArangoException
     */
    public function renameView(string $old, string $new): array
    {
        $uri = '/_api/view/' . $old . '/rename';

        $body = json_encode((object) ['name' => $new]);
        $options = ['body' => $body];

        $result = $this->arangoClient->request('put', $uri, $options);

        return $this->sanitizeRequestMetadata($result);
    }

    /**
     * @see https://www.arangodb.com/docs/stable/http/views-arangosearch.html#partially-changes-properties-of-an-arangosearch-view
     *
     * @param  string  $name
     * @param  array<mixed>  $properties
     * @return array<mixed>
     * @throws ArangoException
     */
    public function updateView(string $name, array $properties): array
    {
        // PrimarySort & primarySortCompression are immutable and will throw if we try to change it.
        // Use replaceView if you want to update these properties.
        if (isset($properties['primarySort'])) {
            unset($properties['primarySort']);
        }
        if (isset($properties['primarySortCompression'])) {
            unset($properties['primarySortCompression']);
        }

        $properties['type'] = isset($properties['type']) ? (string) $properties['type'] : 'arangosearch';

        $uri = '/_api/view/' . $name . '/properties#' . $properties['type'];
        $body = json_encode((object) $properties);
        $options = ['body' => $body];

        $result = $this->arangoClient->request('patch', $uri, $options);
        return $this->sanitizeRequestMetadata($result);
    }

    /**
     * Replace an existing view. Use this to change immutable fields like primarySort. Note that
     * this is just a shorthand for delete(old)/create(new). ArangoDB will have to rebuild the view data.
     *
     * @see https://www.arangodb.com/docs/stable/http/views-arangosearch.html#create-an-arangosearch-view
     *
     * @param string $name
     * @param array<mixed> $newView
     * @return false|array<mixed>
     * @throws ArangoException
     */
    public function replaceView(string $name, array $newView)
    {
        if (! $this->hasView($name)) {
            return false;
        }
        $this->deleteView($name);

        // Enforce the view name
        $newView['name'] = $name;

        return $this->createView($newView);
    }
}