1:   2:   3:   4:   5:   6:   7:   8:   9:  10:  11:  12:  13:  14:  15:  16:  17:  18:  19:  20:  21:  22:  23:  24:  25:  26:  27:  28:  29:  30:  31:  32:  33:  34:  35:  36:  37:  38:  39:  40:  41:  42:  43:  44:  45:  46:  47:  48:  49:  50:  51:  52:  53:  54:  55:  56:  57:  58:  59:  60:  61:  62:  63:  64:  65:  66:  67:  68:  69:  70:  71:  72:  73:  74:  75:  76:  77:  78:  79:  80:  81:  82:  83:  84:  85:  86:  87:  88:  89:  90:  91:  92:  93:  94:  95:  96:  97:  98:  99: 100: 101: 102: 103: 104: 105: 106: 107: 108: 109: 110: 111: 112: 113: 114: 115: 

<?php

/**
 * MvcCore
 *
 * This source file is subject to the BSD 3 License
 * For the full copyright and license information, please view
 * the LICENSE.md file that are distributed with this source code.
 *
 * @copyright   Copyright (c) 2016 Tom Flidr (https://github.com/mvccore)
 * @license  https://mvccore.github.io/docs/mvccore/5.0.0/LICENCE.md
 */

namespace MvcCore\Model;

trait MagicMethods {
    
    /**
     * @inheritDocs
     * @param string $rawName
     * @param array  $arguments
     * @throws \InvalidArgumentException If `strtolower($rawName)` doesn't begin with `"get"` or with `"set"`.
     * @return mixed|\MvcCore\Model
     */
    public function __call ($rawName, $arguments = []) {
        /** @var $this \MvcCore\Model */
        $nameBegin = strtolower(substr($rawName, 0, 3));
        $name = substr($rawName, 3);
        if ($nameBegin == 'get') {
            if (property_exists($this, lcfirst($name))) return $this->{lcfirst($name)};
            if (property_exists($this, $name)) return $this->$name;
            return NULL;
        } else if ($nameBegin == 'set') {
            if (property_exists($this, lcfirst($name)))
                $this->{lcfirst($name)} = isset($arguments[0]) ? $arguments[0] : NULL;
            if (property_exists($this, $name))
                $this->$name = isset($arguments[0]) ? $arguments[0] : NULL;
            return $this;
        } else {
            throw new \InvalidArgumentException(
                "[".get_class()."] No method `{$rawName}()` defined."
            );
        }
    }

    /**
     * @inheritDocs
     * @param string $name
     * @param mixed  $value
     * @throws \InvalidArgumentException If name is `initialValues` or any custom name in extended class.
     * @return bool
     */
    public function __set ($name, $value) {
        /** @var $this \MvcCore\Model */
        if (isset(static::$protectedProperties[$name]))
            throw new \InvalidArgumentException(
                "[".get_class()."] It's not possible to change strongly property: `{$name}`."
            );
        if (property_exists($this, lcfirst($name)))
            return $this->{lcfirst($name)} = $value;
        return $this->{$name} = $value;
    }

    /**
     * @inheritDocs
     * @param string $name
     * @throws \InvalidArgumentException If name is `initialValues` or any custom name in extended class.
     * @return mixed
     */
    public function __get ($name) {
        /** @var $this \MvcCore\Model */
        if (isset(static::$protectedProperties[$name]))
            throw new \InvalidArgumentException(
                "[".get_class()."] It's not possible to get strongly protected property: `{$name}`."
            );
        if (isset($this->{lcfirst($name)}))
            return $this->{lcfirst($name)};
        if (isset($this->{$name}))
            return $this->{$name};
        return NULL;
    }

    /**
     * @inheritDocs
     * @return \string[]
     */
    public function __sleep () {
        /** @var $this \MvcCore\Model */
        static $__serializePropsNames = NULL;
        if ($__serializePropsNames == NULL) {
            $rawPropNames = array_keys(
                $this instanceof \ArrayObject
                    ? $this
                    : (array) $this
            );
            $__serializePropsNames = [];
            // for private and protected properties:
            $protectedPropNames = & static::$protectedProperties;
            foreach ($rawPropNames as $rawPropName) {
                $pos = strrpos($rawPropName, "\0");
                $propName = $pos === FALSE
                    ? $rawPropName
                    : substr($rawPropName, $pos + 1);
                $doNotSerialize = (
                    isset($protectedPropNames[$propName]) &&
                    $protectedPropNames[$propName]
                );
                if (!$doNotSerialize)
                    $__serializePropsNames[] = $rawPropName;
            }
        }
        return $__serializePropsNames;
    }

}