Phossa2\Db\Traits\ConnectTrait

Complexity

Total Complexity

18

Size/Duplication

Total Lines	183
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	1

Importance

Changes	5
Bugs	0	Features	1

14 Methods

Rating	Name	Duplication	Size	Complexity
A	connect()	0	14	3
A	disconnect()	0	8	2
A	isConnected()	0	4	1
A	ping()	0	9	2
A	getLink()	0	5	1
A	setAttribute()	0	8	2
A	getAttribute()	0	13	4
A	setDefaultAttributes()	0	8	3
	realConnect()	0	1	?
	realDisconnect()	0	1	?
	realPing()	0	1	?
	realSetAttribute()	0	4	?
	realGetAttribute()	0	1	?
	setError()	0	4	?

<?php
/**
 * Phossa Project
 *
 * PHP version 5.4
 *
 * @category  Library
 * @package   Phossa2\Db
 * @copyright Copyright (c) 2016 phossa.com
 * @license   http://mit-license.org/ MIT License
 * @link      http://www.phossa.com/
 */
/*# declare(strict_types=1); */

namespace Phossa2\Db\Traits;

use Phossa2\Db\Exception\LogicException;
use Phossa2\Db\Interfaces\ConnectInterface;

/**
 * ConnectTrait
 *
 * Implementation of ConnectInterface
 *
 * @package Phossa2\Db
 * @author  Hong Zhang <phossa@126.com>
 * @see     ConnectInterface
 * @version 2.0.0
 * @since   2.0.0 added
 */
trait ConnectTrait
{
    /**
     * the connection link
     *
     * @var    mixed
     * @access protected
     */
    protected $link;

    /**
     * connect parameters
     *
     * @var    array
     * @access protected
     */
    protected $connect_parameters = [];

    /**
     * connection attributes
     *
     * @var    array
     * @access protected
     */
    protected $attributes = [];

    /**
     * {@inheritDoc}
     */
    public function connect()
    {
        if ($this->isConnected()) {
            return $this;
        }

        try {
            $this->link = $this->realConnect($this->connect_parameters);
            $this->setDefaultAttributes();
        } catch (\Exception $e) {
            throw new LogicException($e->getMessage(), $e->getCode());
        }
        return $this;
    }

    /**
     * {@inheritDoc}
     */
    public function disconnect()
    {
        if ($this->isConnected()) {
            $this->realDisconnect();
            $this->link = null;
        }
        return $this;
    }

    /**
     * {@inheritDoc}
     */
    public function isConnected()/*# : bool */
    {
        return null !== $this->link;
    }

    /**
     * {@inheritDoc}
     */
    public function ping()/*# : bool */
    {
        try {
            $this->connect();
        } catch (\Exception $e) {
            return $this->setError($e->getMessage(), $e->getCode());
        }
        return $this->realPing();
    }

    /**
     * {@inheritDoc}
     */
    public function getLink()
    {
        $this->connect();
        return $this->link;
    }

    /**
     * {@inheritDoc}
     */
    public function setAttribute(/*# string */ $attribute, $value)
    {
        $this->attributes[$attribute] = $value;
        if ($this->isConnected()) {
            $this->realSetAttribute($attribute, $value);
        }
        return $this;
    }

    /**
     * {@inheritDoc}
     */
    public function getAttribute(/*# string */ $attribute)
    {
        // current attribute
        $curr = isset($this->attributes[$attribute]) ?
            $this->attributes[$attribute] : null;

        if ($this->isConnected()) {
            $real = $this->realGetAttribute($attribute);
            return $real ?: $curr;
        } else {
            return $curr;
        }
    }

    /**
     * Set default attributes
     *
     * @access protected
     */
    protected function setDefaultAttributes()
    {
        if (!empty($this->attributes)) {
            foreach ($this->attributes as $attr => $val) {
                $this->realSetAttribute($attr, $val);
            }
        }
    }

    /**
     * Driver specific connect
     *
     * @param  array $parameters
     * @return mixed the link
     * @throws \Exception
     * @access protected
     */
    abstract protected function realConnect(array $parameters);

    /**
     * Driver specific disconnect
     *
     * @access protected
     */
    abstract protected function realDisconnect();

    /**
     * Driver related ping
     *
     * @return bool
     * @access protected
     */
    abstract protected function realPing()/*# : bool */;

    /**
     * Set connection specific attribute
     *
     * @param  string attribute
     * @param  mixed $value
     * @throws LogicException if attribute unknown
     * @access protected
     */
    abstract protected function realSetAttribute(
        /*# string */ $attribute,
        $value
    );

    /**
     * Get connection specific attribute
     *
     * @param  string attribute
     * @return mixed|null
     * @throws LogicException if attribute unknown
     * @access protected
     */
    abstract protected function realGetAttribute(/*# string */ $attribute);

    // from ErrorAwareInterface
    abstract public function setError(
        /*# string */ $message = '',
        /*# string */ $code = ''
    )/*# : bool */;
}