alsvanzelf\jsonapi\objects\LinksObject

Complexity

Total Complexity

27

Size/Duplication

Total Lines	178
Duplicated Lines	28.65 %

Coupling/Cohesion

Components	1
Dependencies	6

Importance

Changes

0

10 Methods

Rating	Name	Duplication	Size	Complexity
A	fromArray()	0	9	2
A	fromObject()	0	5	1
A	add()	0	8	2
A	append()	12	12	3
A	addLinkString()	9	9	2
A	addLinkObject()	9	9	2
A	addLinksArray()	9	9	2
A	appendLinkObject()	12	12	3
A	isEmpty()	0	3	2
B	toArray()	0	20	8

<?php

namespace alsvanzelf\jsonapi\objects;

use alsvanzelf\jsonapi\exceptions\DuplicateException;
use alsvanzelf\jsonapi\helpers\AtMemberManager;
use alsvanzelf\jsonapi\helpers\Converter;
use alsvanzelf\jsonapi\helpers\Validator;
use alsvanzelf\jsonapi\interfaces\ObjectInterface;
use alsvanzelf\jsonapi\objects\LinkObject;
use alsvanzelf\jsonapi\objects\LinksArray;

class LinksObject implements ObjectInterface {

Missing doc comment for class LinksObject

	use AtMemberManager;
	
	/** @var array with string|LinkObject */
	protected $links = [];
	
	/**
	 * human api
	 */
	
	/**
	 * @param  array  $links key-value with values being href strings

Expected 1 spaces after parameter type; 2 found

	 * @return LinksObject
	 */
	public static function fromArray(array $links) {
		$linksObject = new self();
		
		foreach ($links as $key => $href) {
			$linksObject->add($key, $href);
		}
		
		return $linksObject;
	}
	
	/**
	 * @param  object $links

Missing parameter comment

	 * @return LinksObject
	 */
	public static function fromObject($links) {
		$array = Converter::objectToArray($links);
		
		return self::fromArray($array);
	}
	
	/**
	 * @param string $key

Missing parameter comment

	 * @param string $href

Missing parameter comment

	 * @param array  $meta optional, if given a LinkObject is added, otherwise a link string is added
	 */

Missing @return tag in function comment

	public function add($key, $href, array $meta=[]) {
		if ($meta === []) {
			$this->addLinkString($key, $href);
		}
		else {
			$this->addLinkObject($key, new LinkObject($href, $meta));
		}
	}
	
	/**
	 * appends a link to an array of links under a specific key
	 * 
	 * @see LinksArray for use cases
	 * 
	 * @param string $key

Missing parameter comment

	 * @param string $href

Missing parameter comment

	 * @param array  $meta optional, if given a LinkObject is added, otherwise a link string is added
	 * 
	 * @throws DuplicateException if another link is already using that $key but is not an array
	 */

Missing @return tag in function comment

	public function append($key, $href, array $meta=[]) {

This method seems to be duplicated in your project.

		Validator::checkMemberName($key);
		
		if (isset($this->links[$key]) === false) {
			$this->addLinksArray($key, new LinksArray());
		}
		elseif ($this->links[$key] instanceof LinksArray === false) {
			throw new DuplicateException('can not add to key "'.$key.'", it is not an array of links');
		}
		
		$this->links[$key]->add($href, $meta);
	}
	
	/**
	 * spec api
	 */
	
	/**
	 * @param string $key

Missing parameter comment

	 * @param string $href

Missing parameter comment

	 * 
	 * @throws DuplicateException if another link is already using that $key
	 */

Missing @return tag in function comment

	public function addLinkString($key, $href) {

This method seems to be duplicated in your project.

		Validator::checkMemberName($key);
		
		if (isset($this->links[$key])) {
			throw new DuplicateException('link with key "'.$key.'" already set');
		}
		
		$this->links[$key] = $href;
	}
	
	/**
	 * @param string     $key

Missing parameter comment

	 * @param LinkObject $linkObject

Missing parameter comment

	 * 
	 * @throws DuplicateException if another link is already using that $key
	 */

Missing @return tag in function comment

	public function addLinkObject($key, LinkObject $linkObject) {

This method seems to be duplicated in your project.

		Validator::checkMemberName($key);
		
		if (isset($this->links[$key])) {
			throw new DuplicateException('link with key "'.$key.'" already set');
		}
		
		$this->links[$key] = $linkObject;
	}
	
	/**
	 * @param string     $key

Missing parameter comment

	 * @param LinksArray $linksArray

Missing parameter comment

	 * 
	 * @throws DuplicateException if another link is already using that $key
	 */

Missing @return tag in function comment

	public function addLinksArray($key, LinksArray $linksArray) {

This method seems to be duplicated in your project.

		Validator::checkMemberName($key);
		
		if (isset($this->links[$key])) {
			throw new DuplicateException('link with key "'.$key.'" already set');
		}
		
		$this->links[$key] = $linksArray;
	}
	
	/**
	 * @param  string     $key

Missing parameter comment

	 * @param  LinkObject $linkObject

Missing parameter comment

	 * 
	 * @throws DuplicateException if another link is already using that $key but is not an array
	 */

Missing @return tag in function comment

	public function appendLinkObject($key, LinkObject $linkObject) {

This method seems to be duplicated in your project.

		Validator::checkMemberName($key);
		
		if (isset($this->links[$key]) === false) {
			$this->addLinksArray($key, new LinksArray());
		}
		elseif ($this->links[$key] instanceof LinksArray === false) {
			throw new DuplicateException('can not add to key "'.$key.'", it is not an array of links');
		}
		
		$this->links[$key]->addLinkObject($linkObject);
	}
	
	/**
	 * ObjectInterface
	 */
	
	/**
	 * @inheritDoc
	 */

Missing @return tag in function comment

	public function isEmpty() {
		return ($this->links === [] && $this->hasAtMembers() === false);
	}
	
	/**
	 * @inheritDoc
	 */

Missing @return tag in function comment

	public function toArray() {
		$array = $this->getAtMembers();
		
		foreach ($this->links as $key => $link) {
			if ($link instanceof LinkObject && $link->isEmpty() === false) {
				$array[$key] = $link->toArray();
			}
			elseif ($link instanceof LinksArray && $link->isEmpty() === false) {
				$array[$key] = $link->toArray();
			}
			elseif ($link instanceof LinkObject && $link->isEmpty()) {
				$array[$key] = null;
			}
			else { // string or null
				$array[$key] = $link;
			}
		}
		
		return $array;
	}
}