Huntie\JsonApi\Serializers\JsonApiSerializer

Complexity

Total Complexity

12

Size/Duplication

Total Lines	129
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	2

Importance

Changes

0

10 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	5	1
	getPrimaryData()	0	1	?
A	getIncluded()	0	4	1
A	setBaseUrl()	0	5	1
A	addMeta()	0	4	2
A	addLinks()	0	4	2
A	serializeToObject()	0	10	1
A	jsonSerialize()	0	4	1
A	serializeToJson()	0	4	1
A	getDocumentMeta()	0	6	2

<?php

namespace Huntie\JsonApi\Serializers;

use JsonSerializable;
use Request;

abstract class JsonApiSerializer implements JsonSerializable
{
    /**
     * The JSON API version being implemented.
     *
     * @var string
     */
    const JSON_API_VERSION = '1.0';

    /**
     * The base URL for links.
     *
     * @var string
     */
    protected $baseUrl;

    /**
     * Meta information to include.
     *
     * @var array
     */
    protected $meta = [];

    /**
     * Resource links to include.
     *
     * @var array
     */
    protected $links = [];

    /**
     * Create a new JSON API document serializer.
     */
    public function __construct()
    {
        $this->baseUrl = Request::url();
        $this->addLinks('self', Request::fullUrl());
    }

    /**
     * Return primary data for the JSON API document.
     *
     * @return mixed
     */
    abstract protected function getPrimaryData();

    /**
     * Return any secondary included resource objects.
     *
     * @return \Illuminate\Support\Collection
     */
    public function getIncluded()
    {
        return collect();
    }

    /**
     * Set the base URL for document links.
     *
     * @param string $url
     */
    public function setBaseUrl(string $url)
    {
        $this->baseUrl = preg_replace('/\/$/', '', $url);
        $this->addLinks('self', str_replace(Request::url(), $this->baseUrl, Request::fullUrl()));
    }

    /**
     * Add included meta information.
     *
     * @param string|array    $key
     * @param string|int|null $value
     */
    public function addMeta($key, $value = null)
    {
        $this->meta = array_merge($this->meta, is_array($key) ? $key : [$key => $value]);
    }

    /**
     * Add one or more included links.
     *
     * @param string|array    $key
     * @param string|int|null $value
     */
    public function addLinks($key, $value = null)
    {
        $this->links = array_merge($this->links, is_array($key) ? $key : [$key => $value]);
    }

    /**
     * Serialise JSON API document to an array.
     */
    public function serializeToObject(): array
    {
        return array_filter([
            'data' => $this->getPrimaryData(),
            'links' => $this->links,
            'meta' => $this->meta,
            'included' => $this->getIncluded()->toArray(),
            'jsonapi' => $this->getDocumentMeta(),
        ]);
    }

    /**
     * Convert the object into something JSON serializable.
     */
    public function jsonSerialize(): array
    {
        return $this->serializeToObject();
    }

    /**
     * Serialise JSON API document to a JSON string.
     */
    public function serializeToJson(): string
    {
        return json_encode($this->jsonSerialize());
    }

    /**
     * Return JSON API implementation information.
     */
    private function getDocumentMeta(): array
    {
        return array_filter([
            'version' => config('jsonapi.include_version') ? self::JSON_API_VERSION : null,
        ]);
    }
}