Zepi\Turbo\Request\RequestAbstract

Complexity

Total Complexity

24

Size/Duplication

Total Lines	248
Duplicated Lines	0 %

Coupling/Cohesion

Components	3
Dependencies	0

Test Coverage

Coverage

96.23%

Importance

Changes

0

13 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	19	4
A	getRoute()	0	4	1
A	setRoute()	0	4	1
A	hasParam()	0	4	1
A	getParam()	0	8	2
A	getParams()	0	4	1
A	addRouteParam()	0	8	2
A	setRouteParams()	0	10	2
A	getRouteParam()	0	8	2
	getRouteDelimiter()	0	1	?
B	getFullRoute()	0	18	6
A	getLocale()	0	4	1
A	getOperatingSystem()	0	4	1

<?php
/*
 * The MIT License (MIT)
 *
 * Copyright (c) 2015 zepi
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 */

/**
 * The abstract RequestAbstract is the base for all request types
 * 
 * @package Zepi\Turbo\Request
 * @author Matthias Zobrist <matthias.zobrist@zepi.net>
 * @copyright Copyright (c) 2015 zepi
 */

namespace Zepi\Turbo\Request;

/**
 * The abstract RequestAbstract is the base for all request types
 * 
 * @author Matthias Zobrist <matthias.zobrist@zepi.net>
 * @copyright Copyright (c) 2015 zepi
 */
abstract class RequestAbstract
{
    const OS_LINUX = 'linux';
    const OS_WINDOWS = 'windows';
    const OS_UNKNOWN = 'unknown';
    
    /**
     * @access protected
     * @var string
     */
    protected $route;
    
    /**
     * @access protected
     * @var array
     */
    protected $params = array();
    
    /**
     * @access protected
     * @var array
     */
    protected $routeParams = array();
    
    /**
     * @access protected
     * @var string
     */
    protected $base;
    
    /**
     * @access protected
     * @var string
     */
    protected $locale;
    
    /**
     * @access protected
     * @var string
     */
    protected $operatingSystem;
    
    /**
     * @access protected
     * @var array
     */
    protected $data = array();
    
    /**
     * Constructs the object
     * 
     * @access public
     * @param string $route
     * @param array params
     * @param string $base
     * @param string $locale
     * @param string $operatingSystem
     * @param array $data
     */
    public function __construct($route, $params, $base, $locale, $operatingSystem, $data = array())
    {
        $this->route = $route;
        $this->locale = $locale;
        $this->operatingSystem = $operatingSystem;
        
        if (is_array($params)) {
            $this->params = $params; 
        }
        
        if (substr($base, -1) === '/') {
            $base = substr($base, 0, -1);
        }
        $this->base = $base;
        
        if (is_array($data)) {
            $this->data = $data;
        }
    }
    
    /**
     * Returns the route of the request.
     * 
     * @access public
     * @return string
     */
    public function getRoute()
    {
        return $this->route;
    }
    
    /**
     * Sets the route of the request
     * 
     * @access public
     * @param string $route
     */
    public function setRoute($route)
    {
        $this->route = $route;
    }
    
    /**
     * Returns true if the given param key exists.
     * 
     * @access public
     * @param string $key
     * @return string
     */
    public function hasParam($key)
    {
        return (isset($this->params[$key]));
    }
    
    /**
     * Returns the value for the given param key. If the
     * key does not exists the function will return false.
     * 
     * @access public
     * @param string $key
     * @return mixed
     */
    public function getParam($key)
    {
        if (!$this->hasParam($key)) {
            return false;
        }
        
        return $this->params[$key];
    }
    
    /**
     * Returns all params of the request
     * 
     * @access public
     * @return array
     */
    public function getParams()
    {
        return $this->params;
    }
    
    /**
     * Adds an parameter which is detected in the route.
     * 
     * @access public
     * @param mixed $param
     * @param string $key
     */
    public function addRouteParam($param, $key = '')
    {
        $this->routeParams[] = $param;
        
        if ($key != '') {
            $this->routeParams[$key]= $param;
        }
    }
    
    /**
     * Sets the array of route params for the request
     * 
     * @access public
     * @param array $params
     * @return boolean
     */
    public function setRouteParams($params)
    {
        if (!is_array($params)) {
            return false;
        }
        
        $this->routeParams = $params;
        
        return true;
    }
    
    /**
     * Returns the route param for the given index.
     * 
     * @access public
     * @param integer|string $key
     * @return false|mixed
     */
    public function getRouteParam($key)
    {
        if (!isset($this->routeParams[$key])) {
            return false;
        }
        
        return $this->routeParams[$key];
    }
    
    /**
     * Returns the delimitier, which is used to split the route
     * into parts.
     * 
     * @access public
     * @return string
     */
    abstract public function getRouteDelimiter();
    
    /**
     * Returns the correct url for the given url part
     * 
     * @access public
     * @param string $routePart
     * @return string
     */
    public function getFullRoute($routePart = '')
    {
        if ($routePart == '') {
            $routePart = $this->route;
        }
        
        $delimiter = $this->getRouteDelimiter();
        if (substr($routePart, 0, strlen($delimiter)) !== $delimiter) {
            $routePart = $delimiter . $routePart;
        }
        
        $posPoint = strrpos($routePart, '.');
        if (substr($routePart, -1) !== $delimiter && ($posPoint === false || $posPoint < strrpos($routePart, $delimiter))) {
            $routePart .= $delimiter;
        }
        
        return $this->base . $routePart;
    }
    
    /**
     * Returns the locale of the request
     * 
     * @access public
     * @return string
     */
    public function getLocale()
    {
        return $this->locale;
    }
    
    /**
     * Returns the operating system of the machine
     *
     * @access public
     * @return string
     */
    public function getOperatingSystem()
    {
        return $this->operatingSystem;
    }
}