Tenside\CoreBundle\Annotation\TensideApiDocHandler

Complexity

Total Complexity

21

Size/Duplication

Total Lines	121
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	3

Importance

Changes	3
Bugs	0	Features	0

4 Methods

Rating	Name	Duplication	Size	Complexity
B	handle()	0	25	6
C	convertField()	0	24	7
B	convertChildren()	0	15	5
A	inferType()	0	9	3

<?php

/**
 * This file is part of tenside/core-bundle.
 *
 * (c) Christian Schiffler <c.schiffler@cyberspectrum.de>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 *
 * This project is provided in good faith and hope to be usable by anyone.
 *
 * @package    tenside/core-bundle
 * @author     Christian Schiffler <c.schiffler@cyberspectrum.de>
 * @copyright  2015 Christian Schiffler <c.schiffler@cyberspectrum.de>
 * @license    https://github.com/tenside/core-bundle/blob/master/LICENSE MIT
 * @link       https://github.com/tenside/core-bundle
 * @filesource
 */

namespace Tenside\CoreBundle\Annotation;

use Nelmio\ApiDocBundle\Annotation\ApiDoc;
use Nelmio\ApiDocBundle\DataTypes;
use Nelmio\ApiDocBundle\Extractor\HandlerInterface;
use Symfony\Component\Routing\Route;

/**
 * This class parses the API annotation.
 */
class TensideApiDocHandler implements HandlerInterface
{
    /**
     * The field names of parameters to convert by default.
     *
     * @var array
     */
    public static $convertFields = [
        'default',
        'description',
        'format',
        'actualType',
        'subType',
        'sinceVersion',
        'untilVersion',
        'requirement'
    ];

    /**
     * {@inheritdoc}
     */
    public function handle(ApiDoc $annotation, array $annotations, Route $route, \ReflectionMethod $method)
    {
        foreach ($annotations as $description) {
            if (!($description instanceof ApiDescription)) {
                continue;
            }

            $current = $annotation->toArray();

            $request = [];
            foreach ($description->getRequest() as $name => $field) {
                $request[$name] = $this->convertField($field);
            }
            $annotation->setParameters($request);

            if (!isset($current['response'])) {
                $response = [];
                foreach ($description->getResponse() as $name => $field) {
                    $response[$name] = $this->convertField($field);
                }

                $annotation->setResponse($response);
            }
        }
    }

    /**
     * Convert the annotation for a field.
     *
     * @param array $array The information for the field.
     *
     * @return array
     */
    private function convertField($array)
    {
        $result = [];

        // Copy over well known keys.
        foreach (static::$convertFields as $key) {
            if (isset($array[$key])) {
                $result[$key] = $array[$key];
            }
        }

        if (isset($array['dataType'])) {
            $result['dataType'] = $this->inferType($array['dataType']);
        } else {
            $result['dataType'] = isset($array['children']) ? 'object' : DataTypes::STRING;
        }

        $result['required'] = isset($array['required']) && (bool) $array['required'];
        $result['readonly'] = isset($array['readonly']) && (bool) $array['readonly'];

        $result = $this->convertChildren($array, $result);

        return $result;
    }

    /**
     * Convert the children key of an array.
     *
     * @param array $array  The source array.
     *
     * @param array $result The partly converted array.
     *
     * @return array
     */
    private function convertChildren($array, $result)
    {
        if (isset($array['children'])) {
            foreach ($array['children'] as $key => $value) {
                $result['children'][$key] = $this->convertField($value);
                if (isset($result['children'][$key]['required'])) {
                    $result['required'] = $result['required'] || (bool) $result['children'][$key]['required'];
                }
            }

            return $result;
        }

        return $result;
    }

    /**
     * Convert the type.
     *
     * @param string $type The type name.
     *
     * @return string
     */
    public function inferType($type)
    {
        if (DataTypes::isPrimitive($type)) {
            return $type;
        } elseif (DataTypes::COLLECTION === strtolower($type)) {
            return $type;
        }
        return DataTypes::STRING;
    }
}