CarbonFramework\Routing\Handler

Complexity

Total Complexity

14

Size/Duplication

Total Lines	110
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	1

Test Coverage

Coverage

0%

Importance

Changes	5
Bugs	1	Features	0

6 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	3	1
A	parse()	0	11	3
A	parseFromString()	0	15	3
A	executeHandler()	0	12	2
A	set()	0	9	2
A	execute()	0	13	3

<?php

namespace CarbonFramework\Routing;

use Closure;
use Exception;
use CarbonFramework\Framework;

/**
 * Represent a callable or a controller method to be executed in response to a request
 */
class Handler {
	/**
	 * Actual handler
	 *
	 * @var callable|array|null
	 */
	protected $handler = null;

	/**
	 * Constructor
	 *
	 * @param string|callable $handler
	 */
	public function __construct( $handler ) {
		$this->set( $handler );
	}

	/**
	 * Parse a handler to a callable or a [class, method] array
	 *
	 * @param  string|callable     $handler
	 * @return callable|array|null
	 */
	protected function parse( $handler ) {
		if ( $handler instanceof Closure ) {
			return $handler;
		}

		if ( is_string( $handler ) )  {
			return $this->parseFromString( $handler );
		}

		return null;
	}

	/**
	 * Parse a string handler to a callable or a [class, method] array
	 *
	 * @param  string              $handler
	 * @return callable|array|null
	 */
	protected function parseFromString( $handler ) {
		$handlerPieces = preg_split( '/@|::/', $handler, 2 );

		if ( count( $handlerPieces ) === 1 ) {
			if ( is_callable( $handlerPieces[0] ) ) {
				return $handlerPieces[0];
			}
			return null;
		}

		return array(
			'class' => $handlerPieces[0],
			'method' => $handlerPieces[1],
		);
	}

	/**
	 * Execute the handler returning raw result
	 *
	 * @return string|array|\Psr\Http\Message\ResponseInterface
	 */
	protected function executeHandler() {
		$arguments = func_get_args();
		if ( is_callable( $this->handler ) ) {
			return call_user_func_array( $this->handler, $arguments );
		}

		$class = $this->handler['class'];
		$method = $this->handler['method'];

		$controller = Framework::instantiate( $class );
		return call_user_func_array( [$controller, $method], $arguments );
	}

	/**
	 * Set the handler
	 *
	 * @param  string|callable $new_handler
	 * @return null
	 */
	public function set( $new_handler ) {
		$handler = $this->parse( $new_handler );

		if ( $handler === null ) {
			throw new Exception( 'No or invalid handler provided.' );
		}

		$this->handler = $handler;
	}

	/**
	 * Execute the handler
	 *
	 * @return \Psr\Http\Message\ResponseInterface
	 */
	public function execute() {
		$response = call_user_func_array( [$this, 'executeHandler'], func_get_args() );

		if ( is_string( $response ) ) {
			return cf_output( $response );
		}

		if ( is_array( $response ) ) {
			return cf_json( $response );
		}

		return $response;
	}
}